Realiza o parse de um XML passado através de uma string, podendo especificar a codificação do XML e opções para alterar o comportamento do parser. Se o parse for realizado com sucesso, é construida a árvore do XML.
Sintaxe
Read( < cXml >, [ cURL ], [ cEncoding ], [ nOptions ] ) |
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
|---|---|---|---|---|
cXml | caractere | Indica a string que contém o XML. | X |
|
cURL | caractere | Indica a URL Base utilizada para o documento. |
|
|
cEncoding | caractere | Indica a codificação do documento. |
|
|
nOptions | numérico | Indica a combinação de opções para alterar o comportamento do parser. |
|
|
Retorno
Nome | Tipo | Descrição |
|---|---|---|
lRet | lógico | Retorna, verdadeiro (.T.) caso tenha sido realizado o parse com sucesso. Caso contrário, falso (.F.). |
Observações
Tabela de valores válidos em cEncoding:
UTF-8
UTF-16
UTF-16LE
UTF-16BE
ISO-8859-1
ASCII
US-ASCII
- Os valores aceitos em nOptions são 0 (comportamento padrão, igual a função Parse) ou a soma de atributos cujo nome se incia com "Parse_".
- Caso o parâmetro <cEncoding> não seja informado, a método utilizará o encondig padrão contindo no XML.
- Caso não tenha sido possível realizar o parser XML, verifique os erros ou avisos através dos métodos Error e Warning.
- Ao ser realizado o parser, automaticamente a classe irá posicionar o nó corrente no nó raiz do XML.
Exemplos
user function tstXmlRead()
Local cXML := ""
Local oXML
oXML := TXMLManager():New()
cXML += '<book isNew="true">' + CRLF
cXML += ' <title>A Clash of Kings</title>' + CRLF
cXML += ' <author>George R. R. Martin</author>' + CRLF
cXML += ' <price>9.99</price>' + CRLF
cXML += ' <origin>US</origin>' + CRLF
cXML += '</book>' + CRLF
// Vai exibir "No errors on Parse!"
if !oXML:Read( cXML, "mybook.xml", "UTF-8", 0 )
conout( "Errors on Parse!" )
else
conout( "No errors on Parse!" )
endif
return
|