cpiBufferSize

Finalidad

Obtiene el tamaño del almacenamiento intermedio que contiene la representación de corriente de bits del mensaje de entrada, para el objeto de analizador especificado.

Sintaxis

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

Parámetros

returnCode
Recibe el código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_PARSER_OBJECT
  • CCI_NO_BUFFER_EXISTS
parser
Especifica la dirección del objeto de analizador (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, se devuelve el tamaño del almacenamiento intermedio en bytes. Si se produce un error, se devuelve cero (CCI_NULL_ADDR) y returnCode indica la razón del error.

Ejemplo

Este ejemplo se ha tomado del archivo de nodo de ejemplo BipSampPluginParser.c (líneas 428 a 452):

int cpiParseBufferEncoded(
  CciParser*  parser,


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

  /* Obtener un puntero al almacenamiento intermedio de mensaje y establecer el desplazamiento */
  pc->iBuffer = (void *)cpiBufferPointer(&rc, parser);
  pc->iIndex = 0;

  /* Guardar el formato del almacenamiento intermedio */
  pc->iEncoding = encoding;
  pc->iCcsid = ccsid;

  /* Guardar el tamaño del almacenamiento intermedio */
  pc->iSize = cpiBufferSize(&rc, parser);
Conceptos relacionados
Analizadores definidos por el usuario
Extensiones definidas por el usuario
Tareas relacionadas
Creación de un analizador en C
Referencia relacionada
cpiAppendToBuffer
cpiBufferByte
cpiBufferPointer
Funciones de programa de utilidad de analizador en C
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08290_