Spec-Zone.ru › Scala 2.13 Library

Тракт scala.collection.BitSetOps

Компаньон объект BitSetOps

тракт BitSetOps[+C <: BitSet with BitSetOps[C]] extends SortedSetOps[Int, SortedSet, C]

Базовый тип реализации битовых множеств

Self Type
BitSetOps[C]
Source
BitSet.scala
Линейные супертипы
SortedSetOps[Int, SortedSet, C], SortedOps[Int, C], SetOps[Int, Set, C], (Int) => Boolean, IterableOps[Int, Set, C], IterableOnceOps[Int, Set, C], IterableOnce[Int], AnyRef, Any
Известные подклассы
BitSet, BitSet, BitSet, BitSet1, BitSet2, BitSetN

Абстрактные члены Value

абстрактный def bitSetFactory: SpecificIterableFactory[Int, C]

абстрактный def coll: C

возвращает

Этот набор как C.

Атрибуты
protected
Определяющие классы
IterableOps

абстрактный def fromBitMaskNoCopy(elems: Array[Long]): C

Создаёт новый набор этого типа из массива long

Атрибуты
protected[scala.collection]

абстрактный def fromSpecific(coll: IterableOnce[Int]): C

Определяет, как преобразовать заданный Iterable[A] в набор типа C.

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

Атрибуты
protected
Определяющие классы
IterableOps
Примечание

При реализации пользовательского типа набора и уточнении C до нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В общем случае, когда C =:= CC[A], это можно сделать, смешав в IterableFactoryDefaults трейт, который реализует метод с использованием iterableFactory.

,

Как видно из аннотации @uncheckedVariance, использование этого метода может быть некорректным. Однако, до тех пор, пока он вызывается с Iterable[A] полученным из this набора (как это происходит при реализации операций, где используется View[A]), это безопасно.

абстрактный def iterableFactory: IterableFactory[Set]

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

Определяющие классы
IterableOps
Примечание

При реализации пользовательского типа набора и уточнении CC до нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (иначе компилятор выдаст ошибку).

абстрактный def newSpecificBuilder: Builder[Int, C]

возвращает

строгий билдер для того же типа набора. Обратите внимание, что в случае ленивых наборов (например, View или immutable.LazyList), реализовать этот метод возможно, но результирующий Builder нарушит ленивость. Поэтому операции предпочтительно реализовывать с fromSpecific вместо этого метода.

Атрибуты
protected
Определяющие классы
IterableOps
Примечание

При реализации пользовательского типа набора и уточнении C до нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В общем случае, когда C =:= CC[A], это можно сделать, смешав в IterableFactoryDefaults трейт, который реализует метод с использованием iterableFactory.

,

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

абстрактный def nwords: Int

Количество слов (каждое по 64 бита), составляющих набор.

Атрибуты
protected[scala.collection]

абстрактный def sortedIterableFactory: SortedIterableFactory[SortedSet]

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

Определяющие классы
SortedSetOps
Примечание

При реализации пользовательского типа набора и уточнении CC до нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (иначе компилятор выдаст ошибку).

абстрактный def toIterable: Iterable[Int]

возвращает

Этот набор как итератор. Новый набор не будет создан, если this уже является Iterable[A].

Определяющие классы
IterableOps

абстрактный def unsorted: Set[Int]

Определяющие классы
BitSetOps → SortedSetOps

абстрактный def word(idx: Int): Long

Слова с индексом idx, или 0L, если за пределами набора. Примечание: требует idx >= 0

Атрибуты
protected[scala.collection]

Члены конкретных значений

final def !=(arg0: Any): Boolean

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

возвращает

true если !(this == that), в противном случае false.

Определяющие классы
AnyRef → Any

final def ##(): Int

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

возвращает

значение хэша, согласованное с ==

Определяющие классы
AnyRef → Any

final def &(that: Set[Int]): C

Псевдоним для intersect

Определяющие классы
SetOps
Аннотации
@inline()

final def &~(that: Set[Int]): C

Псевдоним для diff

Определяющие классы
SetOps
Аннотации
@inline()

final def ++(that: IterableOnce[Int]): C

Псевдоним для concat

Определяющие классы
SetOps
Аннотации
@inline()

final def ++[B >: Int](suffix: IterableOnce[B]): Set[B]

Псевдоним для concat

Определяющие классы
IterableOps
Аннотации
@inline()

def ->[B](y: B): (BitSetOps[C], B)

Неявный
Этот член добавлен благодаря неявной конвертации из BitSetOps[C] в ArrowAssoc[BitSetOps[C]] с помощью метода ArrowAssoc в scala.Predef.
Определяющие классы
ArrowAssoc
Аннотации
@inline()

final def ==(arg0: Any): Boolean

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

возвращает

true если объект-получатель эквивалентен аргументу; false в противном случае.

Определяющие классы
AnyRef → Any

final def ^(other: BitSet): C

Аннотации
@inline()

final def addString(b: mutable.StringBuilder): mutable.StringBuilder

Добавляет все элементы этой коллекции в строковый билдер. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этой коллекции без разделительной строки.

Пример:

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

scala> val b = new StringBuilder()
b: StringBuilder =

scala> val h = a.addString(b)
h: StringBuilder = 1234
b

строковый билдер, в который добавляются элементы.

возвращает

строковый билдер b в который добавлялись элементы.

Определяющие классы
IterableOnceOps
Аннотации
@inline()

final def addString(b: mutable.StringBuilder, sep: String): mutable.StringBuilder

