first property Null safety

Length first
override

Returns the first element.

Throws a StateError if this is empty. Otherwise returns the first element in the iteration order, equivalent to this.elementAt(0).

Implementation

Length get first {
  if (this.length > 0) {
    return JS('Length', '#[0]', this);
  }
  throw new StateError("No elements");
}
void first=(Length value)
inherited

The first element of the list.

The list must be non-empty when accessing its first element.

The first element of a list can be modified, unlike an Iterable. A list.first is equivalent to list[0], both for getting and setting the value.

final numbers = <int>[1, 2, 3];
print(numbers.first); // 1
numbers.first = 10;
print(numbers.first); // 10
numbers.clear();
numbers.first; // Throws.

Implementation

void set first(E value) {
  if (length == 0) throw IterableElementError.noElement();
  this[0] = value;
}