cpiSetElementName

Finalidade

Define o nome do elemento de sintaxe especificado.

Sintaxe

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

Parâmetros

returnCode
Recebe o código de retorno da função (saída).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
targetElement
Especifica o endereço do objeto do elemento de sintaxe de destino (entrada).
name
O nome a ser definido no elemento de destino (entrada).

Valores de Retorno

Nenhuma. Se ocorrer um erro, returnCode indicará o motivo do erro.

Amostra

Este exemplo foi tirado do arquivo do analisador de amostra BipSampPluginParser.c (linhas 209 a 228):

/* Converter o valor do atributo para o formato do intermediário */
          data = CciNString((char *)startMarker, markedSize, pc->iCcsid);

/* Criar um novo elemento nome-valor para o 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 a memória criada em CciNString() */
          free((void *)data);

          /* Incluir o elemento */
          cpiAddAsLastChild(&rc, element, newElement);
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
cpiSetElementType
grupo cpiSetElementValue
cpiSetElementValueValue
Funções de Utilitários do Analisador C
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as08500_