Format the items of a collection and join them with spacers, or index into a list with a selector.

The List formatter is both a formatter and a source. As a formatter it repeats a format for each item of any IEnumerable, such as an array or a , joining the items with spacers. As a source it provides list-item selectors, so you can read an item by index or by the current iteration index. Apply the formatter explicitly with the name , or omit the name to apply it implicitly to a collection.

The format takes up to four parts, separated by the split character:

{}

The item format can contain nested placeholders, so each item can be formatted in detail, for example .

Spacers can include character literals, for example to put each item on its own line. A spacer that contains nested placeholders is formatted against the collection's parent value, not the individual item.

{0:list:{}|, |, and }

["one", "two", "three"]

{0:list:{}| and }

["one", "two"]

{0:list:{:0.00}|, }

[1, 2, 3]

As a source, the List formatter lets a selector index into an IList. Use a numeric selector to read a specific item, and the selector to read the current item's position while iterating.

A string is an , but the formatter does not treat strings or values as lists.

The value at index 1 is {0.1}

[1, 2, 3]

{0.0} {0.1} {0.2}

[1, "Hello", "World"]

Use the selector to synchronize two lists by iterating one and indexing the other at the same position:

{0:{} = {1.index}|, }

[1, 2, 3, 4]

["one", "two", "three", "four"]