cpiSetElementNamespace

Finalidad

Establece el atributo "espacio de nombres" del elemento de sintaxis especificado.

Definida en Tipo Miembro
CPI_VFT Opcional iFpSetElementValue

Sintaxis

void cpiSetElementNamespace(
int* returnCode,
CciElement* targetElement,
const CciChar* nameSpace);

Parámetros

returnCode
Una entrada de puntero NULL significa que el nodo definido por el usuario no desea tratar los errores. Las excepciones emitidas durante la ejecución de esta llamada se volverán a emitir en el nodo ascendente siguiente del flujo. Si la entrada no es NULL, la salida significará el estado de éxito de la llamada. Si se produce una excepción durante la ejecución, *returnCode se establecerá en CCI_EXCEPTION en la salida. Una llamada a CciGetLastExceptionData proporcionará los detalles de la excepción (entrada).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
currentElement
Dirección del elemento de sintaxis actual (entrada).
targetElement
Especifica la dirección del objeto de elemento de sintaxis de destino.
value
Especifica la dirección de una serie de caracteres terminada en nulo de CciChar que representan el valor de espacio de nombres. Una serie de caracteres vacía es un valor válido para el espacio de nombres. Dado que, de hecho los elementos se crean por omisión en el espacio de nombres de serie de caracteres vacía, la especificación de una serie de caracteres vacía como espacio de nombres a través de esta API sólo tendrá un efecto si el elemento se encontraba anteriormente en otro espacio de nombres y el efecto deseado es cambiar el valor de espacio de nombres por una serie de caracteres vacía.

Valores de retorno

Ninguno.

Ejemplo

/* Convertir el valor de atributo a formato de intermediario */
          data = CciNString((char *)startMarker, markedSize, pc->iCcsid);

/* Crear un elemento de nombre-valor nuevo para el atributo */
          newElement = cpiCreateElement(&rc, parser);
          cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
          cpiSetElementName(&rc, newElement, data);
          cpiSetElementNamespace(&rc, newElement, data);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMESPACEVALUE element; 
                    object=0x%x type=0x%x name=",
                    newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
            fprintf(pc->tracefile, "%s\n", mbData);
            fflush(pc->tracefile);
            free((void *)mbData);
          }
          /* Liberar la memoria creada en CciNString() */
          free((void *)data);

          /* Añadir el elemento */
          cpiAddAsLastChild(&rc, element, newElement);
Conceptos relacionados
Analizadores definidos por el usuario
Extensiones definidas por el usuario
Tareas relacionadas
Creación de un analizador en C
Referencia relacionada
cpiElementNameSpace
Funciones de implementación de analizador en C
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08185_