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
Visión general de las extensiones definidas por el usuario
Tareas relacionadas
Creación de un analizador definido por el usuario
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, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:56:15

as08330_