Добавляет все элементы этого набора в строковый буфер с использованием разделительной строки. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этого набора, разделенных строкой sep.

Пример:

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

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b, ", ")
res0: StringBuilder = 1, 2, 3, 4
b

строковый буфер, в который добавляются элементы.

sep

разделительная строка.

returns

строковый буфер b, в который были добавлены элементы.

Definition Classes
IterableOnceOps
Annotations
@inline()

def addString(b: mutable.StringBuilder, start: String, sep: String, end: String): mutable.StringBuilder

Добавляет все элементы этого набора в строковый буфер с использованием начальной, конечной и разделительной строк. Записанный текст начинается со строки start и заканчивается строкой end. Внутри строковые представления (относительно метода toString) всех элементов этого набора разделены строкой sep.

Пример:

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

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
b

строковый буфер, в который добавляются элементы.

start

начальная строка.

sep

разделительная строка.

end

конечная строка.

returns

строковый буфер b, в который были добавлены элементы.

Definition Classes
IterableOnceOps

def andThen[A](g: (Boolean) => A): (Int) => A

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

A

тип результата функции g

g

функция R => A

returns

новая функция f такая, что f(x) == g(apply(x))

Definition Classes
Function1
Annotations
@unspecialized()

final def apply(elem: Int): Boolean

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

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

elem

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

returns

true если elem содержится в этом наборе, false в противном случае.

Definition Classes
SetOps → Function1
Annotations
@inline()

final def asInstanceOf[T0]: T0

Приводит объект-получатель к типу T0.

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

returns

объект-получатель.

Definition Classes
Any
Исключения

ClassCastException если объект-получатель не является экземпляром стирания типа T0.

def clone(): AnyRef

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

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

returns

копия объекта-получателя.

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.CloneNotSupportedException]) @native()
Примечание

не определено в SLS как член AnyRef

def collect(pf: PartialFunction[Int, Int]): C

def collect[B](pf: PartialFunction[Int, B])(implicit ev: Ordering[B]): SortedSet[B]

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

B

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

pf

частичная функция, которая фильтрует и отображает множество.

returns

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

Definition Classes
SortedSetOps

def collect[B](pf: PartialFunction[Int, B]): Set[B]

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

B

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

pf

частичная функция, которая фильтрует и отображает итерируемую коллекцию.

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

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

def collectFirst[B](pf: PartialFunction[Int, B]): Option[B]

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

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

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

pf

частичная функция

returns

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

Definition Classes
IterableOnceOps
Пример:

    Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)

def compose[A](g: (A) => Int): (A) => Boolean

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

A

тип, к которому можно применить функцию g

g

функция A => T1

returns

новая функция f такая, что f(x) == apply(g(x))

Definition Classes
Function1
Annotations
@unspecialized()

def concat(other: IterableOnce[Int]): C

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

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

Пример:

scala> val a = Set(1, 2) concat Set(2, 3)
a: scala.collection.immutable.Set[Int] = Set(1, 2, 3)
returns

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

Definition Classes
BitSetOps → SetOps

def concat[B >: Int](suffix: IterableOnce[B]): Set[B]

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

B

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

suffix

перечисляемая для добавления.

returns

новая итерируемая коллекция, которая содержит все элементы этой итерируемой коллекции, за которыми следуют все элементы suffix.

Definition Classes
IterableOps

def contains(elem: Int): Boolean

Definition Classes
BitSetOps → SetOps

def copyToArray[B >: Int](xs: Array[B], start: Int, len: Int): Int

Копирует элементы в массив, возвращая количество скопированных элементов.

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

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

B

тип элементов массива.

xs

массив для заполнения.

start

начальный индекс xs.

len

максимальное количество элементов для копирования.

returns

количество элементов, записанных в массив

Definition Classes
IterableOnceOps
Note

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

def copyToArray[B >: Int](xs: Array[B], start: Int): Int

Копирует элементы в массив, возвращая количество скопированных элементов.

Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.

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

B

тип элементов массива.

xs

массив для заполнения.

start

начальный индекс xs.

returns

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

Definition Classes
IterableOnceOps

def copyToArray[B >: Int](xs: Array[B]): Int

Копирует элементы в массив, возвращая количество скопированных элементов.

Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.

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

B

тип элементов массива.

xs

массив для заполнения.

returns

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

Definition Classes
IterableOnceOps

def corresponds[B](that: IterableOnce[B])(p: (Int, B) => Boolean): Boolean

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

B

тип элементов that

that

другая коллекция

p

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

returns

true если обе коллекции имеют одинаковую длину и p(x, y) равно true для всех соответствующих элементов x этого итератора и y that, в противном случае false

Definition Classes
IterableOnceOps

def count(p: (Int) => Boolean): Int

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

p

предикат для проверки элементов.

returns

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

Definition Classes
IterableOnceOps

def diff(other: Set[Int]): C

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

returns

множество, содержащее элементы этого множества, которые также не содержатся в данном множестве that.

Definition Classes
BitSetOps → SetOps

def drop(n: Int): C

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

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

n

количество элементов для удаления из этой коллекции.

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

Переиспользование: После вызова этого метода итератор, на котором он был вызван, должен быть отброшен, и использоваться только возвращённый итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе.

def dropRight(n: Int): C

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

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

n

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

returns

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

Определяющие классы
IterableOps

def dropWhile(p: (Int) => Boolean): C

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

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

p

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

returns

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

Определяющие классы
IterableOps → IterableOnceOps
Примечание

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

