cpiSetElementNamespace

Finalidade

Define o atributo "namespace" para o elemento de sintaxe especificado.

Definido em Type Membro
CPI_VFT Opcional iFpSetElementValue

Sintaxe

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

Parâmetros

returnCode
Um entrada de ponteiro NULL significa que o nó definido pelo usuário não irá lidar com erros. Quaisquer exceções lançadas durante a execução desta chamada serão lançadas novamente para o próximo nó acima no fluxo. Se a entrada não for NULL, a saída significará o status de êxito da chamada. Se uma exceção ocorrer durante a execução, *returnCode será definido como CCI_EXCEPTION na saída. Uma chamada para CciGetLastExceptionData fornecerá detalhes da exceção. (entrada).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
currentElement
O endereço do elemento de sintaxe atual (entrada).
targetElement
Especifica o endereço do objeto do elemento de sintaxe de destino.
value
Especifica o endereço de uma cadeia terminada com nulo de CciChars representando o valor de namespace. Uma cadeia vazia é um valor válido para namespace. De fato, elementos são criados no espaço de nomes de cadeia vazia por padrão, portanto especificar uma cadeia vazia como o espaço de nomes através desta API somente terá algum efeito se o elemento estava anteriormente em outro espaço de nomes e o efeito desejado for alterar o valor do espaço de nomes para a cadeia vazia.

Valores de Retorno

Nenhum.

Amostra

          /* 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);
                    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 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
cpiElementNameSpace
Funções de Implementação do Analisador C
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as08185_