Класс scala.collection.immutable.Map.Map4
final класс Map4[K, +V] extends AbstractMap[K, V] with StrictOptimizedIterableOps[(K, V), Iterable, Map[K, V]] with Serializable
- Аннотации
- @SerialVersionUID()
- Источник
- Map.scala
- Линейные надтипы
- java.io.Serializable, StrictOptimizedIterableOps[(K, V), Iterable, Map[K, V]], AbstractMap[K, V], Map[K, V], MapOps[K, V, Map, Map[K, V]], Iterable[(K, V)], collection.AbstractMap[K, V], collection.Map[K, V], Equals, MapFactoryDefaults[K, V, [x, y]Map[x, y], [x]Iterable[x]], collection.MapOps[K, V, [_, _]Map[_, _], Map[K, V]], PartialFunction[K, V], (K) => V, AbstractIterable[(K, V)], collection.Iterable[(K, V)], IterableFactoryDefaults[(K, V), [x]Iterable[x]], IterableOps[(K, V), [_]Iterable[_], Map[K, V]], IterableOnceOps[(K, V), [_]Iterable[_], Map[K, V]], IterableOnce[(K, V)], AnyRef, Any
Конструкторы экземпляров
new Map4(key1: K, value1: V, key2: K, value2: V, key3: K, value3: V, key4: K, value4: V)
Типы-члены
trait GenKeySet extends AnyRef
Абострактный трайт, используемый в реализации наборов ключей
- Attributes
- protected
- Definition Classes
- MapOps
class KeySet extends AbstractSet[K] with GenKeySet with DefaultSerializable
Реализующий класс набора, возвращаемого keySet.
- Attributes
- protected
- Definition Classes
- MapOps
class ImmutableKeySet extends AbstractSet[K] with GenKeySet with DefaultSerializable
Реализующий класс набора, возвращаемого keySet
- Attributes
- protected
- Definition Classes
- 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
def +[V1 >: V](kv: (K, V1)): Map[K, V1]
Псевдоним для updated
- V1
тип значения в паре ключ/значение.
- kv
пара ключ/значение.
- returns
Новая карта с новым привязкой, добавленной к этой карте.
def ++[V2 >: V](xs: IterableOnce[(K, V2)]): Map[K, V2]
Псевдоним для concat
- Определяющие классы
- MapOps
final def ++[B >: (K, V)](suffix: IterableOnce[B]): Iterable[B]
Псевдоним для concat
- Определяющие классы
- IterableOps
- Аннотации
- @inline()
final def -(key: K): Map[K, V]
final def --(keys: IterableOnce[K]): Map[K, V]
def ->[B](y: B): (Map4[K, V], B)
- Неявный
- Этот член добавляется неявным преобразованием из Map4[K, V] в ArrowAssoc[Map4[K, V]], выполняемым методом 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).
- returns
trueесли принимающий объект эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- 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к которому были добавлены элементы.
- Определяющие классы
- 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
функция по умолчанию
- возвращает
результат применения этой функции или функции по умолчанию.
- Definition Classes
- MapOps → PartialFunction
- Since
2.10
final def asInstanceOf[T0]: T0
Приводит объект-получатель к типу T0.
Обратите внимание, что успешность приведения типов во время выполнения зависит от семантики стирания типов Scala. Поэтому выражение 1.asInstanceOf[String] выбросит исключение ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] не выбросит исключение. В последнем примере, поскольку аргумент типа стирается во время компиляции, невозможно проверить, содержат ли элементы списка нужный тип.
- возвращает
объект-получатель.
- Definition Classes
- Any
- Исключения
ClassCastException, если объект-получатель не является экземпляром стираемого типаT0.
def canEqual(that: Any): Boolean
Метод, который должен вызываться из каждого хорошо спроектированного метода equals, который может быть переопределен в подклассе. См. Programming in Scala, Chapter 28 для обсуждения и проектирования.
- that
значение, которое проверяется на возможность равенства
- возвращает
true, если этот экземпляр потенциально может быть равен
that, иначе false
def className: String
Определяет префикс представления этого объекта в toString.
Рекомендуется возвращать имя конкретного типа коллекции, но не подклассы реализации. Например, для ListMap этот метод должен возвращать "ListMap", а не "Map" (супертип) или "Node" (подкласс реализации).
По умолчанию реализация возвращает "Iterable". Она переопределяется для основных типов коллекций "Seq", "IndexedSeq", "LinearSeq", "Buffer", "Set", "Map", "SortedSet", "SortedMap" и "View".
- возвращает
строковое представление, которое начинается с результата
toString, примененного к этой итерируемой коллекции. По умолчанию строковый префикс — это простое имя класса коллекции для итерируемой коллекции.
- Attributes
- protected[this]
- Definition Classes
- Iterable
def clone(): AnyRef
Создает копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- возвращает
копию объекта-получателя.
final def coll: Map4.this.type
- возвращает
эту коллекцию как
C.
- Attributes
- protected
- Definition Classes
- Iterable → IterableOps
def collect[B](pf: PartialFunction[(K, V), B]): Iterable[B]
Создаёт новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, для которых функция определена.
- B
тип элемента возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- возвращает
новую итерируемую коллекцию, полученную путём применения заданной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
def collect[K2, V2](pf: PartialFunction[(K, V), (K2, V2)]): Map[K2, V2]
Создаёт новую коллекцию, применяя частичную функцию ко всем элементам этой карты, для которых функция определена.
- K2
тип ключа возвращаемой карты.
- V2
тип значения возвращаемой карты.
- pf
частичная функция, которая фильтрует и отображает карту.
- returns
новая карта, полученная в результате применения данной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Определяющие классы
- MapOps
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)]): Map[K, V2]
Возвращает новую карту, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента карты является наиболее специфичным суперклассом, охватывающим типы элементов двух операндов.
- suffix
объект IterableOnce для добавления.
- returns
новая карта, которая содержит все элементы этой карты, за которыми следуют все элементы
suffix.
- Определяющие классы
- MapOps
def concat[B >: (K, V)](suffix: IterableOnce[B]): Iterable[B]
Возвращает новую итерируемую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента итерируемой коллекции является наиболее специфичным суперклассом, охватывающим типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
объект IterableOnce для добавления.
- returns
новая итерируемая коллекция, которая содержит все элементы этой итерируемой коллекции, за которыми следуют все элементы
suffix.
- Определяющие классы
- IterableOps
def contains(key: K): Boolean
Проверяет, содержит ли эта карта привязку для ключа.
- ключ
ключ
- возвращает
trueесли в этой карте есть привязка дляkey,falseв противном случае.
def copyToArray[B >: (K, V)](xs: Array[B], start: Int, len: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start не более чем len элементами этого набора.
Копирование прекратится, когда будут скопированы все элементы этого набора, или будет достигнут конец массива, или len элементов будут скопированы.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- len
максимальное количество элементов для копирования.
- возвращает
количество элементов, записанных в массив
- Классы-определения
- IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование этого метода после вызова не определено и может быть изменено. Примечание: не завершится для наборов бесконечного размера.
def copyToArray[B >: (K, V)](xs: Array[B], start: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start значениями этого набора.
Копирование прекратится, когда будут скопированы все элементы этого набора или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- возвращает
количество элементов, записанных в массив. Примечание: не завершится для наборов бесконечного размера.
- Классы-определения
- IterableOnceOps
def copyToArray[B >: (K, V)](xs: Array[B]): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start значениями этого набора.
Копирование прекратится, когда будут скопированы все элементы этого набора или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- возвращает
количество элементов, записанных в массив. Примечание: не завершится для наборов бесконечного размера.
- Классы-определения
- 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
Определяет вычисление значения по умолчанию для карты, возвращаемого, когда ключ не найден. Реализованный здесь метод выбрасывает исключение, но может быть переопределен в подклассах.
- ключ
переданное значение ключа, для которого отсутствует привязка.
def drop(n: Int): Map[K, V]
Выбирает все элементы, кроме первых n.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- n
количество элементов, которые нужно удалить из этого итерируемого набора.
- returns
итерируемый набор, состоящий из всех элементов этого итерируемого набора, кроме первых
nэлементов, или пустой итерируемый набор, если в этом итерируемом наборе меньше чемnэлементов. Еслиnотрицательно, не удалять ни одного элемента.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def dropRight(n: Int): Map[K, V]
Остальная часть набора без n последних элементов. Для линейных, неизменяемых наборов это должно предотвратить создание копии.
Примечание: даже при применении к представлению или ленивому набору, это всегда будет принудительно использовать элементы.
- n
количество элементов, которые нужно удалить из этого итерируемого набора.
- returns
итерируемый набор, состоящий из всех элементов этого итерируемого набора, кроме последних
nэлементов, или пустой итерируемый набор, если в этом итерируемом наборе меньше чемnэлементов. Еслиnотрицательно, не удалять ни одного элемента.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps
def dropWhile(p: ((K, V)) => Boolean): Map[K, V]
Удаляет самый длинный префикс элементов, которые удовлетворяют предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- 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: Map[K, V]
Пустой итерируемый набор того же типа, что и этот итерируемый набор.
- returns
пустой итерируемый набор типа
C.
- Definition Classes
- MapFactoryDefaults → IterableOps
def ensuring(cond: (Map4[K, V]) => Boolean, msg: => Any): Map4[K, V]
- Implicit
- Этот член добавлен неявным преобразованием из Map4[K, V] в Ensuring[Map4[K, V]] выполненный методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (Map4[K, V]) => Boolean): Map4[K, V]
- Implicit
- Этот член добавлен неявным преобразованием из Map4[K, V] в Ensuring[Map4[K, V]] выполненный методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: => Any): Map4[K, V]
- Неявный
- Этот член добавлен неявным преобразованием из Map4[K, V] в Ensuring[Map4[K, V]], выполненным методом Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): Map4[K, V]
- Неявный
- Этот член добавлен неявным преобразованием из Map4[K, V] в Ensuring[Map4[K, V]], выполненным методом 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).
- возвращает
trueесли аргумент является ссылкой на объект-получатель;falseв противном случае.
- Определяющие классы
- AnyRef
def equals(o: Any): Boolean
Универсальный метод равенства, определенный в AnyRef.
def exists(p: ((K, V)) => Boolean): Boolean
Проверяет, выполняется ли предикат хотя бы для одного элемента этого набора.
Примечание: может не завершиться для бесконечных наборов.
- p
предикат, используемый для проверки элементов.
- возвращает
trueесли заданный предикатpвыполняется хотя бы для одного элемента этого набора, в противном случаеfalse
- Определяющие классы
- IterableOnceOps
def filter(pred: ((K, V)) => Boolean): Map[K, V]
Выбирает все элементы этого итерируемого набора, которые удовлетворяют предикату.
- возвращает
новый итератор, содержащий все элементы этого итерируемого набора, удовлетворяющие заданному предикату
p. Порядок элементов сохраняется.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
def filterImpl(pred: ((K, V)) => Boolean, isFlipped: Boolean): Map[K, V]
- Атрибуты
- protected[scala.collection]
- Определяющие классы
- StrictOptimizedIterableOps
def filterNot(pred: ((K, V)) => Boolean): Map[K, V]
Выбирает все элементы этой итерируемой коллекции, которые не удовлетворяют предикату.
- pred
предикат, используемый для проверки элементов.
- returns
новая итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, которые не удовлетворяют заданному предикату
pred. Их порядок может не сохраняться.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.
Подробности о том, когда и если вызывается метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.
def find(p: ((K, V)) => Boolean): Option[(K, V)]
Находит первый элемент коллекции, удовлетворяющий предикату, если таковой существует.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
необязательное значение, содержащее первый элемент в коллекции, который удовлетворяет
p, илиNone, если такового не существует.
- Определяющие классы
- IterableOnceOps
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к каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def flatMap[K2, V2](f: ((K, V)) => IterableOnce[(K2, V2)]): Map[K2, V2]
Создает новую карту, применяя функцию ко всем элементам этой карты и используя элементы результирующих коллекций.
- f
функция, применяемая к каждому элементу.
- returns
новая карта, полученная в результате применения данной функции со значениями-коллекциями
fк каждому элементу этой карты и конкатенации результатов.
- Определяющие классы
- MapOps
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, если эта коллекция пуста.
- Definition Classes
- 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, если эта коллекция пуста.
- Definition Classes
- 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, если эта коллекция пуста.
- Definition Classes
- IterableOnceOps
def forall(p: ((K, V)) => Boolean): Boolean
Проверяет, выполняется ли предикат для всех элементов этой коллекции.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
true, если эта коллекция пуста или данный предикатpвыполняется для всех элементов этой коллекции, в противном случаеfalse.
- Definition Classes
- IterableOnceOps
def foreach[U](f: ((K, V)) => U): Unit
Применяет f к каждому элементу для его побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типов scalac.
- Definition Classes
- Map4 → IterableOnceOps
def foreachEntry[U](f: (K, V) => U): Unit
Применяет f к каждой паре ключ/значение для его побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типов scalac.
- Definition Classes
- MapOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой форматирования. Строки форматирования такие же, как для String.format (@см. java.lang.String.format).
- Implicit
- Этот член добавлен неявным преобразованием из Map4[K, V] в StringFormat[Map4[K, V]] с помощью метода StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
def fromSpecific(coll: IterableOnce[(K, V)]): Map[K, V]
Определяет, как преобразовать заданный Iterable[A] в коллекцию типа C.
Этот процесс может быть выполнен строго или нестрого (т. е. без оценки элементов результирующих коллекций). Другими словами, этот метод определяет модель оценки коллекции.
- Атрибуты
- protected
- Классы-определения
- MapFactoryDefaults → IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, смешав в себе трейт IterableFactoryDefaults, который реализует метод с использованием iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, если он вызывается сIterable[A], полученным из коллекцииthis(как это происходит при реализации операций, где мы используемView[A]), он безопасен.
def get(key: K): Option[V]
Возвращает значение, связанное с ключом.
- key
значение ключа
- returns
объект Option, содержащий значение, связанное с
keyв этом словаре, илиNone, если оно не существует.
final def getClass(): Class[_ <: AnyRef]
Возвращает представление класса объекта во время выполнения.
- returns
объект класса, соответствующий типу получателя во время выполнения.
def getOrElse[V1 >: V](key: K, default: => V1): V1
Возвращает значение, связанное с ключом, или значение по умолчанию, если ключ не содержится в словаре.
- V1
тип результата вычисления по умолчанию.
- key
ключ.
- default
вычисление, которое возвращает значение по умолчанию в случае, если в словаре не найдено привязки для
key.- returns
значение, связанное с
key, если оно существует, в противном случае результат вычисленияdefault.
def groupBy[K](f: ((K, V)) => K): Map[K, Map[K, V]]
Разделяет эту итерируемую коллекцию на словарь итерируемых коллекций по некоторой функции-дискриминатору.
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут форсироваться.
- 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): 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
функция преобразования элементов
- Классы-определения
- 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)(_ + _)
Примечание: Даже при применении к представлению или ленивой коллекции все элементы всегда будут принудительно вычислены.
- Definition Classes
- IterableOps
def grouped(size: Int): Iterator[Map[K, V]]
Разбивает элементы на итерируемые коллекции фиксированного размера.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размером
size, за исключением последней, которая будет меньше sizesize, если элементы не делятся на size без остатка.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- returns
значение хэш-кода для этого объекта.
def head: (K, V)
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Исключения
NoSuchElementException, если итерируемая коллекция пуста.
def headOption: Option[(K, V)]
Возвращает первый элемент коллекции, если он существует.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции, если она не пуста,
Noneесли она пуста.
- Definition Classes
- IterableOps
def init: Map[K, V]
Первая часть коллекции без последнего элемента.
Примечание: Даже при применении к представлению или ленивой коллекции все элементы всегда будут принудительно вычислены.
- Definition Classes
- IterableOps
def inits: Iterator[Map[K, V]]
Итерируется по начальным частям этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, а промежуточные значения — результаты последовательных применений init.
Примечание: Даже при применении к представлению или ленивой коллекции все элементы всегда будут принудительно вычислены.
- returns
итератор по всем начальным частям этой итерируемой коллекции
- Definition Classes
- 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
ключ
- returns
trueесли дляkeyв этой карте есть привязка,falseв противном случае.
- Definition Classes
- MapOps → PartialFunction
def isEmpty: Boolean
Проверяет, является ли неизменяемая карта пустой.
Примечание: Реализации в подклассах, которые не являются многократно проходимыми, должны позаботиться о том, чтобы не использовать элементы, когда isEmpty вызывается.
- returns
trueесли неизменяемая карта не содержит элементов,falseв противном случае.
- Definition Classes
- Map4 → IterableOnceOps
final def isInstanceOf[T0]: Boolean
Проверить, является ли динамический тип объекта-получателя T0.
Обратите внимание, что результат теста зависит от семантики стирания типов Scala. Поэтому выражение 1.isInstanceOf[String] вернет false, а выражение List(1).isInstanceOf[List[String]] вернет true. Во втором примере, поскольку тип аргумента стирается во время компиляции, проверить, являются ли содержимое списка указанного типа, невозможно.
- returns
trueесли объект-получатель является экземпляром стирания типаT0;falseв противном случае.
- Определяющие классы
- Any
def isTraversableAgain: Boolean
Проверяет, можно ли многократно проходить по этой итерируемой коллекции. Всегда true для Iterable и false для Iterator, если не переопределено.
- returns
trueесли она многократно проходима,falseв противном случае.
- Определяющие классы
- IterableOps → IterableOnceOps
def iterableFactory: IterableFactory[Iterable]
Вспомогательный объект этой неизменяемой коллекции, предоставляющий различные методы создания.
- Определяющие классы
- Iterable → Iterable → IterableOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод должен быть переопределен для возврата фабрики для нового типа (в противном случае компилятор выдаст ошибку).
def iterator: Iterator[(K, V)]
Итератор можно использовать только один раз
- Определяющие классы
- Map4 → IterableOnce
def keySet: Set[K]
Собирает все ключи этой карты в множество.
- returns
множество, содержащее все ключи этой карты.
def keyStepper[S <: Stepper[_]](implicit shape: StepperShape[K, S]): S
def keys: collection.Iterable[K]
Собирает все ключи этой карты в итерируемую коллекцию.
- returns
ключи этой карты как итерируемый объект.
- Определяющие классы
- MapOps
def keysIterator: Iterator[K]
Создает итератор для всех ключей.
- returns
итератор по всем ключам.
def knownSize: Int
- returns
Количество элементов в этой неизменяемой карте, если оно может быть легко вычислено, -1 в противном случае. Легко обычно означает: не требует обхода коллекции.
- Определяющие классы
- Map4 → IterableOnce
def last: (K, V)
Выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
Последний элемент этой итерируемой коллекции.
- Определяющие классы
- IterableOps
- Выбрасываемые исключения
NoSuchElementExceptionЕсли итерируемая коллекция пуста.
def lastOption: Option[(K, V)]
Необязательно выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
последний элемент этой итерируемой коллекции, если она не пуста,
Noneесли она пуста.
- Определяющие классы
- IterableOps
def lazyZip[B](that: collection.Iterable[B]): LazyZip2[(K, V), B, Map4.this.type]
Аналогично zip за исключением того, что элементы в каждой коллекции не используются, пока не будет вызвана строгая операция для возвращаемого декоратора LazyZip2.
Вызовы lazyZip могут быть связаны для поддержки более высоких арностей (до 4), не вызывая затрат на создание и разрушение промежуточных кортежей.
val xs = List(1, 2, 3) val res = (xs lazyZip xs lazyZip xs lazyZip xs).map((a, b, c, d) => a + b + c + d) // res == List(4, 8, 12)
- B
тип второго элемента в каждой будущей паре
- that
итерируемый объект, предоставляющий второй элемент каждой будущей пары
- returns
декоратор
LazyZip2, который позволяет выполнять строгие операции над лениво вычисляемыми парами или цепочками вызововlazyZip. Также поддерживается неявное преобразование вIterable[(A, B)].
- Определяющие классы
- Iterable
def lift: (K) => Option[V]
Преобразует эту частичную функцию в обычную функцию, возвращающую результат Option.
- returns
функция, которая принимает аргумент
xвSome(this(x)), еслиthisопределено дляx, и вNoneв противном случае.
- Определяющие классы
- PartialFunction
- См. также
Function.unlift
def map[B](f: ((K, V)) => B): Iterable[B]
Создает новую итерируемую коллекцию, применяя функцию ко всем элементам этой итерируемой коллекции.
- B
тип элемента возвращаемой итерируемой коллекции.
- f
функция, применяемая к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения данной функции
fк каждому элементу этой итерируемой коллекции и сбора результатов.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def map[K2, V2](f: ((K, V)) => (K2, V2)): Map[K2, V2]
Создает новую карту, применяя функцию ко всем элементам этой карты.
- f
функция, применяемая к каждому элементу.
- returns
новая карта, полученная в результате применения данной функции
fк каждому элементу этой карты и сбора результатов.
- Определяющие классы
- MapOps
def mapFactory: MapFactory[Map]
Вспомогательный объект этой карты, предоставляющий различные методы фабрики.
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.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxBy[B](f: ((K, V)) => B)(implicit cmp: math.Ordering[B]): (K, V)
Находит первый элемент, который даёт наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, который будет использоваться для сравнения элементов.
- returns
первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
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 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, содержащее наименьший элемент этого набора по отношению к заданному порядку.
- 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), Map[K, V]]
- returns
строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList) реализация этого метода возможна, но полученный
Builderнарушит ленивость. Поэтому операции предпочтительно реализовывать с помощьюfromSpecificвместо этого метода.
- Attributes
- protected
- Definition Classes
- MapFactoryDefaults → 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): (Map[K, V], Map[K, V])
Пара из, во-первых, всех элементов, удовлетворяющих предикату 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 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в противном случае.
- Определяющие классы
- IterableOnceOps
def reduceOption[B >: (K, V)](op: (B, B) => B): Option[B]
Сокращает элементы этой коллекции, если таковые имеются, с использованием указанного ассоциативного бинарного оператора.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
- B
Типовой параметр для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Необязательное значение, содержащее результат применения оператора сокращения
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
необязательное значение, содержащее результат
reduceRight(op), если эта коллекция не пуста,Noneв противном случае.
- Определяющие классы
- IterableOnceOps
def removed(key: K): Map[K, V]
Удаляет ключ из этого отображения, возвращая новую карту.
- key
ключ, который нужно удалить
- returns
новая карта без связи для key
def removedAll(keys: IterableOnce[K]): Map[K, V]
Создает новую неизменяемую карту из этой неизменяемой карты, удаляя все элементы из другого набора.
Примечание: Даже при применении к представлению или ленивой коллекции, элементы всегда будут принудительно вычисляться.
- 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
- Map4 → IterableOnceOps
def sizeCompare(that: collection.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.
- Definition Classes
- 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.
- 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): Map[K, V]
Выбирает интервал элементов. Возвращаемая итерируемая коллекция состоит из всех элементов x, которые удовлетворяют условию:
from <= indexOf(x) < until
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции упорядочен.
- from
наименьший индекс для включения из этой итерируемой коллекции.
- until
наименьший индекс для исключения из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая элементы, большие или равные индексу
from, и простирающиеся до (но не включая) индексаuntilэтой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def sliding(size: Int, step: Int): Iterator[Map[K, V]]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» над ними (в отличие от разбиения на группы, как в grouped.)
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, производящий итерируемые коллекции размером
size, за исключением последнего элемента (который может быть единственным), который будет усечён, если оставшихся элементов меньшеsize.
- Definition Classes
- IterableOps
- См. также
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[Map[K, V]]
Группирует элементы в блоки фиксированного размера, пропуская по ним «скользящее окно» (в отличие от разбиения, как это делается в grouped). Шаг «скользящего окна» установлен в единицу.
- размер
количество элементов в группе
- возвращает
Итератор, генерирующий итерируемые коллекции размером
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если оставшихся элементов для группировки меньше, чемsize.
- Определяющие классы
- IterableOps
- См. также
scala.collection.Iterator, метод
sliding
def span(p: ((K, V)) => Boolean): (Map[K, V], Map[K, V])
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.
Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.
Примечание: может возвращать разные результаты для разных запусков, если тип основной коллекции не упорядочен.
- p
предикат проверки
- возвращает
пара, состоящая из самого длинного префикса этой итерируемой коллекции, элементы которой удовлетворяют
p, и остальной части этой итерируемой коллекции.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода нужно сбросить вызываемый итератор и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def splitAt(n: Int): (Map[K, V], Map[K, V])
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: 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 stringPrefix: String
- Attributes
- protected[this]
- Definition Classes
- Map → Iterable
- Annotations
- @deprecatedOverriding("Compatibility override", "2.13.0")
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: Map[K, V]
Остальная часть набора без первого элемента.
- Definition Classes
- IterableOps
def tails: Iterator[Map[K, V]]
Итерируется по хвостам этого итерируемого набора. Первое значение будет этим итерируемым набором, а последнее — пустым итерируемым набором, а промежуточные значения — результаты последовательных применений 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): Map[K, V]
Выбирает первые n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- n
количество элементов для взятия из этого итерируемого набора.
- returns
итерируемый набор, содержащий только первые
nэлементов этого итерируемого набора, или же весь итерируемый набор, если в нём меньшеnэлементов. Еслиnотрицательно, возвращает пустой итерируемый набор.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует удалить итератор, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе также.
def takeRight(n: Int): Map[K, V]
Коллекция, содержащая последние n элементы этого набора.
Примечание: даже при применении к представлению или ленивой коллекции она всегда принудительно получит элементы.
- n
количество элементов для взятия из этого итерируемого набора.
- returns
итерируемый набор, содержащий только последние
nэлементов этого итерируемого набора, или же весь итерируемый набор, если в нём меньшеnэлементов. Еслиnотрицательно, возвращает пустой итерируемый набор.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps
def takeWhile(p: ((K, V)) => Boolean): Map[K, V]
Берёт наибольший префикс элементов, которые удовлетворяют предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- p
Предикат, используемый для проверки элементов.
- returns
наибольший префикс этого итерируемого набора, чьи элементы все удовлетворяют предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
def tapEach[U](f: ((K, V)) => U): Map[K, V]
Применяет функцию со побочным эффектом к каждому элементу в этом наборе. Строгие наборы будут применять f к своим элементам немедленно, в то время как ленивые наборы, такие как Views и 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]
- 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: IndexedSeq[(K, V)]
- Definition Classes
- IterableOnceOps
final def toIterable: Map4.this.type
- returns
Этот набор в виде
Iterable[A]. Новый набор не будет создан, еслиthisуже являетсяIterable[A].
- Definition Classes
- Iterable → IterableOps
def toList: List[(K, V)]
- Definition Classes
- IterableOnceOps
final def toMap[K2, V2](implicit ev: <:<[(K, V), (K2, V2)]): Map[K2, V2]
- Definition Classes
- Map → IterableOnceOps
def toSeq: Seq[(K, V)]
- returns
Этот набор в виде
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Definition Classes
- IterableOnceOps
def toSet[B >: (K, V)]: Set[B]
- Definition Classes
- IterableOnceOps
def toString(): String
def toVector: Vector[(K, V)]
- Definition Classes
- IterableOnceOps
def transform[W](f: (K, V) => W): Map[K, W]
Эта функция преобразует все значения отображений, содержащихся в этой карте, с помощью функции f.
- f
Функция над ключами и значениями
- returns
обновленная карта
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-й столбец этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Исключения
IllegalArgumentExceptionесли все коллекции в этой итерируемой коллекции не имеют одинаковый размер.
def unapply(a: K): Option[V]
Пытается извлечь B из A в выражении сопоставления с образцом.
- Definition Classes
- PartialFunction
def unlift: PartialFunction[K, B]
Преобразует опциональную функцию в частичную функцию.
- Неявный
- Этот член добавляется с помощью неявного преобразования из Map4[K, V] в 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)): (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
пара итерируемых коллекций, содержащая первую, соответственно вторую половину каждой пары элементов этой итерируемой коллекции.
- Definition Classes
- 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 updated[V1 >: V](key: K, value: V1): Map[K, V1]
Создает новую карту, полученную путем обновления этой карты с помощью заданной пары ключ/значение.
- V1
тип добавленного значения
- key
ключ
- value
значение
- returns
Новая карта с добавленным в эту карту новым сопоставлением ключ/значение. <invalid inheritdoc annotation>
def updatedWith[V1 >: V](key: K)(remappingFunction: (Option[V]) => Option[V1]): Map[K, V1]
Обновляет сопоставление для указанного ключа и его текущего значения с опциональным отображением (Some если есть текущее сопоставление, None если нет).
Если функция переназначения возвращает Some(v), сопоставление обновляется с новым значением v. Если функция переназначения возвращает None, сопоставление удаляется (или остается отсутствующим, если изначально отсутствовало). Если сама функция вызывает исключение, исключение перебрасывается, а текущее сопоставление остается без изменений.
- key
ключ
- remappingFunction
частичная функция, которая получает текущее значение с опциональным отображением и возвращает новое сопоставление
- returns
Новая карта с обновленным сопоставлением с ключом
- Определяющие классы
- MapOps
- С версии
2.13.0
def valueStepper[S <: Stepper[_]](implicit shape: StepperShape[V, S]): S
def values: collection.Iterable[V]
Собирает все значения этой карты в итерируемую коллекцию.
- returns
значения этой карты в виде итерируемого объекта.
- Определяющие классы
- MapOps
def valuesIterator: Iterator[V]
Создает итератор для всех значений в этой карте.
- returns
итератор по всем значениям, которые связаны с некоторым ключом в этой карте.
def view: MapView[K, V]
Представление элементов этой коллекции.
- Определяющие классы
- MapOps → IterableOps
final def wait(): Unit
- Определяющие классы
- AnyRef
- Аннотации
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long, arg1: Int): Unit
- Определяющие классы
- AnyRef
- Аннотации
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long): Unit
def withDefault[V1 >: V](d: (K) => V1): Map[K, V1]
Тот же самый массив с заданной функцией по умолчанию. Примечание: значение по умолчанию используется только для apply. Другие методы, такие как get, contains, iterator, keys, и т. д., не подвержены влиянию withDefault.
Вызов методов преобразования (например, map) не сохранит значение по умолчанию.
- d
функция, отображающая ключи в значения, используемая для отсутствующих ключей
- returns
обёртка карты со значением по умолчанию
- Definition Classes
- Map
def withDefaultValue[V1 >: V](d: V1): Map[K, V1]
Тот же самый массив с заданным значением по умолчанию. Примечание: значение по умолчанию используется только для apply. Другие методы, такие как get, contains, iterator, keys, и т. д., не подвержены влиянию withDefaultValue.
Вызов методов преобразования (например, map) не сохранит значение по умолчанию.
- d
значение по умолчанию, используемое для отсутствующих ключей
- returns
обёртка карты со значением по умолчанию
- Definition Classes
- Map
def withFilter(p: ((K, V)) => Boolean): MapOps.WithFilter[K, V, [x]Iterable[x], [x, y]Map[x, y]]
Создаёт нестрогий фильтр этой карты.
Примечание: разница между c filter p и c withFilter p заключается в том, что первый создаёт новую коллекцию, а второй только ограничивает область применения последующих map, flatMap, foreach, и withFilter операций.
Примечание: результаты могут отличаться при разных запусках, если тип базовой коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
объект класса
WithFilter, который поддерживаетmap,flatMap,foreach, иwithFilterоперации. Все эти операции применяются к тем элементам этой карты, которые удовлетворяют предикатуp.
- Definition Classes
- MapFactoryDefaults → 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
- Неявный
- Этот член добавлен неявным преобразованием из Map4[K, V] вany2stringadd[Map4[K, V]] , выполненное методом any2stringadd в scala.Predef.
- Затенение
- Этот неявный унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать привязку типа:(map4: any2stringadd[Map4[K, V]]).+(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/Map$$Map4.html