4D Doc Center : Comandos BLOB

Página Inicial

4D v14.3

Manual de linguagem 4D

BLOB

Comandos BLOB

Definição

4D suporta o tipo de dados BLOB (objetos binários grandes).

Você pode definir campos BLOB e variáveis BLOB:

Para criar um campo BLOB, escolha BLOB no lista suspensa tipo de campo na janela Propriedades do Campo.
Para criar uma variável BLOB, use o comando declaração do compilador C_BLOB. Você pode criar variáveis processo, locais, e inter-processos do tipo BLOB.

Nota: Não existem arrays para BLOBs.

Com 4D, um BLOB é uma série de bytes de comprimento variável, que pode ser tratado como um objeto inteiro ou cujos bytes podem ser endereçados individualmente. Um BLOB pode ser vazio (comprimento zero) ou pode conter até 2147483647 bytes (2 GB).

BLOBs e Memória

Um BLOB é carregado na memória na sua totalidade. Uma variável BLOB é realizada e existe apenas na memória. Um campo BLOB é carregado na memória do disco, como o resto do registro a que pertence.

Como os outros tipos de campo que podem reter uma grande quantidade de dados (imagens e tipos de campo subtabela), os campos BLOB, não são duplicadas na memória quando você modifica um registro. Consequentemente, o resultado retornado pelo Old e Modified comandos não é significativo quando aplicado a um campo BLOB.

Exibindo BLOBs

Um BLOB pode reter qualquer tipo de dados, por isso não tem nenhuma representação padrão na tela. Se você exibir um campo BLOB ou variável em um formulário, ele vai aparecer sempre em branco, independentemente do seu conteúdo.

Campos BLOB

Você pode usar campos BLOB para armazenar qualquer tipo de dados, até 2 GB. Você não pode indexar um campo BLOB, então você deve usar uma fórmula para buscar registros sobre os valores armazenados em um campo BLOB.

Passagem de parâmetros, ponteiros e resultados de funções

BLOBs 4D podem ser passados como parâmetros para comandos 4D ou rotinas de plug-in que esperam um parâmetro de um BLOB. BLOBS também podem ser passadas como parâmetros para um método do usuário ou ser retornado como um resultado da função.

Para passar um BLOB para seus próprios métodos, você também pode definir um ponteiro para o BLOB e passar o ponteiro como parâmetro.

Exemplos:

  ` Declare uma variável do tipo BLOB

 C_BLOB(umaBlobVar)

  ` O BLOB é passado como parâmetro para um comando 4D

 SET BLOB SIZE(unBlobVar;1024*1024)

  ` O BLOB é passado como parâmetro para uma rotina externa

 $errCode:=Fazer Algo Com Este BLOB(umaBlobVar)

  ` O BLOB é passado como um parâmetro para um método que retorna um BLOB

 C_BLOB(trazerBlob)

 trazerBlob:=Preencher_Blob(umaBlobVar)

  ` Um ponteiro para o BLOB é passado como parâmetro para um método do usuário

 CALCULAR BLOB(->umaBlobVar)

Nota para os desenvolvedores de plug-in: Um parâmetro BLOB é declarado como "&O" (a letra "O", não o dígito "0").

Atribuição

Você pode atribuir BLOBs uns aos outros.

Exemplo:

  ` Declarar duas variáveis de tipo BLOB

 C_BLOB(vBlobA;vBlobB)

  ` Definir o tamanho do primeiro BLOB em 10K

 SET BLOB SIZE(vBlobA;10*1024)

  ` Atribuir o primeiro BLOB ao segundo

 vBlobB:=vBlobA

No entanto, nenhum operador pode ser aplicado para BLOBs, não há expressão do tipo BLOB.

Endereçando o conteúdo de BLOB

Você pode endereçar cada byte de um BLOB individualmente usando as chaves {...}. Dentro de um BLOB, os bytes são numerados de 0 a N-1, onde N é o tamanho do BLOB. Exemplo:

  ` Declarar uma variável de tipo BLOB

 C_BLOB(vBlob)

  ` Fixar o tamanho do BLOB em 256 bytes

 SET BLOB SIZE(vBlob;256)

  ` O loop a seguir inicializa os 256 bytes do BLOB em zero

 For(vByte;0;BLOB size(vBlob)-1)

    vBlob{vByte}:=0

 End for

Como você pode endereçar todos os bytes de um BLOB individualmente, você pode realmente armazenar o que quiser em um campo ou variável BLOB.

Comando 4D BLOBs

4D oferece os seguintes comandos para trabalhar com BLOBS:

SET BLOB SIZE redimensiona um campo ou variável BLOB.
BLOB size retorna o tamanho de um BLOB.
DOCUMENT TO BLOB e BLOB TO DOCUMENT permitem carregar e escrever um documento conjunto para e de um BLOB (opcionalmente, os dados e forks dos recursos em Macintosh).
VARIABLE TO BLOB e BLOB TO VARIABLE como também Old e Old le permiten guardar y cargar las variables 4D en BLOBs.
COMPRESS BLOB, EXPAND BLOB y BLOB PROPERTIES permitem armazenar e recuperar variáveis 4D em BLOBs.
Os comandos BLOB to integer, BLOB to longint, BLOB to real, BLOB to text, INTEGER TO BLOB, LONGINT TO BLOB, REAL TO BLOB e TEXT TO BLOB permitem que você trabalhe com BLOBs comprimidos.
DELETE FROM BLOB, INSERT IN BLOB e COPY BLOB permitem a manipulação rápida de grandes blocos de dados dentro de BLOBs.
ENCRYPT BLOB e DECRYPT BLOB permitem criptografar e descriptografar dados em um banco de dados 4D.

Estes comandos são descritos neste capítulo.

Adicionalmente:

C_BLOB declara uma variável do tipo BLOB. Consulte o capítulo PRINT SETTINGS para obter mais informações.
GET PASTEBOARD DATA e APPEND DATA TO PASTEBOARD lhe permitem lidar com qualquer tipo de dados armazenados na área de trabalho. Consulte a seção C_INTEGER para mais informações.
GET RESOURCE e SET RESOURCE permitem que você trabalhe com qualquer tipo de recurso armazenados em disco. Consulte o capítulo [#cmd id="2784"/] para obter mais informações.
SEND HTML BLOB permite que você envie qualquer tipo de dados para um Web browser. Consulte o capítulo DEFAULT TABLE para obter mais informações.
PICTURE TO BLOB, BLOB TO PICTURE e PICTURE TO GIF permite abrir e converter imagens. Consulte o capítulo SEND VARIABLE para mais informações.
GENERATE ENCRYPTION KEYPAIR e GENERATE CERTIFICATE REQUEST são os comandos usados pelo protocolo de conexão SSL (Secured Socket Layer). Consulte o capítulo WEB SERVICE SET PARAMETER para mais informações.