cciUcsToMbs

Convierte datos UCS (Universal Character Set - Juego de caracteres universal) en datos de serie de caracteres de varios bytes. Normalmente esta función sólo se utiliza formatear mensajes de diagnóstico. El proceso normal se realiza mejor en UCS-2, que puede representar todos los caracteres de todos los idiomas.

El código de ejemplo (BipSampPluginUtil.c) muestra más programas de utilidad para procesar caracteres UCS-2 de un modo portable.

Sintaxis

int cciUcsToMbs(
  int*           returnCode,
  const CciChar* ucsString,
  char*          mbString,
  int            mbStringLength,
  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
ucsString
Serie de caracteres que se debe convertir, expresada como Unicode UCS-2 (entrada).
mbString
Ubicación de la serie de caracteres resultante (entrada). La serie de caracteres tiene un byte de cola de 0, igual que Unicode tiene un CciChar de cola de 0.
mbStringLength
Longitud (en bytes) del almacenamiento intermedio que ha proporcionado (entrada). Cada CciChar de la serie de caracteres de origen se expande a un byte (para páginas de códigos SBCS) o hasta un máximo que no supere el valor MB_CUR_MAX de la página de códigos (normalmente menos de cinco bytes), lo que define un límite superior del tamaño de almacenamiento intermedio necesario.
codePage
Página de códigos de la serie de caracteres resultante (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 cciUcsToMbs 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 bytes.

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
as08556_