def empty: C

Пустая итерируемая коллекция того же типа, что и эта итерируемая коллекция

returns

пустая итерируемая коллекция типа C.

Определяющие классы
IterableOps

def ensuring(cond: (BitSetOps[C]) => Boolean, msg: => Any): BitSetOps[C]

Неявное
Этот член добавлен неявным преобразованием из BitSetOps[C] в Ensuring[BitSetOps[C]] с помощью метода Ensuring в scala.Predef.
Определяющие классы
Ensuring

def ensuring(cond: (BitSetOps[C]) => Boolean): BitSetOps[C]

Неявное
Этот член добавлен неявным преобразованием из BitSetOps[C] в Ensuring[BitSetOps[C]] с помощью метода Ensuring в scala.Predef.
Определяющие классы
Ensuring

def ensuring(cond: Boolean, msg: => Any): BitSetOps[C]

Неявное
Этот член добавлен неявным преобразованием из BitSetOps[C] в Ensuring[BitSetOps[C]] с помощью метода Ensuring в scala.Predef.
Определяющие классы
Ensuring

def ensuring(cond: Boolean): BitSetOps[C]

Неявное
Этот член добавлен неявным преобразованием из BitSetOps[C] в Ensuring[BitSetOps[C]] с помощью метода Ensuring в scala.Predef.
Определяющие классы
Ensuring

final def eq(arg0: AnyRef): Boolean

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

returns

true если аргумент является ссылкой на объект-получатель; false в противном случае.

Определяющие классы
AnyRef

def equals(arg0: AnyRef): Boolean

Метод проверки равенства для ссылочных типов. Реализация по умолчанию делегирует вызов методу eq.

Смотрите также equals в scala.Any.

returns

true если объект-приемник эквивалентен аргументу; false в противном случае.

Definition Classes
AnyRef → Any

def exists(p: (Int) => Boolean): Boolean

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

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

p

предикат для проверки элементов.

returns

true если заданный предикат p выполняется хотя бы для одного элемента в этом наборе, иначе false

Definition Classes
IterableOnceOps

def filter(pred: (Int) => Boolean): C

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

returns

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

Definition Classes
IterableOps → IterableOnceOps

def filterNot(pred: (Int) => Boolean): C

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

pred

предикат для проверки элементов.

returns

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

Definition Classes
IterableOps → IterableOnceOps

def finalize(): Unit

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

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

def find(p: (Int) => Boolean): Option[Int]

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

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

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

def firstKey: Int

Возвращает первый ключ набора.

def flatMap(f: (Int) => IterableOnce[Int]): C

def flatMap[B](f: (Int) => IterableOnce[B])(implicit ev: Ordering[B]): SortedSet[B]

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

def flatMap[B](f: (Int) => IterableOnce[B]): Set[B]

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

Например:

def getWords(lines: Seq[String]): Seq[String] = lines flatMap (line => line split "\\W+")

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

// lettersOf will return a Seq[Char] of likely repeated letters, instead of a Set
def lettersOf(words: Seq[String]) = words flatMap (word => word.toSet)

// lettersOf will return a Set[Char], not a Seq
def lettersOf(words: Seq[String]) = words.toSet flatMap ((word: String) => word.toSeq)

// xs will be an Iterable[Int]
val xs = Map("a" -> List(11,111), "b" -> List(22,222)).flatMap(_._2)

// ys will be a Map[Int, Int]
val ys = Map("a" -> List(1 -> 11,1 -> 111), "b" -> List(2 -> 22,2 -> 222)).flatMap(_._2)
B

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

f

функция, применяемая к каждому элементу.

returns

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

Определяющие классы
IterableOps → IterableOnceOps
Примечание

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

def flatten[B](implicit asIterable: (Int) => IterableOnce[B]): Set[B]

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

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

val xs = List(
           Set(1, 2, 3),
           Set(1, 2, 3)
         ).flatten
// xs == List(1, 2, 3, 1, 2, 3)

val ys = Set(
           List(1, 2, 3),
           List(3, 2, 1)
         ).flatten
// ys == Set(1, 2, 3)
B

тип элементов каждой итерируемой коллекции.

asIterable

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

returns

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

Определяющие классы
IterableOps → IterableOnceOps
Примечание

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

def fold[A1 >: Int](z: A1)(op: (A1, A1) => A1): A1

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

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

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

A1

типовой параметр для бинарного оператора, супертип A.

z

нейтральный элемент для операции сворачивания; может быть добавлен к результату произвольное количество раз, и не должен изменять результат (например, Nil для конкатенации списков, 0 для сложения или 1 для умножения).

op

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

returns

результат применения оператора сворачивания op ко всем элементам и z, или z, если эта коллекция пуста.

Определяющие классы
IterableOnceOps

def foldLeft[B](z: B)(op: (B, Int) => B): B

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

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

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

B

результирующий тип бинарного оператора.

z

начальное значение.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этой коллекции, слева направо с начальным значением z слева:

op(...op(z, x_1), x_2, ..., x_n)

где x1, ..., xn — элементы этой коллекции. Возвращает z, если эта коллекция пуста.

Определяющие классы
IterableOnceOps

def foldRight[B](z: B)(op: (Int, B) => B): B

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

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

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

B

результирующий тип бинарного оператора.

z

начальное значение.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этой коллекции, справа налево с начальным значением z справа:

op(x_1, op(x_2, ... op(x_n, z)...))

где x1, ..., xn — элементы этой коллекции. Возвращает z, если эта коллекция пуста.

