cciMbsToUcs

Convierte datos de serie de caracteres de varios bytes a UCS (Universal Character Set - Juego de caracteres universal).

Sintaxis

int cciMbsToUcs(
  int*         returnCode,
  const char*  mbString,
  CciChar*     ucsString,
  int          ucsStringLength,
  int          codePage);

Parámetros

returnCode
Código de retorno de la función (salida). Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_BUFFER_TOO_SMALL
  • CCI_INV_CHARACTER
  • CCI_FAILURE
  • CCI_INV_CODEPAGE
mbString
Serie de caracteres que se debe convertir, expresada como 'código de archivo' (entrada).
ucsString
Ubicación de la serie de caracteres Unicode UCS-2 resultante (entrada). Tiene un CciChar de cola de 0, igual que mbString tiene un byte de cola de 0.
ucsStringLength
Longitud (en CciChar) del almacenamiento intermedio que ha proporcionado (entrada). Cada byte de mbString no se expande más que a un CciChar y esto define un límite superior para el tamaño de almacenamiento intermedio necesario.
codePage
Página de códigos de la serie de caracteres de origen (entrada). El valor de la página de códigos debe ser el adecuado para el compilador que se utiliza para compilar el nodo definido por el usuario.

Para un sistema ASCII, el valor 1208 (lo que significa la página de códigos ibm-1208, que es UTF-8 Unicode) es una buena opción si está utilizando cciMbsToUcs para convertir constantes de series de caracteres para que las procese WebSphere Message Broker. 1208 es adecuado para Linux y UNIX, y para plataformas Windows.

En Linux y UNIX, nl_langinfo(CODEPAGE) le proporciona la página de códigos seleccionada por setlocale.

Para OS/390 y z/OS, no debe utilizarse la página de códigos por omisión para WebSphere MQ, que es 500. En su lugar, debe utilizar el valor de página de códigos 1047.

Valores de retorno

Longitud convertida en medias palabras (caracteres UCS-2).

Conceptos relacionados
Extensiones definidas por el usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08555_