Array Filters

join

Joins the elements of an array into a string. Basically proxies string.Join. The method will call ToStringValue on everything in the array, so if they’re not already strings, they’ll get “flattened” into strings.

{{ "Alec,Gabrielle,Isabella" | split:"," | join: " + " }}

Alec + Gabrielle + Isabella

first

Returns the first element of an array. This just calls the “first” virtual member on the FuildValue input. So it’s not using LINQ or anything behind the scenes. And you can call it on anything, but it will return NilValue for anything except an array.

{% assign children = "Alec,Gabrielle,Isabella" | split:"," %}
{{ children | first }}

Alec

{{ children.first.age }}

last

Returns the last element of an array. This just calls the “last” virtual member on the FuildValue input, so all the same information provided for “first” (above) applies.

{% assign children = "Alec,Gabrielle,Isabella" | split:"," %}
{{ children | last }}

Isabella

concat

Glues two arrays together. Internally, it creates a new List<FluidValue>, adds all the original elements to it, then adds all the first argument’s elements to it.

{% assign children = "Alec,Gabrielle,Isabella" | split:"," %}
{% assign pets = "Jersey,Turks,Caicos" | split:"," %}

{{ children | concat:pets | join: ", " }}

Alec, Gabrielle, Isabella, Jersey, Turks, Caicos.

map

Extracts a single expression from all array elements into a new array. It’s the rough equivalent of Select in LINQ.

context.SetValue("children", new List<Person>() {
  new Person() { Name = "Alec", Age = 27 },
  new Person() { Name = "Gabrielle", Age = 20 },
  new Person() { Name = "Isabella", Age = 17 }
});

{{ children | map:"Age" | join:", " }}

27, 20, 17

{% assign children = "Alec,Gabrielle,Isabella" | split:"," %}

{{ children | map:"size" | join:", " }}

4, 9, 8

reverse

When called on an array, it returns a new array with the elements in the reverse order.

{{ children | reverse | join:", " }}

Isabella, Gabrielle, Alec

{{ "Deane" | reverse }}.
{{ "Deane" | reverse | join: ", " }}.

enaeD
e, n, a, e, D

size

Calls the size property on the array value.

{{ children | size }}

3

{{ children.size }}

sort

Returns a new array, sorted either by a supplied expression, or – if you don’t pass an expression in – by whatever the element returns from ToStringValue().

context.SetValue("children", new List<Person>() {
  new Person() { Name = "Alec", Age = 27 },
  new Person() { Name = "Gabrielle", Age = 20 },
  new Person() { Name = "Isabella", Age = 17 }
});

{{ children | sort:"Age" | map:"Name" | join:", " }}

Isabella, Gabrielle, Alec

sort_natural

It’s the same as sort, but when you don’t pass in any arguments, the results of the ToStringValue are case insensitive.

uniq

Returns a new array without duplicate values. Internally it’s calling the Distinct LINQ function.

{% comment %} My youngest is very loud, so she counts twice... {% endcomment %}
{% assign children = "Alec,Gabrielle,Isabella,Isabella" | split:"," %}

{{ children | uniq | join:", " }}

Alec, Gabrielle, Isabella

where

Filters an array by comparing a member to either (1) a matching value or (2) a boolean true.

This will return an array of just the people with a Name of “Bob”:

{{ people | where:"Name","Bob" | map:"Age" | join:", " }}

{{ people | where:"IsToasterphile" | map:"Name" | join:", " }}