cpiSetCharacterValueFromBuffer

Finalidad

Establece el valor del elemento de sintaxis especificado.

Sintaxis

void cpiSetCharacterValueFromBuffer(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  value,
  CciSize         length);

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
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
targetElement
Especifica la dirección del objeto de elemento de sintaxis de destino (entrada).
value
Valor que se debe establecer en el elemento de destino (entrada).
length
Longitud de la serie de caracteres, expresada como el número de caracteres CciChar, especificada por el parámetro value (entrada).

Valores de retorno

Ninguno. Si se produce un error, returnCode indica la razón del mismo.

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);
          cpiSetCharacterValueFromBuffer(&rc, newElement, data, length);
          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
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
as08470_