cpiFirstChild

Finalidad

Devuelve la dirección del objeto de elemento de sintaxis que es el primer hijo 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).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
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 hijo en cuyo caso se devuelve cero. Si se produce un error, se devuelve cero (CCI_NULL_ADDR) y returnCode indica la razón del error.

Ejemplo

Este ejemplo se ha tomado del archivo de nodo de ejemplo BipSampPluginParser.c (líneas 494 a 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 en C
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08330_