Тракт scala.collection.parallel.mutable.ParSetLike

Добавляет один элемент в это изменяемое параллельное множество.

Удаляет один элемент из этого изменяемого параллельного множества.

Очищает содержимое изменяемой коллекции. После этой операции изменяемая коллекция пуста.

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

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

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

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

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

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

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

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

Разность этого набора и другого набора.

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

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

Добавляет все элементы, полученные от TraversableOnce, в этот набор.

Добавляет два или более элементов в этот набор.

Удаляет все элементы, полученные из итератора, из этого уменьшаемого набора.

Удаляет два или более элементов из этого уменьшаемого набора.

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

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

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

Примечание: Эта операция содержит непроверенное приведение типов: если 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.

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

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

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

Эквивалентно !(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)

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

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

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 это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.

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

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

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

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

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

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

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

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

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

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

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

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

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