Определяющие классы
IterableOnceOps

def forall(p: (Int) => Boolean): Boolean

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

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

p

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

returns

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

Определяющие классы
IterableOnceOps

def foreach[U](f: (Int) => U): Unit

Применить f к каждому элементу для его побочных эффектов. Примечание: параметр [U] необходим для помощи выводу типа scalac.

Определяющие классы
BitSetOps → IterableOnceOps

def formatted(fmtstr: String): String

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

Неявный
Этот член добавляется неявным преобразованием из BitSetOps[C] в StringFormat[BitSetOps[C]] с помощью метода StringFormat в scala.Predef.
Определяющие классы
StringFormat
Аннотации
@inline()

final def getClass(): Class[_ <: AnyRef]

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

возвращает

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

Определяющие классы
AnyRef → Any
Аннотации
@native()

def groupBy[K](f: (Int) => K): immutable.Map[K, C]

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

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

K

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

f

функция дискриминатора.

возвращает

Карта из ключей в итерируемые коллекции, так что соблюдается следующее инвариантное условие:

(xs groupBy f)(k) = xs filter (x => f(x) == k)

То есть каждый ключ k связан с итерируемой коллекцией тех элементов x, для которых f(x) равно k.

Определяющие классы
IterableOps

def groupMap[K, B](key: (Int) => K)(f: (Int) => B): immutable.Map[K, Set[B]]

Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с функцией дискриминатора key. Каждый элемент в группе преобразуется в значение типа B с помощью функции value.

Это эквивалентно groupBy(key).mapValues(_.map(f)), но более эффективно.

case class User(name: String, age: Int)

def namesByAge(users: Seq[User]): Map[Int, Seq[String]] =
  users.groupMap(_.age)(_.name)

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

K

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

B

тип значений, возвращаемых функцией преобразования

key

функция дискриминатора

f

функция преобразования элементов

Определяющие классы
IterableOps

def groupMapReduce[K, B](key: (Int) => K)(f: (Int) => B)(reduce: (B, B) => B): immutable.Map[K, B]

Разделяет эту итерируемую коллекцию на карту в соответствии с функцией дискриминатора key. Все значения, имеющие один и тот же дискриминатор, затем преобразуются функцией value и затем сводятся к одному значению с помощью функции reduce.

Это эквивалентно groupBy(key).mapValues(_.map(f).reduce(reduce)), но более эффективно.

def occurrences[A](as: Seq[A]): Map[A, Int] =
  as.groupMapReduce(identity)(_ => 1)(_ + _)

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

Определяющие классы
IterableOps

def grouped(size: Int): Iterator[C]

Разделяет элементы на итерируемые коллекции фиксированного размера.

size

количество элементов в группе

возвращает

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

Определяющие классы
IterableOps
См. также

scala.collection.Iterator, метод grouped

def hashCode(): Int

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

returns

значение хэш-кода для этого объекта.

Definition Classes
AnyRef → Any
Annotations
@native()

def head: Int

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

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

returns

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

Definition Classes
IterableOps
Исключения

NoSuchElementException, если итерируемый набор пуст.

def headOption: Option[Int]

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

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

returns

первый элемент этого итерируемого набора, если он не пуст, None если он пуст.

Definition Classes
IterableOps

def init: C

Начальная часть набора без последнего элемента.

Примечание: Даже при применении к представлению или ленивому набору элементы всегда будут форсироваться.

Definition Classes
IterableOps

def inits: Iterator[C]

Итерируется по начальным частям этого итерируемого набора. Первое значение будет этим итерируемым набором, а последнее — пустым итерируемым набором, а промежуточные значения — результатом последовательных применений init.

Примечание: Даже при применении к представлению или ленивому набору элементы всегда будут форсироваться.

returns

итератор по всем начальным частям этого итерируемого набора

Definition Classes
IterableOps
Пример:

    List(1,2,3).inits = Iterator(List(1,2,3), List(1,2), List(1), Nil)

def intersect(other: Set[Int]): C

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

returns

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

Definition Classes
BitSetOps → SetOps

def isEmpty: Boolean

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

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

returns

true если набор не содержит элементов, false в противном случае.

Definition Classes
BitSetOps → IterableOnceOps

final def isInstanceOf[T0]: Boolean

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

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

returns

true если объект-получатель является экземпляром стёртого типа T0; false в противном случае.

Definition Classes
Any

def isTraversableAgain: Boolean

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

returns

true если набор повторно проходим, false в противном случае.

Definition Classes
IterableOps → IterableOnceOps

def iterator: Iterator[Int]

Итератор может быть использован только один раз

Definition Classes
BitSetOps → IterableOnce

def iteratorFrom(start: Int): Iterator[Int]

Создаёт итератор, содержащий все значения из этого набора, большие или равные start в соответствии с порядком этого набора. x.iteratorFrom(y) эквивалентно, но обычно более эффективно, чем x.from(y).iterator

start

Нижняя граница (включительно) итератора

Definition Classes
BitSetOps → SortedSetOps

def knownSize: Int

returns

Количество элементов в этом наборе, если его можно вычислить без больших затрат, -1 в противном случае. Без больших затрат обычно означает: не требуя прохода по набору.

Definition Classes
IterableOnce

def last: Int

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

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

returns

Последний элемент этой итерируемой коллекции.

Definition Classes
IterableOps
Exceptions thrown

NoSuchElementException Если итерируемая коллекция пуста.

def lastKey: Int

Возвращает последний ключ коллекции.

