$getmulti
Beschrijving:
Haalt het element op de positie index in de meervoudige variabele naam op. In plaats van naam kan je ook een tekenreeks opgegeven, zodat deze tekenreeks in een meervoudige variabele wordt omgezet. Je kan het scheidingsteken voor deze tekenreeks opgeven met de derde parameter (als je deze parameter niet opgeeft, wordt ‘; ’ gebruikt).
The index is zero based. If index is less than 0, then the value used is the number of elements in name plus index (e.g.: $getmulti(%abcd%,-1) is the same as $getmulti(%abcd%,3) if %abcd% is a multi-value variable with four elements). If index is missing, not an integer, a number greater than or equal to the number of elements in name, or a negative number greater than the number of elements in name, then the function will return an empty string.
Voorbeeld:
De volgende instructies retourneren de aangegeven waarden:
$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) ==> ""