4D v14.3

Document to text

Página Inicial

 
4D v14.3
Document to text

Document to text 


 

Document to text ( nomeArquivo {; conjCaracteres {; modoRetorno}} ) -> Resultado 
Parâmetro Tipo   Descrição
nomeArquivo  cadeia in Nome do documento ou caminho ao documento
conjCaracteres  Texto, Inteiro longo in Nome ou número do conjunto de caracteres
modoRetorno  Inteiro longo in Modo de processamento para as linhas de ruptura
Resultado  Texto in Texto do documento

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 OS X.
  • Um caminho de acesso absoluto, por exemplo, "c:\\app\\docs\\meuArquivo.txt" em Windows ou "MacHD:docs:meuArquivo.txt" em OS X.

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 OS X: 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 OS X: 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 OS X, 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: 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    vat
3    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

 
PROPRIEDADES 

Produto: 4D
Tema: Documentos de Sistema
Número 1236

 
HISTÓRIA 

New
Criado por: 4D v14

 
VER TAMBÉM 

Documentos Sistema
TEXT TO DOCUMENT

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)