ListSetAt()
Replaces the contents of a list element.
ListSetAt( list=string, position=number, value=string, delimiters=string, includeEmptyFields=boolean );
Returns: String
| Argument | Description | Default |
|---|---|---|
|
list
string,
required
|
edit
a string list |
|
|
position
number,
required
|
edit
Position at which to set a value. The first list position is 1. |
|
|
value
string,
required
|
edit
An element or a list of elements to set. |
|
|
delimiters
string,
optional
|
edit
Characters that separate list elements. The default value is comma. Alias: delimiter |
, |
|
includeEmptyFields
boolean,
optional
|
edit
if set to true, empty values are included as well |
Examples
editlist1 = ",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
- Lists
- Strings
- string.listSetAt()
- Search Issue Tracker open_in_new
- Search Lucee Test Cases open_in_new (good for further, detailed examples)