cniCreateElementAsLastChildUsingParser

Crea un nuevo elemento de sintaxis como el último hijo del elemento de sintaxis especificado y lo asocia con el nombre de clase de analizador especificado.

Una parte del árbol de elementos de sintaxis que es propiedad de un analizador sólo puede tener la raíz efectiva en la primera generación de elementos (es decir, como hijos inmediatos de la raíz). La interfaz de nodo definido por el usuario no restringe la posibilidad de crear un subárbol que parezca ser propiedad de un analizador diferente. Sin embargo, no es posible serializar estos árboles de elementos en una corriente de bits cuando se está emitiendo un mensaje de salida.

Si especifica el nombre de un analizador proporcionado con WebSphere Message Broker, deberá utilizar el nombre de clase correcto del analizador. Consulte el apartado Funciones de implementación de nodo en C para obtener una lista de los analizadores proporcionados.

Si utiliza esta función para crear una carpeta de analizador BLOB, el nombre interno para el analizador BLOB es none. Por tanto, si utiliza esta función para crear una carpeta de analizador BLOB, el nombre del analizador asociado debe ser none.

El nombre interno para el analizador BLOB es none. Por tanto, si utiliza esta función para crear una carpeta de analizador BLOB, el nombre del analizador asociado debe ser none.

Sintaxis

CciElement* cniCreateElementAsLastChildUsingParser(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  parserClassName);

Parámetros

returnCode
Código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_PARSER_NAME
targetElement
Dirección del objeto de elemento (entrada).
parserClassName
Nombre de la clase de analizador (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, se devuelve la dirección del objeto de elemento nuevo. De lo contrario, se devuelve un valor de cero (CCI_NULL_ADDR) y el parámetro returnCode indica la razón del error.

Ejemplo

    cniElementName(&rc, firstChild, elementName);
    CciElementType type = cniElementType(&rc, firstChild);
    CciElement* lastChild = cniCreateElementAsLastChildUsingParser(
                                                                  &rc, 
                                                                  outRootElement, 
                                                                  parserName);
    cniSetElementName(&rc, lastChild, elementName);
    cniSetElementType(&rc, lastChild, elementType);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as07870_