Document to text
Document to text* ( nomeArquivo {; conjCaracteres {; modoRetorno}} ) : Text
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| nomeArquivo | Text | → | Nome do documento ou caminho ao documento |
| conjCaracteres | Text, Integer | → | Nome ou número do conjunto de caracteres |
| modoRetorno | Integer | → | Modo de processamento para as linhas de ruptura |
| Resultado | Text | ← | Texto do documento |
Descrição
comando Document to text le permite recuperar o conteúdo de um arquivo diretamente no disco em uma variável texto 4D ou campo texto.
Em nomeArquivo, passe o nome ou caminho de acesso do arquivo a ler. O arquivo deve existir no disco, caso contrário é gerado um erro. Pode passar:
- Só o nome do arquivo, por exemplo "meuArquivo.txt": neste caso, o arquivo deve estar localizado junto ao arquivo de estrutura da aplicação.
- Um caminho de acesso relativo ao arquivo de estrutura da aplicação, por exemplo, "\\docs\\meuArquivo.txt" em Windows ou ": docs: meuArquivo.txt" em macOS.
- Um caminho de acesso absoluto, por exemplo, "c:\\app\\docs\\meuArquivo.txt" em Windows ou "MacHD:docs:meuArquivo.txt" em macOS.
Em conjCaracteres, se passa o conjunto de caracteres a utilizar para a leitura dos conteúdos. Pode passar uma cadeia com o nome estandarte do conjunto (por exemplo, "ISO-8859-1" ou "UTF-8") ou seu ID MIBEnum (inteiro longo). Para mais informação sobre a lista de conjuntos de caracteres suportados por 4D, consulte a descrição do comando CONVERT FROM TEXT.
Se o documento contém um Byte Order Mark (BOM), 4D utiliza o conjunto de caracteres que foi definido em conjCaracteres (este parâmetro então se ignora).
Se o documento não contém um BOM e se for omitido o parâmetro conjCaracteres, 4D utiliza por padrão os seguintes conjuntos de caracteres:
- Sob Windows: ANSI
- Sob macOS: MacRoman
Em breakMode, pode passar um inteiro longo que indica o processo a realizar nos caracteres de fim de linha presentes no documento. Pode passar uma das seguintes constantes, do tema "Documentos Sistema":
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| Document unchanged | Inteiro longo | 0 | Sem processamento |
| Document with CR | Inteiro longo | 3 | As linhas de ruptura se convertem ao formato macOS: CR (retorno de carro) |
| Document with CRLF | Inteiro longo | 2 | As linhas de ruptura se convertem ao formato Windows: CRLF (return + salto de linha) |
| Document with LF | Inteiro longo | 4 | As linhas de ruptura se convertem ao formato Unix: LF (salto de linha) |
| Document with native format | Inteiro longo | 1 | (Por padrão) as linhas de ruptura se convertem ao formato nativo do sistema operativo: CR (retorno de carro) em macOS, CRLF (retorno de carro + salto de linha) em Windows |
Por padrão, quando se omite o parâmetro modoRetorno, os saltos de linha se processam em modo nativo (1).
Nota de Compatibidade: opções de compatibilidade estão disponíveis para gerenciamento EOL e BOM. Ver Página Compatibilidade.
Nota: Este comando não modifica a variável OK. Em caso de falha, é gerado um erro que pode interceptar utilizando um método instalado pelo comando ON ERR CALL.
Exemplo
Dado o documento texto seguinte (os campos estão separados por tabulações):
id name price vat3 4D Tags 99 19.6
Quando executa este código:
$Text:=Document to text("products.txt")
... obtém:
// $Text = "id\tname\tprice\tvat\r\n3\t4D Tags\t99 \t19.6"
// \t = tab
// \r = CR
Ver também
Documentos Sistema
TEXT TO DOCUMENT
Propriedades
| Número do comando | 1236 |
| Thread-seguro | ✓ |