`Iterable.first` în Dart

Iterable: parcurgere și transformare Dart 2.0

first și last dau primul și ultimul element; single dă singurul element și verifică faptul că este unul singur.

Sintaxă

E get first
E get last
E get single

Ce face `Iterable.first`

first returnează primul element, last ultimul. Pe o colecție goală ambele aruncă StateError (Bad state: No element). Pe o listă, first este același lucru cu lista[0].

single returnează elementul doar dacă există exact unul. Dacă nu există niciunul sau sunt mai multe, aruncă StateError. Este util când știi că un filtru trebuie să găsească un singur rezultat. Pentru variantele fără excepții vezi firstOrNull, lastOrNull, singleOrNull.

Ce returnează

Elementul cerut.

Exemple

Exemplul 1: Primul și ultimul din clasament

void main() {
  final clasament = ['Ana', 'Mihai', 'Ioana', 'Vlad'];
  print('Locul 1: ${clasament.first}');
  print('Ultimul: ${clasament.last}');

  final admis = clasament.where((n) => n.startsWith('I'));
  print('Singurul cu I: ${admis.single}');
}

Rezultat

Locul 1: Ana
Ultimul: Vlad
Singurul cu I: Ioana

Exemplul 2: Erorile pe colecții goale sau prea mari

void main() {
  final goala = <String>[];
  try {
    print(goala.first);
  } on StateError catch (e) {
    print('first: $e');
  }
  try {
    print([1, 2].single);
  } on StateError catch (e) {
    print('single: $e');
  }
}