cciMbsToUcs

Diese Funktion konvertiert Mehrfachbyte-Zeichenfolgedaten in den Universalzeichensatz (Universal Character Set, UCS).

Syntax

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

Parameter

returnCode
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
mbString
Die Zeichenfolge, die konvertiert werden soll, als 'Dateicode' (Eingabe).
ucsString
Die Position der UCS-2-Unicode-Ergebniszeichenfolge (Eingabe). Das abschließende Zeichen vom Typ CciChar dieser Zeichenfolge ist 0, ebenso wie das abschließende Byte von mbString.
ucsStringLength
Die Länge des Puffers, den Sie angegeben haben, in Zeichen vom Typ CciChar) (Eingabe). Jedes Byte in der Zeichenfolge mbString wird höchstens auf ein Zeichen vom Typ CciChar erweitert. Dies bildet die Obergrenze für die erforderliche Puffergröße.
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: 18.05.2006
as08555_