cciUcsToMbs

Wandelt Universalzeichensatz-Daten (UCS) in Mehrfachbytezeichenfolgedaten um. 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 (BipSampPluginUtil.c) zeigt weitere Dienstprogramme zur portierbaren Verarbeitung von USC-2-Zeichen.

Syntax

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

Parameter

Rückkehrcode
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
ucs-Zeichenfolge
Die zu konvertierende Zeichenfolge, als UCS-2 Unicode dargestellt (Eingabe).
mb-Zeichenfolge
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.
mb-Zeichenfolgelänge
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 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 Bytes.

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