4D v16.3

BLOB to list

Página Inicial

 
4D v16.3
BLOB to list

BLOB to list 


 

BLOB to list ( BLOB {; offset} ) -> Resultado 
Parâmetro Tipo   Descrição
BLOB  BLOB in BLOB que contém uma lista hierárquica
offset  Inteiro longo in Offset no BLOB (expressado em bytes)
in Novo offset depois da leitura
Resultado  ListRef in Referência da lista criada recentemente

O comando BLOB to list cria uma lista hierárquica com os dados armazenados no BLOB blob no o offset de bytes (a partir de zero) especificado pelo offset e retorna um número de referência de lista hierárquica para essa nova lista.

Os dados do BLOB devem ser coerentes com o comando. Normalmente, você irá usar BLOBs que você previamente preenchou utilizando o comando LIST TO BLOB.

Se você não especificar o parâmetro opcional offset, os dados da lista são lidos a partir do início do BLOB. Se você lidar com um BLOB em que diversas variáveis ou listas tenham sido armazenados, você deve passar o parâmetro de deslocamento e, além disso, você deve passar uma variável numérica. Antes da chamada, defina essa variável numérica para o deslocamento apropriado. Após a chamada, a mesma variável numérica retorna o deslocamento da próxima variável armazenada dentro do BLOB.

Após a chamada, se a lista hierárquica foi criado 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:  BLOB to list e LIST TO BLOB usam um formato interno de 4D para o 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 dois comandos podem ser reutilizados em Macintosh e vice-versa.

Exemplo  

Neste exemplo, o método do formulário para um formulário de entrada de dados extrai uma lista de um campo BLOB antes que o formulário seja exibido na tela, e armazena-lo de volta no campo BLOB se a entrada de dados for validada:

  ` Método de formulario [Coisas para fazer];"Entrada"
 
 Case of
 
    :(Form event=On Load)
       hList:=BLOB to list([Coisas para fazer]Ideias)
       If(OK=0)
          hList:=New list
       End if
 
    :(Form event=On Unload)
       CLEAR LIST(hList;*)
 
    :(bValidate=1)
       LIST TO BLOB(hList;[Coisas para fazer]Ideias)
 
 End case

A variável OK recebe o valor 1 se a lista for criada corretamente, caso contrário recebe o valor 0.



Ver também 

LIST TO BLOB

 
PROPRIEDADES 

Produto: 4D
Tema: BLOB
Número 557

Este comando modifica a variável sistema OK

 
HISTÓRIA 

Criado por: 4D v6

 
PALAVRAS CHAVES 

List, Hierarchical List

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)