Definition Classes
SortedSetOps → SortedOps

def lastOption: Option[Int]

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

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

returns

последний элемент этой итерируемой коллекции$ если она не пуста, None если она пуста.

Definition Classes
IterableOps

def map(f: (Int) => Int): C

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

f

функция, применяемая к каждому элементу.

returns

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

def map[B](f: (Int) => B)(implicit ev: Ordering[B]): SortedSet[B]

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

B

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

f

функция, применяемая к каждому элементу.

returns

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

Definition Classes
SortedSetOps

def map[B](f: (Int) => B): Set[B]

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

B

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

f

функция, применяемая к каждому элементу.

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

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

def max[B >: Int](implicit ord: Ordering[B]): Int

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

B

Тип, по которому определено упорядочение.

ord

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

returns

наибольший элемент этого множества относительно упорядочения ord.

Definition Classes
BitSetOps → SortedSetOps → IterableOnceOps
Exceptions thrown

UnsupportedOperationException если это множество пусто.

def maxBefore(key: Int): Option[Int]

Находит наибольший элемент, меньший заданного ключа.

key

Заданный ключ.

returns

None если такого узла нет.

Definition Classes
SortedSetOps

def maxBy[B](f: (Int) => B)(implicit cmp: math.Ordering[B]): Int

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

B

Тип результата функции f.

f

Функция измерения.

cmp

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

returns

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

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def maxByOption[B](f: (Int) => B)(implicit cmp: math.Ordering[B]): Option[Int]

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

B

Тип результата функции f.

f

Функция измерения.

cmp

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

returns

опциональное значение, содержащее первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка cmp.

Определяющие классы
IterableOnceOps

def maxOption[B >: Int](implicit ord: math.Ordering[B]): Option[Int]

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

B

Тип, над которым определен порядок.

ord

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

returns

опциональное значение, содержащее наибольший элемент этой коллекции относительно порядка ord.

Определяющие классы
IterableOnceOps

def min[B >: Int](implicit ord: Ordering[B]): Int

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

B

Тип, над которым определен порядок.

ord

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

returns

наименьший элемент этого множества относительно порядка ord.

Определяющие классы
BitSetOps → SortedSetOps → IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если это множество пусто.

def minAfter(key: Int): Option[Int]

Найти наименьший элемент, больший или равный данному ключу.

key

Данный ключ.

returns

None если такого узла нет.

Определяющие классы
SortedSetOps

def minBy[B](f: (Int) => B)(implicit cmp: math.Ordering[B]): Int

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

B

Тип результата функции f.

f

Функция измерения.

cmp

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

returns

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

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def minByOption[B](f: (Int) => B)(implicit cmp: math.Ordering[B]): Option[Int]

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

B

Тип результата функции f.

f

Функция измерения.

cmp

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

returns

опциональное значение, содержащее первый элемент этой коллекции с наименьшим значением, измеренным функцией f относительно порядка cmp.

Определяющие классы
IterableOnceOps

def minOption[B >: Int](implicit ord: math.Ordering[B]): Option[Int]

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

B

Тип, над которым определено упорядочение.

ord

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

returns

значение типа Option, содержащее наименьший элемент этого набора относительно упорядочения ord.

Definition Classes
IterableOnceOps

final def mkString: String

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

Делегирует вызов addString, который можно переопределить.

returns

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

Definition Classes
IterableOnceOps
Annotations
@inline()

final def mkString(sep: String): String

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

Делегирует вызов addString, который можно переопределить.

sep

разделительная строка.

returns

строковое представление этого набора. В результирующей строке строковые представления (с использованием метода toString) всех элементов этого набора разделяются строкой sep.

Definition Classes
IterableOnceOps
Annotations
@inline()
Пример:

    List(1, 2, 3).mkString("|") = "1|2|3"

final def mkString(start: String, sep: String, end: String): String

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

Делегирует вызов addString, который можно переопределить.

start

начальная строка.

sep

разделительная строка.

end

конечная строка.

returns

строковое представление этого набора. Результирующая строка начинается со строки start и заканчивается строкой end. Внутри, строковые представления (с использованием метода toString) всех элементов этого набора разделяются строкой sep.

Definition Classes
IterableOnceOps
Пример:

    List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"

final def ne(arg0: AnyRef): Boolean

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

returns

true если аргумент не является ссылкой на объект-получатель; false в противном случае.

Definition Classes
AnyRef

def nonEmpty: Boolean

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

returns

true если набор содержит по крайней мере один элемент, false в противном случае.

Definition Classes
IterableOnceOps
Annotations
@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

не специфицируется SLS как член AnyRef

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

не специфицируется SLS как член AnyRef

final def ordering: Ordering[Int]

Definition Classes
BitSetOps → SortedOps

def partition(p: (Int) => Boolean): (C, C)

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

Предусмотренная здесь реализация по умолчанию требует двух проходов по набору. Наборам со строгой семантикой есть переопределённая версия partition в StrictOptimizedIterableOps, которая требует только одного прохода.

Definition Classes
BitSetOps → IterableOps

def partitionMap[A1, A2](f: (Int) => Either[A1, A2]): (Set[A1], Set[A2])

Применяет функцию f к каждому элементу итерируемой коллекции и возвращает пару итерируемых коллекций: первая состоит из значений, возвращенных f, которые были обернуты в scala.util.Left, а вторая — из тех, которые были обернуты в scala.util.Right.

Пример:

