cpiBufferSize

Scopo

Fornisce la dimensione del buffer contenente la rappresentazione del flusso di bit del messaggio di input, per l'oggetto programma di analisi specificato.

Sintassi

CciSize cpiBufferSize(
  int*      returnCode,
  CciParser*   parser);

Parametri

returnCode
Riceve il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_PARSER_OBJECT
  • CCI_NO_BUFFER_EXISTS
parser
Specifica l'indirizzo dell'oggetto programma di analisi (input).

Valori di restituzione

Se ha esito positivo, viene restituita la dimensione del buffer, in byte. Se si verifica un errore, viene restituito un valore zero (CCI_NULL_ADDR) e il parametro returnCode indica il motivo dell'errore.

Esempio

Questo esempio è estratto dal file del nodo di esempio BipSampPluginParser.c (da riga 428 a 452):

int cpiParseBufferEncoded(
  CciParser*  parser,


  CciContext*  context,
  int                        encoding,
  int         ccsid
){
  PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
  int rc;

  /* Fornisce un puntatore nel buffer di messaggi e imposta l'offset */
  pc->iBuffer = (void *)cpiBufferPointer(&rc, parser);
  pc->iIndex = 0;

  /* Salva il formato del buffer */
  pc->iEncoding = encoding;
  pc->iCcsid = ccsid;

  /* Salva la dimensione del buffer */
  pc->iSize = cpiBufferSize(&rc, parser);
Concetti correlati
Programmi di analisi definiti dall'utente
Estensioni definite dall'utente
Attività correlate
Creazione di un programma di analisi in C
Riferimenti correlati
cpiAppendToBuffer
cpiBufferByte
cpiBufferPointer
Funzioni di utilità del programma di analisi in C
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08290_