cpiSetCharacterValueFromBuffer

Finalidade

Define o valor do elemento de sintaxe especificado.

Sintaxe

void cpiSetCharacterValueFromBuffer(
int*            returnCode,
CciElement*     targetElement,
const CciChar*  value,
CciSize         length);

Parâmetros

returnCode
Recebe o código de retorno da função (saída).Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
targetElement
Especifica o endereço do objeto do elemento de sintaxe de destino (entrada).
value
O valor a ser definido no elemento de destino (entrada).
length
O comprimento da cadeia de caracteres, expresso como o número de caracteres CciChar, especificado pelo parâmetro value (entrada).

Valores de Retorno

Nenhuma. Se ocorrer um erro, returnCode indicará o motivo do erro.

Amostra

/* Converter o valor do atributo para o formato do intermediário */
data = CciNString((char *)startMarker, markedSize, pc->iCcsid);
/* Criar um novo elemento nome-valor para o atributo */
newElement = cpiCreateElement(&rc, parser);
cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
cpiSetCharacterValueFromBuffer(&rc, newElement, data, length);
if (pc->trace) {
const char * mbData = mbString(data, pc->iCcsid);
fprintf(pc->tracefile, "PLUGIN: Created new NAMEVALUE element;
object=0x%x type=0x%x name=",
newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
fprintf(pc->tracefile, "%s\n", mbData);
fflush(pc->tracefile);
free((void *)mbData);
}
/* Liberar a memória criada em CciNString() */
free((void *)data);
/* Incluir o elemento */
cpiAddAsLastChild(&rc, element, newElement);
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
Funções de Utilitários do Analisador C
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as08470_