WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

cciUcsToMbs

Utilice esta función para convertir datos UCS (Universal Character Set - Juego de caracteres universal) en datos de serie de caracteres multibyte. Normalmente esta función sólo se utiliza para 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 de BipSampPluginUtil.c contiene más utilidades 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 esté utilizando 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, UNIX y Windows.

En sistemas Linux y UNIX, nl_langinfo(CODEPAGE) devuelve la página de códigos que ha seleccionado el mandato setlocale.

En z/OS, la página de códigos predeterminada para WebSphere MQ, que es 500, no debe utilizarse. En su lugar, utilice el valor de página de códigos 1047.

Valores de retorno

El parámetro returnCode se establece en la longitud convertida en bytes.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:27


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as08556_