Langage BASICHandles

GetRef

Fonction

Syntaxe

Lit la variable, le champ, la case de tableau, l’élément de liste ou l’entrée de table désigné par un handle.

GetRef(<handle>)

Les éléments

<handle>Un handle fait avec @target, en général rangé dans une variable AS HANDLE.

Rend

La valeur actuelle de la cible. Un enregistrement revient tel quel ; l’affecter à une variable le copie.

À savoir

  • Sur un handle libéré, le programme s’arrête avec « BASIC reference handle has been released ». Sur une variable HANDLE jamais affectée, ou sur une valeur qui n’est pas un handle, il s’arrête avec « BASIC value is not a reference handle ». Testez d’abord avec IsRef().
  • Un handle fait avec @m() ou @l() suit le curseur : GetRef lit l’entrée ou l’élément courant au moment de l’appel, pas celui qui l’était à la création du handle.
  • Un handle vers une entrée de table, @m("key"), survit à DeleteMapElement() : GetRef recrée l’entrée avec la valeur par défaut.

Exemple

GLOBAL hp AS integer = 100GLOBAL link AS HANDLE = @hphp = 80Console(Str(GetRef(link)))   ' 80
Dans le manuel : Fonctions

Voir aussi