cciMbsToUcs

Konvertiert Mehrfachbyte-Zeichenfolgedaten in Universal Character Set (UCS).

Syntax

int cciMbsToUcs(
  int*         Rückkehrcode,
  const char*  mb-Zeichenfolge,
  CciChar*     ucs-Zeichenfolge,
  int          ucs-Zeichenfolgelänge,
  int          Codepage);

Parameter

Rückkehrcode
Der Rückkehrcode aus der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_BUFFER_TOO_SMALL
  • CCI_INV_CHARACTER
  • CCI_FAILURE
  • CCI_INV_CODEPAGE
mb-Zeichenfolge
Die zu konvertierende Zeichenfolge, als 'file code' dargestellt (Eingabe).
ucs-Zeichenfolge
Die Position der UCS-2 Unicode-Zeichenfolge (Eingabe). Sie verfügt über eine nachfolgende Variable CciChar 0, wie auch die Variable mbString über ein nachfolgendes Byte 0 verfügt.
ucsStringLength
Die Länge (in der Variablen CciChars) des Puffers, den Sie bereitgestellt haben (Eingabe). Jedes Byte in der Variablen mbString wird zu nicht mehr als einer CciChar-Variablen, und dadurch wird eine obere Grenze für die erforderliche Puffergröße definiert.
Codepage
Die Codepage der Quellenzeichenfolge (Eingabe). Der Wert der Codepage sollte zum Compiler passen, der zum Kompilieren des benutzerdefinierten Knotens verwendet wird.

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

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

Die Standardcodepage für WebSphere MQ mit dem Codepagewert 500 sollte für OS/390 und z/OS nicht verwendet werden. Stattdessen sollten Sie den Codepagewert 1047 verwenden.

Rückgabewerte

Die konvertierte Länge in Halbwörtern (UCS-2-Zeichen).

Zugehörige Konzepte
Benutzerdefinierte Erweiterungen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08555_