cpiFirstChild

Finalidad

Esta función devuelve la dirección del objeto de elemento de sintaxis que es el primer elemento dependiente del elemento de destino especificado.

Sintaxis

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

Parámetros

returnCode
Recibe el código de retorno de la función (salida).
targetElement
Especifica la dirección del objeto de elemento de sintaxis de destino (entrada).

Valores de retorno

Se devuelve la dirección del objeto de elemento de sintaxis solicitado, a menos que no haya ningún elemento dependiente, en cuyo caso se devuelve cero. Si se produce un error, se devuelve cero (CCI_NULL_ADDR), y returnCode indica la causa de dicho error.

Ejemplo

Este ejemplo se ha tomado del archivo de nodo de ejemplo BipSampPluginParser.c (de la línea 494 a la 496):

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

Conceptos relacionados
Analizadores definidos por el usuario
Extensiones definidas por el usuario

Tareas relacionadas
Creación de un analizador en C

Referencia relacionada
cpiLastChild
Funciones de programa de utilidad de analizador