cpiFirstChild

Finalidade

Retorna o endereço do objeto do elemento de sintaxe que é o primeiro filho do elemento de destino especificado.

Sintaxe

CciElement* cpiFirstChild(
  int*               returnCode,
  const CciElement*  targetElement);

Parâmetros

returnCode
Recebe o código de retorno da função (saída).
targetElement
Especifica o endereço do objeto do elemento de sintaxe de destino (entrada).

Valores de Retorno

O endereço do objeto de elemento de sintaxe pedido é retornado, a menos que não exista um filho; neste caso, zero é retornado. Se um erro ocorrer, zero (CCI_NULL_ADDR) é retornado e returnCode indica a razão do erro.

Amostra

Este exemplo foi tirado do arquivo do nó de amostra BipSampPluginParser.c (linhas 494 a 496):

while ((!cpiElementCompleteNext(&rc, element))     &&
           (!cpiFirstChild(&rc, element)) &&
           (pc->iCurrentElement))

Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário

Tarefas relacionadas
Criando um Analisador em C

Referências relacionadas
cpiLastChild
Funções Utilitárias de Analisador