listInsertAt

Inserts an element in a list.

listInsertAt(list, position, value [, delimiters]) → returns string

  1. CFDocs
  2. Functions
  3. List Functions
  4. listInsertAt
  5. CF
  6. Lucee
  7. 0 Issue
  8. Edit
See Also:   listGetAt   listDeleteAt   listSetAt

Argument Reference

list string
Required

position numeric
Required

value string
Required

delimiters string
Default: ,

Examples
Sample code invoking the listInsertAt function

Inserts 'foo' into the list at position 2

listInsertAt("bar,lorem,ipsum", 2, "foo")

Expected Result: bar,foo,lorem,ipsum

Inserts 'foo' into the list with a custom delimiter

listInsertAt("bar|lorem,ipsum|me|something", 2, "foo", "|")

Expected Result: bar|foo|lorem,ipsum|me|something

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub