cpiBufferByte

目的

从包含输入消息的位流表示的缓冲区获取单个字节,用于指定的解析器对象。索引自变量的值表明要返回字节数组中的哪个字节。

语法

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

参数

returnCode
接收来自函数(输出)的返回码。可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_PARSER_OBJECT
  • CCI_NO_BUFFER_EXISTS
parser
指定解析器对象的地址(输入)。
index
指定要使用的位移作为到缓冲区中的索引(输入)。

返回值

返回了请求的字节。如果发生错误,则 returnCode 表明错误原因。

样本

此示例取自样本解析器文件 BipSampPluginParser.c(61 行到 75 行):

void advance(
  PARSER_CONTEXT_ST* context,
  CciParser* parser
){
  int                rc = 0;
  /* Advance to the next character */
context->iIndex++;
  /* Detect and handle the end condition */
if (context->iIndex == context->iSize) return;
  /* Obtain the next character from the buffer */
context->iCurrentCharacter = cpiBufferByte(&rc, parser, context->iIndex);
}
相关概念
用户定义的解析器
用户定义的扩展
相关任务
使用 C 创建解析器
相关参考
cpiAppendToBuffer
cpiBufferPointer
cpiBufferSize
C 解析器实用程序函数
声明 | 商标 | 下载 | | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后更新:2006/05/19
as08270_