cniCreateElementAsLastChildUsingParser

Cria um novo elemento de sintaxe como o último filho do elemento de sintaxe especificado e o associa ao nome de classe de analisador 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.Consulte Funções de Implementação de Nó em Linguagem C para obter uma lista dos analisadores fornecidos.

Sintaxe

CciElement* cniCreateElementAsLastChildUsingParser(
  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.

Exemplo

    cniElementName(&rc, firstChild, elementName);
        CciElementType type = cniElementType(&rc, firstChild);
        CciElement* lastChild = cniCreateElementAsLastChildUsingParser(
                                                                  
&rc,
                                                                  
outRootElement,
                                                                  
parserName);
        cniSetElementName(&rc, lastChild, elementName);
        cniSetElementType(&rc, lastChild, elementType);

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
Funções de Implementação de Nó em Linguagem C
cniCreateElementAsFirstChild
cniCreateElementAsFirstChildUsingParser
cniCreateElementAsLastChild
cniCreateElementAsLastChildFromBitstream