Trait scala.collection.GenMap

Возвращает новую общую коллекцию, содержащую элементы левого операнда, за которыми следуют элементы правого операнда. Тип элементов общей коллекции — самый специфичный суперкласс, охватывающий типы элементов обоих операндов.

Применяет бинарный оператор к начальному значению и всем элементам этой коллекции или итератора слева направо.

Примечание: /: — это альтернативная запись для foldLeft; z /: xs — то же самое, что и xs foldLeft z.

Примеры:

Обратите внимание, что функция свертки, используемая для вычисления b, эквивалентна функции, используемой для вычисления c.

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = (5 /: a)(_+_)
b: Int = 15

scala> val c = (5 /: a)((x,y) => x + y)
c: Int = 15

Примечание: для коллекций бесконечного размера процесс не завершится.

Примечание: могут быть получены разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

Применяет бинарный оператор ко всем элементам этой коллекции или итератора и начальному значению, справа налево.

Примечание: :\ — это альтернативная запись для foldRight; xs :\ z — то же самое, что и xs foldRight z.

Примечание: для коллекций бесконечного размера процесс не завершится.

Примечание: могут быть получены разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

Примеры:

Обратите внимание, что функция свертки, используемая для вычисления b, эквивалентна функции, используемой для вычисления c.

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = (a :\ 5)(_+_)
b: Int = 15

scala> val c = (a :\ 5)((x,y) => x + y)
c: Int = 15

Агрегирует результаты применения оператора к последующим элементам.

Это более общий вид fold и reduce. Он похож на foldLeft тем, что не требует, чтобы результат был супертипом типа элемента. Кроме того, он позволяет обрабатывать параллельные коллекции частями, а затем комбинировать промежуточные результаты.

aggregate разбивает коллекцию или итератор на разделы и обрабатывает каждый раздел, последовательно применяя seqop, начиная с z (как в foldLeft). Эти промежуточные результаты затем объединяются с помощью combop (как в fold). Реализация этой операции может работать с произвольным количеством разделов коллекции (даже с 1), поэтому combop может вызываться произвольное количество раз (даже 0).

В качестве примера рассмотрим суммирование целочисленных значений списка символов. Начальное значение для суммы равно 0. Во-первых, seqop преобразует каждый входной символ в Int и добавляет его к сумме (раздела). Затем, combop просто нужно просуммировать промежуточные результаты разделов:

List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })

Метод, который должен вызываться из каждого хорошо спроектированного метода equals, который может быть переопределен в подклассе. См. Programming in Scala, Глава 28 для обсуждения и проектирования.

Проверяет, содержит ли эта карта привязку для ключа.

Подсчитывает количество элементов в коллекции или итераторе, удовлетворяющих предикату.

Выбирает все элементы, кроме первых n.

Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.

Удаляет самый длинный префикс элементов, удовлетворяющих предикату.

Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.

Проверяет, выполняется ли предикат хотя бы для одного элемента этой коллекции или итератора.

Примечание: может не завершаться для бесконечных коллекций.

Выбирает все элементы этого общего набора, которые удовлетворяют предикату.

Фильтрует эту карту, сохраняя только ключи, удовлетворяющие предикату.

Выбирает все элементы этого общего набора, которые не удовлетворяют предикату.

Находит первый элемент коллекции или итератора, удовлетворяющий предикату, если таковой имеется.

Примечание: может не завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

Складывает элементы этой коллекции или итератора, используя указанный ассоциативный бинарный оператор.

Порядок выполнения операций над элементами не определен и может быть недетерминированным.

Примечание: не будет завершаться для коллекций бесконечного размера.

Применяет бинарный оператор к начальному значению и всем элементам этой коллекции или итератора слева направо.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если базовый тип коллекции упорядочен или оператор ассоциативен и коммутативен.

Применяет бинарный оператор ко всем элементам этой коллекции или итератора и начальному значению, справа налево.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если базовый тип коллекции упорядочен или оператор ассоциативен и коммутативен.

Проверяет, выполняется ли предикат для всех элементов этого набора или итератора.

Примечание: может не завершиться для наборов бесконечного размера.

Разделяет этот общий набор на карту общих наборов в соответствии с некоторой функцией-дискриминатором.

Примечание: этот метод не реализован повторно представлениями. Это означает, что при применении к представлению он всегда принуждает представление и возвращает новый общий набор.

