ListSetAt

Replaces the contents of a list element.

ListSetAt( list, position, value [, delimiters [, includeEmptyFields ] ] )

Returns: String

Argument Description Default
list
string, required

a string list

position
number, required

Position at which to set a value. The first list position is 1.

value
string, required

An element or a list of elements to set.

delimiters
string, optional

Characters that separate list elements. The default value is comma.

Alias: delimiter

,

includeEmptyFields
boolean, optional

if set to true, empty values are included as well

Examples

list1 = ",a,b,c,d,e"
Dump(listSetAt(list1,"2", "Z"));
list2 = ",a||b||c||d||e"
Dump(listSetAt(list2,"2", "Z", "||"));
list3 = ",a,b,c,d,e"
Dump(listSetAt(list3,"2", "Z", ",",true)); //Because it includes empty field value ,Z,b,c,d,e
// MemberFunction
dump(list1.listSetAt("4", "Y")); //,a,b,c,Y,e

See also