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).

Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_BUFFER_TOO_SMALL
  • CCI_INV_CHARACTER
  • CCI_FAILURE
  • CCI_INV_CODEPAGE
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ódigos da cadeia resultante (entrada). O valor da página de códigos deve ser apropriado para o compilador sendo utilizado para compilar o nó definido pelo usuário.

Para um sistema ASCII, um valor 1208 (significando a página de códigos ibm-1208, que é Unicode UTF-8) é uma boa opção se você estiver utilizando cciUcsToMbs para converter constantes de cadeia para processamento pelo WebSphere Message Broker. 1208 é apropriado para plataformas Linux e UNIX e Windows.

No Linux e UNIX, nl_langinfo(CODEPAGE) fornece a página de códigos que foi selecionada por setlocale.

Para OS/390 e z/OS, a página de códigos padrão para WebSphere MQ, que é 500, não deveria ser utilizada. Em seu lugar, você deveria utilizar um valor da página de códigos 1047.

Valores de Retorno

O comprimento convertido em bytes.

Conceitos relacionados
Extensões Definidas pelo Usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as08556_