Проверяет, известно ли, что этот набор или итератор имеют конечный размер. Все строгие наборы известны, что имеют конечный размер. Для нестрогого набора, такого как Stream, предикат возвращает true, если все элементы были вычислены. Он возвращает false, если поток ещё не был вычислен до конца. Непустые итераторы обычно возвращают false, даже если они были созданы из набора с известным конечным размером.

Примечание: многие методы наборов не будут работать с наборами бесконечных размеров. Типичный режим сбоя - бесконечный цикл. Эти методы всегда пытаются выполнить обход без предварительной проверки, что hasDefiniteSize возвращает true. Однако проверка hasDefiniteSize может гарантировать, что размер определён и не будет бесконечной работы.

Выбирает первый элемент этого набора.

Возвращает опционально первый элемент.

Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.

Выбирает все элементы, кроме последнего.

Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.

Проверяет, содержит ли эта карта привязку для ключа. Этот метод, который реализует абстрактный метод из тракта PartialFunction, эквивалентен contains.

Проверяет, пуст ли этот набор.

Проверяет, можно ли повторно пройти по этому общему набору.

Сбор всех ключей этой карты в итерируемой коллекции.

Создаёт итератор для всех ключей.

Выбор последнего элемента.

Примечание: может возвращать разные результаты для разных запусков, если тип коллекции, на которой основан объект, не является упорядоченным.

Возвращает последний элемент, если он есть.

Примечание: может возвращать разные результаты для разных запусков, если тип коллекции, на которой основан объект, не является упорядоченным.

Преобразует эту карту, применяя функцию ко всем значениям.

Отображает все элементы этой коллекции или итератора в строке.

Отображает все элементы этой коллекции или итератора в строке с разделителем.

Отображает все элементы этой коллекции или итератора в строке с начальным, конечным и разделительными строками.

Проверяет, не пуста ли коллекция или итератор.

Реализация по умолчанию par использует комбинировщик, предоставленный этим методом, для создания новой параллельной коллекции.

Разделяет эту общую коллекцию на две общие коллекции в соответствии с предикатом.

Приводит элементы этой коллекции или итератора к одному значению с использованием указанного ассоциативного бинарного оператора.

Порядок выполнения операций над элементами не определен и может быть не детерминированным.

При необходимости применяет бинарный оператор ко всем элементам этой коллекции или итератора слева направо.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты при разных запусках, если тип коллекции, на которой основанна коллекция, не упорядочен или оператор не ассоциативный и коммутативный.

Приводит элементы этой коллекции или итератора, если таковые имеются, к одному значению с использованием указанного ассоциативного бинарного оператора.

Порядок выполнения операций над элементами не определен и может быть не детерминированным.

Применяет бинарный оператор ко всем элементам этой коллекции или итератора справа налево.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты при разных запусках, если тип коллекции, на которой основанна коллекция, не упорядочен или оператор не ассоциативный и коммутативный.

Необязательно применяет бинарный оператор ко всем элементам этого набора или итератора, двигаясь справа налево.

Примечание: не будет завершаться для наборов бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если только тип базового набора не упорядочен, или оператор не является ассоциативным и коммутативным.

Вычисляет префиксное сканирование элементов набора.

Примечание: нейтральный элемент z может быть применен более одного раза.

Создаёт набор, содержащий кумулятивные результаты применения оператора слева направо.

Примечание: не будет завершаться для наборов бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если только базовый тип набора не упорядочен.

Создаёт набор, содержащий кумулятивные результаты применения оператора справа налево. Голова набора — последний кумулятивный результат.

Примечание: не будет завершаться для наборов бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если только базовый тип набора не упорядочен.

Пример:

List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)

Размер этого общего набора.

Примечание: не будет завершаться для наборов бесконечного размера.

Выбирает интервал элементов. Возвращаемый набор состоит из всех элементов x, которые удовлетворяют инварианту:

from <= indexOf(x) < until

Примечание: может возвращать разные результаты при разных запусках, если только тип базового набора не является упорядоченным.

Разделяет этот общий набор на пару префикс/суффикс в соответствии с предикатом.

Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.

Примечание: может возвращать разные результаты при разных запусках, если только тип базового набора не является упорядоченным.

Разделяет этот общий набор на два в заданной позиции. Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).

