Saltar para o conteúdo principal
Versão: Próximo

DOM GET XML ATTRIBUTE BY INDEX

DOM GET XML ATTRIBUTE BY INDEX ( refElemento ; indexAtrib ; nomeAtrib ; valorAtrib )

ParâmetroTipoDescrição
refElementoTextReferência de elemento XML
indexAtribIntegerNúmero de índice de atributo
nomeAtribVariableNome atributo
valorAtribVariableValor atributo

Descrição

O comando DOM GET XML ATTRIBUTE BY INDEX permite conhecer o nome assim como o valor de um atributo especificado por seu número de índice.

Passe em refElemento a referência de um elemento XML e em indexAtrib o número de índice do atributo que queira conhecer o nome. O nome se retorna no parâmetro nomeAtrib e seu valor se retorna no parâmetro valorAtrib. 4D tentará converter o valor obtido no tipo de variável passada como parâmetro. Se o tipo variável não for definido, o valor é retornado em tipo texto como padrão.

Nota: O número de índice não corresponde à localização do atributo no arquivo XML mostrado em forma de texto. Em XML, o índice de um atributo indica sua posição entre os atributos classificados por ordem alfabética (em função de seu nome). Para ver uma ilustração deste principio, consulte o exemplo do comando DOM Count XML attributes.

Se o valor passado em indexAtrib é superior ao número de atributos presentes no elemento XML, se retorna um erro.

Exemplo

Consulte o exemplo do comando DOM Count XML attributes. .

Variáveis e conjuntos do sistema

Se o comando tiver sido executado corretamente, a variável sistema OK assume o valor 1. Se ocorrer um erro, assume o valor 0.

Ver também

DOM GET XML ATTRIBUTE BY NAME
DOM REMOVE XML ATTRIBUTE