cpiElementNameSpace

Finalidade

Obtém o valor do atributo "namespace" para o elemento de sintaxe especificado

Definido em Type Membro
CPI_VFT Opcional iFpElementValue

Sintaxe

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

Parâmetros

returnCode
Uma 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. Se o responsável pela chamada não alocou memória suficiente para conter o valor de espaço de nomes, *returncode será definido como CCI_BUFFER_TOO_SMALL.
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
Especifica o endereço do objeto do elemento de sintaxe de destino.
value
Especifica o endereço de um buffer para o qual o valor de espaço de nomes do elemento será copiado. Uma cadeia de caracteres (incluindo um terminador NULL) representando o valor de espaço de nomes é copiada para esse buffer. O buffer deve ser uma parte da memória alocada anteriormente pelo responsável pela chamada
length
O comprimento em CciChars do buffer especificado pelo parâmetro de valor.

Valores de Retorno

Se bem-sucedida, o número de CciChars copiados para o buffer é retornado.

Se o buffer não for grande o suficiente para conter o valor de atributo, returnCode será configurado como CCI_BUFFER_TOO_SMALL e o número de bytes CciChars requeridos será retornado.

Amostra

elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
    elementNamespaceLength = cpiElementNamespace(&rc;,
                        element,
                        elementNamespace,
                        elementNamespaceLength);
    
    if (rc==CCI_BUFFER_TOO_SMALL){
      free(elementNamespace);
      elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
      elementNamespaceLength = cpiElementNamespace(&rc;,
                        element,
                        elementNamespace,
                        elementNamespaceLength);
    }
        checkRC(rc);
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
cpiSetElementNamespace
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
as08105_