cpiBufferByte

Finalidad

Esta función obtiene un solo byte del almacenamiento intermedio que contiene la representación de corriente de bits del mensaje de entrada, para el objeto de analizador especificado. El valor del argumento de índice indica el byte de la matriz de bytes que se debe devolver.

Sintaxis

CciByte cpiBufferByte(
  int*        returnCode,
  CciParser*  parser,
  CciSize     index);

Parámetros

returnCode
Recibe el código de retorno de la función (salida).
parser
Especifica la dirección del objeto de analizador (entrada).
index
Especifica el desplazamiento utilizado como índice en el almacenamiento intermedio (entrada).

Valores de retorno

Se devuelve el byte solicitado. Si se produce un error, returnCode indica la causa de dicho error.

Ejemplo

Este ejemplo se ha tomado del archivo de analizador de ejemplo BipSampPluginParser.c (de la línea 61 a la 75):

void advance(
  PARSER_CONTEXT_ST* context,
  CciParser*         parser
){
  int rc = 0;

  /* Avanzar hasta el carácter siguiente                         */
  context->iIndex++;

  /* Detectar y manejar la condición final                       */
  if (context->iIndex == context->iSize) return;

  /* Obtener el carácter siguiente del almacenamiento intermedio */
  context->iCurrentCharacter = cpiBufferByte(&rc, parser, context->iIndex);
}

Conceptos relacionados
Analizadores definidos por el usuario
Extensiones definidas por el usuario

Tareas relacionadas
Creación de un analizador en C

Referencia relacionada
cpiAppendToBuffer
cpiBufferPointer
cpiBufferSize
Funciones de programa de utilidad de analizador