cpiSetElementName

Finalidad

Esta función establece el nombre del elemento de sintaxis especificado.

Sintaxis

void cpiSetElementName(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  name);

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).
name
Nombre que debe establecerse en el elemento de destino (entrada).

Valores de retorno

Ninguno. Si se produce un error, returnCode indica la causa de dicho error.

Ejemplo

Este ejemplo se ha tomado del archivo de analizador de ejemplo BipSampPluginParser.c (de la línea 209 a la 228):

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

/* Crear un nuevo elemento nombre-valor para el atributo              */
          newElement = cpiCreateElement(&rc, parser);
          cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
          cpiSetElementName(&rc, newElement, data);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMEVALUE 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
cpiSetElementType
Grupo cpiSetElementValue
cpiSetElementValueValue
Funciones de programa de utilidad de analizador