Esta função cria um elemento da sintaxe padrão que não está conectado a uma árvore de sintaxe. O elemento é de propriedade do analisador especificado. O elemento é incompleto no sentido de que nenhum de seus atributos (tais como tipo ou nome) são definidos.
CciElement* cpiCreateElement(
int* returnCode,
CciParser* parser);
Se for bem-sucedido, o endereço do novo objeto de elemento é retornado. Caso contrário, um valor de zero (CCI_NULL_ADDR) é retornado e returnCode indica a razão do erro.
Este exemplo é obtido do arquivo analisador de amostra BipSampPluginParser.c:
/* Avançar até o final do valor */
while (pc->iCurrentCharacter != quoteChar) {
advance( (PARSER_CONTEXT_ST *)context, parser );
}
/* Obter um ponteiro para o final da tag */
endMarker = (char*)pc->iBuffer+(int)pc->iIndex;
/* Calcular o tamanho da tag */
markedSize = (size_t)endMarker-(int)startMarker;
/* 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);
cpiSetElementName(&rc, newElement, data);
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);