Трейт scala.collection.immutable.StrictOptimizedSortedMapOps
trait StrictOptimizedSortedMapOps[K, +V, +CC[X, +Y] <: Map[X, Y] with SortedMapOps[X, Y, CC, _], +C <: SortedMapOps[K, V, CC, C]] extends SortedMapOps[K, V, CC, C] with collection.StrictOptimizedSortedMapOps[K, V, CC, C] with StrictOptimizedMapOps[K, V, Map, C]
- Источник
- SortedMap.scala
- Линейные супертипы
- StrictOptimizedMapOps[K, V, Map, C], collection.StrictOptimizedSortedMapOps[K, V, CC, C], collection.StrictOptimizedMapOps[K, V, [_, _]Map[_, _], C], StrictOptimizedIterableOps[(K, V), [_]Iterable[_], C], SortedMapOps[K, V, CC, C], collection.SortedMapOps[K, V, CC, C], SortedOps[K, C], MapOps[K, V, Map, C], collection.MapOps[K, V, [_, _]Map[_, _], C], PartialFunction[K, V], (K) => V, IterableOps[(K, V), [_]Iterable[_], C], IterableOnceOps[(K, V), [_]Iterable[_], C], IterableOnce[(K, V)], AnyRef, Any
- Известные подклассы
- TreeMap
Члены типа
тракт GenKeySet extends AnyRef
Общий тракт, используемый реализациями keyset
- Атрибуты
- protected
- Определяющие классы
- MapOps
класс KeySet extends AbstractSet[K] with GenKeySet with DefaultSerializable
Реализующий класс множества, возвращаемого keySet.
- Атрибуты
- protected
- Определяющие классы
- MapOps
тракт GenKeySortedSet extends GenKeySet
Общий тракт, используемый реализациями sorted keyset
- Атрибуты
- protected
- Определяющие классы
- SortedMapOps
класс KeySortedSet extends SortedSet[K] with GenKeySet with GenKeySortedSet
Реализующий класс множества, возвращаемого keySet
- Атрибуты
- protected
- Определяющие классы
- SortedMapOps
класс ImmutableKeySet extends AbstractSet[K] with GenKeySet with DefaultSerializable
Реализующий класс множества, возвращаемого keySet
- Атрибуты
- protected
- Определяющие классы
- MapOps
класс ImmutableKeySortedSet extends AbstractSet[K] with SortedSet[K] with GenKeySet with GenKeySortedSet
Реализующий класс множества, возвращаемого keySet
- Атрибуты
- protected
- Определяющие классы
- SortedMapOps
Абстрактные члены-значения
abstract def coll: C with CC[K, V]
- returns
Это коллекция в виде
C.
- Атрибуты
- protected
- Определяющие классы
- SortedMapOps → MapOps → IterableOps
abstract def fromSpecific(coll: IterableOnce[(K, V)]): C
Определяет, как преобразовать заданную Iterable[A] в коллекцию типа C.
Этот процесс может быть выполнен строго или нестрого (т. е. без вычисления элементов результирующих коллекций). Другими словами, этот метод определяет модель вычисления коллекции.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, гдеC =:= CC[A], это можно сделать, добавив в класс IterableFactoryDefaults, который реализует метод, используя iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, до тех пор, пока он вызывается сIterable[A], полученным из коллекцииthis(как это происходит при реализации операций, где мы используемView[A]), он безопасен.
abstract def get(key: K): Option[V]
Возвращает значение, связанное с ключом.
- key
значение ключа
- returns
объект Option, содержащий значение, связанное с
keyв этой карте, илиNone, если такового нет.
- Определяющие классы
- MapOps
abstract def iterableFactory: IterableFactory[[_]Iterable[_]]
Объект-компаньон этой коллекции итераций, предоставляющий различные методы создания.
- Определяющие классы
- IterableOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
abstract def iterator: Iterator[(K, V)]
Итератор может быть использован только один раз
- Определяющие классы
- IterableOnce
abstract def iteratorFrom(start: K): Iterator[(K, V)]
Создает итератор по всем парам ключ/значение, содержащимся в этой карте, имеющим ключ, больше или равный start в соответствии с порядком этой карты. x.iteratorFrom(y) эквивалентно, но часто эффективнее, чем x.from(y).iterator.
- start
Нижняя граница (включительно) ключей, которые будут возвращены
- Определяющие классы
- SortedMapOps
abstract def keysIteratorFrom(start: K): Iterator[K]
Создает итератор по всем ключам (или элементам), содержащимся в этой коллекции, которые больше или равны start в соответствии с порядком этой коллекции. x.keysIteratorFrom(y) эквивалентно, но часто эффективнее, чем x.from(y).keysIterator.
- start
Нижняя граница (включительно) ключей, которые будут возвращены
- Определяющие классы
- SortedMapOps
abstract def mapFactory: MapFactory[[_, _]Map[_, _]]
Объект-компаньон этой карты, предоставляющий различные методы создания.
- Определяющие классы
- MapOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
abstract def newSpecificBuilder: Builder[(K, V), C]
- возвращает
строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList), реализация этого метода возможна, но полученный
Builderнарушит ленивость. Вследствие этого операции предпочтительно реализовывать с помощьюfromSpecificвместо этого метода.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, добавив в миксин IterableFactoryDefaults трейт, который реализует метод с использованием iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, до тех пор, пока возвращаемый билдер получает только значенияAвзятые из экземпляраthis, он безопасен.
абстрактный def ordering: Ordering[K]
- Определяющие классы
- SortedOps
абстрактный def rangeImpl(from: Option[K], until: Option[K]): C
Создаёт проекцию диапазона этой коллекции. Любые изменения в проекции диапазона изменят эту коллекцию и наоборот.
Примечание: ключи не гарантируются как согласованные между этой коллекцией и проекцией. Это справедливо для буферов, где индексирование относительно проекции.
- from
Нижняя граница (включительно) проекции диапазона.
Noneесли нижней границы нет.- until
Верхняя граница (исключительно) проекции диапазона.
Noneесли верхней границы нет.
- Определяющие классы
- SortedOps
абстрактный def removed(key: K): C
Удаляет ключ из этой карты, возвращая новую карту.
- key
ключ для удаления
- возвращает
новая карта без связи для key
- Определяющие классы
- MapOps
абстрактный def sortedMapFactory: SortedMapFactory[CC]
Компаньон-объект этой сортированной карты, предоставляющий различные методы фабрики.
- Определяющие классы
- SortedMapOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
абстрактный def toIterable: collection.Iterable[(K, V)]
- возвращает
Эта коллекция как
Iterable[A]. Новая коллекция не будет построена, еслиthisуже являетсяIterable[A].
- Определяющие классы
- IterableOps
абстрактный def unsorted: Map[K, V]
- Определяющие классы
- SortedMapOps → SortedMapOps
абстрактный def updated[V1 >: V](key: K, value: V1): CC[K, V1]
Создаёт новую карту, полученную путём обновления этой карты заданной парой ключ/значение.
- V1
тип добавленного значения
- key
ключ
- value
значение
- возвращает
Новая карта с добавленной в эту карту новой связью ключ/значение. <ошибка в аннотации inheritdoc>
- Определяющие классы
- SortedMapOps → MapOps
Конкретные члены значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), иначе false.
- Определяющие классы
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением boxed числовых типов и null. Для чисел возвращает хэш-значение, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## выдаст одно и то же хэш-значение для каждого из них. Для null возвращает хэш-код, где null.hashCode выбрасывает NullPointerException.
- returns
хэш-значение, согласованное с ==
- Определяющие классы
- AnyRef → Any
final def +[V1 >: V](kv: (K, V1)): CC[K, V1]
Псевдоним для updated
- V1
тип значения в паре ключ/значение.
- kv
пара ключ/значение.
- returns
Новая карта с добавленным в эту карту новым привязкой.
- Определяющие классы
- SortedMapOps → SortedMapOps → MapOps → MapOps
- Аннотации
- @inline()
final def ++[V2 >: V](xs: IterableOnce[(K, V2)]): CC[K, V2]
Псевдоним для concat
- Определяющие классы
- SortedMapOps → MapOps
- Аннотации
- @inline()
final def ++[B >: (K, V)](suffix: IterableOnce[B]): Iterable[B]
Псевдоним для concat
- Определяющие классы
- IterableOps
- Аннотации
- @inline()
final def -(key: K): C
final def --(keys: IterableOnce[K]): C
def ->[B](y: B): (StrictOptimizedSortedMapOps[K, V, CC, C], B)
- Неявный
- Этот член добавляется с помощью неявного преобразования из StrictOptimizedSortedMapOps[K, V, CC, C] в ArrowAssoc[StrictOptimizedSortedMapOps[K, V, CC, C]] выполняемый методом ArrowAssoc в scala.Predef.Это преобразование произойдёт только если V является подклассом Option[Nothing] (V <: Option[Nothing]).
- Определяющие классы
- ArrowAssoc
- Аннотации
- @inline()
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- возвращает
trueесли объект получателя эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
def addString(sb: mutable.StringBuilder, start: String, sep: String, end: String): mutable.StringBuilder
Добавляет все элементы этой карты в строку-строитель, используя строки start, end и separator. Записываемый текст начинается со строки start и заканчивается строкой end. Внутри строковые представления (относительно метода toString) всех элементов этой карты разделяются строкой sep.
Пример:
scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)
scala> val b = new StringBuilder()
b: StringBuilder =
scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- возвращает
строка-строитель
b, в которую были добавлены элементы.
- Определяющие классы
- MapOps → IterableOnceOps
final def addString(b: mutable.StringBuilder): mutable.StringBuilder
Добавляет все элементы этого набора в строку-строитель. Записываемый текст состоит из строковых представлений (относительно метода toString) всех элементов этого набора без разделительной строки.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> val h = a.addString(b) h: StringBuilder = 1234
- b
строка-строитель, в которую добавляются элементы.
- возвращает
строка-строитель
b, в которую были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
final def addString(b: mutable.StringBuilder, sep: String): mutable.StringBuilder
Добавляет все элементы этой коллекции в строку-строитель, используя разделительную строку. Записываемый текст состоит из строковых представлений (относительно метода toString) всех элементов этой коллекции, разделённых строкой sep.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> a.addString(b, ", ") res0: StringBuilder = 1, 2, 3, 4
- b
строка-строитель, в которую добавляются элементы.
- sep
разделительная строка.
- возвращает
строка-строитель
b, в которую были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
def andThen[C](k: PartialFunction[V, C]): PartialFunction[K, C]
Компонует эту частичную функцию с другой частичной функцией, которая применяется к результатам этой частичной функции.
Обратите внимание, что вызов isDefinedAt для полученной частичной функции может применить первую частичную функцию и выполнить её побочное действие. Рекомендуется использовать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- C
тип результата функции преобразования.
- k
функция преобразования
- возвращает
частичная функция с областью определения этой частичной функции, суженной другой частичной функцией, которая отображает аргументы
xвk(this(x)).
- Определяющие классы
- PartialFunction
def andThen[C](k: (V) => C): PartialFunction[K, C]
Компонует эту частичную функцию с функцией преобразования, которая применяется к результатам этой частичной функции.
Если тип времени выполнения функции — PartialFunction — используется другой метод andThen (обратите внимание на его предостережения).
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, возможно суженной указанной функцией, которая отображает аргументы
xвk(this(x)).
- Definition Classes
- PartialFunction → Function1
def apply(key: K): V
Получает значение, связанное с заданным ключом. Этот метод вызывает метод default карты, если нет соответствия от данного ключа к значению. Если не переопределено, метод default выбросит NoSuchElementException.
- key
ключ
- returns
значение, связанное с заданным ключом, или результат метода
defaultкарты, если такого соответствия нет.
def applyOrElse[K1 <: K, V1 >: V](x: K1, default: (K1) => V1): V1
Применяет эту частичную функцию к данному аргументу, когда он содержится в области определения функции. Применяет функцию по умолчанию, если эта частичная функция не определена.
Обратите внимание, что выражение pf.applyOrElse(x, default) эквивалентно
if(pf isDefinedAt x) pf(x) else default(x)
кроме того, что метод applyOrElse может быть реализован более эффективно. Для всех литералов частичных функций компилятор генерирует реализацию applyOrElse, которая избегает двойной оценки операторов pattern matching и guard. Это делает applyOrElse основой для эффективной реализации многих операций и сценариев, таких как:
-
комбинирование частичных функций в цепочки
orElse/andThen не приводит к чрезмерной оценке apply/isDefinedAt
lift и unlift не оценивают исходные функции дважды при каждом вызове
runWith позволяет эффективно комбинировать частичные функции в императивном стиле с условными действиямиДля нелитеральных классов частичных функций с нетривиальным методом isDefinedAt рекомендуется переопределить метод applyOrElse с пользовательской реализацией, которая избегает двойной оценки isDefinedAt. Это может привести к лучшей производительности и более предсказуемому поведению относительно побочных эффектов.
- x
аргумент функции
- default
функция по умолчанию
- returns
результат применения этой функции или функции по умолчанию.
- Definition Classes
- MapOps → PartialFunction
- Since
2.10
final def asInstanceOf[T0]: T0
Приводит объект-получатель к типу T0.
Обратите внимание, что успех приведения типов во время выполнения определяется семантикой стирания Scala. Поэтому выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, а выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере, поскольку аргумент типа стирается во время компиляции, невозможно проверить, содержатся ли элементы списка в требуемом типе.
- returns
объект-получатель.
- Definition Classes
- Any
- Exceptions thrown
ClassCastException, если объект-получатель не является экземпляром стирания типаT0.
def clone(): AnyRef
Создает копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- returns
копия объекта-получателя.
def collect[K2, V2](pf: PartialFunction[(K, V), (K2, V2)])(implicit ordering: Ordering[K2]): CC[K2, V2]
Создает новую сортированную карту, применяя частичную функцию ко всем элементам этой карты, для которых функция определена.
- pf
частичная функция, которая фильтрует и отображает карту.
- returns
новая карта, полученная в результате применения данной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Definition Classes
- StrictOptimizedSortedMapOps → SortedMapOps
def collect[K2, V2](pf: PartialFunction[(K, V), (K2, V2)]): Map[K2, V2]
Создаёт новую коллекцию, применяя частичную функцию ко всем элементам этой карты, для которых она определена.
- K2
тип ключа возвращаемой карты.
- V2
тип значения возвращаемой карты.
- pf
частичная функция, которая фильтрует и отображает карту.
- returns
новая карта, полученная путём применения заданной частичной функции к каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Definition Classes
- StrictOptimizedMapOps → MapOps
def collect[B](pf: PartialFunction[(K, V), B]): Iterable[B]
Создаёт новую коллекцию Iterable, применяя частичную функцию к всем элементам этой коллекции, для которых она определена.
- B
тип элементов возвращаемой коллекции Iterable.
- pf
частичная функция, которая фильтрует и отображает коллекцию Iterable.
- returns
новая коллекция Iterable, полученная путём применения заданной частичной функции к каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Note
Повторное использование: После вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
def collectFirst[B](pf: PartialFunction[(K, V), B]): Option[B]
Находит первый элемент коллекции, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- pf
частичная функция
- returns
значение Option, содержащее результат применения pf к первому значению, для которого она определена, или None, если такого значения не существует.
- Definition Classes
- IterableOnceOps
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def compose[R](k: PartialFunction[R, K]): PartialFunction[R, V]
Компонует другую частичную функцию с этой частичной функцией так, что эта частичная функция применяется к результатам другой частичной функции.
Обратите внимание, что вызов isDefinedAt на полученной частичной функции может применить первую частичную функцию и выполнить её побочные эффекты. Крайне рекомендуется использовать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- R
тип параметра функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения другой частичной функции, суженной этой частичной функцией, которая отображает аргументы
xвthis(k(x)).
- Definition Classes
- PartialFunction
def compose[A](g: (A) => K): (A) => V
Компонует два экземпляра Function1 в новый Function1, при этом эта функция применяется последней.
- A
тип, к которому можно применить функцию
g.- g
функция A => T1
- returns
новая функция
fтакая, чтоf(x) == apply(g(x)).
- Definition Classes
- Function1
- Annotations
- @unspecialized()
def concat[V2 >: V](xs: IterableOnce[(K, V2)]): CC[K, V2]
Возвращает новую неизменяемую карту, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элементов неизменяемой карты — это наиболее специфический суперкласс, охватывающий типы элементов двух операндов.
- returns
новая неизменяемая карта, которая содержит все элементы этой неизменяемой карты, за которыми следуют все элементы
suffix.
- Definition Classes
- StrictOptimizedSortedMapOps → StrictOptimizedMapOps → StrictOptimizedSortedMapOps → StrictOptimizedMapOps → SortedMapOps → MapOps
def concat[B >: (K, V)](suffix: IterableOnce[B]): Iterable[B]
Возвращает новую итерируемую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элементов итерируемой коллекции — это наиболее специфический суперкласс, охватывающий типы элементов двух операндов.
- B
тип элементов возвращаемой коллекции.
- suffix
перебираемая коллекция для добавления.
- returns
новая итерируемая коллекция, которая содержит все элементы этой итерируемой коллекции, за которыми следуют все элементы
suffix.
- Definition Classes
- IterableOps
def contains(key: K): Boolean
Проверяет, содержит ли эта карта привязку для ключа.
- key
ключ
- returns
trueесли в этой карте есть привязка дляkey,falseв противном случае.
- Definition Classes
- MapOps
def copyToArray[B >: (K, V)](xs: Array[B], start: Int, len: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет данный массив xs начиная с индекса start максимум len элементами этой коллекции.
Копирование прекращается, когда скопированы все элементы этой коллекции, достигнут конец массива или скопировано len элементов.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- len
максимальное количество копируемых элементов.
- returns
количество элементов, записанных в массив
- Definition Classes
- IterableOnceOps
- Note
Переиспользование: После вызова этого метода итератор, на котором он был вызван, должен быть удалён. Использование его в ином случае не определено и может быть изменено. Примечание: не завершится для коллекций бесконечного размера.
def copyToArray[B >: (K, V)](xs: Array[B], start: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет данный массив xs начиная с индекса start значениями этой коллекции.
Копирование прекращается, когда скопированы все элементы этой коллекции или достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- returns
количество элементов, записанных в массив. Примечание: не завершится для коллекций бесконечного размера.
- Definition Classes
- IterableOnceOps
def copyToArray[B >: (K, V)](xs: Array[B]): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет данный массив xs начиная с индекса start значениями этой коллекции.
Копирование прекращается, когда скопированы все элементы этой коллекции или достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- returns
количество элементов, записанных в массив. Примечание: не завершится для коллекций бесконечного размера.
- Definition Classes
- IterableOnceOps
def corresponds[B](that: IterableOnce[B])(p: ((K, V), B) => Boolean): Boolean
Проверяет, относится ли каждый элемент итератора этой коллекции к соответствующему элементу другой коллекции, удовлетворяя предикату проверки.
- B
тип элементов
that- that
другая коллекция
- p
предикат проверки, который связывает элементы из обеих коллекций
- возвращает
trueесли обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иythat, в противном случаеfalse
- Определяющие классы
- IterableOnceOps
def count(p: ((K, V)) => Boolean): Int
Подсчитывает количество элементов в коллекции, удовлетворяющих предикату.
- p
предикат, используемый для проверки элементов.
- возвращает
количество элементов, удовлетворяющих предикату
p.
- Определяющие классы
- IterableOnceOps
def default(key: K): V
Определяет вычисление значения по умолчанию для карты, возвращаемое, когда ключ не найден. Реализованный здесь метод выбрасывает исключение, но он может быть переопределен в подклассах.
- key
указанное значение ключа, для которого отсутствует привязка.
def drop(n: Int): C
Выбирает все элементы, кроме первых n.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
количество элементов, которые необходимо удалить из этой итерируемой коллекции.
- возвращает
итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, кроме первых
nэлементов, или же пустая итерируемая коллекция, если у этой итерируемой коллекции меньше, чемnэлементов. Еслиnотрицательно, не удалять никаких элементов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода необходимо отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределено, может измениться и может привести к изменениям в новом итераторе также.
def dropRight(n: Int): C
Остальная часть коллекции без её n последних элементов. Для линейных неизменяемых коллекций это должно избежать создания копии.
Примечание: даже при применении к представлению или ленивой коллекции это всегда заставит элементы.
- n
количество элементов, которые необходимо удалить из этой итерируемой коллекции.
- возвращает
итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, кроме последних
nэлементов, или же пустая итерируемая коллекция, если у этой итерируемой коллекции меньше, чемnэлементов. Еслиnотрицательно, не удалять никаких элементов.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps
def dropWhile(p: ((K, V)) => Boolean): C
Удаляет самую длинную префиксную часть элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
Предикат, используемый для проверки элементов.
- возвращает
самый длинный суффикс этой итерируемой коллекции, первый элемент которого не удовлетворяет предикату
p.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода необходимо отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределено, может измениться и может привести к изменениям в новом итераторе также.
def elementWise: ElementWiseExtractor[K, V]
Возвращает объект-экстрактор с методом unapplySeq, который извлекает каждый элемент последовательных данных.
- Определяющие классы
- PartialFunction
val firstChar: String => Option[Char] = _.headOption
Seq("foo", "bar", "baz") match {
case firstChar.unlift.elementWise(c0, c1, c2) =>
println(s"$c0, $c1, $c2") // Output: f, b, b
}
def empty: C
Пустая итерируемая коллекция того же типа, что и эта итерируемая коллекция
- возвращает
пустую итерируемую коллекцию типа
C.
- Определяющие классы
- IterableOps
def ensuring(cond: (StrictOptimizedSortedMapOps[K, V, CC, C]) => Boolean, msg: => Any): StrictOptimizedSortedMapOps[K, V, CC, C]
- Неявный
- Этот член добавлен с помощью неявного преобразования из StrictOptimizedSortedMapOps[K, V, CC, C] в Ensuring[StrictOptimizedSortedMapOps[K, V, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: (StrictOptimizedSortedMapOps[K, V, CC, C]) => Boolean): StrictOptimizedSortedMapOps[K, V, CC, C]
- Неявный
- Этот член добавлен с помощью неявного преобразования из StrictOptimizedSortedMapOps[K, V, CC, C] в Ensuring[StrictOptimizedSortedMapOps[K, V, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean, msg: => Any): StrictOptimizedSortedMapOps[K, V, CC, C]
- Неявный
- Этот член добавлен с помощью неявного преобразования из StrictOptimizedSortedMapOps[K, V, CC, C] в Ensuring[StrictOptimizedSortedMapOps[K, V, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): StrictOptimizedSortedMapOps[K, V, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из StrictOptimizedSortedMapOps[K, V, CC, C] вEnsuring[StrictOptimizedSortedMapOps[K, V, CC, C]] выполнено методом Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности отношение эквивалентности на не-null экземплярах AnyRef, и имеет три дополнительных свойства:
-
Он согласован: для любых не-null экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого не-null экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false.
null.eq(null) возвращает true. При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны хешироваться до одного и того же значения (o1.hashCode == o2.hashCode).
- возвращает
trueесли аргумент является ссылкой на объект-получатель;falseв противном случае.
- Определяющие классы
- AnyRef
def equals(arg0: AnyRef): Boolean
Метод равенства для ссылочных типов. Реализация по умолчанию делегирует вызов eq.
См. также equals в scala.Any.
- возвращает
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
def exists(p: ((K, V)) => Boolean): Boolean
Проверяет, выполняется ли предикат хотя бы для одного элемента в этом наборе.
Примечание: может не завершиться для наборов бесконечного размера.
- p
предикат, используемый для проверки элементов.
- возвращает
trueесли заданный предикатpвыполняется хотя бы для одного элемента в этом наборе, иначеfalse
- Определяющие классы
- IterableOnceOps
def filter(pred: ((K, V)) => Boolean): C
Выбирает все элементы из этого итерируемого набора, удовлетворяющие предикату.
- возвращает
новый итератор, состоящий из всех элементов этого итерируемого набора, удовлетворяющих заданному предикату
p. Порядок элементов сохраняется.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
def filterImpl(pred: ((K, V)) => Boolean, isFlipped: Boolean): C
- Атрибуты
- protected[scala.collection]
- Определяющие классы
- StrictOptimizedIterableOps
def filterNot(pred: ((K, V)) => Boolean): C
Выбирает все элементы из этого итерируемого набора, не удовлетворяющие предикату.
- pred
предикат, используемый для проверки элементов.
- возвращает
новый итерируемый набор, состоящий из всех элементов этого итерируемого набора, не удовлетворяющих заданному предикату
pred. Порядок элементов может не сохраняться.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда на объект больше нет ссылок.
Подробности о том, когда и вызывается ли метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями зависят от платформы.
def find(p: ((K, V)) => Boolean): Option[(K, V)]
Находит первый элемент коллекции, удовлетворяющий предикату, если таковой существует.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
необязательное значение, содержащее первый элемент в коллекции, который удовлетворяет
p, илиNone, если такового не существует.
- Definition Classes
- IterableOnceOps
def firstKey: K
Возвращает первый ключ коллекции.
- Definition Classes
- SortedMapOps → SortedOps
def flatMap[K2, V2](f: ((K, V)) => IterableOnce[(K2, V2)])(implicit ordering: Ordering[K2]): CC[K2, V2]
Построит новую отсортированную карту, применяя функцию ко всем элементам этой карты и используя элементы результирующих коллекций.
- f
функция, которую нужно применить к каждому элементу.
- returns
новая карта, полученная путем применения данной функции со значениями-коллекциями
fк каждому элементу этой карты и конкатенации результатов.
- Definition Classes
- StrictOptimizedSortedMapOps → SortedMapOps
def flatMap[K2, V2](f: ((K, V)) => IterableOnce[(K2, V2)]): Map[K2, V2]
Построит новую карту, применяя функцию ко всем элементам этой карты и используя элементы результирующих коллекций.
- f
функция, которую нужно применить к каждому элементу.
- returns
новая карта, полученная путем применения данной функции со значениями-коллекциями
fк каждому элементу этой карты и конкатенации результатов.
- Definition Classes
- StrictOptimizedMapOps → MapOps
def flatMap[B](f: ((K, V)) => IterableOnce[B]): Iterable[B]
Построит новую итерируемую коллекцию, применяя функцию ко всем элементам этой итерируемой коллекции и используя элементы результирующих коллекций.
Например:
def getWords(lines: Seq[String]): Seq[String] = lines flatMap (line => line split "\\W+")
Тип результирующей коллекции определяется статическим типом итерируемой коллекции. Это иногда может приводить к неожиданным результатам. Например:
// lettersOf will return a Seq[Char] of likely repeated letters, instead of a Set
def lettersOf(words: Seq[String]) = words flatMap (word => word.toSet)
// lettersOf will return a Set[Char], not a Seq
def lettersOf(words: Seq[String]) = words.toSet flatMap ((word: String) => word.toSeq)
// xs will be an Iterable[Int]
val xs = Map("a" -> List(11,111), "b" -> List(22,222)).flatMap(_._2)
// ys will be a Map[Int, Int]
val ys = Map("a" -> List(1 -> 11,1 -> 111), "b" -> List(2 -> 22,2 -> 222)).flatMap(_._2)
- B
тип элемента возвращаемой коллекции.
- f
функция, которую нужно применить к каждому элементу.
- returns
новая итерируемая коллекция, полученная путем применения данной функции со значениями-коллекциями
fк каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует отказаться от итератора, к которому он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def flatten[B](implicit toIterableOnce: ((K, V)) => IterableOnce[B]): Iterable[B]
Преобразует эту итерируемую коллекцию траверсируемых коллекций в итерируемую коллекцию, образованную элементами этих траверсируемых коллекций.
Тип результирующей коллекции будет определяться типом итерируемой коллекции. Например:
val xs = List(
Set(1, 2, 3),
Set(1, 2, 3)
).flatten
// xs == List(1, 2, 3, 1, 2, 3)
val ys = Set(
List(1, 2, 3),
List(3, 2, 1)
).flatten
// ys == Set(1, 2, 3)
- B
тип элементов каждой траверсируемой коллекции.
- returns
новая итерируемая коллекция, полученная в результате конкатенации всех итерируемых коллекций элементов.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def fold[A1 >: (K, V)](z: A1)(op: (A1, A1) => A1): A1
Сворачивает элементы этой коллекции, используя указанный ассоциативный бинарный оператор. Реализация по умолчанию в IterableOnce эквивалентна foldLeft, но может быть переопределена для более эффективных порядков обхода.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
Примечание: не будет завершаться для коллекций бесконечного размера.
- A1
типовой параметр для бинарного оператора, супертип
A.- z
нейтральный элемент для операции сворачивания; может быть добавлен к результату произвольное количество раз и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- returns
результат применения оператора сворачивания
opко всем элементам иz, илиz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def foldLeft[B](z: B)(op: (B, (K, V)) => B): B
Применяет бинарный оператор к начальному значению и всем элементам этой коллекции, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
результирующий тип бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, слева направо, с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn— элементы этой коллекции. Возвращаетz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def foldRight[B](z: B)(op: ((K, V), B) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции и начальному значению, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
результирующий тип бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, справа налево, с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn— элементы этой коллекции. Возвращаетz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def forall(p: ((K, V)) => Boolean): Boolean
Проверяет, выполняется ли предикат для всех элементов этой коллекции.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
true, если эта коллекция пуста или заданный предикатpвыполняется для всех элементов этой коллекции, иначеfalse.
- Определяющие классы
- IterableOnceOps
def foreach[U](f: ((K, V)) => U): Unit
Применить f к каждому элементу для его побочных эффектов. Примечание: параметр [U] необходим для помощи выводу типов scalac.
- Определяющие классы
- IterableOnceOps
def foreachEntry[U](f: (K, V) => U): Unit
Применить f к каждой паре ключ/значение для её побочных эффектов. Примечание: параметр [U] необходим для помощи выводу типов scalac.
- Определяющие классы
- MapOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой format. Форматные строки аналогичны String.format (@см. java.lang.String.format).
- Implicit
- Этот член добавлен неявным преобразованием из StrictOptimizedSortedMapOps[K, V, CC, C] в StringFormat[StrictOptimizedSortedMapOps[K, V, CC, C]] при помощи метода StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
final def getClass(): Class[_ <: AnyRef]
Возвращает представление класса объекта во время выполнения.
- returns
объект класса, соответствующий типу получателя во время выполнения.
def getOrElse[V1 >: V](key: K, default: => V1): V1
Возвращает значение, связанное с ключом, или значение по умолчанию, если ключ не содержится в карте.
- V1
тип результата вычисления по умолчанию.
- key
ключ.
- default
вычисление, которое возвращает значение по умолчанию в случае, если в карте нет привязки к
key.- returns
значение, связанное с
key, если оно существует, в противном случае результат вычисленияdefault.
- Definition Classes
- MapOps
def groupBy[K](f: ((K, V)) => K): Map[K, C]
Разделяет эту коллекцию итерируемых элементов на карту итерируемых коллекций в соответствии с функцией-дискриминатором.
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- K
тип ключей, возвращаемых функцией-дискриминатором.
- f
функция-дискриминатор.
- returns
-
Карта от ключей к итерируемым коллекциям, в которой выполняется следующее инвариантное условие:
(xs groupBy f)(k) = xs filter (x => f(x) == k)
То есть каждый ключ
kсвязан с итерируемой коллекцией элементовx, для которыхf(x)равноk.
- Definition Classes
- IterableOps
def groupMap[K, B](key: ((K, V)) => K)(f: ((K, V)) => B): Map[K, Iterable[B]]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с функцией-дискриминатором key. Каждый элемент в группе преобразуется в значение типа B с помощью функции value.
Это эквивалентно groupBy(key).mapValues(_.map(f)), но более эффективно.
case class User(name: String, age: Int) def namesByAge(users: Seq[User]): Map[Int, Seq[String]] = users.groupMap(_.age)(_.name)
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- K
тип ключей, возвращаемых функцией-дискриминатором
- B
тип значений, возвращаемых функцией преобразования
- key
функция-дискриминатор
- f
функция преобразования элементов
- Definition Classes
- IterableOps
def groupMapReduce[K, B](key: ((K, V)) => K)(f: ((K, V)) => B)(reduce: (B, B) => B): Map[K, B]
Разбивает эту итерируемую коллекцию на карту в соответствии с функцией дискриминатора key. Все значения, имеющие один и тот же дискриминатор, затем преобразуются функцией value и затем сводятся к одному значению с помощью функции reduce.
Это эквивалентно groupBy(key).mapValues(_.map(f).reduce(reduce)), но более эффективно.
def occurrences[A](as: Seq[A]): Map[A, Int] = as.groupMapReduce(identity)(_ => 1)(_ + _)
Примечание: даже при применении к представлению или ленивой коллекции это всегда будет принудительно обрабатывать элементы.
- Определяющие классы
- IterableOps
def grouped(size: Int): Iterator[C]
Разбивает элементы на итерируемые коллекции фиксированного размера.
- size
количество элементов в группе
- возвращает
Итератор, производящий итерируемые коллекции размером
size, за исключением последней, которая будет меньше размераsize, если элементы не делятся равномерно.
- Определяющие классы
- IterableOps
- См. также
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- возвращает
значение хэш-кода для этого объекта.
def head: (K, V)
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- возвращает
первый элемент этой итерируемой коллекции.
- Определяющие классы
- IterableOps
- Выбрасываемые исключения
NoSuchElementExceptionесли итерируемая коллекция пуста.
def headOption: Option[(K, V)]
Необязательно выбирает первый элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- возвращает
первый элемент этой итерируемой коллекции, если она не пуста,
None, если она пуста.
- Определяющие классы
- IterableOps
def init: C
Начальная часть коллекции без её последнего элемента.
Примечание: даже при применении к представлению или ленивой коллекции это всегда будет принудительно обрабатывать элементы.
- Определяющие классы
- IterableOps
def inits: Iterator[C]
Итерирует по начальным частям этой итерируемой коллекции. Первым значением будет эта итерируемая коллекция, а последним — пустая итерируемая коллекция, а промежуточные значения — результаты последовательного применения init.
Примечание: даже при применении к представлению или ленивой коллекции это всегда будет принудительно обрабатывать элементы.
- возвращает
итератор по всем начальным частям этой итерируемой коллекции
- Определяющие классы
- IterableOps
List(1,2,3).inits = Iterator(List(1,2,3), List(1,2), List(1), Nil)
def isDefinedAt(key: K): Boolean
Проверяет, содержит ли эта карта привязку для ключа. Этот метод, реализующий абстрактный метод черты PartialFunction, эквивалентен contains.
- key
ключ
- возвращает
trueесли есть привязка дляkeyв этой карте,falseв противном случае.
- Определяющие классы
- MapOps → PartialFunction
def isEmpty: Boolean
Проверяет, пуста ли коллекция.
Примечание: реализации в подклассах, которые не являются многократно проходимыми, должны позаботиться о том, чтобы не потреблять никаких элементов, когда вызывается isEmpty.
- возвращает
trueесли коллекция не содержит элементов,falseв противном случае.
- Определяющие классы
- IterableOnceOps
final def isInstanceOf[T0]: Boolean
Проверяет, является ли динамический тип принимающего объекта T0.
Обратите внимание, что результат теста соответствует семантике стирания Scala. Поэтому выражение 1.isInstanceOf[String] вернет false, а выражение List(1).isInstanceOf[List[String]] вернет true. Во втором примере, поскольку аргумент типа стирается в процессе компиляции, невозможно проверить, соответствует ли содержимое списка указанному типу.
- возвращает
trueесли принимающий объект является экземпляром стирания типаT0;falseв противном случае.
- Определяющие классы
- Any
def isTraversableAgain: Boolean
Проверяет, можно ли многократно пройти по этому итерируемому набору. Всегда истинно для Iterables и ложно для Iterators, если не переопределено.
- returns
trueесли можно многократно пройтись,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def keySet: SortedSet[K]
Собирает все ключи этой карты в множество.
- returns
множество, содержащее все ключи этой карты.
- Definition Classes
- SortedMapOps → SortedMapOps → MapOps → MapOps
def keyStepper[S <: Stepper[_]](implicit shape: StepperShape[K, S]): S
def keys: collection.Iterable[K]
Собирает все ключи этой карты в итерируемый набор.
- returns
ключи этой карты в виде итерируемого объекта.
- Definition Classes
- MapOps
def keysIterator: Iterator[K]
def knownSize: Int
- returns
Количество элементов в этом наборе, если его можно вычислить недорого, -1 в противном случае. Недорого обычно означает: не требует обхода коллекции.
- Definition Classes
- IterableOnce
def last: (K, V)
Выбирает последний элемент.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- returns
Последний элемент этого итерируемого набора.
- Definition Classes
- IterableOps
- Исключения
NoSuchElementExceptionЕсли итерируемый набор пуст.
def lastKey: K
Возвращает последний ключ коллекции.
- Definition Classes
- SortedMapOps → SortedOps
def lastOption: Option[(K, V)]
Возвращает последний элемент, если он есть.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- returns
последний элемент этого итерируемого набора, если он не пустой,
Noneесли он пустой.
- Definition Classes
- IterableOps
def lift: (K) => Option[V]
Преобразует эту частичную функцию в обычную функцию, возвращающую результат.
- returns
функция, которая принимает аргумент
xвSome(this(x)), еслиthisопределена дляx, и вNoneв противном случае.
- Definition Classes
- PartialFunction
- См. также
Function.unlift
def map[K2, V2](f: ((K, V)) => (K2, V2))(implicit ordering: Ordering[K2]): CC[K2, V2]
Создаёт новую отсортированную карту, применяя функцию ко всем элементам этой карты.
- f
функция, применяемая к каждому элементу.
- returns
новая карта, полученная в результате применения заданной функции
fк каждому элементу этой карты и сбора результатов.
- Definition Classes
- StrictOptimizedSortedMapOps → SortedMapOps
def map[K2, V2](f: ((K, V)) => (K2, V2)): Map[K2, V2]
Создаёт новую карту, применяя функцию ко всем элементам этой карты.
- f
функция, применяемая к каждому элементу.
- returns
новая карта, полученная в результате применения заданной функции
fк каждому элементу этой карты и сбора результатов.
- Definition Classes
- StrictOptimizedMapOps → MapOps
def map[B](f: ((K, V)) => B): Iterable[B]
Создаёт новую коллекцию итерируемых элементов, применяя функцию ко всем элементам этой итерируемой коллекции.
- B
тип элементов возвращаемой итерируемой коллекции.
- f
функция, применяемая к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения заданной функции
fк каждому элементу этой итерируемой коллекции и сбора результатов.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только тот итератор, который был возвращён. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
final def mapFromIterable[K2, V2](it: collection.Iterable[(K2, V2)]): Map[K2, V2]
Аналогично fromIterable, но возвращает тип коллекции Map. Обратите внимание, что тип возвращаемого значения теперь CC[K2, V2].
def max[B >: (K, V)](implicit ord: math.Ordering[B]): (K, V)
Находит наибольший элемент.
- B
Тип, для которого определено упорядочение.
- ord
Упорядочение, используемое для сравнения элементов.
- returns
наибольший элемент этой коллекции относительно упорядочения
ord.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxBefore(key: K): Option[(K, V)]
Находит элемент с наибольшим ключом, меньшим заданного ключа.
- key
Заданный ключ.
- returns
None, если такого узла нет.
- Definition Classes
- SortedMapOps
def maxBy[B](f: ((K, V)) => B)(implicit cmp: math.Ordering[B]): (K, V)
Находит первый элемент, который даёт наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Упорядочение, используемое для сравнения элементов.
- returns
первый элемент этой коллекции с наибольшим значением, измеренным функцией f, относительно упорядочения
cmp.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxByOption[B](f: ((K, V)) => B)(implicit cmp: math.Ordering[B]): Option[(K, V)]
Находит первый элемент, который даёт наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, который будет использоваться для сравнения элементов.
- returns
необязательное значение, содержащее первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
def maxOption[B >: (K, V)](implicit ord: math.Ordering[B]): Option[(K, V)]
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, который будет использоваться для сравнения элементов.
- returns
необязательное значение, содержащее наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
def min[B >: (K, V)](implicit ord: math.Ordering[B]): (K, V)
Находит наименьший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, который будет использоваться для сравнения элементов.
- returns
наименьший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def minAfter(key: K): Option[(K, V)]
Найти элемент с наименьшим ключом, большим или равным заданному ключу.
- key
Заданный ключ.
- returns
Noneесли такого узла нет.
- Определяющие классы
- SortedMapOps
def minBy[B](f: ((K, V)) => B)(implicit cmp: math.Ordering[B]): (K, V)
Находит первый элемент, который даёт наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, который будет использоваться для сравнения элементов.
- returns
первый элемент этой коллекции с наименьшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def minByOption[B](f: ((K, V)) => B)(implicit cmp: math.Ordering[B]): Option[(K, V)]
Находит первый элемент, который даёт наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, который будет использоваться для сравнения элементов.
- returns
необязательное значение, содержащее первый элемент этой коллекции с наименьшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
def minOption[B >: (K, V)](implicit ord: math.Ordering[B]): Option[(K, V)]
Находит наименьший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
значение типа Option, содержащее наименьший элемент этого набора в соответствии с порядком
ord.
- Definition Classes
- IterableOnceOps
final def mkString: String
Отображает все элементы этого набора в строке.
Делегирует addString, который можно переопределить.
- returns
строковое представление этого набора. В результирующей строке строковые представления (с помощью метода
toString) всех элементов этого набора следуют друг за другом без разделительной строки.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
final def mkString(sep: String): String
Отображает все элементы этого набора в строке с использованием разделительной строки.
Делегирует addString, который можно переопределить.
- sep
разделительная строка.
- returns
строковое представление этого набора. В результирующей строке строковые представления (с помощью метода
toString) всех элементов этого набора разделены строкойsep.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
List(1, 2, 3).mkString("|") = "1|2|3"
final def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого набора в строку, используя начальную, конечную и разделительные строки.
Делегирует addString, который можно переопределить.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковое представление этого набора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри строковые представления (с помощью методаtoString) всех элементов этого набора разделены строкойsep.
- Definition Classes
- IterableOnceOps
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- returns
trueесли аргумент не является ссылкой на объект-приемник;falseв противном случае.
- Definition Classes
- AnyRef
def nonEmpty: Boolean
Проверяет, не пуст ли набор.
- returns
trueесли набор содержит хотя бы один элемент,falseв противном случае.
- Definition Classes
- IterableOnceOps
- Annotations
- @deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
final def notify(): Unit
Разбуживает одну нить, ожидающую монитора объекта-приемника.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Note
не указано в SLS как член AnyRef
final def notifyAll(): Unit
Разбуживает все нити, ожидающие монитора объекта-приемника.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Note
не указано в SLS как член AnyRef
def orElse[A1 <: K, B1 >: V](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]
Составляет эту частичную функцию с резервной частичной функцией, которая применяется там, где эта частичная функция не определена.
- A1
тип аргумента резервной функции
- B1
тип результата резервной функции
- that
функция резервного копирования
- returns
частичная функция, область определения которой является объединением областей определения этой частичной функции и
that. Результирующая частичная функция принимаетxдоthis(x)там, гдеthisопределена, иthat(x)в противном случае.
- Definition Classes
- PartialFunction
def partition(p: ((K, V)) => Boolean): (C, C)
Пара, состоящая из, во-первых, всех элементов, удовлетворяющих предикату p, и, во-вторых, всех элементов, которые не удовлетворяют ему. Интересно, потому что разделяет коллекцию на две части.
Реализация по умолчанию, представленная здесь, требует два прохода по коллекции. У строгих коллекций есть переопределенная версия partition в StrictOptimizedIterableOps, которая требует только одного прохода.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps
def partitionMap[A1, A2](f: ((K, V)) => Either[A1, A2]): (Iterable[A1], Iterable[A2])
Применяет функцию f к каждому элементу итерируемой коллекции и возвращает пару итерируемых коллекций: первая содержит значения, возвращённые f, которые были обернуты в scala.util.Left, а вторая — значения, обернутые в scala.util.Right.
Пример:
val xs = Iterable(1, "one", 2, "two", 3, "three") partitionMap {
case i: Int => Left(i)
case s: String => Right(s)
}
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип элементов первой результирующей коллекции
- A2
тип элементов второй результирующей коллекции
- f
функция 'разделения', отображающая элементы этой итерируемой коллекции в scala.util.Either
- returns
пара итерируемых коллекций: первая содержит значения, возвращённые
f, которые были обернуты в scala.util.Left, а вторая — значения, обернутые в scala.util.Right.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps
def product[B >: (K, V)](implicit num: math.Numeric[B]): B
Перемножает элементы этой коллекции.
- B
тип результата оператора
*.- num
неявный параметр, определяющий набор арифметических операций, включающий оператор
*, используемый для вычисления произведения.- returns
произведение всех элементов этой коллекции относительно оператора
*вnum.
- Definition Classes
- IterableOnceOps
def range(from: K, until: K): C
Создаёт проекцию диапазона этой коллекции с нижней и верхней границами.
- from
Нижняя граница (включительно) проекции диапазона.
- until
Верхняя граница (исключительно) проекции диапазона.
- Definition Classes
- SortedOps
def rangeFrom(from: K): C
Создаёт проекцию диапазона этой коллекции без верхней границы.
- from
Нижняя граница (включительно) проекции диапазона.
- Definition Classes
- SortedOps
def rangeTo(to: K): C
Создаёт проекцию диапазона этой коллекции без нижней границы.
- to
Верхняя граница (включительно) проекции диапазона.
- Definition Classes
- SortedMapOps → SortedOps
def rangeUntil(until: K): C
Создаёт проекцию диапазона этой коллекции без нижней границы.
- until
Верхняя граница (исключительно) проекции диапазона.
- Definition Classes
- SortedOps
def reduce[B >: (K, V)](op: (B, B) => B): B
Сводит элементы этой коллекции, используя указанный ассоциативный бинарный оператор.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
- B
Типовой параметр для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce
opко всем элементам, если коллекция не пуста.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceLeft[B >: (K, V)](op: (B, (K, V)) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, слева направо:op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)где
x1, ..., xn— элементы этой коллекции.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceLeftOption[B >: (K, V)](op: (B, (K, V)) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этой коллекции, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
необязательное значение, содержащее результат
reduceLeft(op), если эта коллекция не пуста,Noneв противном случае.
- Определяющие классы
- IterableOnceOps
def reduceOption[B >: (K, V)](op: (B, B) => B): Option[B]
Сводит элементы этой коллекции, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
- B
Типовой параметр для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Необязательное значение, содержащее результат применения оператора reduce
opко всем элементам, если коллекция не пуста, иNoneв противном случае.
- Определяющие классы
- IterableOnceOps
def reduceRight[B >: (K, V)](op: ((K, V), B) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn— элементы этой коллекции.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceRightOption[B >: (K, V)](op: ((K, V), B) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого набора, слева направо.
Примечание: не будет завершаться для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение типа Option, содержащее результат
reduceRight(op)если этот набор не пуст,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def removedAll(keys: IterableOnce[K]): C
Создаёт новую неизменяемую карту из этой неизменяемой карты, удаляя все элементы другого набора.
Примечание: Даже при применении к представлению или ленивому набору элементы всегда будут принудительно вычислены.
- keys
набор, содержащий удаляемые элементы.
- returns
новая неизменяемая карта, содержащая все элементы текущей неизменяемой карты, за исключением одного меньшего вхождения каждого элемента из
elems.
- Definition Classes
- MapOps
def reversed: collection.Iterable[(K, V)]
- Attributes
- protected
- Definition Classes
- IterableOnceOps
def runWith[U](action: (V) => U): (K) => Boolean
Компонует эту частичную функцию с функцией действия, которая применяется к результатам этой частичной функции. Функция действия вызывается только для побочных эффектов; её результат игнорируется.
Обратите внимание, что выражение pf.runWith(action)(x) эквивалентно
if(pf isDefinedAt x) { action(pf(x)); true } else false
за исключением того, что runWith реализована через applyOrElse и, следовательно, потенциально более эффективна. Использование runWith избегает двойной оценки совпадений с образцом и условий для литералов частичных функций.
- action
функция действия
- returns
функция, которая отображает аргументы
xвisDefinedAt(x). Результирующая функция выполняетaction(this(x))там, гдеthisопределена.
- Definition Classes
- PartialFunction
- Since
2.10
- See also
applyOrElse.
def scan[B >: (K, V)](z: B)(op: (B, B) => B): Iterable[B]
Вычисляет префиксное сканирование элементов набора.
Примечание: нейтральный элемент z может применяться более одного раза.
- B
тип элементов результирующего набора
- z
нейтральный элемент для оператора
op- op
ассоциативный оператор для сканирования
- returns
новый набор итерируемых элементов, содержащий префиксное сканирование элементов в этом итерируемом наборе
- Definition Classes
- IterableOps
def scanLeft[B](z: B)(op: (B, (K, V)) => B): Iterable[B]
Производит набор итерируемых элементов, содержащий кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не будет завершаться для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- B
тип элементов в результирующем наборе
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
набор с промежуточными результатами
- Definition Classes
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def scanRight[B](z: B)(op: ((K, V), B) => B): Iterable[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Головка коллекции — это последний кумулятивный результат.
Примечание: не будет завершаться для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
Примечание: Даже при применении к представлению или ленивому набору элементы всегда будут принудительно вычислены.
Пример:
List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Definition Classes
- IterableOps
def size: Int
Размер этого набора.
Примечание: не завершится для наборов бесконечного размера.
- returns
количество элементов в этом наборе.
- Definition Classes
- IterableOnceOps
def sizeCompare(that: collection.Iterable[_]): Int
Сравнивает размер этого итерируемого набора с размером другого набора.
- that
набор, размер которого сравнивается с размером этого итерируемого набора.
- returns
-
Значение, где
x < 0 if this.size < that.size x == 0 if this.size == that.size x > 0 if this.size > that.size
Реализация этого метода не вызывает
sizeнапрямую; его время выполнения равноO(this.size min that.size)вместоO(this.size + that.size). Метод следует переопределить, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Definition Classes
- IterableOps
def sizeCompare(otherSize: Int): Int
Сравнивает размер этого итерируемого набора со значением-тестом.
- otherSize
значение-тест, которое сравнивается с размером.
- returns
-
Значение, где
x < 0 if this.size < otherSize x == 0 if this.size == otherSize x > 0 if this.size > otherSize
Реализация этого метода не вызывает
sizeнапрямую; его время выполнения равноO(size min otherSize)вместоO(size). Метод следует переопределить, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Definition Classes
- IterableOps
- See also
final def sizeIs: SizeCompareOps
Возвращает класс значений, содержащий операции для сравнения размера этого итерируемого набора со значением-тестом.
Эти операции реализуются с помощью sizeCompare(Int) и позволяют использовать следующие более удобочитаемые выражения:
this.sizeIs < size // this.sizeCompare(size) < 0 this.sizeIs <= size // this.sizeCompare(size) <= 0 this.sizeIs == size // this.sizeCompare(size) == 0 this.sizeIs != size // this.sizeCompare(size) != 0 this.sizeIs >= size // this.sizeCompare(size) >= 0 this.sizeIs > size // this.sizeCompare(size) > 0
- Definition Classes
- IterableOps
- Annotations
- @inline()
def slice(from: Int, until: Int): C
Выбирает интервал элементов. Возвращаемый итерируемый набор состоит из всех элементов, которые удовлетворяют условию:
from <= indexOf(x) < until
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- from
самый низкий индекс для включения из этого итерируемого набора.
- until
самый низкий индекс для исключения из этого итерируемого набора.
- returns
итерируемый набор, содержащий элементы, большие или равные индексу
from, простираясь до (но не включая) индексuntilэтого итерируемого набора.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
def sliding(size: Int, step: Int): Iterator[C]
Группирует элементы в блоки фиксированного размера, пропуская "скользящее окно" по ним (в отличие от их разбиения, как это делается в grouped.)
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, генерирующий итерируемые наборы размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если оставшихся элементов меньше, чемsizeэлементов.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[C]
Группирует элементы в блоки фиксированного размера, пропуская "скользящее окно" по ним (в отличие от их разбиения, как это делается в grouped.) Шаг "скользящего окна" установлен в единицу.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые наборы размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если оставшихся элементов меньше, чемsizeэлементов.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
final def sortedMapFromIterable[K2, V2](it: collection.Iterable[(K2, V2)])(implicit ordering: Ordering[K2]): CC[K2, V2]
Аналогично mapFromIterable, но возвращает тип коллекции SortedMap. Обратите внимание, что тип возвращаемого значения теперь CC[K2, V2].
- Атрибуты
- protected
- Определяющие классы
- SortedMapOps
- Аннотации
- @inline()
def span(p: ((K, V)) => Boolean): (C, C)
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.
Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.
- p
предикат проверки
- возвращает
пара, состоящая из самого длинного префикса этой итерируемой коллекции, элементы которого удовлетворяют
p, и оставшаяся часть этой итерируемой коллекции.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def splitAt(n: Int): (C, C)
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.
- n
позиция разделения.
- возвращает
пара итерируемых коллекций, состоящая из первых
nэлементов этой итерируемой коллекции и других элементов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def stepper[S <: Stepper[_]](implicit shape: StepperShape[(K, V), S]): S
Возвращает Stepper для элементов этой коллекции.
Stepper позволяет создавать Java поток для работы с коллекцией, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться как итератор, который не упаковывает элементы.
Неявный параметр StepperShape определяет тип возвращаемого Stepper в соответствии с типом элемента этой коллекции.
-
Для коллекций
Int, Short, Byte или Char, возвращается IntStepperДля коллекций Double или Float, возвращается DoubleStepperДля коллекций Long возвращается LongStepperДля любого другого типа элемента возвращается AnyStepperОбратите внимание, что этот метод переопределен в подклассах, и тип возвращаемого значения уточняется до S with EfficientSplit, например, IndexedSeqOps.stepper. Для Stepper, помеченного как scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Stepper можно преобразовать только в последовательные потоки.
- Определяющие классы
- IterableOnce
final def strictOptimizedCollect[B, C2](b: Builder[B, C2], pf: PartialFunction[(K, V), B]): C2
- B
Тип элементов результирующей коллекции (например,
String)- C2
Тип результирующей коллекции (например,
List[String])- b
Библиотека для построения результирующей коллекции
- pf
Частичная функция преобразования элемента
- возвращает
Результат коллекции
- Атрибуты
- protected[this]
- Определяющие классы
- StrictOptimizedIterableOps
- Аннотации
- @inline()
final def strictOptimizedConcat[B >: (K, V), C2](that: IterableOnce[B], b: Builder[B, C2]): C2
- B
Тип элементов результирующих коллекций (например,
Int)- C2
Тип результирующей коллекции (например,
List[Int])- that
Элементы для конкатенации с этой коллекцией
- b
Би́лдер для построения результирующей коллекции
- returns
Результирующая коллекция
- Attributes
- protected[this]
- Definition Classes
- StrictOptimizedIterableOps
- Annotations
- @inline()
final def strictOptimizedFlatMap[B, C2](b: Builder[B, C2], f: ((K, V)) => IterableOnce[B]): C2
- B
Тип элементов результирующей коллекции (например,
String)- C2
Тип результирующей коллекции (например,
List[String])- b
Би́лдер для построения результирующей коллекции
- f
Функция трансформации элемента
- returns
Результирующая коллекция
- Attributes
- protected[this]
- Definition Classes
- StrictOptimizedIterableOps
- Annotations
- @inline()
final def strictOptimizedFlatten[B, C2](b: Builder[B, C2])(implicit toIterableOnce: ((K, V)) => IterableOnce[B]): C2
- B
Тип элементов результирующей коллекции (например,
Int)- C2
Тип результирующей коллекции (например,
List[Int])- b
Би́лдер для построения результирующей коллекции
- toIterableOnce
Доказательство, что
Aможет быть представлен какIterableOnce[B]- returns
Результирующая коллекция
- Attributes
- protected[this]
- Definition Classes
- StrictOptimizedIterableOps
- Annotations
- @inline()
final def strictOptimizedMap[B, C2](b: Builder[B, C2], f: ((K, V)) => B): C2
- B
Тип элементов результирующей коллекции (например,
String)- C2
Тип результирующей коллекции (например,
List[String])- b
Би́лдер для построения результирующей коллекции
- f
Функция трансформации элемента
- returns
Результирующая коллекция
- Attributes
- protected[this]
- Definition Classes
- StrictOptimizedIterableOps
- Annotations
- @inline()
final def strictOptimizedZip[B, C2](that: IterableOnce[B], b: Builder[((K, V), B), C2]): C2
- B
Тип элементов второй коллекции (например,
String)- C2
Тип результирующей коллекции (например,
List[(Int, String)])- that
Коллекция для зи́ппирования с этой коллекцией
- b
Би́лдер для построения результирующей коллекции
- returns
Результирующая коллекция
- Attributes
- protected[this]
- Definition Classes
- StrictOptimizedIterableOps
- Annotations
- @inline()
def sum[B >: (K, V)](implicit num: math.Numeric[B]): B
Суммирует элементы этого набора.
- B
тип результата оператора
+.- num
явный параметр, определяющий набор числовых операций, который включает оператор
+, используемый для формирования суммы.- returns
сумма всех элементов этого набора по отношению к оператору
+вnum.
- Definition Classes
- IterableOnceOps
final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
def tail: C
Остальная часть коллекции без первого элемента.
- Definition Classes
- IterableOps
def tails: Iterator[C]
Итерируется по хвостам этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, при этом промежуточные значения будут результатом последовательных применений tail.
- returns
итератор по всем хвостам этой итерируемой коллекции
- Definition Classes
- IterableOps
List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)
def take(n: Int): C
Выбирает первые n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
количество элементов для взятия из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая только первые
nэлементов этой итерируемой коллекции, или вся итерируемая коллекция, если она содержит меньшеnэлементов. Еслиnотрицательное, возвращает пустую итерируемую коллекцию.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только тот итератор, который был возвращен. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def takeRight(n: Int): C
Коллекция, содержащая последние n элементов этой коллекции.
Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно форсировать элементы.
- n
количество элементов для взятия из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая только последние
nэлементов этой итерируемой коллекции, или вся итерируемая коллекция, если она содержит меньшеnэлементов. Еслиnотрицательное, возвращает пустую итерируемую коллекцию.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps
def takeWhile(p: ((K, V)) => Boolean): C
Берет наибольший префикс элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
Предикат, используемый для проверки элементов.
- returns
наибольший префикс этой итерируемой коллекции, элементы которого удовлетворяют предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
def tapEach[U](f: ((K, V)) => U): C
Применяет функцию побочного эффекта к каждому элементу в этой коллекции. Строгие коллекции немедленно применят f к своим элементам, в то время как ленивые коллекции, такие как представления и LazyLists, будут применять f к каждому элементу только при его вычислении и каждый раз при его вычислении.
- U
тип возвращаемого значения f
- f
функция, которая применяется к каждому элементу в этой итерируемой коллекции
- returns
Такая же логическая коллекция, как и эта
- Definition Classes
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
def to[C1](factory: Factory[(K, V), C1]): C1
При заданном фабрике коллекции factory, преобразуйте эту коллекцию в соответствующее представление для текущего типа элемента A. Примеры использования:
xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]
- Определяющие классы
- IterableOnceOps
def toArray[B >: (K, V)](implicit arg0: ClassTag[B]): Array[B]
Преобразовать коллекцию в массив.
- Определяющие классы
- IterableOnceOps
final def toBuffer[B >: (K, V)]: Buffer[B]
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
def toIndexedSeq: IndexedSeq[(K, V)]
- Определяющие классы
- IterableOnceOps
def toList: List[(K, V)]
- Определяющие классы
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[(K, V), (K, V)]): Map[K, V]
- Определяющие классы
- IterableOnceOps
def toSeq: Seq[(K, V)]
- возвращает
Эта коллекция в виде
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Определяющие классы
- IterableOnceOps
def toSet[B >: (K, V)]: Set[B]
- Определяющие классы
- IterableOnceOps
def toString(): String
Создаёт строковое представление этого объекта. Стандартное представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.
- возвращает
строковое представление объекта.
def toVector: Vector[(K, V)]
- Определяющие классы
- IterableOnceOps
def transform[W](f: (K, V) => W): CC[K, W]
Эта функция преобразует все значения отображений, содержащихся в этом отображении, с помощью функции f.
- f
Функция над ключами и значениями
- возвращает
обновлённое отображение
- Определяющие классы
- SortedMapOps → MapOps
def transpose[B](implicit asIterable: ((K, V)) => collection.Iterable[B]): Iterable[Iterable[B]]
Транспонирует этот итерируемый набор итерируемых наборов в итерируемый набор итерируемых наборов.
Тип результирующего набора будет определяться статическим типом итерируемого набора. Например:
val xs = List(
Set(1, 2, 3),
Set(4, 5, 6)).transpose
// xs == List(
// List(1, 4),
// List(2, 5),
// List(3, 6))
val ys = Vector(
List(1, 2, 3),
List(4, 5, 6)).transpose
// ys == Vector(
// Vector(1, 4),
// Vector(2, 5),
// Vector(3, 6))
Примечание: Даже при применении к представлению или ленивому набору, элементы всегда будут принудительно вычислены.
- B
тип элементов каждого итерируемого набора.
- asIterable
явное преобразование, которое утверждает, что тип элементов этого итерируемого набора является
Iterable.- returns
двумерный итерируемый набор итерируемых наборов, в котором n-я строка содержит n-й столбец этого итерируемого набора.
- Классы определений
- IterableOps
- Исключения
IllegalArgumentException, если все наборы в этом итерируемом наборе не имеют одинаковый размер.
def unapply(a: K): Option[V]
Попытка извлечь B из A в выражении сопоставления с образцом.
- Классы определений
- PartialFunction
def unlift: PartialFunction[K, B]
Преобразует необязательную функцию в частичную функцию.
- Неявный
- Этот член добавлен неявным преобразованием из StrictOptimizedSortedMapOps[K, V, CC, C] в UnliftOps[K, B], выполненное методом UnliftOps в scala.Function1. Это преобразование будет выполнено только в том случае, если V является подклассом Option[B] (V <: Option[B]).
- Классы определений
- UnliftOps
В отличие от Function.unlift, этот метод UnliftOps.unlift может использоваться в экстракторах.
val of: Int => Option[String] = { i =>
if (i == 2) {
Some("matched by an optional function")
} else {
None
}
}
util.Random.nextInt(4) match {
case of.unlift(m) => // Convert an optional function to a pattern
println(m)
case _ =>
println("Not matched")
}
def unzip[A1, A2](implicit asPair: ((K, V)) => (A1, A2)): (Iterable[A1], Iterable[A2])
Преобразует этот итерируемый набор пар в два набора первой и второй половины каждой пары.
val xs = Iterable(
(1, "one"),
(2, "two"),
(3, "three")).unzip
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип первой половины пар элементов
- A2
тип второй половины пар элементов
- asPair
явное преобразование, которое утверждает, что тип элементов этого итерируемого набора является парой.
- returns
пара итерируемых наборов, содержащая первую и, соответственно, вторую половину каждой пары элементов этого итерируемого набора.
- Классы определений
- StrictOptimizedIterableOps → IterableOps
def unzip3[A1, A2, A3](implicit asTriple: ((K, V)) => (A1, A2, A3)): (Iterable[A1], Iterable[A2], Iterable[A3])
Преобразует этот итерируемый набор троек в три набора первого, второго и третьего элемента каждой тройки.
val xs = Iterable(
(1, "one", '1'),
(2, "two", '2'),
(3, "three", '3')).unzip3
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three),
// Iterable(1, 2, 3))
- A1
тип первого члена троек элементов
- A2
тип второго члена троек элементов
- A3
тип третьего члена троек элементов
- asTriple
явное преобразование, которое утверждает, что тип элементов этого итерируемого набора является тройкой.
- returns
тройка итерируемых наборов, содержащая первый, второй, соответственно третий элемент каждой тройки элементов этого итерируемого набора.
- Классы определений
- StrictOptimizedIterableOps → IterableOps
def updatedWith[V1 >: V](key: K)(remappingFunction: (Option[V]) => Option[V1]): CC[K, V1]
Обновить отображение для указанного ключа и его текущего, необязательно сопоставленного значения (Some если есть текущее отображение, None если нет).
Если функция переназначения возвращает Some(v), отображение обновляется с новым значением v. Если функция переназначения возвращает None, отображение удаляется (или остается отсутствующим, если изначально отсутствовало). Если сама функция вызывает исключение, исключение перебрасывается, а текущее отображение остается без изменений.
- key
значение ключа
- remappingFunction
частичная функция, которая получает текущее необязательно сопоставленное значение и возвращает новое отображение
- returns
Новая карта с обновленным отображением с ключом
- Definition Classes
- SortedMapOps → MapOps
- Since
2.13.0
def valueStepper[S <: Stepper[_]](implicit shape: StepperShape[V, S]): S
def values: collection.Iterable[V]
Собирает все значения этой карты в итерируемое множество.
- returns
значения этой карты в виде итерируемого объекта.
- Definition Classes
- MapOps
def valuesIterator: Iterator[V]
Создает итератор для всех значений в этой карте.
- returns
итератор по всем значениям, связанным с некоторым ключом в этой карте.
- Definition Classes
- MapOps
def valuesIteratorFrom(start: K): Iterator[V]
Создает итератор по всем значениям, содержащимся в этой карте, которые связаны с ключом, большим или равным start в соответствии с порядком этой карты. x.valuesIteratorFrom(y) эквивалентно, но часто эффективнее, чем x.from(y).valuesIterator.
- start
Нижняя граница (включительно) ключей, которые будут возвращены
- Definition Classes
- SortedMapOps
def view: MapView[K, V]
Вид на элементы этого набора.
- Definition Classes
- MapOps → IterableOps
final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long): Unit
def withFilter(p: ((K, V)) => Boolean): WithFilter[(K, V), [_]Iterable[_]]
Создает нестрогий фильтр этого итерируемого набора.
Примечание: разница между c filter p и c withFilter p заключается в том, что первый создает новый набор, а второй только ограничивает область действия последующих map, flatMap, foreach, и withFilter операций.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
объект класса
WithFilter, который поддерживаетmap,flatMap,foreach, иwithFilterопераций. Все эти операции применяются к тем элементам этого итерируемого набора, которые удовлетворяют предикатуp.
- Definition Classes
- IterableOps
def zip[B](that: IterableOnce[B]): Iterable[((K, V), B)]
Возвращает итерируемую коллекцию, сформированную из этой итерируемой коллекции и другой итерируемой коллекции, объединяя соответствующие элементы парами. Если одна из двух коллекций длиннее другой, ее оставшиеся элементы игнорируются.
- B
тип второй половины возвращаемых пар
- that
Итерируемая коллекция, предоставляющая вторую половину каждой пары результата
- returns
новая итерируемая коллекция, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции и
that. Длина возвращаемой коллекции — минимальное из длин этой итерируемой коллекции иthat.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps
def zipAll[A1 >: (K, V), B](that: collection.Iterable[B], thisElem: A1, thatElem: B): Iterable[(A1, B)]
Возвращает итерируемую коллекцию, сформированную из этой итерируемой коллекции и другой итерируемой коллекции, объединяя соответствующие элементы парами. Если одна из двух коллекций короче другой, используются заполнители для расширения более короткой коллекции до длины более длинной.
- that
итерируемая коллекция, предоставляющая вторую половину каждой пары результата
- thisElem
элемент, используемый для заполнения результата, если эта итерируемая коллекция короче, чем
that.- thatElem
элемент, используемый для заполнения результата, если
thatкороче, чем эта итерируемая коллекция.- returns
новая коллекция типа
That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции иthat. Длина возвращаемой коллекции — максимальное из длин этой итерируемой коллекции иthat. Если эта итерируемая коллекция короче, чемthat, значенияthisElemиспользуются для заполнения результата. Еслиthatкороче, чем эта итерируемая коллекция, значенияthatElemиспользуются для заполнения результата.
- Definition Classes
- IterableOps
def zipWithIndex: Iterable[((K, V), Int)]
Объединяет эту итерируемую коллекцию с ее индексами.
- returns
Новая итерируемая коллекция, содержащая пары, состоящие из всех элементов этой итерируемой коллекции, спаренных с их индексом. Индексы начинаются с
0.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))
Затененные неявные члены значения
def +(other: String): String
- Неявный
- Этот член добавлен неявным преобразованием из StrictOptimizedSortedMapOps[K, V, CC, C] вany2stringadd[StrictOptimizedSortedMapOps[K, V, CC, C]] выполненный методом any2stringadd в scala.Predef.
- Затенение
- Этот неявный унаследованный член затеняется одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать явное указание типа:(strictOptimizedSortedMapOps: any2stringadd[StrictOptimizedSortedMapOps[K, V, CC, C]]).+(other)
- Definition Classes
- any2stringadd
© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/collection/immutable/StrictOptimizedSortedMapOps.html