Трейт scala.collection.SortedMapFactoryDefaults
trait SortedMapFactoryDefaults[K, +V, +CC[x, y] <: Map[x, y] with SortedMapOps[x, y, CC, CC[x, y]] with UnsortedCC[x, y], +WithFilterCC[x] <: IterableOps[x, WithFilterCC, WithFilterCC[x]] with Iterable[x], +UnsortedCC[x, y] <: Map[x, y]] extends SortedMapOps[K, V, CC, CC[K, V]] with MapOps[K, V, UnsortedCC, CC[K, V]]
Члены типов
интерфейс GenKeySet extends AnyRef
Обобщённый интерфейс, используемый реализациями набора ключей
- Атрибуты
- protected
- Определяющие классы
- MapOps
класс KeySet extends AbstractSet[K] with GenKeySet with DefaultSerializable
Реализующий класс набора, возвращаемого методом keySet.
- Атрибуты
- protected
- Определяющие классы
- MapOps
интерфейс GenKeySortedSet extends GenKeySet
Обобщённый интерфейс, используемый реализациями упорядоченного набора ключей
- Атрибуты
- protected
- Определяющие классы
- SortedMapOps
класс KeySortedSet extends SortedSet[K] with GenKeySet with GenKeySortedSet
Реализующий класс набора, возвращаемого методом keySet
- Атрибуты
- protected
- Определяющие классы
- SortedMapOps
Члены-значения абстрактного типа
abstract def coll: CC[K, V @scala.annotation.unchecked.uncheckedVariance]
- возвращает
Это коллекция в виде
C.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
abstract def get(key: K): Option[V]
Возвращает значение, связанное с ключом.
- key
значение ключа
- возвращает
объект Option, содержащий значение, связанное с
keyв этом словаре, илиNone, если такового нет.
- Определяющие классы
- MapOps
abstract def iterableFactory: IterableFactory[[_]WithFilterCC[_]]
Объект-компаньон этой итерируемой коллекции, предоставляющий различные методы фабрики.
- Определяющие классы
- 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[[_, _]UnsortedCC[_, _]]
Объект-компаньон этого словаря, предоставляющий различные методы фабрики.
- Определяющие классы
- MapOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы он возвращал фабрику для нового типа (в противном случае компилятор выдаст ошибку).
abstract def ordering: Ordering[K]
- Определяющие классы
- SortedOps
abstract def rangeImpl(from: Option[K], until: Option[K]): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Создаёт проекцию по диапазону этой коллекции. Любые изменения в проекции по диапазону будут обновлять эту коллекцию и наоборот.
Примечание: ключи не гарантируются как согласованные между этой коллекцией и проекцией. Это относится к буферам, где индексация относительна к проекции.
- from
Нижняя граница (включительно) диапазона проекции.
None, если нижней границы нет.- until
Верхняя граница (исключительно) диапазона проекции.
None, если верхней границы нет.
- Определяющие классы
- SortedOps
abstract def sortedMapFactory: SortedMapFactory[CC]
Объект-компаньон этого отсортированного словаря, предоставляющий различные методы фабрики.
- Определяющие классы
- SortedMapOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы он возвращал фабрику для нового типа (в противном случае компилятор выдаст ошибку).
abstract def toIterable: Iterable[(K, V)]
- возвращает
Это коллекция в качестве
Iterable[A]. Новая коллекция не будет создана, еслиthisуже являетсяIterable[A].
- Определяющие классы
- IterableOps
абстрактный def unsorted: Map[K, V]
- Определяющие классы
- SortedMapOps
Члены конкретных значений
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), иначе false.
- Definition Classes
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode, за исключением упакованных числовых типов и null. Для числовых типов возвращает значение хэша, согласованное с равенством значений: если две инстанции типа значения сравниваются как true, то ## вернёт одно и то же значение хэша для каждой из них. Для null возвращает хэш-код, где null.hashCode выбрасывает NullPointerException.
- returns
значение хэша, согласованное с ==
- Definition Classes
- AnyRef → Any
final def ++[V2 >: V](xs: IterableOnce[(K, V2)]): CC[K, V2]
Псевдоним для concat
- Definition Classes
- SortedMapOps → MapOps
- Annotations
- @inline()
final def ++[B >: (K, V)](suffix: IterableOnce[B]): WithFilterCC[B]
Псевдоним для concat
- Definition Classes
- IterableOps
- Annotations
- @inline()
def ->[B](y: B): (SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC], B)
- Неявный
- Этот член добавлен неявным преобразованием из SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC] в ArrowAssoc[SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]] с помощью метода ArrowAssoc в scala.Predef.Это преобразование произойдёт только если V является подклассом Option[Nothing] (V <: Option[Nothing]).
- Definition Classes
- ArrowAssoc
- Annotations
- @inline()
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- returns
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Definition Classes
- AnyRef → Any
def addString(sb: mutable.StringBuilder, start: String, sep: String, end: String): mutable.StringBuilder
Добавляет все элементы этого словаря в строку-построитель, используя начальную, конечную и разделительные строки. Текст, который будет записан, начинается со строки 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
конечная строка.
- returns
строка-построитель
b, в которую были добавлены элементы.
- Definition Classes
- 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
строковый билдер, к которому добавляются элементы.
- returns
строковый билдер
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
разделительная строка.
- returns
строковый билдер
b, к которому были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
def andThen[C](k: PartialFunction[V, C]): PartialFunction[K, C]
Компонует эту частичную функцию с другой частичной функцией, которая применяется к результатам этой частичной функции.
Обратите внимание, что вызов isDefinedAt для результирующей частичной функции может применить первую частичную функцию и выполнить её побочный эффект. Настоятельно рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, суженной другой частичной функцией, которая отображает аргументы
xнаk(this(x)).
- Определяющие классы
- PartialFunction
def andThen[C](k: (V) => C): PartialFunction[K, C]
Компонует эту частичную функцию с функцией преобразования, которая применяется к результатам этой частичной функции.
Если тип функции во время выполнения является PartialFunction, то используется другой метод andThen (обратите внимание на его предостережения).
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, возможно, суженной указанной функцией, которая отображает аргументы
xнаk(this(x)).
- Определяющие классы
- 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, которая избегает двойной оценки согласующих шаблонов и охранников. Это делает applyOrElse основой для эффективной реализации многих операций и сценариев, таких как:
-
объединение частичных функций в цепочки
orElse/andThen не приводит к чрезмерной оценке apply/isDefinedAt
lift и unlift не оценивают исходные функции дважды при каждом вызове
runWith позволяет эффективное императивное объединение частичных функций с условно применяемыми действиями Для нелитеральных классов частичных функций с нетривиальным методом isDefinedAt рекомендуется переопределить applyOrElse с помощью пользовательской реализации, которая избегает двойной оценки isDefinedAt. Это может привести к лучшей производительности и более предсказуемому поведению в отношении побочных эффектов.
- x
аргумент функции
- default
резервная функция
- returns
результат применения этой функции или резервной функции.
- Определяющие классы
- MapOps → PartialFunction
- С версии
2.10
final def asInstanceOf[T0]: T0
Привести получаемый объект к типу T0.
Обратите внимание, что успешность приведения типов во время выполнения зависит от семантики стирания типов Scala. Поэтому выражение 1.asInstanceOf[String] вызовет исключение ClassCastException во время выполнения, а выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере, поскольку аргумент типа стирается во время компиляции, невозможно проверить, соответствуют ли содержимое списка требуемому типу.
- returns
получаемый объект.
- Определяющие классы
- Any
- Выбрасываемые исключения
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к каждому элементу, на котором она определена, и сбора результатов. Порядок элементов сохраняется.
- Определяющие классы
- SortedMapOps
def collect[K2, V2](pf: PartialFunction[(K, V), (K2, V2)]): UnsortedCC[K2, V2]
Создает новую коллекцию, применяя частичную функцию ко всем элементам этой карты, на которых функция определена.
- K2
тип ключа возвращаемой карты.
- V2
тип значения возвращаемой карты.
- pf
частичная функция, которая фильтрует и отображает карту.
- returns
новая карта, полученная в результате применения данной частичной функции
pfк каждому элементу, на котором она определена, и сбора результатов. Порядок элементов сохраняется.
- Определяющие классы
- MapOps
def collect[B](pf: PartialFunction[(K, V), B]): WithFilterCC[B]
Создает новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, на которых функция определена.
- B
тип элемента возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- returns
новая итерируемая коллекция, полученная в результате применения данной частичной функции
pfк каждому элементу, на котором она определена, и сбора результатов. Порядок элементов сохраняется.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def collectFirst[B](pf: PartialFunction[(K, V), B]): Option[B]
Находит первый элемент коллекции, для которого определена данная частичная функция, и применяет к нему частичную функцию.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- pf
частичная функция
- returns
необязательное значение, содержащее pf, примененное к первому значению, для которого оно определено, или
None, если такового не существует.
- Определяющие классы
- IterableOnceOps
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def compose[R](k: PartialFunction[R, K]): PartialFunction[R, V]
Компонует другую частичную функцию k с этой частичной функцией так, чтобы эта частичная функция применялась к результатам k.
Обратите внимание, что вызов isDefinedAt для результирующей частичной функции может применить первую частичную функцию и выполнить ее побочный эффект. Настоятельно рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- R
тип параметра функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения другой частичной функции, суженной этой частичной функцией, которая отображает аргументы
xнаthis(k(x)).
- Определяющие классы
- PartialFunction
def compose[A](g: (A) => K): (A) => V
Компонует два экземпляра Function1 в новый Function1, при этом эта функция применяется последней.
- A
тип, к которому можно применить функцию
g- g
функция A => T1
- returns
новая функция
fтакая, чтоf(x) == apply(g(x))
- Определяющие классы
- Function1
- Аннотации
- @unspecialized()
def concat[V2 >: V](suffix: IterableOnce[(K, V2)]): CC[K, V2]
Возвращает новую карту, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента карты является наиболее специфическим суперклассом, охватывающим типы элементов двух операндов.
- suffix
объект IterableOnce для добавления.
- returns
новая карта, которая содержит все элементы этой карты, за которыми следуют все элементы
suffix.
- Определяющие классы
- SortedMapOps → MapOps
def concat[B >: (K, V)](suffix: IterableOnce[B]): WithFilterCC[B]
Возвращает новую итерируемую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента итерируемой коллекции является наиболее специфическим суперклассом, охватывающим типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
объект IterableOnce для добавления.
- returns
новая итерируемая коллекция, которая содержит все элементы этой итерируемой коллекции, за которыми следуют все элементы
suffix.
- Определяющие классы
- IterableOps
def contains(key: K): Boolean
Проверяет, содержит ли эта карта привязку для ключа.
- key
ключ
- returns
true, если в этой карте есть привязка дляkey,falseв противном случае.
- Определяющие классы
- 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
предикат проверки, который связывает элементы обеих коллекций
- returns
true, если обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иyитератораthat, иначеfalse
- Definition Classes
- IterableOnceOps
def count(p: ((K, V)) => Boolean): Int
Подсчитывает количество элементов в коллекции, которые удовлетворяют предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- IterableOnceOps
def default(key: K): V
Определяет вычисление значения по умолчанию для карты, возвращаемое при отсутствии ключа. Реализованный здесь метод выбрасывает исключение, но может быть переопределен в подклассах.
- key
значение ключа, для которого отсутствует привязка.
def drop(n: Int): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Выбирает все элементы, кроме первых n.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
количество элементов, которые нужно удалить из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, кроме первых
nэлементов, или пустой итерируемой коллекции, если в этой итерируемой коллекции меньше чемnэлементов. Еслиnотрицательное, не удалять никаких элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def dropRight(n: Int): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Выбирает все элементы, кроме последних n.
Примечание: результаты могут отличаться при разных запусках, если тип базового набора не упорядочен.
- n
количество элементов для удаления из этого итерируемого набора.
- returns
итерируемый набор, состоящий из всех элементов этого итерируемого набора, кроме последних
nэлементов, или же пустой итерируемый набор, если этот итерируемый набор содержит меньше, чемnэлементов. Еслиnотрицательно, элементы не удаляются.
- Definition Classes
- IterableOps
def dropWhile(p: ((K, V)) => Boolean): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Удаляет самую длинную префиксную последовательность элементов, удовлетворяющих предикату.
Примечание: результаты могут отличаться при разных запусках, если тип базового набора не упорядочен.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный суффикс этого итерируемого набора, первый элемент которого не удовлетворяет предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода итератор, на котором был вызван метод, следует отбросить и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться и может привести к изменениям в новом итераторе тоже.
def elementWise: ElementWiseExtractor[K, V]
Возвращает объект-экстрактор с методом unapplySeq, который извлекает каждый элемент данных последовательности.
- Definition Classes
- 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: CC[K, V]
Пустой итерируемый набор того же типа, что и этот итерируемый набор
- returns
пустой итерируемый набор типа
C.
- Definition Classes
- SortedMapFactoryDefaults → IterableOps
def ensuring(cond: (SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]) => Boolean, msg: => Any): SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]
- Неявный
- Этот член добавлен неявным преобразованием из SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC] в Ensuring[SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]) => Boolean): SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]
- Неявный
- Этот член добавляется неявным преобразованием из SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC] в Ensuring[SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean, msg: => Any): SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]
- Неявный
- Этот член добавляется неявным преобразованием из SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC] в Ensuring[SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]
- Неявный
- Этот член добавляется неявным преобразованием из SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC] в Ensuring[SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности для не-нулевых экземпляров AnyRef и имеет три дополнительных свойства:
-
Он согласован: для любых не-нулевых экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого не-нулевого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false.
null.eq(null) возвращает true.При переопределении методов equals или hashCode важно обеспечить соответствие их поведения равенству ссылок. Таким образом, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковые значения хеша (o1.hashCode == o2.hashCode).
- returns
true, если аргумент является ссылкой на объект-получатель;falseв противном случае.
- Определяющие классы
- AnyRef
def equals(arg0: AnyRef): Boolean
Метод равенства для ссылочных типов. Реализация по умолчанию делегирует вызов eq.
См. также equals в scala.Any.
- returns
true, если объект-получатель эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
def exists(p: ((K, V)) => Boolean): Boolean
Проверяет, выполняется ли предикат хотя бы для одного элемента этого набора.
Примечание: может не завершиться для наборов бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
true, если заданный предикатpвыполняется хотя бы для одного элемента этого набора, в противном случаеfalse
- Definition Classes
- IterableOnceOps
def filter(pred: ((K, V)) => Boolean): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Выбирает все элементы этого итерируемого набора, удовлетворяющие предикату.
- returns
новый итератор, состоящий из всех элементов этого итерируемого набора, удовлетворяющих заданному предикату
p. Порядок элементов сохраняется.
- Definition Classes
- IterableOps → IterableOnceOps
def filterNot(pred: ((K, V)) => Boolean): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Выбирает все элементы этого итерируемого набора, которые не удовлетворяют предикату.
- pred
предикат, используемый для проверки элементов.
- returns
новый итерируемый набор, состоящий из всех элементов этого итерируемого набора, которые не удовлетворяют заданному предикату
pred. Их порядок может быть не сохранён.
- Definition Classes
- IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора для объекта получателя, когда к объекту больше нет ссылок.
Подробности о том, когда и будет ли вызываться метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.
def find(p: ((K, V)) => Boolean): Option[(K, V)]
Находит первый элемент набора, удовлетворяющий предикату, если таковой имеется.
Примечание: может не завершиться для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
значение option, содержащее первый элемент в наборе, удовлетворяющий
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
- SortedMapOps
def flatMap[K2, V2](f: ((K, V)) => IterableOnce[(K2, V2)]): UnsortedCC[K2, V2]
Создаёт новый набор, применяя функцию ко всем элементам этого набора и используя элементы полученных коллекций.
- f
функция, применяемая к каждому элементу.
- returns
новый набор, полученный путём применения заданной функции, принимающей значение коллекции
fк каждому элементу этого набора и конкатенации результатов.
- Definition Classes
- MapOps
def flatMap[B](f: ((K, V)) => IterableOnce[B]): WithFilterCC[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к каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def flatten[B](implicit asIterable: ((K, V)) => IterableOnce[B]): WithFilterCC[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
тип элементов каждой итерируемой коллекции.
- asIterable
неявное преобразование, которое утверждает, что тип элемента этой итерируемой коллекции является
GenTraversable.- returns
новая итерируемая коллекция, полученная в результате конкатенации всех итерируемых коллекций элементов.
- Определяющие классы
- 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
предикат, используемый для проверки элементов.
- возвращает
true, если этот набор пуст или заданный предикатpвыполняется для всех элементов этого набора, в противном случаеfalse.
- Definition Classes
- IterableOnceOps
def foreach[U](f: ((K, V)) => U): Unit
Применяет f к каждому элементу для побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типов scalac.
- Definition Classes
- IterableOnceOps
def foreachEntry[U](f: (K, V) => U): Unit
Применяет f к каждой паре ключ/значение для побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типов scalac.
- Definition Classes
- MapOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой формата. Строки формата такие же, как для String.format (@see java.lang.String.format).
- Неявный
- Этот член добавляется неявным преобразованием из SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC] в StringFormat[SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]] , выполненное методом StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
def fromSpecific(coll: IterableOnce[(K, V)]): CC[K, V]
Определяет, как преобразовать заданный Iterable[A] в набор типа C.
Этот процесс может быть выполнен строго или нестрого (т.е. без оценки элементов результирующих наборов). Другими словами, этот метод определяет модель оценки набора.
- Атрибуты
- protected
- Definition Classes
- SortedMapFactoryDefaults → IterableOps
- Примечание
-
При реализации пользовательского типа набора и уточнении
,Cдо нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, смешав в себе тракт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть некорректным. Однако, до тех пор, пока он вызывается сIterable[A], полученным изthisнабора (как это происходит в реализациях операций, где мы используемView[A]), это безопасно.
final def getClass(): Class[_ <: AnyRef]
Возвращает представление класса объекта во время выполнения.
- возвращает
объект класса, соответствующий типу получателя во время выполнения.
def getOrElse[V1 >: V](key: K, default: => V1): V1
Возвращает значение, связанное с ключом, или значение по умолчанию, если ключ не содержится в карте.
- V1
тип результата вычисления по умолчанию.
- key
ключ.
- default
вычисление, которое возвращает значение по умолчанию в случае, если в карте нет привязки к
key.- возвращает
значение, связанное с
key, если оно существует, иначе результатdefaultвычисления.
- Definition Classes
- MapOps
def groupBy[K](f: ((K, V)) => K): immutable.Map[K, CC[K, V @scala.annotation.unchecked.uncheckedVariance]]
Разбивает эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с некоторой функцией дискриминатора.
Примечание: даже при применении к представлению или ленивой коллекции, это всегда будет приводить к вычислению элементов.
- K
тип ключей, возвращаемых функцией дискриминатора.
- f
функция дискриминатора.
- returns
-
Карта из ключей в итерируемые коллекции, для которой выполняется следующее инвариантное условие:
(xs groupBy f)(k) = xs filter (x => f(x) == k)
То есть, каждый ключ
kсвязан с итерируемой коллекцией тех элементовx, для которыхf(x)равноk.
- Определяющие классы
- IterableOps
def groupMap[K, B](key: ((K, V)) => K)(f: ((K, V)) => B): immutable.Map[K, WithFilterCC[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
функция преобразования элементов
- Определяющие классы
- IterableOps
def groupMapReduce[K, B](key: ((K, V)) => K)(f: ((K, V)) => B)(reduce: (B, B) => B): immutable.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[CC[K, V @scala.annotation.unchecked.uncheckedVariance]]
Разбивает элементы на итерируемые коллекции фиксированного размера.
- size
количество элементов в группе
- returns
Итератор, создающий итерируемые коллекции размером
size, за исключением последней, которая будет меньше sizesize, если элементы не делятся нацело.
- Определяющие классы
- IterableOps
- См. также
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- returns
хеш-код для этого объекта.
def head: (K, V)
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции.
- Определяющие классы
- IterableOps
- Выбрасываемые исключения
NoSuchElementExceptionесли итерируемая коллекция пуста.
def headOption: Option[(K, V)]
Необязательно выбирает первый элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции, если она не пуста,
None, если она пуста.
- Определяющие классы
- IterableOps
def init: CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Начальная часть коллекции без последнего элемента.
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычислены.
- Классы определения
- IterableOps
def inits: Iterator[CC[K, V @scala.annotation.unchecked.uncheckedVariance]]
Итерирует по начальным частям этой коллекции. Первое значение будет этой коллекцией, а последнее — пустой коллекцией, промежуточные значения — результаты последовательных применений 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.
- ключ
ключ
- возвращает
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, если не переопределено.
- возвращает
true, если коллекция может быть пройдена повторно,falseв противном случае.
- Классы определения
- IterableOps → IterableOnceOps
def keySet: SortedSet[K]
Собирает все ключи этой карты в множество.
- возвращает
множество, содержащее все ключи этой карты.
- Классы определения
- SortedMapOps → MapOps
def keyStepper[S <: Stepper[_]](implicit shape: StepperShape[K, S]): S
def keys: Iterable[K]
Собирает все ключи этой карты в итерируемую коллекцию.
- возвращает
ключи этой карты как итерируемую коллекцию.
- Классы определения
- MapOps
def keysIterator: Iterator[K]
def knownSize: Int
- возвращает
Количество элементов в этой коллекции, если оно может быть вычислено без затрат, в противном случае -1. Без затрат обычно означает: без обхода коллекции.
- Классы определения
- IterableOnce
def last: (K, V)
Выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- возвращает
Последний элемент этой итерируемой коллекции.
- Определяющие классы
- IterableOps
- Выбрасываемые исключения
NoSuchElementExceptionЕсли итерируемая коллекция пуста.
def lastKey: K
Возвращает последний ключ коллекции.
- Определяющие классы
- SortedMapOps → SortedOps
def lastOption: Option[(K, V)]
Необязательно выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- возвращает
последний элемент этой итерируемой коллекции, если она не пуста,
Noneесли она пуста.
- Определяющие классы
- IterableOps
def lift: (K) => Option[V]
Превращает эту частичную функцию в обычную функцию, возвращающую Option результат.
- возвращает
функцию, которая принимает аргумент
xвSome(this(x))еслиthisопределено дляx, и вNoneв противном случае.
- Определяющие классы
- PartialFunction
- См. также
Function.unlift
def map[K2, V2](f: ((K, V)) => (K2, V2))(implicit ordering: Ordering[K2]): CC[K2, V2]
Создает новую отсортированную карту, применяя функцию ко всем элементам этой карты.
- f
функция, которую нужно применить к каждому элементу.
- возвращает
новая карта, полученная в результате применения данной функции
fк каждому элементу этой карты и сбора результатов.
- Определяющие классы
- SortedMapOps
def map[K2, V2](f: ((K, V)) => (K2, V2)): UnsortedCC[K2, V2]
Создает новую карту, применяя функцию ко всем элементам этой карты.
- f
функция, которую нужно применить к каждому элементу.
- возвращает
новая карта, полученная в результате применения данной функции
fк каждому элементу этой карты и сбора результатов.
- Определяющие классы
- MapOps
def map[B](f: ((K, V)) => B): WithFilterCC[B]
Создает новую итерируемую коллекцию, применяя функцию ко всем элементам этой итерируемой коллекции.
- B
тип элемента возвращаемой итерируемой коллекции.
- f
функция, которую нужно применить к каждому элементу.
- возвращает
новая итерируемая коллекция, полученная в результате применения данной функции
fк каждому элементу этой итерируемой коллекции и сбора результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
final def mapFromIterable[K2, V2](it: Iterable[(K2, V2)]): UnsortedCC[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: scala.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: scala.math.Ordering[B]): Option[(K, V)]
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Упорядочение, используемое для сравнения элементов.
- returns
значения Option, содержащие первый элемент этого набора с наибольшим значением, измеренным функцией f, по отношению к упорядочению
cmp.
- Definition Classes
- IterableOnceOps
def maxOption[B >: (K, V)](implicit ord: scala.math.Ordering[B]): Option[(K, V)]
Находит наибольший элемент.
- B
Тип, по которому определено упорядочение.
- ord
Упорядочение, используемое для сравнения элементов.
- returns
значения Option, содержащие наибольший элемент этого набора по отношению к упорядочению
ord.
- Definition Classes
- IterableOnceOps
def min[B >: (K, V)](implicit ord: scala.math.Ordering[B]): (K, V)
Находит наименьший элемент.
- B
Тип, по которому определено упорядочение.
- ord
Упорядочение, используемое для сравнения элементов.
- returns
наименьший элемент этого набора по отношению к упорядочению
ord.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если этот набор пуст.
def minAfter(key: K): Option[(K, V)]
Находит элемент с наименьшим ключом, большим или равным заданному ключу.
- key
Заданный ключ.
- returns
None, если такого узла нет.
- Definition Classes
- SortedMapOps
def minBy[B](f: ((K, V)) => B)(implicit cmp: scala.math.Ordering[B]): (K, V)
Находит первый элемент, который даёт наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок для сравнения элементов.
- returns
первый элемент этого набора с наименьшим значением, измеренным функцией f с учётом порядка
cmp.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если этот набор пуст.
def minByOption[B](f: ((K, V)) => B)(implicit cmp: math.Ordering[B]): Option[(K, V)]
Находит первый элемент, который даёт наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок для сравнения элементов.
- returns
значение Option, содержащее первый элемент этого набора с наименьшим значением, измеренным функцией f с учётом порядка
cmp.
- Definition Classes
- 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 newSpecificBuilder: Builder[(K, V), CC[K, V]]
- returns
строгий строитель для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList), возможно реализовать этот метод, но результирующий
Builderнарушит леность. Вследствие этого операции предпочтительно должны быть реализованы с помощьюfromSpecificвместо этого метода.
- Attributes
- protected
- Definition Classes
- SortedMapFactoryDefaults → IterableOps
- Note
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, добавив трейт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, пока возвращаемый строитель заполняется только значениямиA, взятыми из экземпляраthis, это безопасно.
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
not specified by SLS as a member of AnyRef
final def notifyAll(): Unit
Разбуждает все потоки, которые ожидают на мониторе объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Note
not specified by SLS as a member of 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): (CC[K, V @scala.annotation.unchecked.uncheckedVariance], CC[K, V @scala.annotation.unchecked.uncheckedVariance])
Пара из, во-первых, всех элементов, удовлетворяющих предикату p, и, во-вторых, всех элементов, которые не удовлетворяют ему. Интересно тем, что разделяет коллекцию на две части.
Предоставленная здесь реализация по умолчанию должна дважды пройти по коллекции. Строгие коллекции имеют переопределенную версию partition в StrictOptimizedIterableOps, которая требует только одного прохода.
- Definition Classes
- IterableOps
def partitionMap[A1, A2](f: ((K, V)) => Either[A1, A2]): (WithFilterCC[A1], WithFilterCC[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
- IterableOps
def product[B >: (K, V)](implicit num: math.Numeric[B]): B
Перемножает элементы этой коллекции.
- B
результирующий тип оператора
*.- num
неявный параметр, определяющий набор числовых операций, который включает оператор
*, используемый для формирования произведения.- returns
произведение всех элементов этой коллекции относительно оператора
*вnum.
- Определяющие классы
- IterableOnceOps
def range(from: K, until: K): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Создает диапазонную проекцию этой коллекции с нижней и верхней границами.
- from
Нижняя граница (включительно) диапазонной проекции.
- until
Верхняя граница (исключительно) диапазонной проекции.
- Определяющие классы
- SortedOps
def rangeFrom(from: K): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Создает диапазонную проекцию этой коллекции без верхней границы.
- from
Нижняя граница (включительно) диапазонной проекции.
- Определяющие классы
- SortedOps
def rangeTo(to: K): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Создает диапазонную проекцию этой коллекции без нижней границы.
- to
Верхняя граница (включительно) диапазонной проекции.
- Определяющие классы
- SortedMapOps → SortedOps
def rangeUntil(until: K): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Создает диапазонную проекцию этой коллекции без нижней границы.
- until
Верхняя граница (исключительно) диапазонной проекции.
- Определяющие классы
- SortedOps
def reduce[B >: (K, V)](op: (B, B) => B): B
Сводит элементы этой коллекции, используя указанный ассоциативный бинарный оператор.
Порядок, в котором выполняются операции над элементами, не указан и может быть недетерминированным.
- B
Типовой параметр для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора сводки
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в противном случае.
- Definition Classes
- IterableOnceOps
def reduceOption[B >: (K, V)](op: (B, B) => B): Option[B]
Применяет оператор к элементам этого набора, если таковые имеются, с использованием заданного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- B
Параметр типа для бинарного оператора, сверхтип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение опции, содержащее результат применения оператора
opко всем элементам, если набор непустой, иNoneв противном случае.
- Definition Classes
- 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- элементы этого набора.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если этот набор пустой.
def reduceRightOption[B >: (K, V)](op: ((K, V), B) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого набора, справа налево.
Примечание: не будет завершаться для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора упорядочен или оператор ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение опции, содержащее результат
reduceRight(op), если этот набор непустой,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def reversed: 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 позволяет избежать двойной оценки операторов pattern matching и условий для литералов частичных функций.
- 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): WithFilterCC[B]
Вычисляет префиксное сканирование элементов набора.
Примечание: нейтральный элемент z может применяться более одного раза.
- B
тип элементов результирующего набора
- z
нейтральный элемент для оператора
op- op
ассоциативный оператор для сканирования
- returns
новый итерируемый набор, содержащий префиксное сканирование элементов в этом итерируемом наборе
- Definition Classes
- IterableOps
def scanLeft[B](z: B)(op: (B, (K, V)) => B): WithFilterCC[B]
Создаёт итерируемую коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: ((K, V), B) => B): WithFilterCC[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции — последний кумулятивный результат.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
Примечание: даже при применении к представлению или ленивой коллекции он всегда будет принудительно обрабатывать элементы.
Пример:
List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Определяющие классы
- IterableOps
def size: Int
Размер этой коллекции.
Примечание: не завершится для коллекций бесконечного размера.
- returns
число элементов в этой коллекции.
- Определяющие классы
- IterableOnceOps
def sizeCompare(that: Iterable[_]): Int
Сравнивает размер этой итерируемой коллекции с размером другой Iterable.
- that
Iterable, размер которого сравнивается с размером этой итерируемой коллекции.- returns
-
Значение
x, где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.
- Определяющие классы
- IterableOps
def sizeCompare(otherSize: Int): Int
Сравнивает размер этой итерируемой коллекции с тестовым значением.
- otherSize
тестовое значение, которое сравнивается с размером.
- returns
-
Значение
x, где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.
- Определяющие классы
- IterableOps
- См. также
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
- Определяющие классы
- IterableOps
- Аннотации
- @inline()
def slice(from: Int, until: Int): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Выбирает интервал элементов. Возвращаемая итерируемая коллекция состоит из всех элементов x, которые удовлетворяют инварианту:
from <= indexOf(x) < until
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- from
наименьший индекс для включения из этой итерируемой коллекции.
- until
наименьший индекс для ИСКЛЮЧЕНИЯ из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая элементы больше или равные индексу
from, простирающиеся до (но не включая) индексuntilэтой итерируемой коллекции.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def sliding(size: Int, step: Int): Iterator[CC[K, V @scala.annotation.unchecked.uncheckedVariance]]
Группирует элементы в блоки фиксированного размера, перемещая "скользящее окно" по ним (в отличие от разделения на части, как это делается в grouped.)
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным), который будет усечен, если оставшихся элементов для группировки меньше, чемsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[CC[K, V @scala.annotation.unchecked.uncheckedVariance]]
Группирует элементы в блоки фиксированного размера, перемещая "скользящее окно" по ним (в отличие от разделения на части, как это делается в grouped). Шаг "скользящего окна" установлен в один.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным), который будет усечен, если оставшихся элементов для группировки меньше, чемsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
final def sortedMapFromIterable[K2, V2](it: Iterable[(K2, V2)])(implicit ordering: Ordering[K2]): CC[K2, V2]
Аналогично mapFromIterable, но возвращает тип коллекции SortedMap. Обратите внимание, что тип возвращаемого значения теперь CC[K2, V2].
- Attributes
- protected
- Definition Classes
- SortedMapOps
- Annotations
- @inline()
def span(p: ((K, V)) => Boolean): (CC[K, V @scala.annotation.unchecked.uncheckedVariance], CC[K, V @scala.annotation.unchecked.uncheckedVariance])
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.
Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
предикат проверки
- returns
пара, состоящая из самого длинного префикса этой итерируемой коллекции, элементы которого удовлетворяют
p, и остальной части этой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода нужно сбросить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def splitAt(n: Int): (CC[K, V @scala.annotation.unchecked.uncheckedVariance], CC[K, V @scala.annotation.unchecked.uncheckedVariance])
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
позиция разделения.
- returns
пара итерируемых коллекций, состоящая из первых
nэлементов этой итерируемой коллекции и других элементов.
- Definition Classes
- 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
def sum[B >: (K, V)](implicit num: math.Numeric[B]): B
Суммирует элементы этого набора.
- B
тип результата операции
+.- num
неявный параметр, определяющий набор числовых операций, который включает операцию
+, используемую при формировании суммы.- возвращает
сумма всех элементов этого набора относительно операции
+вnum.
- Определяющие классы
- IterableOnceOps
final def synchronized[T0](arg0: => T0): T0
- Определяющие классы
- AnyRef
def tail: CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Остальная часть набора без его первого элемента.
- Определяющие классы
- IterableOps
def tails: Iterator[CC[K, V @scala.annotation.unchecked.uncheckedVariance]]
Итерируется по хвостам этого итерируемого набора. Первое значение будет этим итерируемым набором, а последнее — пустым итерируемым набором, промежуточные значения — результаты последовательных применений tail.
- возвращает
итератор по всем хвостам этого итерируемого набора
- Определяющие классы
- IterableOps
List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)
def take(n: Int): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Выбирает первые n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- n
количество элементов, которые нужно взять из этого итерируемого набора.
- возвращает
итерируемый набор, содержащий только первые
nэлементов этого итерируемого набора, или весь итерируемый набор, если он содержит меньшеnэлементов. Еслиnотрицательное, возвращается пустой итерируемый набор.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def takeRight(n: Int): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Выбирает последние n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- n
количество элементов, которые нужно взять из этого итерируемого набора.
- возвращает
итерируемый набор, содержащий только последние
nэлементов этого итерируемого набора, или весь итерируемый набор, если он содержит меньшеnэлементов. Еслиnотрицательное, возвращается пустой итерируемый набор.
- Определяющие классы
- IterableOps
def takeWhile(p: ((K, V)) => Boolean): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Возвращает самый длинный префикс элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- p
Предикат для проверки элементов.
- возвращает
самый длинный префикс этого итерируемого набора, элементы которого удовлетворяют предикату
p.
- Определяющие классы
- IterableOps → IterableOnceOps
def tapEach[U](f: ((K, V)) => U): CC[K, V @scala.annotation.unchecked.uncheckedVariance]
Применяет функцию с побочным эффектом к каждому элементу в этом наборе. Строгие коллекции применят f к своим элементам немедленно, тогда как ленивые коллекции, такие как Views и LazyLists, будут применять f к каждому элементу только при необходимости и при каждом вычислении элемента.
- U
тип возвращаемого значения f
- f
функция, применяемая к каждому элементу в этой итерируемой коллекции
- returns
Такая же логическая коллекция, как и эта
- Definition Classes
- 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]
- Definition Classes
- IterableOnceOps
def toArray[B >: (K, V)](implicit arg0: ClassTag[B]): Array[B]
Преобразовать коллекцию в массив.
- Definition Classes
- IterableOnceOps
final def toBuffer[B >: (K, V)]: Buffer[B]
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def toIndexedSeq: immutable.IndexedSeq[(K, V)]
- Definition Classes
- IterableOnceOps
def toList: immutable.List[(K, V)]
- Definition Classes
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[(K, V), (K, V)]): immutable.Map[K, V]
- Definition Classes
- IterableOnceOps
def toSeq: immutable.Seq[(K, V)]
- returns
Эта коллекция в виде
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Definition Classes
- IterableOnceOps
def toSet[B >: (K, V)]: immutable.Set[B]
- Definition Classes
- IterableOnceOps
def toString(): String
Создает строковое представление этого объекта. Стандартное представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.
- returns
строковое представление объекта.
def toVector: immutable.Vector[(K, V)]
- Definition Classes
- IterableOnceOps
def transpose[B](implicit asIterable: ((K, V)) => Iterable[B]): WithFilterCC[WithFilterCC[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-й столбец этого итерируемого множества.
- Definition Classes
- IterableOps
- Exceptions thrown
IllegalArgumentException, если все множества в этом итерируемом множестве не имеют одинаковый размер.
def unapply(a: K): Option[V]
Попытка извлечь B из A в выражении сопоставления с образцом.
- Definition Classes
- PartialFunction
def unlift: PartialFunction[K, B]
Преобразует необязательную функцию в частичную функцию.
- Implicit
- Этот член добавлен явным преобразованием из SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC] в UnliftOps[K, B], выполненное методом UnliftOps в scala.Function1. Это преобразование выполняется только в том случае, если V является подклассом Option[B] (V <: Option[B]).
- Definition Classes
- 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)): (WithFilterCC[A1], WithFilterCC[A2])
Преобразует это итерируемое множество пар в два множества первой и второй половины каждой пары.
val xs = Iterable(
(1, "one"),
(2, "two"),
(3, "three")).unzip
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип первой половины пар элементов
- A2
тип второй половины пар элементов
- asPair
явное преобразование, которое утверждает, что тип элемента этого итерируемого множества — пара.
- returns
пара итерируемых множеств, содержащих первую, соответственно вторую половину каждой пары элементов этого итерируемого множества.
- Definition Classes
- IterableOps
def unzip3[A1, A2, A3](implicit asTriple: ((K, V)) => (A1, A2, A3)): (WithFilterCC[A1], WithFilterCC[A2], WithFilterCC[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
тройка итерируемых множеств, содержащих первый, второй, соответственно третий член каждой тройки элементов этого итерируемого множества.
- Definition Classes
- IterableOps
def valueStepper[S <: Stepper[_]](implicit shape: StepperShape[V, S]): S
def values: 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): SortedMapOps.WithFilter[K, V, WithFilterCC, UnsortedCC, CC]
Создаёт нестрогий фильтр этой карты.
Примечание: разница между c filter p и c withFilter p заключается в том, что первый создаёт новый набор, а второй только ограничивает область действия последующих map, flatMap, foreach и withFilter операций.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
объект класса
WithFilter, который поддерживаетmap,flatMap,foreachиwithFilterоперации. Все эти операции применяются к тем элементам этой карты, которые удовлетворяют предикатуp.
- Definition Classes
- SortedMapFactoryDefaults → IterableOps
def zip[B](that: IterableOnce[B]): WithFilterCC[((K, V), B)]
Возвращает итерируемый набор, образованный из этого итерируемого набора и другого итерируемого набора путём объединения соответствующих элементов в пары. Если один из двух наборов длиннее другого, его оставшиеся элементы игнорируются.
- B
тип второй половины возвращаемых пар
- that
Итерируемый набор, предоставляющий вторую половину каждой пары результата
- returns
новый итерируемый набор, содержащий пары, состоящие из соответствующих элементов этого итерируемого набора и
that. Длина возвращаемого набора — это минимум из длин этого итерируемого набора иthat.
- Definition Classes
- IterableOps
def zipAll[A1 >: (K, V), B](that: Iterable[B], thisElem: A1, thatElem: B): WithFilterCC[(A1, B)]
Возвращает итерируемую коллекцию, образованную из этой итерируемой коллекции и другой итерируемой коллекции путём объединения соответствующих элементов парами. Если одна из двух коллекций короче другой, элементы-заполнители используются для расширения более короткой коллекции до длины более длинной.
- that
итерируемый объект, предоставляющий вторую половину каждой пары результатов
- thisElem
элемент, который будет использоваться для заполнения результата, если эта итерируемая коллекция короче
that.- thatElem
элемент, который будет использоваться для заполнения результата, если
thatкороче этой итерируемой коллекции.- returns
новая коллекция типа
That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции иthat. Длина возвращаемой коллекции — максимальная из длин этой итерируемой коллекции иthat. Если эта итерируемая коллекция корочеthat, значенияthisElemиспользуются для заполнения результата. Еслиthatкороче этой итерируемой коллекции, значенияthatElemиспользуются для заполнения результата.
- Definition Classes
- IterableOps
def zipWithIndex: WithFilterCC[((K, V), Int)]
Объединяет эту итерируемую коллекцию со своими индексами.
- returns
Новая итерируемая коллекция, содержащая пары, состоящие из всех элементов этой итерируемой коллекции, соединённых с их индексом. Индексы начинаются с
0.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора является неопределённым, может измениться и может привести к изменениям в новом итераторе также.
List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))
Затенённые неявные члены значения
def +(other: String): String
- Неявный
- Этот член добавлен неявным преобразованием из SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC] вany2stringadd[SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]] выполненным методом any2stringadd в scala.Predef.
- Затенение
- Этот неявный унаследованный член затеневается одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типов:(sortedMapFactoryDefaults: any2stringadd[SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]]).+(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/SortedMapFactoryDefaults.html
Этот трейт предоставляет реализации по умолчанию для фабричных методов
fromSpecificиnewSpecificBuilder, которые необходимо уточнить при реализации типа коллекции, уточняющего типы параметровCCиC. Он используется для сортированных карт.Обратите внимание, что в сортированных картах тип
CCкарты не такой же, как типCCдля базовой карты (который закреплён заMapв SortedMapOps). Поэтому этот трейт имеет три параметра типа:CC,WithFilterCCиUnsortedCC. МетодwithFilter, унаследованный отIterableOps, переопределён с совместимой реализацией по умолчанию.Реализации по умолчанию в этом трейте могут использоваться в общем случае, когда
CC[A]совпадает сC.