val xs = Iterable(1, "one", 2, "two", 3, "three") partitionMap {
 case i: Int => Left(i)
 case s: String => Right(s)
}
// xs == (Iterable(1, 2, 3),
//        Iterable(one, two, three))
A1

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

A2

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

f

'функция разделения', отображающая элементы этой итерируемой коллекции на scala.util.Either

returns

пара итерируемых коллекций: первая состоит из значений, возвращенных f, которые были обернуты в scala.util.Left, а вторая — из тех, которые были обернуты в scala.util.Right.

Определяющие классы
IterableOps

def product[B >: Int](implicit num: math.Numeric[B]): B

Перемножает элементы этой коллекции.

B

результирующий тип оператора *.

num

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

returns

произведение всех элементов этой коллекции относительно оператора * в num.

Определяющие классы
IterableOnceOps

def range(from: Int, until: Int): C

Создает диапазон проекции этой коллекции с нижней и верхней границами.

from

Нижняя граница (включительно) диапазона проекции.

until

Верхняя граница (исключительно) диапазона проекции.

Определяющие классы
SortedOps

def rangeFrom(from: Int): C

Создает диапазон проекции этой коллекции без верхней границы.

from

Нижняя граница (включительно) диапазона проекции.

Определяющие классы
SortedOps

def rangeImpl(from: Option[Int], until: Option[Int]): C

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

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

from

Нижняя граница (включительно) диапазона проекции. None если нет нижней границы.

until

Верхняя граница (исключительно) диапазона проекции. None если нет верхней границы.

Определяющие классы
BitSetOps → SortedOps

def rangeTo(to: Int): C

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

to

Верхняя граница (включительно) диапазона проекции.

Определяющие классы
SortedSetOps → SortedOps

def rangeUntil(until: Int): C

Создает диапазон проекции этой коллекции без нижней границы.

until

Верхняя граница (исключительно) диапазона проекции.

Определяющие классы
SortedOps

def reduce[B >: Int](op: (B, B) => B): B

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

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

B

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

op

Бинарный оператор, который должен быть ассоциативным.

returns

Результат применения оператора reduce op между всеми элементами, если коллекция не пуста.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def reduceLeft[B >: Int](op: (B, Int) => B): B

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

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

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

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этой коллекции, слева направо:

op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)

где x1, ..., xn - элементы этой коллекции.

Определяющие классы
IterableOnceOps
Исключения

UnsupportedOperationException если эта коллекция пуста.

def reduceLeftOption[B >: Int](op: (B, Int) => B): Option[B]

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

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

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

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

необязательное значение, содержащее результат reduceLeft(op) если эта коллекция не пуста, None в противном случае.

Определяющие классы
IterableOnceOps

def reduceOption[B >: Int](op: (B, B) => B): Option[B]

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

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

B

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

op

Бинарный оператор, который должен быть ассоциативным.

returns

Необязательное значение, содержащее результат применения оператора reduce op между всеми элементами, если коллекция не пуста, и None в противном случае.

Определяющие классы
IterableOnceOps

def reduceRight[B >: Int](op: (Int, B) => B): B

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

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

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

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этой коллекции, справа налево:

op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))

где x1, ..., xn - элементы этой коллекции.

Определяющие классы
IterableOnceOps
Исключения

UnsupportedOperationException если эта коллекция пуста.

def reduceRightOption[B >: Int](op: (Int, B) => B): Option[B]

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

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

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

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

необязательное значение, содержащее результат reduceRight(op) если эта коллекция не пуста, None в противном случае.

Определяющие классы
IterableOnceOps

def reversed: Iterable[Int]

Атрибуты
protected
Определяющие классы
IterableOnceOps

def scan[B >: Int](z: B)(op: (B, B) => B): Set[B]

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

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

B

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

z

нейтральный элемент для оператора op

op

ассоциативный оператор для сканирования

returns

новая итерируемая коллекция, содержащая сканирование префикса элементов в этой итерируемой коллекции

Definition Classes
IterableOps

def scanLeft[B](z: B)(op: (B, Int) => B): Set[B]

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

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

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

B

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

z

начальное значение

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

коллекция с промежуточными результатами

Definition Classes
IterableOps → IterableOnceOps
Примечание

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

def scanRight[B](z: B)(op: (Int, B) => B): Set[B]

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

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

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

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

Пример:

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

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

z

начальное значение

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

коллекция с промежуточными результатами

Definition Classes
IterableOps

def size: Int

Размер этого множества.

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

returns

количество элементов в этом множестве.

Definition Classes
BitSetOps → IterableOnceOps

def sizeCompare(that: Iterable[_]): Int

Сравнивает размер этой итерируемой коллекции с размером другой Iterable.

that

другая Iterable для сравнения размера с размером этой итерируемой коллекции.

returns

Значение x, где

x <  0       if this.size <  that.size
x == 0       if this.size == that.size
x >  0       if this.size >  that.size

Данный метод не вызывает size напрямую; его время выполнения — O(this.size min that.size) вместо O(this.size + that.size). Метод следует переопределять, если вычисление size является дешёвым, а knownSize возвращает -1.

Definition Classes
IterableOps

def sizeCompare(otherSize: Int): Int

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

otherSize

тестовое значение для сравнения с размером.

returns

Значение x, где

x <  0       if this.size <  otherSize
x == 0       if this.size == otherSize
x >  0       if this.size >  otherSize

Данный метод не вызывает size напрямую; его время выполнения — O(size min otherSize) вместо O(size). Метод следует переопределять, если вычисление size является дешёвым, а knownSize возвращает -1.

