cciUcsToMbs

Converte dados de UCS (Universal Character Set) para dados de cadeia multi-byte. Essa função é, em geral, utilizada somente para formatar mensagens de diagnóstico. O processamento normal é feito melhor em UCS-2, o qual pode representar todos os caracteres de todos os idiomas.

O código de amostra (BipSampPluginUtil.c) mostra mais utilitários para processar caracteres UCS-2 de uma maneira portátil.

Sintaxe

int cciUcsToMbs(
  int*           returnCode,
  const CciChar* ucsString,
  char*          mbString,
  int            mbStringLength,
  int            codePage);

Parâmetros

returnCode
O código de retorno da função (saída).
ucsString
A cadeia a ser convertida, expressa como Unicode UCS-2 (entrada).
mbString
O local da cadeia resultante (entrada). A cadeia tem um byte final de 0, da mesma forma que o Unicode tem um CciChar final de 0.
mbStringLength
O comprimento (em bytes) do buffer fornecido (entrada). Cada CciChar da cadeia de origem expande até um byte (para páginas de códigos SBCS) ou até não mais que o valor MB_CUR_MAX da página de códigos (geralmente menos do que cinco bytes), que define o limite superior do tamanho de buffer necessário.
codePage
A página de código necessária (entrada). Em um sistema Unix, nl_langinfo(CODEPAGE) fornece a página de códigos que foi selecionada por setlocale. 1208 fornece Unicode UTF-8.

Valores de Retorno

O comprimento convertido em bytes.

Conceitos relacionados
Extensões Definidas pelo Usuário

Tarefas relacionadas
Criando um Nó de Entrada em C
Criando um Nó de Processamento de Mensagem em C
Criando um Analisador em C

Referências relacionadas
Extensões Definidas pelo Usuário
cciMbsToUcs