WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cciUcsToMbs

Verwenden Sie diese Funktion, um Universalzeichensatz-Daten in Mehrfachbyte-Zeichenfolgedaten umzuwandeln. Diese Funktion wird üblicherweise nur für die Formatierung von Diagnosenachrichten verwendet. Normale Verarbeitungen werden am besten in UCS-2 durchgeführt. Darin können alle Zeichen aus allen Sprachen dargestellt werden.

Der Mustercode in BipSampPluginUtil.c enthält weitere Dienstprogramme zur portierbaren Verarbeitung von USC-2-Zeichen.

Syntax

int cciUcsToMbs(
  int*           returnCode,
  const CciChar* ucsString,
  char*          mbString,
  int            mbStringLength,
  int            codePage);

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).

Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_BUFFER_TOO_SMALL
  • CCI_INV_CHARACTER
  • CCI_FAILURE
  • CCI_INV_CODEPAGE
ucsString
Die zu konvertierende Zeichenfolge, als UCS-2 Unicode dargestellt (Eingabe).
mbString
Die Position der Ergebniszeichenfolge (Eingabe). Die Zeichenfolge verfügt über ein nachfolgendes Byte 0, wie auch der Unicode über eine nachfolgende Variable CciChar 0 verfügt.
mbStringLength
Die Länge des Puffers (in Bytes), den Sie bereitgestellt haben (Eingabe). Jede Variable CciChar in der Quellenzeichenfolge wird zu einem Byte (gilt für SBCS-Codeseiten) bzw. zu mehr als dem MB_CUR_MAX-Wert der Codepage (üblicherweise weniger als fünf Bytes) erweitert, was die obere Grenze der erforderlichen Puffergröße definiert.
codePage
Die Codepage der Quellenzeichenfolge (Eingabe). Der Wert der Codepage muss zum Compiler passen, den Sie zum Kompilieren des benutzerdefinierten Knotens verwenden.

Auf einem ASCII-System ist der Wert 1208 zu empfehlen (d. h. Codepage ibm-1208, was UTF-8 Unicode bedeutet), wenn Sie cciUcsToMbs verwenden, um Zeichenfolgekonstanten für die Verarbeitung durch WebSphere Message Broker zu konvertieren. 1208 ist für Linux, UNIX und Windows geeignet.

Auf Linux- und UNIX-Systemen gibt nl_langinfo(CODEPAGE) die Codepage an, die durch den Befehl setlocale ausgewählt wurde.

Die Standardcodepage für WebSphere MQ mit dem Codepagewert 500 darf unter z/OS nicht verwendet werden. Verwenden Sie stattdessen den Codepagewert 1047.

Rückgabewerte

Der Parameter returnCode wird auf die konvertierte Länge in Byte gesetzt.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:05


ReferenzthemaReferenzthema | Version 8.0.0.5 | as08556_