Трейт scala.collection.parallel.ParSetLike

Проверка двух объектов на неравенство.

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

Вычисляет пересечение этого множества с другим множеством.

Примечание: То же, что и intersect.

Разность этого множества и другого множества.

Примечание: То же, что и diff.

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

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

Примечание: /: — это альтернативная синтаксическая запись для 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

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

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

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

Например, может потребоваться обработать некоторые элементы, а затем создать Set. В этом случае seqop будет обрабатывать элемент и добавлять его в множество, а combop будет объединять два множества из разных разделов. Начальное значение z будет пустым множеством.

pc.aggregate(Set[Int]())(_ += process(_), _ ++ _)

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

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

Проверяет, содержится ли некоторый элемент в этом множестве.

Этот метод эквивалентен contains. Он позволяет интерпретировать множества как предикаты.

Привести принимаемый объект к типу T0.

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

Создать копию объекта-приёмника.

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

Построение новой коллекции путём применения частичной функции ко всем элементам этого параллельного множества

к которому применяется функция.

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

По умолчанию фабрика комбинаторов создаёт новый комбинатор каждый раз, когда он запрашивается, если только комбинатор не является потокобезопасным, как указано в его методе canBeShared. В этом случае метод возвращает фабрику, которая возвращает один и тот же комбинатор каждый раз. Это обычно делается для параллельных коллекций с конкурентным доступом, комбинаторы которых позволяют безопасный доступ в потоках.

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

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

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

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

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

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

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

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

Вычисляет разность этого множества и другого множества.

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

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

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

Этот метод будет использовать indexFlag возможности сигнализации. Это означает, что разделители могут установить и прочитать состояние indexFlag. Флаг индекса изначально установлен в максимальное целочисленное значение.

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

Сравнивает этот набор с другим объектом на равенство.

Примечание: Эта операция содержит неконтролируемое приведение типов: если that является набором, оно предположит с неконтролируемым приведением типов, что оно имеет тот же тип элементов, что и этот набор. Любая последующая ClassCastException обрабатывается как результат false.

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

Этот метод будет использовать abort возможности сигнализации. Это означает, что разделители могут отправлять и читать abort сигналы.

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

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

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

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

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

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

Этот метод будет использовать abort возможности сигнализации. Это означает, что разделители могут отправлять и получать abort сигналы.

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

и используя элементы получившихся коллекций.

Например:

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)

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

Обратите внимание, что у этого метода другая сигнатура, чем у методов foldLeft и foldRight трактата Traversable. Результатом свертки может быть только супертип параметра типа этой параллельной коллекции T.

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

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

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

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

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

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

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

Этот метод будет использовать abort возможности сигнализации. Это означает, что разделители могут отправлять и читать abort сигналы.

Применяет функцию f ко всем элементам параллельного итерируемого объекта в неопределенном порядке.

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

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

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

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

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

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

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

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

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

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

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

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

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

Вычисляет пересечение этого множества и другого множества.

Проверяет, пуст ли параллельный итерируемый объект.

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

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

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

Указывает, имеет ли эта параллельная коллекция жёсткие разделители.

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

Этот метод помогает гарантировать, что такие ошибки произойдут при вызовах методов, а не позже и непредсказуемым образом.

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

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

По умолчанию этот метод реализован с помощью защищённого метода splitter.

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

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

Выбирает последний элемент по желанию.

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

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

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

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

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

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

Отображает все элементы этого параллельного итерируемого объекта в строке.

Отображает все элементы этого параллельного итерируемого объекта в строке с использованием разделительной строки.

Отображает все элементы этого параллельного итерируемого объекта в строке с использованием строк start, end и разделителя.

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

Проверяет, пуст ли параллельный итерируемый объект.

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

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

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

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

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

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

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

Разделяет этот параллельный итерируемый объект на два параллельных итерируемых объекта в соответствии с предикатом.

Вычисляет произведение элементов этой коллекции.

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

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

Обратите внимание, что у этого метода другой синтаксис, чем у методов reduceLeft и reduceRight в трайте Traversable. Результат сокращения может быть только супертипом параметра типа этого параллельного набора T.

Опциональное применение бинарного оператора ко всем элементам этого параллельного итерируемого объекта слева направо.

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

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

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

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

Обратите внимание, что у этого метода другой синтаксис, чем у методов reduceLeftOption и reduceRightOption в трайте Traversable. Результат сокращения может быть только супертипом параметра типа этого параллельного набора T.

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

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

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

Опциональное применение бинарного оператора ко всем элементам этого параллельного итерируемого объекта, справа налево.

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

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

При необходимости повторно использует существующий комбинатор для повышения производительности. По умолчанию этого не происходит - подклассы могут переопределить это поведение. Предоставленный комбинатор oldc , который потенциально может быть повторно использован, будет либо некоторым комбинатором из предыдущей вычислительной задачи, либо None, если предыдущей фазы не было (в этом случае этот метод должен вернуть newc).

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

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

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

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

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

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

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

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

Производит коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции - это последний кумулятивный результат.

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

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

Пример:

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

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

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

from <= indexOf(x) < until

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

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

Этот метод будет использовать indexFlag возможности сигнализации. Это означает, что разделители могут устанавливать и читать indexFlag состояние. Флаг индекса первоначально устанавливается в максимальное целое значение.

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

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

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

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

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

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

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

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

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

Этот метод будет использовать indexFlag возможности сигнализации. Это означает, что разделы могут устанавливать и считывать состояние indexFlag. Флаг индекса изначально установлен на максимальное целочисленное значение.

Объект поддержки задач, отвечающий за планирование и балансировку задач на процессорах.

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

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

Вот как изменить поддержку задач параллельной коллекции:

import scala.collection.parallel._
val pc = mutable.ParArray(1, 2, 3)
pc.tasksupport = new ForkJoinTaskSupport(
  new java.util.concurrent.ForkJoinPool(2))

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

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

Преобразует это параллельное множество в массив.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Преобразует этот параллельный итерируемый объект в множество.

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

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

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

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

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

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

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

Вычисляет объединение множества с другим множеством.

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

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

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

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

Объединяет это параллельное множество со своими индексами.

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

Вычисляет объединение между этим множеством и другим множеством.

Примечание: То же, что и union.