cniCreateElementBeforeUsingParser

Cria um novo elemento de sintaxe, insere-o antes do elemento de sintaxe especificado e o associa ao nome de classe de analisador especificado. O novo elemento se torna o irmão anterior do elemento especificado.

Uma parte da árvore de elementos de sintaxe que pertence a um analisador pode apenas ter sua raiz efetiva na primeira geração de elementos (ou seja, como filhos imediatos da raiz). A interface do nó definido pelo usuário não restringe a capacidade de criar uma subárvore que parece pertencer a um analisador diferente. Entretanto, não é possível serializar essas árvores de elementos em um fluxo de bits ao enviar mensagens à saída.

Se você especificar o nome de um analisador fornecido com o , deverá utilizar o nome de classe correto do analisador.

Sintaxe

CciElement* cniCreateElementBeforeUsingParser(
    int*            returnCode,
    CciElement*     targetElement,
    const CciChar*  parserClassName);

Parâmetros

returnCode
O código de retorno da função (saída).
targetElement
O endereço do objeto do elemento (entrada).
parserClassName
O nome da classe do analisador (entrada).

Valores de Retorno

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 o parâmetro returnCode indica a razão do erro.

Conceitos relacionados
Nós de Processamento de Mensagem Definidos pelo Usuário
Nós de Saída Definidos pelo Usuário

Tarefas relacionadas
Criando um Nó de Processamento de Mensagem em C

Referências relacionadas
Funções Utilitárias de Nó em Linguagem C
cniCreateElementAfter
cniCreateElementAfterUsingParser
cniCreateElementBefore