Definition Classes
IterableOps
См. также

sizeIs

final def sizeIs: SizeCompareOps

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

Эти операции реализованы с помощью sizeCompare(Int) и позволяют использовать более читаемый код:

this.sizeIs < size     // this.sizeCompare(size) < 0
this.sizeIs <= size    // this.sizeCompare(size) <= 0
this.sizeIs == size    // this.sizeCompare(size) == 0
this.sizeIs != size    // this.sizeCompare(size) != 0
this.sizeIs >= size    // this.sizeCompare(size) >= 0
this.sizeIs > size     // this.sizeCompare(size) > 0
Definition Classes
IterableOps
Аннотации
@inline()

def slice(from: Int, until: Int): C

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

from <= indexOf(x) < until

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

from

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

until

наименьший индекс для ИСКЛЮЧЕНИЯ из этой итерируемой коллекции.

returns

итерируемая коллекция, содержащая элементы, большие или равные индексу from, простирающаяся до (но не включая) индекс until этой итерируемой коллекции.

Definition Classes
IterableOps → IterableOnceOps
Note

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

def sliding(size: Int, step: Int): Iterator[C]

Группирует элементы в блоки фиксированного размера, передавая «скользящее окно» над ними (в отличие от разделения их, как это делается в grouped.)

size

количество элементов в группе

step

расстояние между первыми элементами последовательных групп

returns

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

Definition Classes
IterableOps
See also

scala.collection.Iterator, метод sliding

def sliding(size: Int): Iterator[C]

Группирует элементы в блоки фиксированного размера, передавая «скользящее окно» над ними (в отличие от разделения их, как это делается в grouped.) Шаг «скользящего окна» установлен в единицу.

size

количество элементов в группе

returns

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

Definition Classes
IterableOps
See also

scala.collection.Iterator, метод sliding

def span(p: (Int) => Boolean): (C, C)

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

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

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

p

тестовый предикат

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

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

def splitAt(n: Int): (C, C)

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

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

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

n

позиция, в которой следует разделить.

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

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

def stepper[S <: Stepper[_]](implicit shape: StepperShape[Int, S]): S with EfficientSplit

Возвращает Stepper для элементов этого набора.

Stepper позволяет создавать Java-поток для работы с набором, см. scala.jdk.StreamConverters. Для наборов, содержащих примитивные значения, Stepper можно использовать как итератор, который не упаковывает элементы.

Неявный параметр StepperShape определяет тип результирующего Stepper в соответствии с типом элементов этого набора.

    Для наборов Int, Short, Byte или Char, возвращается IntStepperДля наборов Double или Float, возвращается DoubleStepperДля наборов Long возвращается LongStepperДля любого другого типа элементов возвращается AnyStepper

Обратите внимание, что этот метод переопределен в подклассах, и тип возвращаемого значения уточняется до S with EfficientSplit, например IndexedSeqOps.stepper. Для Stepper, помеченных scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Stepper могут быть преобразованы только в последовательные потоки.

Definition Classes
BitSetOps → IterableOnce

def subsetOf(that: Set[Int]): Boolean

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

that

тестируемый набор.

returns

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

Definition Classes
SetOps

def subsets(): Iterator[C]

Итератор по всем подмножествам этого набора.

returns

итератор.

Definition Classes
SetOps

def subsets(len: Int): Iterator[C]

Итератор по всем подмножествам этого набора заданного размера. Если запрашиваемый размер невозможен, возвращается пустой итератор.

len

размер подмножеств.

returns

итератор.

Definition Classes
SetOps

def sum[B >: Int](implicit num: math.Numeric[B]): B

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

B

тип результата оператора +.

num

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

returns

сумма всех элементов этого набора относительно оператора + в num.

Definition Classes
IterableOnceOps

final def synchronized[T0](arg0: => T0): T0

Definition Classes
AnyRef

def tail: C

Остальная часть набора без первого элемента.

Definition Classes
IterableOps

def tails: Iterator[C]

Итерирует по хвостам этого итерируемого набора. Первое значение будет этим итерируемым набором, а последнее — пустым итерируемым набором, а промежуточные значения — результаты последовательных применений tail.

returns

итератор по всем хвостам этого итерируемого набора

Definition Classes
IterableOps
Пример:

    List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)

def take(n: Int): C

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

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

n

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

returns

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

Definition Classes
IterableOps → IterableOnceOps
Примечание

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

def takeRight(n: Int): C

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

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

n

количество элементов, которые нужно взять из этой итерируемой коллекции.

возвращает

итерируемую коллекцию, содержащую только последние n элементы этой итерируемой коллекции, или же всю итерируемую коллекцию, если она содержит меньше, чем n элементов. Если n отрицательно, возвращает пустую итерируемую коллекцию.

Классы определения
IterableOps

def takeWhile(p: (Int) => Boolean): C

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

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

p

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

возвращает

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

Классы определения
IterableOps → IterableOnceOps

def tapEach[U](f: (Int) => U): C

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

U

тип возвращаемого значения f

f

функция, которую нужно применить к каждому элементу в этой итерируемой коллекции

возвращает

Такая же логическая коллекция, как и эта

Классы определения
IterableOps → IterableOnceOps

def to[C1](factory: Factory[Int, C1]): C1

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

xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]

Классы определения
IterableOnceOps

def toArray[B >: Int](implicit arg0: ClassTag[B]): Array[B]

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

Классы определения
IterableOnceOps

