LIST TO BLOB
LIST TO BLOB ( lista ; BLOB {; *} )
Parâmetro | Tipo | Descrição | |
---|---|---|---|
lista | Integer | → | Lista hierárquica a armazenar no BLOB |
Blob | Blob | → | BLOB a receber a lista hierárquica |
* | Operador | → | * adicionar o valor |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando LIST TO BLOB armazena a lista hierárquica no BLOB blob.
Se você especificar o parâmetro opcional *, a lista hierárquica é anexada 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 *, a lista hierárquica é armazenada no início do BLOB, substituindo o conteúdo anterior, o tamanho do BLOB é ajustado em conformidade.
Onde quer que a lista hierárquica seja armazenada, o tamanho do BLOB será aumentado, se necessário de acordo com o local especificado (até do tamanho da lista se necessário). Bytes modificados (exceto os que você definir) são colocados em 0 (zero).
Advertência: Se você usar um BLOB para armazenar listas, você deve usar mais tarde o comando BLOB to list para ler o conteúdo do BLOB, porque as listas são armazenados em BLOBs usando um formato interno de 4D.
Após a chamada, se a lista tiver sido salva com sucesso, a variável OK é definida como 1. Se a operação não pôde ser executada, a variável OK é definido como 0, por exemplo, se não havia memória suficiente.
Nota sobre a independência de plataforma: LIST TO BLOB e BLOB to list usam um formato interno de 4D para processamento de listas 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 os 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
Exemplo
Veja o exemplo para o comando BLOB to list.