BLOB to list

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 6.0


BLOB to list (BLOB{; offset}) ListRef

ParámetroTipoDescripción
BLOBBLOBBLOB que contiene una lista jerárquica
offsetNúmeroOffset en el BLOB (expresado en bytes)
Nuevo offset después de la lectura
ResultadoListRefReferencia de la lista creada recientemente

Descripción

El comando BLOB to list crea una nueva lista jerárquica con los datos almacenados en el BLOB blob en el offset de bytes (a partir de cero) especificado por offset y devuelve un número de referencia de lista jerárquica para esa nueva lista.

Los datos del BLOB deben ser compatibles con el comando. Generalmente, usted utiliza BLOBs llenados previamente con el comando LIST TO BLOB.

Si no especifica el parámetro opcional offset, los valores de las lista se leen desde el comienzo del BLOB. Si trabaja con un BLOB en el cual se almacenan muchas variables o listas, debe pasar el parámetro offset y, adicionalmente, debe pasar una variable numérica. Antes del llamado, fije esta variable numérica al offset apropiado. Después del llamado, la misma variable numérica devuelve el offset de la variable siguiente almacenada en el BLOB.

Después del llamado, si la lista jerárquica ha sido creada correctamente, la variable OK toma el valor 1. Si la operación no pueder ser efectuada, la variable OK toma el valor 0; por ejemplo, si no hay suficiente memoria.

Nota sobre la independencia de plataforma: BLOB to list y LIST TO BLOB utilizan un formato interno 4D para administrar listas almacenadas en BLOBs. La ventaja es que usted no tiene que preocuparse por la conversión de bytes (byte swapping) entre plataformas cuando utilice estos dos comandos. En otras palabras, un BLOB creado en Windows utilizando estos dos comandos puede ser reutilizados en Macintosh y viceversa.

Ejemplo

En este ejemplo, el método de un formulario de entrada extrae una lista de un campo BLOB antes de que el formulario aparezca en la pantalla, y lo almacena nuevamente en el campo BLOB si la entrada de datos se valida:

      ` Método de formulario [Cosas por hacer];"Entrada"

   Case of 

      : (Form event=On Load)
         hList:=BLOB to list([Cosas por hacer]Ideas)
         If (OK=0)
            hList:=New list
         End if 

      : (Form event=On Unload)
         CLEAR LIST(hList;*)

      : (bValidate=1)
             LIST TO BLOB(hList;[Cosas por hacer]Ideas)

   End case 

Ver también

LIST TO BLOB.

Variables y conjuntos sistema

La variable OK toma el valor 1 si la lista se crea correctamente, de lo contrario toma el valor 0.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente