Трейт scala.collection.parallel.mutable.ParMapLike

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

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

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

Добавляет все элементы, полученные из 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(_), _ ++ _)

Еще один пример — вычисление геометрического среднего из коллекции значений типа double (обычно для этого требуется тип big double).

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

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

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

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

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

на которых функция определена.

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

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

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

Копирует элементы этой параллельной карты в массив. Заполняет заданный массив 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).

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

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

Этот метод будет использовать возможности 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 (@see java.lang.String.format).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание: реализации в подклассах, которые не являются многократно итерируемыми, должны следить за тем, чтобы не использовать какие-либо элементы при вызове 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 это конкатенация имени класса, "@", и хэш-кода объекта в шестнадцатеричном формате.

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

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

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

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

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

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

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

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

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

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

Объединяет эту параллельную карту с её индексами.

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