contains方法

bool contains(
  1. Object? element
)

判断集合中是否包含与element相等的元素。

此操作将按顺序检查每个元素是否等于element,除非有更有效的方法来找到与element相等的元素。在找到第一个相等的元素时停止迭代。

用于判断element是否与迭代器中的元素相等的等价性默认为元素的Object.==

某些类型的迭代器可能对其元素使用不同的等价性。例如,一个Set可能有一个自定义的等价性(见Set.identity),其contains方法使用该等价性。同样,由Map.keys调用返回的Iterable应该使用与Map用于键相同的等价性。

示例

final gasPlanets = <int, String>{1: 'Jupiter', 2: 'Saturn'};
final containsOne = gasPlanets.keys.contains(1); // true
final containsFive = gasPlanets.keys.contains(5); // false
final containsJupiter = gasPlanets.values.contains('Jupiter'); // true
final containsMercury = gasPlanets.values.contains('Mercury'); // false

实现

bool contains(Object? element) {
  for (E e in this) {
    if (e == element) return true;
  }
  return false;
}