Класс scala.collection.AbstractMap
абстрактный класс AbstractMap[K, +V] extends AbstractIterable[(K, V)] with Map[K, V]
Конструкторы экземпляров
новый AbstractMap()
Члены типа
трайт GenKeySet extends AnyRef
Обобщённый трайт, используемый реализациями набора ключей
- Атрибуты
- protected
- Классы определения
- MapOps
класс KeySet extends AbstractSet[K] with GenKeySet with DefaultSerializable
Реализующий класс набора, возвращаемого методом keySet.
- Атрибуты
- protected
- Классы определения
- MapOps
Абстрактные члены-значения
абстрактный def get(key: K): Option[V]
Возвращает значение, связанное с ключом.
- key
значение ключа
- returns
опциональное значение, содержащее значение, связанное с
keyв данном отображении, илиNone, если такого значения нет.
- Классы определения
- MapOps
абстрактный def iterator: Iterator[(K, V)]
Итератор может быть использован только один раз
- Классы определения
- IterableOnce
абстрактный def -(key1: K, key2: K, keys: K*): Map[K, V]
- Классы определения
- Map
- Аннотации
- @deprecated
- Устаревшее
(С версии 2.13.0) Используйте -- или removedAll для неизменяемого отображения
абстрактный def -(key: K): Map[K, V]
- Классы определения
- Map
- Аннотации
- @deprecated
- Устаревшее
(С версии 2.13.0) Используйте - или removed для неизменяемого отображения
Члены значений
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
def ++[V2 >: V](xs: IterableOnce[(K, V2)]): Map[K, V2]
Псевдоним для concat
- Definition Classes
- MapOps
final def ++[B >: (K, V)](suffix: IterableOnce[B]): Iterable[B]
Псевдоним для concat
- Definition Classes
- IterableOps
- Annotations
- @inline()
def ->[B](y: B): (AbstractMap[K, V], B)
- Неявный
- Этот член добавлен неявным преобразованием из AbstractMap[K, V] в ArrowAssoc[AbstractMap[K, V]], выполненное методом 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в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @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, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def andThen[C](k: PartialFunction[V, C]): PartialFunction[K, C]
Компонует эту частичную функцию с другой частичной функцией, которая применяется к результатам этой частичной функции.
Обратите внимание, что вызов isDefinedAt на полученной частичной функции может применить первую частичную функцию и выполнить её побочный эффект. Крайне рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, суженной другой частичной функцией, которая сопоставляет аргументы
xвk(this(x)).
- Definition Classes
- PartialFunction
def andThen[C](k: (V) => C): PartialFunction[K, C]
Компонует эту частичную функцию с функцией преобразования, которая применяется к результатам этой частичной функции.
Если тип времени выполнения функции является PartialFunction, то используется другой метод andThen.
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, возможно суженной указанной функцией, которая сопоставляет аргументы
xвk(this(x)).
- Definition Classes
- PartialFunction → Function1
def apply(key: K): V
Возвращает значение, связанное с заданным ключом. Этот метод вызывает метод default карты, если нет сопоставления от заданного ключа к значению. За исключением переопределения, метод default выбрасывает исключение NoSuchElementException.
- key
ключ
- returns
значение, связанное с заданным ключом, или результат применения метода
defaultкарты, если такового нет.
def applyOrElse[K1 <: K, V1 >: V](x: K1, default: (K1) => V1): V1
Применяет эту частичную функцию к заданному аргументу, когда он содержится в области определения функции. Применяет функцию-обработчик, когда эта частичная функция не определена.
Обратите внимание, что выражение pf.applyOrElse(x, default) эквивалентно
if(pf isDefinedAt x) pf(x) else default(x)
за исключением того, что метод applyOrElse может быть реализован более эффективно. Для всех литералов частичных функций компилятор генерирует реализацию applyOrElse, которая избегает двойного вычисления матчеров и условий. Это делает applyOrElse основой для эффективной реализации многих операций и сценариев, таких как:
-
комбинирование частичных функций в цепочки
orElse/andThen не приводит к чрезмерному вычислению apply/isDefinedAt
lift и unlift не вычисляют исходные функции дважды при каждом вызове
runWith позволяет эффективно комбинировать частичные функции с условными действиями Для классов частичных функций, не являющихся литералами, с нетривиальным методом isDefinedAt, рекомендуется переопределить applyOrElse с пользовательской реализацией, которая избегает двойного вычисления isDefinedAt. Это может привести к лучшей производительности и более предсказуемому поведению в отношении побочных эффектов.
- x
аргумент функции
- default
функция-обработчик
- returns
результат применения этой функции или функции-обработчика.
- Definition Classes
- MapOps → PartialFunction
- Since
2.10
final def asInstanceOf[T0]: T0
Преобразует объект-получатель к типу T0.
Обратите внимание, что успех приведения типов во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] выбросит исключение ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере, поскольку аргумент типа стирается при компиляции, невозможно проверить, соответствуют ли содержимое списка требуемому типу.
- возвращает
объект-получатель.
- Определяющие классы
- 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, применённого к этой итерируемой коллекции. По умолчанию строковый префикс — это простое имя класса коллекции — итерируемой коллекции.
- Атрибуты
- protected[this]
- Определяющие классы
- Iterable
def clone(): AnyRef
Создаёт копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- возвращает
копию объекта-получателя.
final def coll: AbstractMap.this.type
- возвращает
Эту коллекцию в виде
C.
- Атрибуты
- protected
- Определяющие классы
- Iterable → IterableOps
def collect[K2, V2](pf: PartialFunction[(K, V), (K2, V2)]): Map[K2, V2]
Создаёт новую коллекцию, применяя частичную функцию ко всем элементам этой карты, для которых функция определена.
- K2
тип ключа возвращаемой карты.
- V2
тип значения возвращаемой карты.
- pf
частичная функция, которая фильтрует и отображает карту.
- возвращает
новую карту, полученную путём применения данной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Определяющие классы
- MapOps
def collect[B](pf: PartialFunction[(K, V), B]): Iterable[B]
Создаёт новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, для которых функция определена.
- B
тип элементов возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- возвращает
новую итерируемую коллекцию, полученную путём применения данной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться и может привести к изменениям в новом итераторе тоже.
def collectFirst[B](pf: PartialFunction[(K, V), B]): Option[B]
Находит первый элемент коллекции, для которого задана данная частичная функция, и применяет частичную функцию к нему.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если только тип базовой коллекции не упорядочен.
- pf
частичная функция
- возвращает
значение Option, содержащее 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)).
- Definition Classes
- PartialFunction
def compose[A](g: (A) => K): (A) => V
Компонует два экземпляра Function1 в новую Function1, с этой функцией, применяемой последней.
- A
тип, к которому функция
gможет быть применена- g
функция A => T1
- returns
новая функция
fтакая, чтоf(x) == apply(g(x))
- Definition Classes
- Function1
- Annotations
- @unspecialized()
def concat[V2 >: V](suffix: IterableOnce[(K, V2)]): Map[K, V2]
Возвращает новую карту, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента карты — это наиболее специфический суперкласс, охватывающий типы элементов двух операндов.
- suffix
перебираемый для добавления.
- returns
новая карта, содержащая все элементы этой карты, за которыми следуют все элементы
suffix.
- Definition Classes
- MapOps
def concat[B >: (K, V)](suffix: IterableOnce[B]): Iterable[B]
Возвращает новую итерируемую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента итерируемой коллекции — это наиболее специфический суперкласс, охватывающий типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
перебираемый для добавления.
- returns
новая итерируемая коллекция, содержащая все элементы этой итерируемой коллекции, за которыми следуют все элементы
suffix.
- Definition Classes
- IterableOps
def contains(key: K): Boolean
Проверяет, содержит ли эта карта привязку для ключа.
- key
ключ
- returns
trueесли дляkeyесть привязка в этой карте,falseв противном случае.
- Definition Classes
- MapOps
def copyToArray[B >: (K, V)](xs: Array[B], start: Int, len: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start не более чем len элементами этой коллекции.
Копирование прекращается, когда скопированы все элементы этой коллекции, достигнут конец массива или скопировано len элементов.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- len
максимальное количество элементов для копирования.
- returns
количество элементов, записанных в массив
- Definition Classes
- IterableOnceOps
- Note
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует удалить. Использование его не определено и может измениться. Примечание: не завершится для коллекций бесконечного размера.
def copyToArray[B >: (K, V)](xs: Array[B], start: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.
Копирование прекращается, когда либо все элементы этой коллекции были скопированы, либо достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс массива xs.
- returns
количество элементов, записанных в массив. Примечание: не завершается для коллекций бесконечного размера.
- Definition Classes
- IterableOnceOps
def copyToArray[B >: (K, V)](xs: Array[B]): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.
Копирование прекращается, когда либо все элементы этой коллекции были скопированы, либо достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- returns
количество элементов, записанных в массив. Примечание: не завершается для коллекций бесконечного размера.
- Definition Classes
- IterableOnceOps
def corresponds[B](that: IterableOnce[B])(p: ((K, V), B) => Boolean): Boolean
Проверяет, соответствует ли каждый элемент итератора этой коллекции соответствующему элементу другой коллекции, удовлетворяя предикату проверки.
- B
тип элементов
that- that
другая коллекция
- p
предикат проверки, который связывает элементы обеих коллекций
- 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): 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
- 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: (AbstractMap[K, V]) => Boolean, msg: => Any): AbstractMap[K, V]
- Неявный
- Этот член добавлен неявным преобразованием из AbstractMap[K, V] вEnsuring[AbstractMap[K, V]], выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (AbstractMap[K, V]) => Boolean): AbstractMap[K, V]
- Неявный
- Этот член добавлен неявным преобразованием из AbstractMap[K, V] вEnsuring[AbstractMap[K, V]], выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: => Any): AbstractMap[K, V]
- Неявный
- Этот член добавлен неявным преобразованием из AbstractMap[K, V] вEnsuring[AbstractMap[K, V]], выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean): AbstractMap[K, V]
- Неявный
- Этот член добавлен неявным преобразованием из AbstractMap[K, V] вEnsuring[AbstractMap[K, V]], выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef, и обладает тремя дополнительными свойствами:
-
Он согласован: для любых не-null экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого не-null экземпляра x типа AnyRef, вызовы x.eq(null) и null.eq(x) возвращают false.
null.eq(null) возвращает true. При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством ссылок. Таким образом, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковое значение хэша (o1.hashCode == o2.hashCode).
- возвращает
trueесли аргумент является ссылкой на объект-получатель;falseв противном случае.
- Определяющие классы
- AnyRef
def equals(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. Порядок элементов сохраняется.
- Определяющие классы
- IterableOps → IterableOnceOps
def filterNot(pred: ((K, V)) => Boolean): Map[K, V]
Выбирает все элементы этого итерируемого набора, которые не удовлетворяют предикату.
- pred
предикат, используемый для проверки элементов.
- возвращает
новый итерируемый набор, содержащий все элементы этого итерируемого набора, которые не удовлетворяют заданному предикату
pred. Порядок элементов может не сохраняться.
- Определяющие классы
- IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда к объекту больше нет ссылок.
Подробности о том, когда и будет ли вызываться метод finalize, а также взаимодействие finalize с нелокальными возвратами и исключениями, зависят от платформы.
def find(p: ((K, V)) => Boolean): Option[(K, V)]
Находит первый элемент в наборе, удовлетворяющий предикату, если таковой существует.
Примечание: может не завершиться для бесконечных наборов.
Примечание: может возвращать разные результаты при разных запусках, если тип базового набора не упорядочен.
- p
предикат, используемый для проверки элементов.
- возвращает
значение типа Option, содержащее первый элемент в наборе, удовлетворяющий предикату
p, илиNoneесли такой элемент не найден.
- Определяющие классы
- IterableOnceOps
def flatMap[K2, V2](f: ((K, V)) => IterableOnce[(K2, V2)]): Map[K2, V2]
Создаёт новый набор, применяя функцию ко всем элементам этого набора и используя элементы полученных коллекций.
- f
функция, применяемая к каждому элементу.
- возвращает
новый набор, полученный путём применения заданной функции, принимающей коллекции
fк каждому элементу этого набора и конкатенации результатов.
- Определяющие классы
- MapOps
def flatMap[B](f: ((K, V)) => IterableOnce[B]): Iterable[B]
Создаёт новую итерируемую коллекцию, применяя функцию ко всем элементам этой итерируемой коллекции и используя элементы результирующих коллекций.
Например:
def getWords(lines: Seq[String]): Seq[String] = lines flatMap (line => line split "\\W+")
Тип результирующей коллекции определяется статическим типом итерируемой коллекции. Это иногда может приводить к неожиданным результатам. Например:
// lettersOf will return a Seq[Char] of likely repeated letters, instead of a Set
def lettersOf(words: Seq[String]) = words flatMap (word => word.toSet)
// lettersOf will return a Set[Char], not a Seq
def lettersOf(words: Seq[String]) = words.toSet flatMap ((word: String) => word.toSeq)
// xs will be an Iterable[Int]
val xs = Map("a" -> List(11,111), "b" -> List(22,222)).flatMap(_._2)
// ys will be a Map[Int, Int]
val ys = Map("a" -> List(1 -> 11,1 -> 111), "b" -> List(2 -> 22,2 -> 222)).flatMap(_._2)
- B
тип элемента возвращаемой коллекции.
- f
функция, применяемая к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения данной функции со значениями в виде коллекции
fк каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, к которому он был применён, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям нового итератора.
def flatten[B](implicit asIterable: ((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
тип элементов каждой итерируемой коллекции.
- 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
предикат, используемый для проверки элементов.
- returns
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
Возвращает строку, отформатированную в соответствии с данной format строкой. Форматные строки аналогичны String.format (@см. java.lang.String.format).
- Implicit
- Этот член добавлен неявным преобразованием из AbstractMap[K, V] в StringFormat[AbstractMap[K, V]], выполненным методом StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
def fromSpecific(coll: IterableOnce[(K, V)]): Map[K, V]
Определяет, как преобразовать заданный Iterable[A] в коллекцию типа C.
Этот процесс может выполняться строго или нестрого (т. е. без оценки элементов результирующих коллекций). Другими словами, этот метод определяет модель оценки коллекции.
- Attributes
- protected
- Definition Classes
- MapFactoryDefaults → IterableOps
- Note
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, добавив трайт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как показывает аннотация
@uncheckedVariance, использование этого метода может быть некорректным. Однако, пока он вызывается сIterable[A], полученным изthisколлекции (как это происходит в реализациях операций, где мы используемView[A]), он безопасен.
final def getClass(): Class[_ <: AnyRef]
Возвращает представление класса объекта во время выполнения.
- returns
объект класса, соответствующий типу получателя во время выполнения.
def getOrElse[V1 >: V](key: K, default: => V1): V1
Возвращает значение, связанное с ключом, или значение по умолчанию, если ключ не содержится в карте.
- V1
тип результата вычисления по умолчанию.
- key
ключ.
- default
вычисление, которое возвращает значение по умолчанию в случае, если для
keyнет привязки в карте.- returns
значение, связанное с
keyесли оно существует, в противном случае результат вычисленияdefault.
- Definition Classes
- MapOps
def groupBy[K](f: ((K, V)) => K): immutable.Map[K, Map[K, V]]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с некоторой функцией-дискриминатором.
Примечание: даже при применении к представлению или ленивой коллекции она всегда принудительно вычисляет элементы.
- K
тип ключей, возвращаемых функцией-дискриминатором.
- f
функция-дискриминатор.
- returns
-
Карта, сопоставляющая ключи итерируемым коллекциям, в которой выполняется следующее инвариантное свойство:
(xs groupBy f)(k) = xs filter (x => f(x) == k)
То есть каждый ключ
kсвязан с итерируемой коллекцией тех элементовx, для которыхf(x)равноk.
- Definition Classes
- IterableOps
def groupMap[K, B](key: ((K, V)) => K)(f: ((K, V)) => B): immutable.Map[K, Iterable[B]]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций по функции-дискриминатору key. Каждый элемент в группе преобразуется в значение типа B с использованием функции value.
Эквивалентно groupBy(key).mapValues(_.map(f)), но более эффективно.
case class User(name: String, age: Int) def namesByAge(users: Seq[User]): Map[Int, Seq[String]] = users.groupMap(_.age)(_.name)
Примечание: даже при применении к представлению или ленивой коллекции она всегда принудительно вычисляет элементы.
- K
тип ключей, возвращаемых функцией-дискриминатором
- B
тип значений, возвращаемых функцией преобразования
- key
функция-дискриминатор
- f
функция преобразования элементов
- Definition Classes
- IterableOps
def groupMapReduce[K, B](key: ((K, V)) => K)(f: ((K, V)) => B)(reduce: (B, B) => B): 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)(_ + _)
Примечание: даже при применении к представлению или ленивой коллекции она всегда принудительно вычисляет элементы.
- Definition Classes
- IterableOps
def grouped(size: Int): Iterator[Map[K, V]]
Разделяет элементы на итерируемые коллекции фиксированного размера.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размером
size, за исключением последней, которая будет меньше sizesize, если элементы не делятся на размер без остатка.
- 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]]
Итерирует по начальным значениям (inits) этого итерируемого набора. Первым значением будет этот итерируемый набор, а последним — пустой итерируемый набор, промежуточные значения — результат последовательных применений init.
Примечание: Даже при применении к представлению или ленивому набору, элементы всегда будут принудительно получаться.
- returns
итератор по всем начальным значениям (inits) этого итерируемого набора
- 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
- IterableOnceOps
final def isInstanceOf[T0]: Boolean
Проверяет, является ли динамический тип объекта-приемника T0.
Обратите внимание, что результат проверки зависит от семантики стирания Scala. Следовательно, выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, так как тип аргумента стирается во время компиляции, проверить, содержат ли элементы списка указанный тип, невозможно.
- returns
trueесли объект-приемник является экземпляром стирания типаT0;falseв противном случае.
- Definition Classes
- Any
def isTraversableAgain: Boolean
Проверяет, можно ли многократно пройти по этому итерируемому набору. Всегда истинно для Iterables и ложно для Iterators, если не переопределено.
- returns
trueесли можно многократно пройтись,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def iterableFactory: IterableFactory[Iterable]
Компаньон-объект этого итерируемого набора, предоставляющий различные методы создания.
- Definition Classes
- Iterable → IterableOps
- Note
При реализации пользовательского типа набора и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
def keySet: Set[K]
Собирает все ключи этой карты в набор.
- returns
набор, содержащий все ключи этой карты.
- Definition Classes
- MapOps
def keyStepper[S <: Stepper[_]](implicit shape: StepperShape[K, S]): S
def keys: Iterable[K]
Собирает все ключи этой карты в итерируемый набор.
- returns
ключи этой карты в качестве итерируемого набора.
- Definition Classes
- MapOps
def keysIterator: Iterator[K]
def knownSize: Int
- returns
Количество элементов в этом наборе, если оно может быть вычислено недорого, в противном случае — -1. Недорого обычно означает: не требует обхода набора.
- Definition Classes
- IterableOnce
def last: (K, V)
Выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
Последний элемент этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Исключения
NoSuchElementExceptionЕсли итерируемая коллекция пуста.
def lastOption: Option[(K, V)]
Необязательно выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
последний элемент этой итерируемой коллекции, если она не пуста,
Noneесли она пуста.
- Definition Classes
- IterableOps
def lazyZip[B](that: Iterable[B]): LazyZip2[(K, V), B, AbstractMap.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)].
- Definition Classes
- Iterable
def lift: (K) => Option[V]
Преобразует эту частичную функцию в обычную функцию, возвращающую Option результат.
- returns
функция, которая принимает аргумент
xдляSome(this(x)), еслиthisопределено дляx, иNoneв противном случае.
- Definition Classes
- PartialFunction
- См. также
Function.unlift
def map[K2, V2](f: ((K, V)) => (K2, V2)): Map[K2, V2]
Создаёт новую карту, применяя функцию ко всем элементам этой карты.
- f
функция, которую нужно применить к каждому элементу.
- returns
новая карта, полученная в результате применения заданной функции
fк каждому элементу этой карты и сбора результатов.
- Definition Classes
- MapOps
def map[B](f: ((K, V)) => B): Iterable[B]
Создаёт новую итерируемую коллекцию, применяя функцию ко всем элементам этой итерируемой коллекции.
- B
тип элемента возвращаемой итерируемой коллекции.
- f
функция, которую нужно применить к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения заданной функции
fк каждому элементу этой итерируемой коллекции и сбора результатов.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода вы должны отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def mapFactory: MapFactory[Map]
Объект-компаньон этой карты, предоставляющий различные методы создания.
final def mapFromIterable[K2, V2](it: Iterable[(K2, V2)]): Map[K2, V2]
Аналогично fromIterable, но возвращает тип коллекции Map. Обратите внимание, что возвращаемый тип теперь CC[K2, V2].
def max[B >: (K, V)](implicit ord: math.Ordering[B]): (K, V)
Находит наибольший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наибольший элемент этого набора по отношению к порядку
ord.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationExceptionесли этот набор пуст.
def maxBy[B](f: ((K, V)) => B)(implicit cmp: math.Ordering[B]): (K, V)
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этого набора с наибольшим значением, измеренным функцией f, по отношению к порядку
cmp.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationExceptionесли этот набор пуст.
def maxByOption[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 maxOption[B >: (K, V)](implicit ord: math.Ordering[B]): Option[(K, V)]
Находит наибольший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
значение Option, содержащее наибольший элемент этого набора по отношению к порядку
ord.
- Definition Classes
- IterableOnceOps
def min[B >: (K, V)](implicit ord: math.Ordering[B]): (K, V)
Находит наименьший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наименьший элемент этого набора по отношению к порядку
ord.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationExceptionесли этот набор пуст.
def minBy[B](f: ((K, V)) => B)(implicit cmp: math.Ordering[B]): (K, V)
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этого набора с наименьшим значением, измеренным функцией f, по отношению к порядку
cmp.
- Definition Classes
- IterableOnceOps
- Исключения
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), 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
Проверяет, что коллекция не пуста.
- возвращает
trueесли коллекция содержит по крайней мере один элемент,falseв противном случае.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @deprecatedOverriding("nonEmpty определено как !isEmpty; переопределите isEmpty вместо этого", "2.13.0")
final def notify(): Unit
Разбуживает один поток, ожидающий монитора объекта-получателя.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS в качестве члена AnyRef
final def notifyAll(): Unit
Разбуживает все потоки, ожидающие монитора объекта-получателя.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS в качестве члена AnyRef
def orElse[A1 <: K, B1 >: V](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]
Компонует эту частичную функцию с резервной частичной функцией, которая применяется там, где эта частичная функция не определена.
- A1
тип аргумента резервной функции
- B1
тип результата резервной функции
- that
резервная функция
- возвращает
частичная функция, имеющая в качестве области объединение областей этой частичной функции и
that. Результирующая частичная функция принимаетxкthis(x), гдеthisопределена, и кthat(x)в противном случае.
- Определяющие классы
- PartialFunction
def partition(p: ((K, V)) => Boolean): (Map[K, V], Map[K, V])
Пара, состоящая из, во-первых, всех элементов, удовлетворяющих предикату p, и, во-вторых, всех элементов, не удовлетворяющих ему. Интересно, потому что это делит коллекцию на две части.
Представленная здесь реализация по умолчанию должна дважды пройтись по коллекции. Строгие коллекции имеют переопределенный вариант partition в StrictOptimizedIterableOps, который требует только одного прохода.
- Определяющие классы
- IterableOps
def partitionMap[A1, A2](f: ((K, V)) => Either[A1, A2]): (Iterable[A1], Iterable[A2])
Применяет функцию f к каждому элементу коллекции Iterable и возвращает пару коллекций Iterable: первая — из значений, возвращённых 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
функция 'разделения', отображающая элементы этой коллекции Iterable в scala.util.Either
- возвращает
пару коллекций Iterable: первая — из значений, возвращённых
f, которые были обернуты в scala.util.Left, а вторая — из обернутых в scala.util.Right.
- Определяющие классы
- IterableOps
def product[B >: (K, V)](implicit num: math.Numeric[B]): B
Перемножает элементы этой коллекции.
- B
тип результата оператора
*.- num
явный параметр, определяющий набор числовых операций, включающий оператор
*для использования в вычислении произведения.- возвращает
произведение всех элементов этой коллекции относительно оператора
*вnum.
- Определяющие классы
- IterableOnceOps
def reduce[B >: (K, V)](op: (B, B) => B): B
Уменьшает элементы этого набора, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
- B
Тип параметр для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce к
opмежду всеми элементами, если коллекция не пустая.
- Definition Classes
- 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— элементы этой коллекции.
- Definition Classes
- 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
Значение опционального типа, содержащее результат применения оператора reduce
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
- Исключения
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)]
- Атрибуты
- protected
- Определяющие классы
- 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
функция действия
- возвращает
функцию, которая отображает аргументы
xнаisDefinedAt(x). Результирующая функция выполняетaction(this(x)), гдеthisопределено.
- Определяющие классы
- PartialFunction
- С версии
2.10
- См. также
applyOrElse.
def scan[B >: (K, V)](z: B)(op: (B, B) => B): Iterable[B]
Вычисляет префиксное сканирование элементов коллекции.
Примечание: нейтральный элемент z может применяться более одного раза.
- B
тип элементов результирующей коллекции
- z
нейтральный элемент для оператора
op- op
ассоциативный оператор для сканирования
- возвращает
новую итерируемую коллекцию, содержащую префиксное сканирование элементов в этой итерируемой коллекции
- Определяющие классы
- IterableOps
def scanLeft[B](z: B)(op: (B, (K, V)) => B): Iterable[B]
Создает итерируемую коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- возвращает
коллекция с промежуточными результатами
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
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
бинарный оператор, применяемый к промежуточному результату и элементу
- возвращает
коллекция с промежуточными результатами
- Определяющие классы
- IterableOps
def size: Int
Размер этой коллекции.
Примечание: не будет завершаться для коллекций бесконечного размера.
- возвращает
число элементов в этой коллекции.
- Определяющие классы
- IterableOnceOps
def sizeCompare(that: Iterable[_]): Int
Сравнивает размер этой итерируемой коллекции с размером другой Iterable.
- that
Iterable, размер которого сравнивается с размером этой итерируемой коллекции.- возвращает
-
Значение
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.
- 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
- Note
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
def sliding(size: Int, step: Int): Iterator[Map[K, V]]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» по ним (в отличие от их разбиения, как в grouped).
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, производящий итерируемые наборы размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если оставшихся элементов для группировки меньшеsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[Map[K, V]]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» по ним (в отличие от их разбиения, как в grouped). Шаг «скользящего окна» устанавливается в единицу.
- size
количество элементов в группе
- returns
Итератор, производящий итерируемые наборы размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если оставшихся элементов для группировки меньшеsize.
- Definition Classes
- IterableOps
- See also
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
тестовый предикат
- returns
пара, состоящая из самого длинного префикса этого итерируемого набора, чьи элементы все удовлетворяют
p, и остальной части этого итерируемого набора.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах также.
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
def stringPrefix: String
- Атрибуты
- protected[this]
- Определяющие классы
- Map → Iterable
- Аннотации
- @deprecatedOverriding("Compatibility override", "2.13.0")
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: Map[K, V]
Остальная часть коллекции без первого элемента.
- Определяющие классы
- IterableOps
def tails: Iterator[Map[K, V]]
Итерируется по хвостам этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, промежуточные значения — результаты последовательных применений tail.
- возвращает
итератор по всем хвостам этой итерируемой коллекции
- Определяющие классы
- 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
количество элементов для взятия из этой итерируемой коллекции.
- возвращает
итерируемая коллекция, содержащая только первые
nэлементов этой итерируемой коллекции, или вся итерируемая коллекция, если она имеет меньше, чемnэлементов. Еслиnотрицательно, возвращает пустую итерируемую коллекцию.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может изменяться и может привести к изменениям в новом итераторе.
def takeRight(n: Int): Map[K, V]
Выбирает последние n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
количество элементов, которые нужно взять из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая только из последних
nэлементов этой итерируемой коллекции, или вся итерируемая коллекция, если она содержит менееnэлементов. Еслиnотрицательно, возвращает пустую итерируемую коллекцию.
- Определяющие классы
- IterableOps
def takeWhile(p: ((K, V)) => Boolean): Map[K, V]
Берёт самый длинный префикс элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный префикс этой итерируемой коллекции, все элементы которой удовлетворяют предикату
p.
- Определяющие классы
- IterableOps → IterableOnceOps
def tapEach[U](f: ((K, V)) => U): Map[K, V]
Применяет функцию с побочным эффектом к каждому элементу в этой коллекции. Строгие коллекции будут применять f к своим элементам немедленно, в то время как ленивые коллекции, такие как Views и LazyLists, будут применять f к каждому элементу только тогда, когда этот элемент будет вычислен, и каждый раз, когда этот элемент будет вычислен.
- U
тип возвращаемого значения f
- f
функция, которая применяется к каждому элементу в этой итерируемой коллекции
- returns
Та же логическая коллекция, что и эта
- Определяющие классы
- IterableOps → IterableOnceOps
def to[C1](factory: Factory[(K, V), C1]): C1
Учитывая фабрику коллекций factory, преобразуйте эту коллекцию в соответствующее представление для текущего типа элемента A. Примеры использования:
xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]
- Определяющие классы
- IterableOnceOps
def toArray[B >: (K, V)](implicit arg0: ClassTag[B]): Array[B]
Преобразовать коллекцию в массив.
- Определяющие классы
- IterableOnceOps
final def toBuffer[B >: (K, V)]: Buffer[B]
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
def toIndexedSeq: immutable.IndexedSeq[(K, V)]
- Определяющие классы
- IterableOnceOps
final def toIterable: AbstractMap.this.type
- returns
Эта коллекция как
Iterable[A]. Новая коллекция не будет создана, еслиthisуже являетсяIterable[A].
- Определяющие классы
- Iterable → IterableOps
def toList: immutable.List[(K, V)]
- Определяющие классы
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[(K, V), (K, V)]): immutable.Map[K, V]
- Определяющие классы
- IterableOnceOps
def toSeq: immutable.Seq[(K, V)]
- возвращает
Это коллекция в виде
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Определяющие классы
- IterableOnceOps
def toSet[B >: (K, V)]: immutable.Set[B]
- Определяющие классы
- IterableOnceOps
def toString(): String
Создаёт строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java оно представляет собой конкатенацию имени класса, "@" и хэш-кода объекта в шестнадцатеричном формате.
- возвращает
строковое представление объекта.
def toVector: immutable.Vector[(K, V)]
- Определяющие классы
- IterableOnceOps
def transpose[B](неявный asIterable: ((K, V)) => 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.- возвращает
двумерная итерируемая коллекция итерируемых коллекций, где n-я строка соответствует n-му столбцу этой итерируемой коллекции.
- Определяющие классы
- IterableOps
- Исключения
IllegalArgumentException, если все коллекции в этой итерируемой коллекции не имеют одинаковый размер.
def unapply(a: K): Option[V]
Попытка извлечь B из A в выражении сопоставления с образцом.
- Определяющие классы
- PartialFunction
def unlift: PartialFunction[K, B]
Преобразует опциональную функцию в частичную функцию.
- Неявный
- Этот член добавлен с помощью неявного преобразования из AbstractMap[K, V] в UnliftOps[K, B] с помощью метода UnliftOps в scala.Function1. Это преобразование выполнится только в том случае, если V является подклассом Option[B] (V <: Option[B]).
- Определяющие классы
- UnliftOps
В отличие от Function.unlift, этот метод UnliftOps.unlift может быть использован в экстракт орах.
val of: Int => Option[String] = { i =>
if (i == 2) {
Some("matched by an optional function")
} else {
None
}
}
util.Random.nextInt(4) match {
case of.unlift(m) => // Convert an optional function to a pattern
println(m)
case _ =>
println("Not matched")
}
def unzip[A1, A2](неявный 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
неявное преобразование, которое утверждает, что тип элемента этой итерируемой коллекции является парой.
- возвращает
пара итерируемых коллекций, содержащих первую и соответственно вторую половину каждой пары элементов этой итерируемой коллекции.
- Определяющие классы
- 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
тройка итерируемых коллекций, содержащих первый, второй и соответственно третий член каждой тройки элементов этой итерируемой коллекции.
- 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 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): MapOps.WithFilter[K, V, Iterable, Map]
Создаёт нестрогий фильтр этой карты.
Примечание: отличие между 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
- IterableOps
def zipAll[A1 >: (K, V), B](that: Iterable[B], thisElem: A1, thatElem: B): Iterable[(A1, B)]
Возвращает итерируемую коллекцию, сформированную из этой итерируемой коллекции и другой итерируемой коллекции, объединяя соответствующие элементы парами. Если одна из двух коллекций короче другой, элементы-заполнители используются для расширения более короткой коллекции до длины более длинной.
- that
Итерируемый объект, предоставляющий вторую половину каждой пары результата
- thisElem
элемент, используемый для заполнения результата, если эта итерируемая коллекция короче
that.- thatElem
элемент, используемый для заполнения результата, если
thatкороче этой итерируемой коллекции.- returns
новая коллекция типа
That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции иthat. Длина возвращаемой коллекции — максимальная из длин этой итерируемой коллекции иthat.
- Definition Classes
- IterableOps
def zipWithIndex: Iterable[((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
- Неявный
- Этот член добавляется неявным преобразованием из AbstractMap[K, V] в any2stringadd[AbstractMap[K, V]], выполненным методом any2stringadd в scala.Predef.
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(abstractMap: any2stringadd[AbstractMap[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/AbstractMap.html
Явное создание экземпляра
Mapинтерфейса для уменьшения размера файла класса в подклассах.