TOTVSTEC

Árvore de páginas

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

Exemplo 1
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
  • Sem rótulos