4D v14.3

BLOB to text

Página Inicial

 
4D v14.3
BLOB to text

BLOB to text 


 

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

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.

 
PROPRIEDADES 

Produto: 4D
Tema: BLOB
Número 555

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
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

 
PALAVRAS CHAVES 

Text, UTF8

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)