cpiWriteBufferEncoded

用途

此函数是现有 cpiWriteBuffer() 实施函数所提供的功能的扩展,它提供了译码和编码字符集,当解析器按顺序将其元素树解析为输出位流时,应使用此字符集来表示输出消息。如果不需要进行序列化(例如,当输出基于输入位流并且树未经更改时),则代理不会调用此实施函数。如果 CPI_VFT 结构中提供了此实施函数,则既不能指定 cpiWriteBuffer() 也不能指定 cpiWriteBufferFormatted(),这是因为 cpiDefineParserClass() 函数将失败,返回码为 CCI_INVALID_IMPL_FUNCTION。

在其中定义 类型 成员
CPI_VFT 有条件的 iFpWriteBufferEncoded

语法

int cpiWriteBufferEncoded(
    CciParser*  parser,
    CciContext* context,                
    int         encoding,
    int          ccsid); 

参数

parser
解析器对象的地址(输入)。
context
解析器对象拥有的上下文的地址(输入)。
encoding
消息缓冲区的编码(输入)。
ccsid
消息缓冲区的 ccsid(输入)。

返回值

追加在缓冲区中位流后面的数据大小(以字节为单位)。

样本

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

int cpiWriteBufferEncoded(
    CciParser*  parser,
    CciContext* context,                
    int         encoding,
    int         ccsid
){
    PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
    int                initialSize = 0;
    int                rc = 0;
    const void* a;
    CciByte b;

  
    initialSize = cpiBufferSize(&rc, parser);
    a = cpiBufferPointer(&rc, parser);
    b = cpiBufferByte(&rc, parser, 0);

    cpiAppendToBuffer(&rc, parser, (char *)"Some test data", 14);

    return cpiBufferSize(0, parser) - initialSize;
}
相关概念
用户定义的解析器
用户定义的扩展
相关任务
使用 C 创建解析器
相关参考
cpiWriteBuffer
cpiWriteBufferFormatted
C 解析器实施函数
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as08220_