VARIABLE TO BLOB

VARIABLE TO BLOB* ( variável ; BLOB {; offset | *} )

Parâmetro	Tipo		Descrição
variável	Variable	→	Variável a ser armazenada no BLOB
Blob	Blob	→	BLOB a receber a variável
offset | *	Variável, Operador	↔	Offset da variável(expressado em bytes) no BLOB ou * para adicionar o valor
			Novo offset depois de escrita se * for omitido

Descrição

comando VARIABLE TO BLOB armazena a variável no BLOB blob.

Se você especificar o parâmetro opcional *, a variável é acrescentada ao BLOB e o tamanho do BLOB é aumentado em conformidade. Usando o parâmetro opcional *, você pode armazenar qualquer número de variáveis ou listas (ver outros comandos BLOB) em um BLOB, enquanto o BLOB couber na memória.

Se você não especificar o parâmetro opcional * ou o parâmetro de deslocamento variável, a variável é armazenada no início do BLOB, substituindo o conteúdo anterior, o tamanho do BLOB é ajustado em conformidade.

Se você passar o parâmetro de deslocamento variável, a variável é escrita no offset (a partir do zero) dentro do BLOB. Não importa onde você escreva a variável, o tamanho do BLOB é aumentado de acordo com o local que você passou (mais o tamanho da variável, se necessário). Bytes recém-alocados, com exceção do que você está escrevendo, são inicializados em zero.

Após a chamada, o parâmetro variável offset é devolvido, incrementado pelo número de bytes que foram escritos. Portanto, você pode reutilizar a mesma variável com outro comando de escrita BLOB para escrever uma outra variável ou lista.

VARIABLE TO BLOB aceita qualquer tipo de variável (incluindo outros BLOBs), exceto os seguintes:

• Ponteiros
• Array de ponteiros

Note que:

• Se guardar uma variável de tipo Inteiro longo que é uma referência a uma lista hierárquica (ListRef), VARIABLE TO BLOB guardará a variável Inteiro longo, não a lista. Para guardar e recuperar as listas hierárquicas em um BLOB, utilize os comandos LIST TO BLOB e BLOB to list.
• Se passar um objeto ou uma coleção no parâmetro variavel, o comando põe uma cópia (e não uma referência) no BLOB. Se o objeto contém ponteiros, os valores não referenciados são guardados no BLOB, não os ponteiros mesmos.

ATENÇÃO: Se você usar um BLOB para armazenar as variáveis, você deve usar mais tarde o comando BLOB TO VARIABLE para reler o conteúdo do BLOB, pois as variáveis são armazenadas em BLOBs usando um formato interno de 4D.

Após a chamada, se a variável foi armazenada com sucesso, a variável OK é definida como 1. Se a operação não pôde ser executada, a variável OK é definida como 0, por exemplo, não havia memória suficiente.

Nota sobre a independência de plataforma: VARIABLE TO BLOB e BLOB TO VARIABLE usam um formato interno de 4D para lidar com variáveis armazenadas em BLOBs. Como benefício, você não precisa se preocupar com a troca de bytes entre as plataformas ao usar esses dois comandos. Em outras palavras, um BLOB criado no Windows usando um desses comandos podem ser reutilizados em Macintosh, e vice-versa.

Nota

Nota de compatibilidade: como este comando altera o blob passado como parâmetro, não é compatível com objetos blob (tipo 4D.Blob). Ver Passing blobs and blob objects to 4D commands em developer.4d.com

Variáveis e conjuntos do sistema

A variável OK é definida como 1 se a variável foi armazenada com sucesso, caso contrário, ela é definido como 0.

Exemplo 1

Os dois métodos de projeto a seguir permitem armazenar e recuperar rapidamente qualquer conjunto de variáveis de/para um BLOB:

  // Método de projeto GUARDAR VARIABLES EN BLOB
  // GUARDAR VARIABLES EN BLOB ( Ponteiro{ ; Ponteiro... { ; Ponteiro} } )
  // GUARDAR VARIABLES EN BLOB ( BLOB { ; Var1 ... { ; Var2 } } )
 #DECLARE(... : Pointer)
 var $vlParam : Integer
 
 SET BLOB SIZE($1->;0)
 For($vlParam;2;Count parameters)
    VARIABLE TO BLOB(${$vlParam}->;$1->;*)
 End for
 
 
  // Método de projeto RECUPERAR VARIAVEIS DO BLOB
  // RECUPERAR VARIAVEIS DO BLOB ( Ponteiro{ ; Ponteiro... { ; Ponteiro} } )
  // RECUPERAR VARIAVEIS DO BLOB ( BLOB { ; Var1 ... { ; Var2 } } )
 #DECLARE(... : Pointer)
 var $vlParam;$vlOffset : Integer
 
 $vlOffset:=0
 For($vlParam;2;Count parameters)
    BLOB TO VARIABLE($1->;${$vlParam}->;$vlOffset)
 End for

Depois que estes métodos foram adicionados ao seu aplicativo, você pode escrever:

 GUARDAR VARIABLES EN BLOB(->vxBLOB;->vgImagem;->comoUmArray;->aoOutroArray)
  // ...
 RECUPERAR VARIABLES DEL BLOB(->vxBLOB;->vgImagem;->comoUmArray;->aoOutroArray)

Exemplo 2

Os dois métodos de projeto a seguir permitem armazenar e recuperar rapidamente arrays e documentos em disco:

  // SAVE ARRAY project method
 
 // SAVE ARRAY (Text ; Pointer)
  // SAVE ARRAY (Document ; -> Array)
 #DECLARE($doc : Text ; $ptrArray : Pointer)
 var $vxArrayData : Blob
 VARIABLE TO BLOB($ptrArray->;$vxArrayData) //Armazena o array em BLOB
 COMPRESS BLOB($vxArrayData) // Comprime o BLOB
 BLOB TO DOCUMENT($doc;$vxArrayData) // Salva o BLOB em disco

  // LOAD ARRAY project method
  // LOAD ARRAY (Text ; Pointer)
  // LOAD ARRAY (Document ; -> Array)
 #DECLARE($doc : Text ; $ptrArray : Pointer)
 var $vxArrayData : Blob
 DOCUMENT TO BLOB($doc;$vxArrayData) // Carrega o BLOB a partir do disco
 EXPAND BLOB($vxArrayData) // Expande o BLOB
 BLOB TO VARIABLE($vxArrayData;$ptrArray->) // Busca o array do BLOB

Depois que esses métodos foram adicionados a sua aplicação, pode escrever:

 ARRAY TEXT(...;asAnyArray;...)
  //  ...
 SAVE ARRAY($vsDocName;->asAnyArray)
  //  ...
 LOAD ARRAY($vsDocName;->asAnyArray)

Ver também

BLOB to list
BLOB TO VARIABLE
LIST TO BLOB

Propriedades

Número do comando	532
Thread-seguro	✓
Modificar variáveis	OK