BLOB to text

4D v16.3

BLOB

BLOB to text


BLOB to text ( BLOB ; formatoTexto {; offset {; compTexto}} ) -> Resultado

Parâmetro	Tipo	Descrição
BLOB	BLOB	BLOB do qual obter o texto
formatoTexto	Inteiro longo	Formato e conjunto de caracteres de texto
offset	Variável	Offset no BLOB (expressado em bytes)
		Novo offset depois da leitura
compTexto	Inteiro longo	Número de caracteres a serem lidos
Resultado	Texto	Valor do texto

Descrição

O comando BLOB to text retorna um valor de texto lido do BLOB blob.

O parâmetro formatoTexto corrige o formato interno e o conjunto de caracteres do valor de texto a ser lido. Em bases de dados criadas a partir da versão 11, 4D usa o conjunto de caracteres Unicode (UTF8) por padrão para o gerenciamento de texto. Por razões de compatibilidade, este comando pode ser usado para "forçar" a conversão usando o conjunto de caracteres romanos Mac (utilizado em versões anteriores do 4D). O conjunto de caracteres é escolhido através do parâmetro formatoTexto. Para fazer isso, passe uma das seguintes constantes (encontrado no tema "BLOB") no parâmetro formatoTexto:

Constante	Tipo	Valor
Mac C string	Inteiro longo	0
Mac Pascal string	Inteiro longo	1
Mac text with length	Inteiro longo	2
Mac text without length	Inteiro longo	3
UTF8 C string	Inteiro longo	4
UTF8 text with length	Inteiro longo	5
UTF8 text without length	Inteiro longo	6

Notas:

As constantes "UTF8" podem ser usadas somente quando o aplicativo é executado no modo Unicode.
As constantes "Mac" não podem trabalhar com textos maiores que 32 KB.
Se você deseja trabalhar com outros conjuntos de caracteres além de UTF8, use o comando Convert to text .

Para obter mais informações sobre essas constantes e os formatos que representam, consulte a descrição do comando TEXT TO BLOB.

Atención: O número de caracteres a ser lido é determinado pelo parâmetro formatoTexto, EXCETO para os formatos Mac Text without length e UTF8 Text without length, para o qual você deve especificar o número de caracteres a ser lido no parâmetro compTexto. Para os outros formatos, compText é ignorado e você pode omiti-lo.

Se você especificar o parâmetro opcional offset, o valor Texto é lido no offset (a partir de zero) dentro do BLOB. Se você não especificar o parâmetro opcional offset, o início do BLOB é lido de acordo com o valor que você passa em formatoTexto. Observe que você deve passar o parâmetro variável offset quando você estiver lendo o texto sem comprimento.

Nota: Você deve passar um valor de deslocamento entre 0 (zero) e o tamanho do BLOB menos o tamanho do texto a ser lido. Se você não fizer isso, o resultado da função é imprevisível.

Após a chamada, a variável é incrementada pelo número de bytes lidos. Portanto, você pode reutilizar a mesma variável com outro comando de leitura BLOB para ler outro valor.

Ver também

BLOB to integer
BLOB to longint
BLOB to real
Convert to text
INTEGER TO BLOB
LONGINT TO BLOB
REAL TO BLOB
TEXT TO BLOB