4D Doc Center : Convert to text

4D v13.4

Convert to text


Convert to text ( BLOB ; conjuntoCaracteres ) -> Resultado

Parâmetro	Tipo	Descrição
BLOB	BLOB	Blob que contém texto expresso num conjunto de caracteres específico
conjuntoCaracteres	cadeia, Inteiro longo	Nome ou número do conjunto de caracteres do BLOB
Resultado	Texto	Conteúdos do BLOB expressos em conjunto de caracteres 4D

Descrição

O comando Convert to text converte o texto contido no parâmetro blob e o devolve em texto expresso no conjunto de caracteres de 4D. Na versão 11, 4D utiliza como padrão o conjunto de caracteres Unicode.

Em conjuntoCaracteres, passe o conjunto de caracteres do texto contido no blob, o qual será utilizado para a conversão. Pode passar uma string com o nome padrão do conjunto de caracteres, ou um de seus apelidos (por exemplo, “ISO-8859-1” ou “UTF-8”), ou seu identificador (inteiro longo). Para maior informação, consulte a descrição do comando CONVERT FROM TEXT.

Convert to text é compatível com BOMs (Byte Order Marks). Se o conjunto de caracteres especificado é de tipo Unicode (UTF-8, UTF-16 ou UTF-32), 4D tenta identificar um BOM entre os primeiros bytes recebidos. Se o detectar, ele é filtrado do resultado e 4D utiliza o conjunto de caracteres definido ao invés do conjunto de caracteres especificado.

Nota: este comando funciona apenas quando 4D for executado em modo Unicode (a opção Unicode deve seleccionarse nas preferências de 4D, ver a seção “ASCII Codes”). Se for utilizado em modo compatibilidade (não Unicode), devolve uma string vazia e a variável OK assume o valor 0.

Variáveis e conjuntos do sistema

Se o comando for executado corretamente, a variável OK assume o valor 1. Do contrário, assume o valor 0.