Skip to main content

List.SingleOrDefault

Returns the one list item for a list of length one and the default value for an empty list.

Syntax

List.SingleOrDefault(
list as list,
optional default as any
) as any

Remarks

If there is only one item in the list list, returns that item. If the list is empty, the function returns null unless an optional default is specified. If there is more than one item in the list, the function returns an error.

Examples

Example #1

Find the single value in the list {1}.

List.SingleOrDefault({1})

Result:

1

Example #2

Find the single value in the list {}.

List.SingleOrDefault({})

Result:

null

Example #3

Find the single value in the list {}. If is empty, return -1.

List.SingleOrDefault({}, -1)

Result:

-1

Category

List.Selection