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

cciMbsToUcs

Use esta função para converter dados de cadeia multibytes em Universal Character Set (UCS).

Sintaxe

int cciMbsToUcs(
  int*            returnCode,
  const char*  mbString,
  CciChar*     ucsString,
  int          ucsStringLength,
  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
mbString
A cadeia a ser convertida, expressa como 'código de arquivo' (entrada).
ucsString
O local da cadeia Unicode UCS-2 resultante (entrada). Esta cadeia possui um CciChar final igual a 0, assim como mbString possui um byte final igual a 0.
ucsStringLength
O comprimento (em CciChar) do buffer que você forneceu (entrada). Cada byte em mbString expande para não mais que um caractere CciChar e isto define um limite superior para o tamanho do buffer necessário.
codePage
A página de códigos da cadeia de origem (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 cciMbsToUcs para converter constantes de cadeia para processamento pelo WebSphere Message Broker. 1208 é apropriado para sistemas Linux, UNIX e Windows.

Nos sistemas Linux, UNIX, nl_langinfo(CODEPAGE) fornece a página de códigos que foi selecionada por 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 com o comprimento convertido em metade das palavras (caracteres UCS-2).

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:25


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