4D Doc Center : BLOB to list

4D v14.3

BLOB

BLOB to list


BLOB to list ( BLOB {; offset} ) -> Resultado

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

Descrição

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

Variáveis e conjuntos do sistema

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