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/08/14
as08270_