4D v16.3

BLOB vers liste

Accueil

 
4D v16.3
BLOB vers liste

BLOB vers liste 


 

BLOB vers liste ( blob {; offset} ) -> Résultat 
Paramètre Type   Description
blob  BLOB in BLOB contenant la liste hiérarchique
offset  Entier long in Offset (en octets) dans le BLOB
in Nouvel offset après la lecture
Résultat  RefListe in Référence de la liste nouvellement créée

BLOB vers liste crée une nouvelle liste hiérarchique avec les données stockées dans le BLOB blob à l'offset d'octet (à partir de zéro) spécifié par offset et retourne un numéro de référence de liste hiérarchique pour cette nouvelle liste.

Les données présentes dans le BLOB doivent être compatibles avec la commande : généralement, vous utilisez des BLOBs préalablement remplis avec la commande LISTE VERS BLOB.

Si vous ne passez pas le paramètre optionnel offset, les valeurs de la liste sont lues à partir du début du BLOB. Si vous gérez un BLOB dans lequel plusieurs variables ou listes ont été stockées, vous devez passer le paramètre offset ainsi qu'une variable numérique. Avant l'appel, fixez cette variable numérique à l'offset désiré. Après l'appel, cette même variable numérique retourne l'offset de la variable suivante stockée dans le BLOB.

Après l'appel, la variable OK prend la valeur 1 si la liste hiérarchique a été correctement créée. Si l'opération ne peut pas être effectuée à cause, par exemple, d'un manque de mémoire, la variable OK prend la valeur 0.

Note pour l'indépendance de plate-forme : BLOB vers liste et LISTE VERS BLOB utilisent un format interne 4D pour gérer les listes stockées dans des BLOBs. L'avantage est que vous n'avez pas besoin de vous soucier de la conversion des octets ("byte swapping") entre les plates-formes lorsque vous utilisez ces deux commandes. Autrement dit, avec ces commandes, un BLOB créé sous Windows peut être réutilisé sous Mac OS et vice-versa.

Exemple  

Dans l'exemple suivant, la méthode d'un formulaire entrée extrait une liste d'un champ BLOB avant que le formulaire ne s'affiche puis le stocke dans le champ BLOB lorsque la saisie est validée :

  ` Méthode du formulaire [Choses à Faire];"Entrée"
 
 Au cas ou
 
    :(Evenement formulaire=Sur chargement)
       hListe:=BLOB vers liste([Choses à Faire]Idées)
       Si(OK=0)
          hListe:=Nouvelle liste
       Fin de si
 
    :(Evenement formulaire=Sur libération)
       SUPPRIMER LISTE(hListe;*)
 
    :(bValider=1)
       LISTE VERS BLOB(hListe;[Choses à Faire]Idées)
 
 Fin de cas

La variable OK prend la valeur 1 si la liste a été correctement créée, sinon elle prend la valeur 0.



Voir aussi  

LISTE VERS BLOB

 
PROPRIÉTÉS 

Produit : 4D
Thème : BLOB
Numéro : 557
Nom intl. : BLOB to list

Cette commande modifie la variable système OK

 
HISTORIQUE 

Créé : 4D v6

 
MOTS-CLÉS 

List, Hierarchical List

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)