def toBitMask: Array[Long]

final def toBuffer[B >: Int]: Buffer[B]

Классы определения
IterableOnceOps
Аннотации
@inline()

def toIndexedSeq: immutable.IndexedSeq[Int]

Классы определения
IterableOnceOps

def toList: immutable.List[Int]

Классы определения
IterableOnceOps

def toMap[K, V](implicit ev: <:<[Int, (K, V)]): immutable.Map[K, V]

Классы определения
IterableOnceOps

def toSeq: immutable.Seq[Int]

возвращает

Эта коллекция как Seq[A]. Это эквивалентно to(Seq), но может быть быстрее.

Классы определения
IterableOnceOps

def toSet[B >: Int]: immutable.Set[B]

Классы определения
IterableOnceOps

def toString(): String

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

возвращает

строковое представление объекта.

Определяющие классы
Function1 → AnyRef → Any

def toVector: immutable.Vector[Int]

Определяющие классы
IterableOnceOps

def transpose[B](неявный asIterable: (Int) => Iterable[B]): Set[Set[B]]

Транспонирует это итерируемое множество итерируемых множеств в итерируемое множество итерируемых множеств.

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

val xs = List(
           Set(1, 2, 3),
           Set(4, 5, 6)).transpose
// xs == List(
//         List(1, 4),
//         List(2, 5),
//         List(3, 6))

val ys = Vector(
           List(1, 2, 3),
           List(4, 5, 6)).transpose
// ys == Vector(
//         Vector(1, 4),
//         Vector(2, 5),
//         Vector(3, 6))

Примечание: Даже при применении к представлению или ленивому множеству элементы всегда будут форсироваться.

B

тип элементов каждого итерируемого множества.

asIterable

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

возвращает

двумерное итерируемое множество итерируемых множеств, в котором n-я строка является n-м столбцом этого итерируемого множества.

Определяющие классы
IterableOps
Исключения

IllegalArgumentException, если все множества в этом итерируемом множестве не имеют одинаковый размер.

final def union(that: Set[Int]): C

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

that

множество, с которым формируется объединение.

возвращает

новое множество, состоящее из всех элементов, которые находятся в этом множестве или в заданном множестве that.

Определяющие классы
SetOps
Аннотации
@inline()

def unzip[A1, A2](неявный asPair: (Int) => (A1, A2)): (Set[A1], Set[A2])

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

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

тип первой половины пар элементов

A2

тип второй половины пар элементов

asPair

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

возвращает

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

Определяющие классы
IterableOps

def unzip3[A1, A2, A3](неявный asTriple: (Int) => (A1, A2, A3)): (Set[A1], Set[A2], Set[A3])

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

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

тип первого члена троек элементов

A2

тип второго члена троек элементов

A3

тип третьего члена троек элементов

asTriple

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

возвращает

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

Определяющие классы
IterableOps

def view: View[Int]

Представление над элементами этого множества.

Определяющие классы
IterableOps

final def wait(): Unit

Определяющие классы
AnyRef
Аннотации
@throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long, arg1: Int): Unit

Определяющие классы
AnyRef
Аннотации
@throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException]) @native()

def withFilter(p: (Int) => Boolean): WithFilter[Int, Set]

Создаёт нестрогий фильтр этого итерируемого набора.

Примечание: разница между c filter p и c withFilter p заключается в том, что первый создаёт новый набор, а второй только ограничивает область действия последующих map, flatMap, foreach, и withFilter операций.

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

p

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

returns

объект класса WithFilter, который поддерживает map, flatMap, foreach, и withFilter операции. Все эти операции применяются к элементам этого итерируемого набора, удовлетворяющим предикату p.

Definition Classes
IterableOps

def xor(other: BitSet): C

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

other

другой набор битов, участвующий в симметрической разности.

returns

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

def zip[B](that: IterableOnce[B])(implicit ev: Ordering[(Int, B)]): SortedSet[(Int, B)]

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

B

тип второй половины возвращаемых пар

that

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

returns

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

Definition Classes
SortedSetOps

def zip[B](that: IterableOnce[B]): Set[(Int, B)]

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

B

тип второй половины возвращаемых пар

that

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

returns

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

Definition Classes
IterableOps

def zipAll[A1 >: Int, B](that: Iterable[B], thisElem: A1, thatElem: B): Set[(A1, B)]

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

that

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

thisElem

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

thatElem

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

returns

новый набор типа That, содержащий пары, состоящие из соответствующих элементов этого итерируемого набора и that. Длина возвращаемого набора равна максимальному из длин этого итерируемого набора и that . Если этот итерируемый набор короче that, для заполнения результата используются значения thisElem. Если that короче этого итерируемого набора, для заполнения результата используются значения thatElem.

Definition Classes
IterableOps

def zipWithIndex: Set[(Int, Int)]

Упаковывает этот итерируемый набор со своими индексами.

returns

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

Definition Classes
IterableOps → IterableOnceOps
Пример:

    List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))

Note

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

final def |(that: Множество[Целое число]): C

Псевдоним для union

Definition Classes
SetOps
Annotations
@inline()

Затенённые неявные члены значения

def +(other: Строка): Строка

Неявный
Этот член добавлен с помощью неявного преобразования из BitSetOps[C] в any2stringadd[BitSetOps[C]], выполненного методом any2stringadd в scala.Predef.
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(bitSetOps: any2stringadd[BitSetOps[C]]).+(other)
Definition Classes
any2stringadd

© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/collection/BitSetOps.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API