$getmulti¶
La description:
Obtient l’élément à index
à partir de la variable à valeurs multiples nom
. Une valeur littérale représentant une valeur multiple peut être remplacée par nom
, en utilisant le séparateur
(ou un point-virgule suivi d’un espace « ; » s’il n’est pas passé) pour forcer la valeur en une valeur multiple appropriée variable.
L”index
est basé sur zéro. Si index
est inférieur à 0, alors la valeur utilisée est le nombre d’éléments dans nom
plus index
(par exemple: $getmulti(%abcd%,-1)
est identique à $getmulti(%abcd%,3)
si %abcd%
est une variable à valeurs multiples avec quatre éléments). Si index
est manquant, pas un entier, un nombre supérieur ou égal au nombre d’éléments dans nom
, ou un nombre négatif supérieur au nombre d’éléments dans nom
, alors le fonction retournera une chaîne vide.
Exemple:
Les instructions suivantes renverront les valeurs indiquées:
$set(foo,A; B; C)
$setmulti(bar,A; B; C)
$set(baz,1)
$getmulti(%foo%,%baz%) ==> ""
$getmulti(%foo%,0) ==> "A; B; C"
$getmulti(%foo%,-1) ==> "A; B; C"
$getmulti(%foo%,-%baz%) ==> "A; B; C"
$getmulti(%bar%,%baz%) ==> "B"
$getmulti(%bar%,0) ==> "A"
$getmulti(%bar%,-1) ==> "C"
$getmulti(%bar%,-%baz%) ==> "C"
$getmulti(A:1; B:2; C:3,1) ==> "B:2"
$getmulti(A:1; B:2; C:3,1,:) ==> "1; B"
$getmulti(A:1; B:2; C:3,10) ==> ""
$getmulti(A:1; B:2; C:3,-10) ==> ""
$getmulti(A:1; B:2; C:3,1.5) ==> ""
$getmulti(A:1; B:2; C:3,a) ==> ""