cciUcsToMbs

Converte i dati UCS (Universal Character Set) in dati di stringhe multi-byte. Questa funzione è solitamente usata solo per messaggi diagnostici di formattazione. L'elaborazione normale viene svolta al meglio in UCS-2, che può rappresentare tutti i caratteri di tutte le lingue.

Il codice di esempio (BipSampPluginUtil.c) mostra diverse funzioni di utilità per l'elaborazione dei caratteri UCS-2.

Sintassi

int cciUcsToMbs(
  int*      returnCode,
  const CciChar* ucsString,
  char*          mbString,
  int            mbStringLength,
  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
ucsString
La stringa da convertire, espressa come UCS-2 Unicode (input).
mbString
L'ubicazione della stringa risultante (input). La stringa ha 0 come byte finale così come Unicode ha 0 come CciChar finale.
mbStringLength
La lunghezza (in byte) del buffer che è stato fornito (input). Ogni CciChar nella stringa di origine si espande su un byte (per code page SBCS) o al massimo fino al valore MB_CUR_MAX della code page (di solito meno di cinque byte), che definisce un limite superiore della dimensione del buffer richiesta.
codePage
La code page della stringa risultante (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 cciUcsToMbs 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 bytes.

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