@SetListElement

Replaces the element at FN POSITION2 of FN/FNLIST/TEXT/TEXTLIST/TD/TDLIST/IDLIST/HUGETEXTLIST FN1/FNLIST1/TEXT1/TEXTLIST1/TD1/TDLIST1/IDLIST1/HUGETEXTLIST1 with FN3/TEXT3/TD3 and returns the new list as the result.

In the case of FN1/TEXT1/TD1 only 1 is allowed as POSITION2 and the effect is equivalent to a direct assignment.

If a list is specified for the second or third parameter, the elements at the positions from POSITIONLIST2 are set to the corresponding values from parameter 3.
If POSITIONLIST2 has fewer elements than the list in parameter 3, the last value from POSITIONLIST2 is incremented by 1 for each additional element in the list in parameter 3.
If the list in parameter 3 has fewer elements than POSITIONLIST2, the last element of the list in parameter 3 is repeated for each additional element of POSITIONLIST2.
If POSITIONLIST2 or the list in parameter 3 has no elements (0 NULL), parameter 1 is returned unchanged.
This applies regardless of whether any elements of POSITIONLIST2 are within the valid range or not.

Example: @SetListElement(FN1;POSITION2;FN3)

FN1:=100.37;
POSITION2:=1;
FN3:=200.12;
FN1:=@SetListElement(FN1;POSITION2;FN3);

returns 200.12

Example: @SetListElement(FNLIST1;POSITION2;FN3);

FN3:=15;
FNLIST1:=@SetListElement(FNLIST1;POSITION2;FN3);

returns 1:2:10:15:33

Example: @SetListElement(TEXT1;POSITION2;TEXT3);

TEXT1:="Hello world!";
POSITION2:=1;
TEXT3:="Hello Earth!";
TEXT1:=@SetListElement(TEXT1;POSITION2;TEXT3);

returns "Hello Earth!"

Example: @SetListElement(TEXTLIST1;POSITION2;TEXT3);

TEXTLIST1:="A":"B":"C":"D";
POSITION2:=3;
TEXT3:="x";
TEXTLIST1:=@SetListElement(TEXTLIST1;POSITION2;TEXT3);

returns "A":"B":"x":"D"

Example: @SetListElement(TD1;POSITION2;TD3);

TD1:=[30.09.93 14:35];
POSITION2:=1;
TD3:=[01.10.93 10:15:45];
TD1:=@SetListElement(TD1;POSITION2;TD3);

returns [01.10.93 10:15:45]

Example: @SetListElement(TDLIST1;POSITION2;TD3);

TDLIST1:=[30.09.93 14:35]:[31.12.93 23:55:30];
POSITION2:=2;
TD3:=[01.10.93 10:15:45];
TDLIST1:=@SetListElement(TDLIST1;POSITION2;TD3);

returns [30.09.93 14:35:00]:[01.10.93 10:15:45]
Example: @SetListElement(IDLIST1;POSITION2;FN3);

IDLIST1:=@IDList:2000:2004;
POSITION2:=2;
FN3:=3000;
IDLIST1:=@SetListElement(IDLIST1;POSITION2;ID3);

returns 2000:3000

Example: @SetListElement(TEXTLIST1;POSITIONLIST2;TEXT3);

TEXTLIST1:="A":"B":"C":"D";
POSITION2:=3:4;
TEXT3:="x";
TEXTLIST1:=@SetListElement(TEXTLIST1;POSITIONLIST2;TEXT3);

returns "A":"B":"x":"x"

Example: @SetListElement(TEXTLIST1;POSITIONLIST2;TEXTLIST3);

TEXTLIST1:="A":"B":"C":"D";
POSITION2:=2:4;
TEXT3:="x":"y";
TEXTLIST1:=@SetListElement(TEXTLIST1;POSITIONLIST2;TEXT3);

returns "A":"x":"C":"y"

Example: @SetListElement(TEXTLIST1;POSITIONLIST2;TEXTLIST3);

TEXTLIST1:="A":"B":"C":"D":"F";
POSITION2:=1:4;
TEXT3:="x":"y":"z";
TEXTLIST1:=@SetListElement(TEXTLIST1;POSITIONLIST2;TEXTLIST3);

returns "x":"B":"C":"y":"z"

Note : This text was machine-translated and may contain inaccuracies.