Свойство single

Свойство single возвращает единственный элемент итерируемого объекта. Оно не принимает параметров. Если в объекте ровно один элемент, он будет возвращён. Если элементов нет или их больше одного, будет выброшено исключение StateError.

Синтаксис

iterable.single

Пример

Давайте получим единственный элемент списка:

void main()
{
	Iterable<int> iter = [1];
	print(iter.single);
}

Результат выполнения кода:

1

Пример

Давайте получим единственный элемент множества:

void main()
{
	Set<String> iter = {'abcde'};
	print(iter.single);
}

Результат выполнения кода:

"abcde"

Пример

Если элементов больше одного, свойство single выбросит исключение:

void main()
{
	Iterable<int> iter = [1, 2, 3];
	print(iter.single);
}

Результат выполнения кода:

Uncaught Error: Bad state: Too many elements

Смотрите также

свойство first,
которое возвращает первый элемент
свойство last,
которое возвращает последний элемент
метод singleWhere,
который возвращает единственный подходящий элемент
свойство length,
которое возвращает количество элементов