cpiWriteBufferFormatted

Finalidade

Essa função é uma extensão da capacidade fornecida pela função de implementação cpiWriteBuffer() existente que fornece:
  1. A codificação e o conjunto de caracteres codificados nos quais a mensagem de saída deve ser representada quando o analisador serializar sua árvore de elementos para um fluxo de bits de saída.
  2. O conjunto de mensagens, tipo e formato para a mensagem de saída desses analisadores que requerem essas informações, para serializar corretamente sua árvore de elementos para um fluxo de bits de saída.

Se a serialização não for necessária, por exemplo, quando a saída tiver como base um fluxo de bits de entrada e a árvore não tiver sido modificada, essa função de implementação não será chamada pelo intermediário.

Se essa função de implementação for fornecida na estrutura CPI_VFT, nem cpiWriteBuffer() nem cpiWriteBufferEncoded() podem ser especificados, porque a função cpiDefineParserClass() falhará com um código de retorno de CCI_INVALID_IMPL_FUNCTION.

Definido em Tipo Membro
CPI_VFT Condicional iFpWriteBufferFormatted

Sintaxe

int cpiWriteBufferFormatted(
CciParser*     parser,
CciContext*    context,
int            encoding,
int            ccsid,
CciChar*       set,
CciChar*       type,
CciChar*       format); 

Parâmetros

parser
O endereço do objeto analisador (entrada).
context
O endereço do contexto de propriedade do objeto analisador (entrada).
encoding
A codificação do buffer de mensagem (entrada).
ccsid
O ccsid do buffer de mensagem (entrada).
set
O conjunto de mensagens ao qual a mensagem pertence (entrada).
type
O tipo de mensagem (entrada).
format
O formato da mensagem (entrada).

Valores de Retorno

O tamanho em bytes dos dados anexados ao fluxo de bits no buffer.

Amostra

int cpiWriteBufferFormatted(
CciParser*  parser,
CciContext* context,
int         encoding,
int         ccsid
CciChar*       set,
CciChar*       type,
CciChar*       format
){
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;
}
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
cpiWriteBuffer
cpiWriteBufferEncoded
Funções de Implementação do Analisador C
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as08230_