$getmulti

Utilisation: $getmulti(nom,index[,séparateur])
Catégorie: multi-valeur
Mis en œuvre: Picard 2.3

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)    ==>  ""