cciUcsToMbs

Diese Funktion konvertiert UCS-Daten (Universal Character Set, Universalzeichensatz) in Mehrfachbyte-Zeichenfolgedaten. Diese Funktion wird normalerweise nur für Formatierungsdiagnosenachrichten verwendet. Für die normale Verarbeitung wird der Zeichensatz UCS-2 empfohlen, in dem alle Zeichen aus allen Sprachen dargestellt werden können.

Der Beispielcode (BipSampPluginUtil.c) zeigt weitere Dienstprogramme für die übertragbare Verarbeitung von UCS-2-Zeichen.

Syntax

int cciUcsToMbs(
int*           returnCode,
const CciChar* ucsString,
char*          mbString,
int            mbStringLength,
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
ucsString
Die Zeichenfolge, die konvertiert werden soll, als UCS-2 Unicode (Eingabe).
mbString
Die Position der Ergebniszeichenfolge (Eingabe). Das abschließende Byte dieser Zeichenfolge ist 0, ebenso wie das abschließende Zeichen vom Typ CciChar von Unicode.
mbStringLength
Die Länge des Puffers, den Sie angegeben haben, in Byte (Eingabe). Jedes Zeichen vom Typ CciChar in der Quellenzeichenfolge wird auf ein Byte (für SBCS-Codepages) oder maximal auf den Wert MB_CUR_MAX der Codepage erweitert (normalerweise weniger als fünf Byte). Dies ist die Obergrenze der erforderlichen 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 cciUcsToMbs 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 Byte.

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