Примечание: может возвращать разные результаты при разных запусках, если только тип базового набора не является упорядоченным.

Определяет префикс представления этого объекта.

Выбирает все элементы, кроме первого.

Примечание: может возвращать разные результаты при разных запусках, если только тип базового набора не является упорядоченным.

Выбирает первые n элементов.

Примечание: может возвращать разные результаты при разных запусках, если только тип базового набора не является упорядоченным.

Взятие самого длинного префикса элементов, удовлетворяющих предикату.

Примечание: может возвращать разные результаты при разных запусках, если только тип базового набора не является упорядоченным.

Использует содержимое этой коллекции или итератора для создания нового изменяемого буфера.

Примечание: не завершит работу для коллекций бесконечного размера.

Преобразует эту коллекцию или итератор в индексированную последовательность.

Примечание: не завершит работу для коллекций бесконечного размера.

Преобразует эту коллекцию или итератор в итерируемую коллекцию. Обратите внимание, что выбор целевого Iterable ленивый в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и невычисленным (то есть это может быть итератор, который доступен только один раз).

Примечание: не завершит работу для коллекций бесконечного размера.

Возвращает итератор по элементам в этой коллекции или итераторе. Вернёт тот же итератор, если этот экземпляр уже является итератором.

Примечание: не завершит работу для коллекций бесконечного размера.

Преобразует эту коллекцию или итератор в список.

Примечание: не завершит работу для коллекций бесконечного размера.

Преобразует эту коллекцию или итератор в последовательность. Как и в toIterable, это ленивое выполнение в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и невычисленным.

Примечание: не завершит работу для коллекций бесконечного размера.

Преобразует эту коллекцию или итератор в множество.

Примечание: не завершит работу для коллекций бесконечного размера.

Преобразует эту коллекцию или итератор в поток.

Преобразует эту коллекцию или итератор в неспецифическое итерируемое множество. Вернёт ту же коллекцию, если этот экземпляр уже итерируемое множество.

Примечание: не завершит работу для коллекций бесконечного размера.

Преобразует эту коллекцию или итератор в вектор.

Примечание: не завершит работу для коллекций бесконечного размера.

Собирает все значения этой карты в итерируемую коллекцию.

Создает итератор для всех значений в этой карте.

Тестирует два объекта на неравенство.

Эквивалентно x.hashCode, за исключением упакованных числовых типов и null. Для числовых типов он возвращает хэш-значение, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, тогда ## вернет одно и то же хэш-значение для каждого из них. Для null возвращает хэш-код, где null.hashCode выбрасывает NullPointerException.

Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

Преобразует получаемый объект к типу T0.

Обратите внимание, что успех преобразования во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] не выбросит. В последнем примере, поскольку аргумент типа стирается во время компиляции, невозможно проверить, содержат ли элементы списка запрошенный тип.

Создает копию объекта-получателя.

По умолчанию реализация метода clone зависит от платформы.

Создает новую коллекцию, применяя частичную функцию ко всем элементам этой коллекции, для которых функция определена.

Компаньон-объект-фабрика, который создает экземпляры класса Traversable. (или его Iterable суперкласса, где класс Traversable не является Seq.)

Копирует элементы этой коллекции в массив. Заполняет заданный массив xs не более чем len элементами этой коллекции, начиная с позиции start. Копирование прекратится, как только будет достигнут конец текущей коллекции, конец целевого массива или len элементов будут скопированы.

Примечание: не завершится для коллекций бесконечного размера.

Копирует элементы этой коллекции в массив. Заполняет заданный массив xs значениями этой коллекции, начиная с индекса start. Копирование прекратится, как только будет достигнут конец текущей коллекции или конец целевого массива.

Примечание: не завершится для коллекций бесконечного размера.

Копирует элементы этой коллекции в массив. Заполняет заданный массив xs значениями этой коллекции. Копирование прекратится, как только будет достигнут конец текущей коллекции или конец целевого массива.

Примечание: не завершится для коллекций бесконечного размера.

Проверяет, является ли аргумент (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).

Структурно сравнивает две карты; т.е. проверяет, содержатся ли все отображения, содержащиеся в этой карте, также в другой карте, и наоборот.

Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.

Детали о том, когда и как вызывается метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями зависят от платформы.

Строит новую коллекцию, применяя функцию ко всем элементам этой коллекции и используя элементы полученных коллекций.

