4D v16.3
DOM EXPORT TO VAR
- Manual de linguagem 4D
-
- XML DOM
-
- Visão Geral dos comandos XML DOM
- DOM Append XML child node
- DOM Append XML element
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elementsUpd
- DOM Create XML element
- DOM Create XML element arrays
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODES
- DOM Get XML document ref
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML elementUpd
- DOM Get XML information
- DOM Insert XML element
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTE
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML DECLARATIONS
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM EXPORT TO VAR
| DOM EXPORT TO VAR ( refElemento ; vXMLVar ) | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| refElemento | String |
|
Referência do elemento Root XMLK | |||||
| vXMLVar | Texto, BLOB |
|
Variável que recebe a árvore XML | |||||
O comando DOM EXPORT TO VAR permite salvar um árvore XML em uma variável texto ou BLOB.
Passe em refElemento a referência do elemento raiz a exportar.
Passe em vXMLVar o nome da variável que deve conter a árvore XML. Esta variável pode ser de tipo Texto ou BLOB. Pode selecionar o tipo em função das operações a ser realizada ou do tamanho que a árvore possa alcançar (lembre que em modo Unicode, as variáveis de tipo Texto estão limitadas a 32 K de texto, enquanto em modo Unicode, este limite é de 2 GB).
Lembre que se utilizar uma variável de tipo texto para armazenar o elemento refElemento, em modo não Unicode, será codificado utilizando o conjunto de caracteres Mac “atual” (é dizer, Mac Romam na maioria dos sistemas ocidentais). Isso significa que o texto retornado perderá sua codificação original (encoding="xxx"). Neste caso, as variáveis vXMLVar permite visualizar ou armazenar o código obtido mas NÃO para gerar um documento XML válido (utilizando o comando SEND PACKET por exemplo).
Em modo Unicode, o código original se conserva na variável.
Em XML, os saltos de linha não são significativos, independentemente se encontram dentro ou entre os elementos XML. Internamente, XML utiliza caracteres estandarte LF como separadores de linhas.
Durante as operações de importação e exportação, os caracteres de salto de linha se podem converter. Durante uma importação, o analisador XML substitui os caracteres CRLF (rupturas de linha estandarte em Windows) por caracteres de LF. Durante a exportação, os caracteres LF se substituem por caracteres CR em caracteres macOS e CRLF em Windows.
Se deseja manter os retornos de carro, deve incluir em um elemento XML CDATA de forma que não seja processado pelo analisador XML. Em lugar de caracteres CRLF, também pode utilizar o caractere "<br/>", que é um retorno de carro explícito que não será processado pelo analisador.
Este exemplo salva a árvore vRefElem em uma variável texto:
C_TEXT(vtMeuTexto)
DOM EXPORT TO VAR(vRefElem;vtMeuTexto)Se o comando for executado corretamente, a variável sistema OK assume o valor 1. Do contrário, assume o valor 0 e um erro é gerado (por exemplo, se a referência do elemento não for válida).
Produto: 4D
Tema: XML DOM
Número
863
Criado por: 4D 2004
Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)
