SAX GET XML ELEMENT
SAX GET XML ELEMENT ( documento ; nome ; prefixo ; nomesAtributos ; valoresAtributos )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| documento | refDoc | 🡒 | Referência do documento aberto |
| nome | String | 🡘 | Element name |
| prefixo | String | 🡘 | Namespace |
| nomesAtributos | Array string | 🡘 | Attribute names |
| valoresAtributos | Array string | 🡘 | Attribute values |
Descrição
O comando SAX GET XML ELEMENT devolve diversa informação relativa ao elemento nome presente no documento XML referenciado por documento. Este comando deve ser chamado com os eventos XML Start Element ou XML End Element SAX. No caso específico de XML End Element, os parâmetros de atributos não são manipulados. Para maior informação sobre os eventos SAX, consulte a descrição do comando SAX Get XML node.
O parâmetro nome contém o nome do elemento.
O parâmetro prefixo devolve o espaço de nome (namespace) do elemento. Este parâmetro está vazio se nenhum espaço de nome estiver associado ao elemento.
O comando preenche o array nomsAtributos com os nomes dos atributos do elemento objetivo. Se for necessário, o comando cria e dimensiona automaticamente o array.
O comando também preenche o array valoresAtributos com os valores dos atributos do elemento objetivo. Se for necessário, o comando cria e dimensiona automaticamente o array.
Exemplo
Consideremos o código XML abaixo:
MeuTexto
Quando executar a seguinte instrução:
SAX GET XML ELEMENT(DocRef;vNome;vPrefixo;tAttrNomes;tAttrValores)
...vNome conterá “Filho”
vPrefix conterá “”
tAttrNomes{1} conterá “Att1”, tAttrNomes{2} conterá “Att2”, tAttrNomes{3} conterá “Att3”
tAttrValores{1} conterá “111”, tAttrValores{2} conterá “222”, tAttrValores{3} conterá “333”
Variáveis e conjuntos do sistema
Se o comando tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Do contrário, assume o valor e se gera um erro.