Например:

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 => 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)

Преобразует эту коллекцию коллекций в коллекцию, образованную элементами этих коллекций.

Тип результирующей коллекции будет определяться статическим типом коллекции. Например:

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)

Возвращает строку, отформатированную в соответствии с заданной строкой форматирования. Строки форматирования аналогичны строкам форматирования String.format (@см. java.lang.String.format).

Обобщённый билдер, строящий экземпляры Traversable для произвольных типов элементов.

Возвращает представление класса во время выполнения для объекта.

Возвращает значение, связанное с ключом, или значение по умолчанию, если ключ не содержится в карте.

Метод hashCode для ссылочных типов. См. hashCode в scala.Any.

Проверка, является ли динамический тип объекта-получателя T0.

Обратите внимание, что результат проверки зависит от стирания типов в Scala. Поэтому выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, из-за стирания аргумента типа во время компиляции, невозможно проверить, соответствуют ли элементы списка указанному типу.

Создаёт новый набор, применяя функцию ко всем элементам этого набора.

Находит наибольший элемент.

Находит первый элемент, который даёт наибольшее значение, измеренное функцией f.

Находит наименьший элемент.

Находит первый элемент, который даёт наименьшее значение, измеренное функцией f.

Эквивалентно !(this eq that).

Построитель, который создаёт экземпляры типа Traversable[A]

Разбуживает единственную нить, ожидающую монитора объекта получателя.

Разбуживает все нити, ожидающие монитора объекта получателя.

Возвращает параллельную реализацию этого набора.

Для большинства типов наборов этот метод создаёт новый параллельный набор, копируя все элементы. Для этих наборов метод par занимает линейное время. Изменяемые наборы в этой категории не создают изменяемый параллельный набор, который имеет тот же базовый набор данных, поэтому изменения в одном наборе не будут отражаться в другом.

Определённые наборы (например, ParArray или mutable.ParHashMap) переопределяют это поведение по умолчанию, создавая параллельный набор, который использует тот же базовый набор данных. Для этих наборов метод par занимает постоянное или подлинейное время.

Все параллельные наборы возвращают ссылку на себя.

Перемножает элементы этого набора.

Проверяет, содержит ли другой итерируемый набор те же элементы в том же порядке, что и этот набор.

Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.

Примечание: не завершится для наборов бесконечного размера.

Размер этого набора или итератора, если его можно вычислить с малой стоимостью

Суммирует элементы этого набора.

Преобразует этот набор в другой, копируя все элементы.

Примечание: не завершится для наборов бесконечного размера.

Преобразует эту коллекцию в массив.

Примечание: не завершится для коллекций бесконечного размера.

Преобразует эту коллекцию в карту. Этот метод недоступен, если элементы не являются членами Tuple2, при этом каждый ((T, U)) становится парой ключ-значение в карте. Повторные ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, то порядок ключей в результирующей карте не определён.

Примечание: не завершится для коллекций бесконечного размера.

Создаёт строковое представление этого объекта. По умолчанию это представление зависит от платформы. На платформе Java это конкатенация имени класса, "@", и хэш-кода объекта в шестнадцатеричном формате.

Транспонирует эту коллекцию коллекций в коллекцию коллекций.

Тип результирующей коллекции будет определяться статическим типом коллекции. Например:

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))

Преобразует эту коллекцию пар в две коллекции первой и второй половины каждой пары.

val xs = Traversable(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (Traversable(1, 2, 3),
//        Traversable(one, two, three))

Преобразует эту коллекцию троек в три коллекции из первого, второго и третьего элемента каждой тройки.

val xs = Traversable(
           (1, "one", '1'),
           (2, "two", '2'),
           (3, "three", '3')).unzip3
// xs == (Traversable(1, 2, 3),
//        Traversable(one, two, three),
//        Traversable(1, 2, 3))

Возвращает коллекцию, образованную из этой коллекции и другой коллекции итерируемых объектов, объединяя соответствующие элементы в пары. Если одна из двух коллекций длиннее другой, ее оставшиеся элементы игнорируются.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

Возвращает коллекцию, образованную из этой коллекции и другой коллекции итерируемых объектов, объединяя соответствующие элементы в пары. Если одна из двух коллекций короче другой, для расширения короче коллекции до длины большей используется элемент-заполнитель.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

Объединяет эту коллекцию со своими индексами.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.