cciMbsToUcs

Converte dati di stringhe multi-byte in UCS (Universal Character Set).

Sintassi

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

Parametri

returnCode
Il codice di ritorno dalla funzione (output). I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_BUFFER_TOO_SMALL
  • CCI_INV_CHARACTER
  • CCI_FAILURE
  • CCI_INV_CODEPAGE
mbString
La stringa da convertire, espressa come 'codice file' (input).
ucsString
L'ubicazione della stringa UCS-2 Unicode risultante (input). Risulta avere 0 come CciChar finale così come 0 è il byte finale di mbString.
ucsStringLength
La lunghezza (in CciChars) del buffer che è stato fornito (input). Ciascun byte in mbString si espande su non più di un CciChar e questo definisce un limite superiore per la dimensione del buffer richiesta.
codePage
La code page della stringa di origine (input). Il valore della code page deve essere appropriato per il compilatore utilizzato per eseguire la compilazione del nodo definito dall'utente.

Relativamente ad un sistema ASCII, il valore 1208 (che indica la code page ibm-1208, che è UTF-8 Unicode) risulta una scelta appropriata se si sta utilizzando cciMbsToUcs per convertire le costanti di stringa per l'elaborazione da parte di WebSphere Message Broker. 1208 risulta appropriato per le piattaforme Windows, Linux e UNIX.

Su Linux e UNIX, nl_langinfo(CODEPAGE) fornisce la code page selezionata da setlocale.

Relativamente a OS/390 e z/OS, non deve essere utilizzata la code page predefinita per WebSphere MQ, che è 500. Utilizzare invece il valore di code page 1047.

Valori di restituzione

La lunghezza convertita in "half-words" (caratteri UCS-2).

Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08555_