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, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:59


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