cciMbsToUcs

Converte dados de cadeia multi-byte para UCS (Universal Character Set).

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). Tem um CciChar final de 0, da mesma forma que a mbString tem um byte final de 0.
ucsStringLength
O comprimento (em CciChars) do buffer fornecido (entrada). Cada byte em mbString se expande para não mais que um CciChar e isto define um limite superior para o tamanho necessário do buffer.
codePage
A página de códigos da cadeia de origem (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 cciMbsToUcs 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 meias-palavras (caracteres UCS-2).

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
as08555_