Questa funzione è un'estensione della caratteristica fornita dalla funzione di implementazione cpiParseBuffer() che fornisce la codifica e la serie di caratteri codificata di rappresentazione del messaggio. Se nella struttura CPI_VFT viene fornita questa funzione di implementazione, non è possibile specificare cpiParseBuffer() né cpiParseBufferFormatted() altrimenti la funzione cpiDefineParserClass() avrà esito negativo e viene restituito il codice di ritorno CCI_INVALID_IMPL_FUNCTION.
Definito in | Tipo | Membro |
CPI_VFT | Condizionale | iFpParseBufferEncoded |
int cpiParseBufferEncoded( CciParser* parser, CciContext* context, int encoding, int ccsid);
La dimensione (in byte) della parte rimanente del buffer di messaggi per il quale il programma di analisi assume la proprietà.
Questo esempio è estratto dal file del programma di analisi di esempio BipSampPluginParser.c (da riga 428 a 466):
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); /* Prepara il primo byte nel flusso */ pc->iCurrentCharacter = cpiBufferByte(&rc, parser, pc->iIndex); /* Imposta l'elemento attuale nell'elemento root */ pc->iCurrentElement = cpiRootElement(&rc, parser); /* Reimposta l'indicatore per garantire che l'analisi venga reimpostata correttamente */ pc->iInTag = 0; if (pc->trace) { fprintf(pc->tracefile, "PLUGIN: <- cpiParseBufferEncoded() retvalue=%d\n", pc->iSize); fflush(pc->tracefile); }