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ó plug-in não deseja 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 namespace, *returncode será definido como CCI_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 namespace do elemento será copiado. Uma cadeia de caracteres (incluindo um terminador NULL) representando o valor de namespace é copiada para esse buffer. O buffer deve ser uma parte da memória alocada anteriormente pelo responsável pela chamada
length
O comprimento em bytes do buffer especificado pelo parâmetro value.

Valores de Retorno

Se bem-sucedida, o número de CciChars copiados para o buffer é retornado. Se o buffer não era grande o suficiente para conter o valor de namespace, o número de bytes necessário é retornado (e returnCode é definido como CCI_BUFFER_TOO_SMALL).

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 de Analisador