WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

cciUcsToMbs

Use esta função para converter dados Universal Character Set (UCS) em dados de cadeia multibytes. 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 em BipSampPluginUtil.c contém mais utilitários para processar caracteres UCS-2 de uma maneira portável.

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 adequado para o compilador que você está usando 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 Linux, UNIX e Windows.

Nos sistemas Linux e UNIX, nl_langinfo(CODEPAGE) fornece a página de códigos que foi selecionada pelo comando setlocale.

No z/OS, a página de códigos padrão para WebSphere MQ, que é 500, não deve ser usada. Em vez disso, use um valor da página de códigos igual a 1047.

Valores de Retorno

O parâmetro returnCode é configurado como o comprimento convertido em bytes.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:26


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | as08556_