List Functions

🛠️ Tools · ⬅ Home

---

Usage

listAppend listValue separator [ --first ] [ --last ] [ item ] [ --help ]

Add an item to the beginning or end of a text-delimited list

Arguments

• listValue - Required. Path value to modify.
• separator - Required. Separator string for item values (typically :)
• --first - Flag. Optional. Place any items after this flag first in the list
• --last - Flag. Optional. Place any items after this flag last in the list. Default.
• item - the path to be added to the listValue
• --help - Flag. Optional. Display this help.

Return codes

• 0 - Success
• 1 - Environment error
• 2 - Argument error

Usage

listRemove listValue separator [ item ] [ --help ]

Remove one or more items from a text-delimited list

Arguments

• listValue - Required. List value to modify.
• separator - Required. Separator string for item values (typically :)
• item - the item to be removed from the listValue
• --help - Flag. Optional. Display this help.

Return codes

• 0 - Success
• 1 - Environment error
• 2 - Argument error

Usage

listJoin separator [ text0 ... ] [ --help ]

Output arguments joined by a character

Arguments

• separator - EmptyString. Required. Single character to join elements. If a multi-character string is used only the first character is used as the delimiter.
• text0 ... - String. Optional. One or more strings to join
• --help - Flag. Optional. Display this help.

Sample Output

text

Return codes

• 0 - Success
• 1 - Environment error
• 2 - Argument error

Usage

listCleanDuplicates separator listText [ --removed ] [ --help ]

Removes duplicates from a list and maintains ordering.

Arguments

• separator - String. Required. List separator character.
• listText - String. Required. List to clean duplicates.
• --removed - Flag. Optional. Show removed items instead of the new list.
• --help - Flag. Optional. Display this help.

Return codes

• 0 - Success
• 1 - Environment error
• 2 - Argument error