BLOB vers entier long

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 6.0


BLOB vers entier long (blob; ordreOctet{; offset}) Numérique

ParamètreTypeDescription
blobBLOBBLOB duquel extraire la valeur de type Entier long
ordreOctetNumérique0 = Ordre d'octets natif
1 = Ordre d'octets Macintosh
2 = Ordre d'octets PC
offsetVariableOffset (en octets) dans le BLOB
Nouvel offset après lecture
RésultatNumériqueValeur de type Entier long (4 octets)

Description

La fonction BLOB vers entier long retourne une valeur de type Entier long (4 octets) lue dans le BLOB blob.

Le paramètre ordreOctet fixe l'ordre des octets ("byte ordering") de la valeur Entier long à lire. Vous passez une des constantes fournies par 4e Dimension :

ConstanteTypeValeur
Ordre octets natifEntier long0
Ordre octets MacintoshEntier long1
Ordre octets PCEntier long2

Note sur l'indépendance de plate-forme : Si vous échangez des BLOBs entre les plates-formes Macintosh et PC, il vous incombe de traiter les conversions d'octets ("byte swapping") lorsque vous utilisez cette fonction.

Si vous ne passez pas de variable dans le paramètre optionnel offset, les quatre premiers octets de BLOB sont lus.

Si vous passez une variable dans le paramètre optionnel offset, l'entier long sur 4 octets est lu depuis l'offset exprimé en octets (à partir de zéro) du BLOB.

Note : Vous devez passer un offset compris entre 0 (zéro) et la taille du BLOB moins 4. Sinon, une erreur -111 est générée.

Après l'exécution de la commande, la variable offset est incrémentée du nombre d'octets qui a été lu. Vous pouvez donc réutiliser la même variable avec une autre commande de lecture de BLOBs pour lire une autre valeur placée juste après celle que vous venez de lire.

Exemple

L'exemple suivant lit 20 valeurs de type Entier long dans un BLOB, à partir de l'offset 0x200 :

   $vlOffset:=0x200
   Boucle ($viBoucle;0;19)
      $vlValeur:=BLOB vers entier long(vxUnBlob;Ordre octets PC;$vlOffset)
         ` Faire quelque chose avec $vlValeur
   Fin de boucle

Référence

BLOB vers entier, BLOB vers reel, BLOB vers texte, ENTIER LONG VERS BLOB, ENTIER VERS BLOB, REEL VERS BLOB, TEXTE VERS BLOB.


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant