Трейт scala.collection.mutable.Traversable

Компонент объект Traversable

Трейт Traversable[A] extends collection.Traversable[A] with GenericTraversableTemplate[A, Traversable] with TraversableLike[A, Traversable[A]] with Mutable

Трейт для коллекций, которые могут быть изменены.

Это базовый трейт всех типов изменяемых коллекций Scala. Он реализует поведение, общее для всех коллекций, в терминах метода foreach со следующим сигнатурой:

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

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

Класс Traversable может или не может иметь два свойства: строгость и упорядоченность. Ни одно из них не представлено как тип.

Экземпляры строгой коллекции вычисляют все свои элементы, прежде чем они могут быть использованы в качестве значений. Напротив, экземпляры нестрогой коллекции могут отложить вычисление некоторых своих элементов до тех пор, пока экземпляр не будет доступен как значение. Типичный пример нестрогой коллекции - scala.collection.immutable.Stream. Более общие примеры - TraversableViews.

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

Типичный пример класса коллекции, который не упорядочен, — это HashMap объектов. Порядок обхода хэш-таблиц будет зависеть от хэш-кодов ее элементов, а эти хэш-коды могут отличаться от одного запуска к другому. Напротив, LinkedHashMap упорядочен, потому что его метод foreach обходит элементы в порядке их вставки в HashMap.

Источник: Traversable.scala

Линейные надтипы

Известные подклассы

Члены типа

Класс WithFilter extends FilterMonadic[A, Repr]

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

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

Тип Self = Traversable[A]

Тип, реализующий эту traversable

Атрибуты: protected[this]
Определяющие классы: TraversableLike

Члены-значения

final def !=(arg0: Any): Boolean

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

возвращает: true если !(this == that), иначе false.

Классы-определения: AnyRef → Any

final def ##(): Int

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

возвращает: значение хеша, согласованное с ==

Классы-определения: AnyRef → Any

def +(other: String): String

Неявный: Этот член добавлен благодаря неявной конвертации из Traversable[A] в any2stringadd[Traversable[A]], выполненной методом any2stringadd в scala.Predef.
Классы-определения: any2stringadd

def ++[B >: A, That](that: GenTraversableOnce[B])(implicit bf: CanBuildFrom[Traversable[A], B, That]): That

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

B: тип элемента возвращаемой коллекции.
That: класс возвращаемой коллекции. Там, где это возможно, That — это тот же класс, что и текущий класс коллекции Repr, но это зависит от типа элемента B , допустимого для этого класса, что означает, что найдена неявная сущность типа CanBuildFrom[Repr, B, That].
that: добавляемая коллекция.
bf: неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.
возвращает: новая коллекция типа That, которая содержит все элементы этой коллекции, за которыми следуют все элементы that.

Классы-определения: TraversableLike → GenTraversableLike

def ++:[B >: A, That](that: collection.Traversable[B])(implicit bf: CanBuildFrom[Traversable[A], B, That]): That

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

Она отличается от ++ тем, что правый операнд определяет тип результирующей коллекции, а не левый. Мнемоника: символ COLon находится со стороны нового типа COLлекции.

Пример:

scala> val x = List(1)
x: List[Int] = List(1)

scala> val y = LinkedList(2)
y: scala.collection.mutable.LinkedList[Int] = LinkedList(2)

scala> val z = x ++: y
z: scala.collection.mutable.LinkedList[Int] = LinkedList(1, 2)

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

Так как TraversableOnce не имеет метода ++, мы должны реализовать его напрямую, но Traversable и ниже могут использовать перегруз.

B: тип элемента возвращаемой коллекции.
That: класс возвращаемой коллекции. Там, где это возможно, That — это тот же класс, что и текущий класс коллекции Repr, но это зависит от типа элемента B , допустимого для этого класса, что означает, что найдена неявная сущность типа CanBuildFrom[Repr, B, That].
that: добавляемая коллекция.
bf: неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.
возвращает: новая коллекция типа That, которая содержит все элементы этой коллекции, за которыми следуют все элементы that.

Классы-определения: TraversableLike

def ++:[B](that: TraversableOnce[B]): Traversable[B]

[use case]

Пример:

scala> val x = List(1)
x: List[Int] = List(1)

scala> val y = LinkedList(2)
y: scala.collection.mutable.LinkedList[Int] = LinkedList(2)

scala> val z = x ++: y
z: scala.collection.mutable.LinkedList[Int] = LinkedList(1, 2)

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

Классы-определения: TraversableLike

def ->[B](y: B): (Перечислимый[A], B)

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

def /:[B](z: B)(op: (B, A) ⇒ B): B

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

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

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

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

B

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

z

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

op

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

возвращает

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

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

где x₁, ..., x_n — элементы этого перечислимого объекта или итератора.

Классы определений: TraversableOnce → GenTraversableOnce

def :\[B](z: B)(op: (A, B) ⇒ B): B

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

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

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

Примеры:

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

B

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

z

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

op

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

возвращает

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

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

где x₁, ..., x_n — элементы этого перечислимого объекта или итератора.

Классы определений: TraversableOnce → GenTraversableOnce

final def ==(arg0: Любой): Boolean

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

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

Классы определений: AnyRef → Любой

def addString(b: scala.StringBuilder): scala.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 в который были добавлены элементы.

Классы определений: TraversableOnce

def addString(b: scala.StringBuilder, sep: String): scala.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: разделительная строка.
возвращает: строковый буфер b в который были добавлены элементы.

Классы определений: TraversableOnce

def addString(b: scala.StringBuilder, start: String, sep: String, end: String): scala.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: TraversableOnce

def aggregate[B](z: ⇒ B)(seqop: (B, A) ⇒ B, combop: (B, B) ⇒ B): B

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

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

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

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

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

B: тип накопленных результатов
z: начальное значение для накопленного результата раздела — это обычно нейтральный элемент для оператора seqop (например, Nil для конкатенации списков или 0 для суммирования) и может быть вычислено более одного раза
seqop: оператор, используемый для накопления результатов в пределах раздела
combop: ассоциативный оператор, используемый для объединения результатов из разных разделов

Definition Classes: TraversableOnce → GenTraversableOnce

final def asInstanceOf[T0]: T0

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

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

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

Definition Classes: Any
Exceptions thrown: ClassCastException, если объект-получатель не является экземпляром стирания типа T0.

def clone(): AnyRef

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

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

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

Attributes: protected[lang]
Definition Classes: AnyRef
Annotations: @throws( ... ) @native()
Note: не указано SLS как член AnyRef

def collect[B](pf: PartialFunction[A, B]): Traversable[B]

[use case]

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

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

Definition Classes: TraversableLike → GenTraversableLike

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

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

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

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

pf: частичная функция
returns: значение типа Option, содержащее результат применения pf к первому элементу, для которого функция определена, или None, если такового не существует.

Definition Classes: TraversableOnce

def companion: GenericCompanion[Traversable]

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

Определяющие классы: Traversable → Traversable → GenTraversable → GenericTraversableTemplate

def copyToArray(xs: Array[A], start: Int, len: Int): Unit

[use case]

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

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

xs: массив для заполнения.
start: начальный индекс.
len: максимальное количество копируемых элементов.

Определяющие классы: TraversableLike → TraversableOnce → GenTraversableOnce

def copyToArray(xs: Array[A]): Unit

[use case]

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

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

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

Определяющие классы: TraversableOnce → GenTraversableOnce

def copyToArray(xs: Array[A], start: Int): Unit

[use case]

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

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

xs: массив для заполнения.
start: начальный индекс.

Определяющие классы: TraversableOnce → GenTraversableOnce

def copyToBuffer[B >: A](dest: Buffer[B]): Unit

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

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

dest: Буфер, в который копируются элементы.

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

def count(p: (A) ⇒ Boolean): Int

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

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

Определяющие классы: TraversableOnce → GenTraversableOnce

def drop(n: Int): Traversable[A]

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

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

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

Определяющие классы: TraversableLike → GenTraversableLike

def dropWhile(p: (A) ⇒ Boolean): Traversable[A]

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

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

Определяющие классы: TraversableLike → GenTraversableLike

def ensuring(cond: (Traversable[A]) ⇒ Boolean, msg: ⇒ Any): Traversable[A]

Неявный: Этот член добавлен неявным преобразованием из Traversable[A] в Ensuring[Traversable[A]] с помощью метода Ensuring в scala.Predef.
Классы определений: Ensuring

def ensuring(cond: (Traversable[A]) ⇒ Boolean): Traversable[A]

Неявный: Этот член добавлен неявным преобразованием из Traversable[A] в Ensuring[Traversable[A]] с помощью метода Ensuring в scala.Predef.
Классы определений: Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): Traversable[A]

Неявный: Этот член добавлен неявным преобразованием из Traversable[A] в Ensuring[Traversable[A]] с помощью метода Ensuring в scala.Predef.
Классы определений: Ensuring

def ensuring(cond: Boolean): Traversable[A]

Неявный: Этот член добавлен неявным преобразованием из Traversable[A] в Ensuring[Traversable[A]] с помощью метода 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).

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

Классы определений: AnyRef

def equals(arg0: Any): Boolean

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

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

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

Классы определений: AnyRef → Any

def exists(p: (A) ⇒ Boolean): Boolean

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

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

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

Классы определений: TraversableLike → TraversableOnce → GenTraversableOnce

def filter(p: (A) ⇒ Boolean): Traversable[A]

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

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

Классы определений: TraversableLike → GenTraversableLike

def filterNot(p: (A) ⇒ Boolean): Traversable[A]

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

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

Definition Classes: TraversableLike → GenTraversableLike

def finalize(): Unit

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

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

Attributes: protected[lang]
Definition Classes: AnyRef
Annotations: @throws( classOf[java.lang.Throwable] )
Note: не определен SLS как член AnyRef

def find(p: (A) ⇒ Boolean): Option[A]

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

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

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

p: предикат, используемый для проверки элементов.
returns: значение типа Option, содержащее первый элемент в итерируемом наборе, который удовлетворяет p, или None , если таковой не существует.

Definition Classes: TraversableLike → TraversableOnce → GenTraversableOnce

def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): Traversable[B]

[use case]

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

Например:

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)

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

Definition Classes: TraversableLike → GenTraversableLike → FilterMonadic

def flatten[B]: Traversable[B]

[use case]

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

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

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: тип элементов каждого итерируемого набора.
returns: новый набор, полученный путем конкатенации всех наборов элементов.

Definition Classes: GenericTraversableTemplate

def fold[A1 >: A](z: A1)(op: (A1, A1) ⇒ A1): A1

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def foldLeft[B](z: B)(op: (B, A) ⇒ B): B

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

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

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

B

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

z

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

op

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

returns

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

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

где x₁, ..., x_n - элементы этого итерируемого набора или итератора. Возвращает z , если этот итерируемый набор или итератор пуст.

Definition Classes: TraversableOnce → GenTraversableOnce

def foldRight[B](z: B)(op: (A, B) ⇒ B): B

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

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

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

B

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

z

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

op

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

returns

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

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

где x₁, ..., x_n — элементы этого итерируемого объекта или итератора. Возвращает z, если этот итерируемый объект или итератор пуст.

Definition Classes: TraversableOnce → GenTraversableOnce

def forall(p: (A) ⇒ Boolean): Boolean

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

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

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

Definition Classes: TraversableLike → TraversableOnce → GenTraversableOnce

abstract def foreach(f: (A) ⇒ Unit): Unit

[use case]

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

Definition Classes: GenericTraversableTemplate

def formatted(fmtstr: String): String

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

Неявный: Этот член добавлен с помощью неявного преобразования из Traversable[A] в StringFormat[Traversable[A]] с помощью метода StringFormat в scala.Predef.
Definition Classes: StringFormat
Annotations: @inline()

def genericBuilder[B]: Builder[B, Traversable[B]]

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

Definition Classes: GenericTraversableTemplate

final def getClass(): Class[_]

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

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

Definition Classes: AnyRef → Any
Annotations: @native()

def groupBy[K](f: (A) ⇒ K): immutable.Map[K, Traversable[A]]

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

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

K

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

f

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

returns

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

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

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

Definition Classes: TraversableLike → GenTraversableLike

def hasDefiniteSize: Boolean

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

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

returns: true , если эта коллекция известна как имеющая конечный размер, false в противном случае.

Definition Classes: TraversableLike → TraversableOnce → GenTraversableOnce

def hashCode(): Int

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

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

Definition Classes: AnyRef → Any
Annotations: @native()

def head: A

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

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

returns: первый элемент этой итерируемой коллекции.

Definition Classes: TraversableLike → GenTraversableLike
Exceptions thrown: NoSuchElementException если итерируемая коллекция пуста.

def headOption: Option[A]

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

returns: первый элемент этой итерируемой коллекции, если она не пуста, None если она пуста.

Definition Classes: TraversableLike → GenTraversableLike

def init: Traversable[A]

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

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

Definition Classes: TraversableLike → GenTraversableLike
Exceptions thrown: UnsupportedOperationException если итерируемая коллекция пуста.

def inits: Iterator[Traversable[A]]

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

returns: итератор по всем начальным значениям этой итерируемой коллекции

Definition Classes: TraversableLike

def isEmpty: Boolean

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

returns: true , если итерируемая коллекция не содержит элементов, false в противном случае.

Definition Classes: TraversableLike → TraversableOnce → GenTraversableOnce

final def isInstanceOf[T0]: Boolean

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

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

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

Definition Classes: Any

final def isTraversableAgain: Boolean

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

returns: true

Definition Classes: TraversableLike → GenTraversableLike → GenTraversableOnce

def last: A

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

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

Definition Classes: TraversableLike → GenTraversableLike
Exceptions thrown: NoSuchElementException Если итерируемая коллекция пуста.

def lastOption: Option[A]

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

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

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

Definition Classes: TraversableLike → GenTraversableLike

def map[B](f: (A) ⇒ B): Traversable[B]

[use case]

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

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

Definition Classes: TraversableLike → GenTraversableLike → FilterMonadic

def max: A

[use case]

Находит максимальный элемент.

returns: максимальный элемент этой коллекции.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если коллекция пуста.

def maxBy[B](f: (A) ⇒ B): A

[use case]

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

B: Тип результата функции f.
f: Функция измерения.
returns: первый элемент этой коллекции с максимальным значением, измеренным с помощью функции f.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если коллекция пуста.

def min: A

[use case]

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

returns: минимальный элемент этой коллекции.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если коллекция пуста.

def minBy[B](f: (A) ⇒ B): A

[use case]

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

B: Тип результата функции f.
f: Функция измерения.
returns: первый элемент этой коллекции с минимальным значением, измеренным с помощью функции f.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если коллекция пуста.

def mkString: String

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

final def ne(arg0: AnyRef): Boolean

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

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

Definition Classes: AnyRef

def newBuilder: Builder[A, Traversable[A]]

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

Attributes: protected[this]
Definition Classes: GenericTraversableTemplate → HasNewBuilder

def nonEmpty: Boolean

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

final def notify(): Unit

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

Definition Classes: AnyRef
Annotations: @native()
Note: не указано SLS в качестве члена AnyRef

final def notifyAll(): Unit

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

Definition Classes: AnyRef
Annotations: @native()
Note: не указано SLS в качестве члена AnyRef

def par: ParIterable[A]

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

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

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

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

returns: параллельная реализация этого набора

Definition Classes: Parallelizable

def parCombiner: Combiner[A, ParIterable[A]]

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

returns: комбинатор для параллельного набора типа ParRepr

Attributes: protected[this]
Definition Classes: TraversableLike → Parallelizable

def partition(p: (A) ⇒ Boolean): (Traversable[A], Traversable[A])

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

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

Definition Classes: TraversableLike → GenTraversableLike

def product: A

[use case]

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

returns: произведение всех элементов этого набора чисел типа Int. Вместо Int, может быть использован любой другой тип T с явным Numeric[T] реализацией в качестве типа элементов набора и в качестве типа результата product. Примеры таких типов: Long, Float, Double, BigInt.

Definition Classes: TraversableOnce → GenTraversableOnce

def reduce[A1 >: A](op: (A1, A1) ⇒ A1): A1

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

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

A1: Параметр типа для бинарного оператора, являющийся надтипом A.
op: Бинарный оператор, который должен быть ассоциативным.
returns: Результат применения оператора reduce op между всеми элементами, если итерируемый объект или итератор не пустой.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если этот итерируемый объект или итератор пустой.

def reduceLeft[B >: A](op: (B, A) ⇒ B): B

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

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

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

B

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

op

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

returns

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

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

где x₁, ..., x_n являются элементами этого итерируемого объекта или итератора.

Definition Classes: TraversableOnce
Исключения: UnsupportedOperationException, если этот итерируемый объект или итератор пустой.

def reduceLeftOption[B >: A](op: (B, A) ⇒ B): Option[B]

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

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

B: тип результата бинарного оператора.
op: бинарный оператор.
returns: значение option, содержащее результат reduceLeft(op) если этот итерируемый объект или итератор не пустой, None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

def reduceOption[A1 >: A](op: (A1, A1) ⇒ A1): Option[A1]

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

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

A1: Параметр типа для бинарного оператора, являющийся надтипом A.
op: Бинарный оператор, который должен быть ассоциативным.
returns: Значение option, содержащее результат применения оператора reduce op между всеми элементами, если коллекция не пустая, и None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

def reduceRight[B >: A](op: (A, B) ⇒ B): B

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

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

B

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

op

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

returns

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

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

где x₁, ..., x_n являются элементами этого итерируемого объекта или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce
Исключения: UnsupportedOperationException, если этот итерируемый объект или итератор пустой.

def reduceRightOption[B >: A](op: (A, B) ⇒ B): Option[B]

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

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

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

B: тип результата бинарного оператора.
op: бинарный оператор.
returns: значение опционального типа, содержащее результат reduceRight(op) если этот перебираемый объект или итератор не пустой, None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

def repr: Traversable[A]

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

Definition Classes: TraversableLike → GenTraversableLike

def reversed: List[A]

Attributes: protected[this]
Definition Classes: TraversableOnce

def scan[B >: A, That](z: B)(op: (B, B) ⇒ B)(implicit cbf: CanBuildFrom[Traversable[A], B, That]): That

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

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

B: тип элементов результирующей коллекции
That: тип результирующей коллекции
z: нейтральный элемент для оператора op
op: ассоциативный оператор для сканирования
cbf: фабрика комбинаторов, которая предоставляет комбинатор
returns: новая перебираемая коллекция, содержащая префиксное сканирование элементов в этой перебираемой коллекции

Definition Classes: TraversableLike → GenTraversableLike

def scanLeft[B, That](z: B)(op: (B, A) ⇒ B)(implicit bf: CanBuildFrom[Traversable[A], B, That]): That

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

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

B: тип элементов в результирующей коллекции
That: фактический тип результирующей коллекции
z: начальное значение
op: бинарный оператор, применяемый к промежуточному результату и элементу
bf: неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.
returns: коллекция с промежуточными результатами

Definition Classes: TraversableLike → GenTraversableLike

def scanRight[B, That](z: B)(op: (A, B) ⇒ B)(implicit bf: CanBuildFrom[Traversable[A], B, That]): That

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

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

Пример:

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

B: тип элементов в результирующей коллекции
That: фактический тип результирующей коллекции
z: начальное значение
op: бинарный оператор, применяемый к промежуточному результату и элементу
bf: неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.
returns: коллекция с промежуточными результатами

Definition Classes: TraversableLike → GenTraversableLike
Annotations: @migration
Migration: (Изменено в версии 2.9.0) Поведение scanRight изменилось. Предыдущее поведение можно воспроизвести с помощью scanRight.reverse.

def seq: Traversable[A]

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

Этот метод возвращает ссылку на эту коллекцию. В параллельных коллекциях он переопределён, чтобы возвращать последовательную реализацию этой коллекции. В обоих случаях сложность составляет O(1).

возвращает: последовательный вид коллекции.

Классы-определения: Traversable → Traversable → GenTraversable → Parallelizable → TraversableOnce → GenTraversableOnce

def size: Int

Размер этой итерируемой последовательности или итератора.

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

возвращает: количество элементов в этой итерируемой последовательности или итераторе.

Классы-определения: TraversableOnce → GenTraversableOnce

def sizeHintIfCheap: Int

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

возвращает: количество элементов в этой коллекции или итераторе, или -1, если размер нельзя определить без больших затрат

Атрибуты: protected[collection]
Классы-определения: GenTraversableOnce

def slice(from: Int, until: Int): Traversable[A]

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

from <= indexOf(x) < until

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

Классы-определения: TraversableLike → GenTraversableLike

def span(p: (A) ⇒ Boolean): (Traversable[A], Traversable[A])

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

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

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

Классы-определения: TraversableLike → GenTraversableLike

def splitAt(n: Int): (Traversable[A], Traversable[A])

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

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

Классы-определения: TraversableLike → GenTraversableLike

def stringPrefix: String

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

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

Классы-определения: TraversableLike → GenTraversableLike

def sum: A

[использование]

Суммирует элементы этой коллекции.

возвращает: сумма всех элементов этой коллекции чисел типа Int. Вместо Int, можно использовать любой другой тип T с неявным Numeric[T] реализацией как тип элемента коллекции и как тип возвращаемого значения sum. Примеры таких типов: Long, Float, Double, BigInt.

Классы-определения: TraversableOnce → GenTraversableOnce

final def synchronized[T0](arg0: ⇒ T0): T0

Классы-определения: AnyRef

def tail: Traversable[A]

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

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

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

Классы-определения: TraversableLike → GenTraversableLike
Исключения: java.lang.UnsupportedOperationException, если перебираемая коллекция пуста.

def tails: Iterator[Traversable[A]]

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

возвращает: итератор по всем хвостам этой перебираемой коллекции

Классы-определения: TraversableLike

def take(n: Int): Traversable[A]

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

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

Классы-определения: TraversableLike → GenTraversableLike

def takeWhile(p: (A) ⇒ Boolean): Traversable[A]

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

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

Классы-определения: TraversableLike → GenTraversableLike

def thisCollection: collection.Traversable[A]

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

Атрибуты: protected[this]
Классы-определения: TraversableLike

def to[Col[_]]: Col[A]

[use case]

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

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

Col: Тип коллекции для создания.
возвращает: новая коллекция, содержащая все элементы этой коллекции.

Классы-определения: TraversableLike → TraversableOnce → GenTraversableOnce

def toArray: Array[A]

[use case]

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

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

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

Классы-определения: TraversableOnce → GenTraversableOnce

def toBuffer[B >: A]: Buffer[B]

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

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

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

Классы-определения: TraversableOnce → GenTraversableOnce

def toCollection(repr: Traversable[A]): collection.Traversable[A]

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

Атрибуты: protected[this]
Классы-определения: TraversableLike

def toIndexedSeq: immutable.IndexedSeq[A]

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

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

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

Классы-определения: TraversableOnce → GenTraversableOnce

def toIterable: collection.Iterable[A]

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

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

returns: a Iterable, содержащий все элементы этого итерируемого объекта или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toIterator: Iterator[A]

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

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

returns: итератор, содержащий все элементы этой итерируемой коллекции.

Definition Classes: TraversableLike → GenTraversableOnce

def toList: List[A]

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

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

returns: список, содержащий все элементы этого итерируемого объекта или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toMap[T, U]: collection.Map[T, U]

[use case]

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

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

returns: словарь типа immutable.Map[T, U], содержащий все пары ключ/значение типа (T, U) этой коллекции.

Definition Classes: TraversableOnce → GenTraversableOnce

def toParArray: ParArray[T]

Неявный: Этот член добавлен с помощью неявного преобразования из Traversable[A] в CollectionsHaveToParArray[Traversable[A], T] выполняемого методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдёт только в том случае, если в области видимости имеется неявное значение типа (Traversable[A]) ⇒ GenTraversableOnce[T].
Definition Classes: CollectionsHaveToParArray

def toSeq: collection.Seq[A]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

returns: множество, содержащее все элементы этого итерируемого объекта или итератора.

Definition Classes: TraversableOnce → GenTraversableOnce

def toStream: Stream[A]

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

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

Definition Classes: TraversableLike → GenTraversableOnce

def toString(): String

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

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

Definition Classes: TraversableLike → Any

def toTraversable: collection.Traversable[A]

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

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

returns: итерируемое множество, содержащее все элементы этого итерируемого множества.

Definition Classes: TraversableLike → TraversableOnce → GenTraversableOnce
Annotations: @deprecatedOverriding( message = ... , since = "2.11.0" )

def toVector: Vector[A]

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def transpose[B](implicit asTraversable: (A) ⇒ GenTraversableOnce[B]): Traversable[Traversable[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: тип элементов каждого итерируемого множества.
asTraversable: явное преобразование, которое утверждает, что тип элемента этого множества является Traversable.
returns: двумерное множество множеств, в котором n-я строка соответствует n-му столбцу этого множества.

Definition Classes: GenericTraversableTemplate
Annotations: @migration
Migration: (Изменено в версии 2.9.0) transpose генерирует IllegalArgumentException если множества не имеют одинакового размера.
Exceptions thrown: IllegalArgumentException если все множества в этом множестве не имеют одинаковый размер.

def unzip[A1, A2](implicit asPair: (A) ⇒ (A1, A2)): (Traversable[A1], Traversable[A2])

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

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

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

Definition Classes: GenericTraversableTemplate

def unzip3[A1, A2, A3](implicit asTriple: (A) ⇒ (A1, A2, A3)): (Traversable[A1], Traversable[A2], Traversable[A3])

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

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

A1: тип первого члена троек элементов
A2: тип второго члена троек элементов
A3: тип третьего члена троек элементов
asTriple: явное преобразование, которое утверждает, что тип элемента этого множества является тройкой.
returns: тройка множеств, содержащих первый, второй и третий член каждой тройки элементов этого множества.

Definition Classes: GenericTraversableTemplate

def view(from: Int, until: Int): TraversableView[A, Traversable[A]]

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

Примечание: разница между view и slice заключается в том, что view создаёт представление текущего итерируемого множества, а slice создаёт новое итерируемое множество.

Примечание: view(from, to) эквивалентно view.slice(from, to)

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

from: индекс первого элемента представления
until: индекс элемента, следующего за представлением
returns: нестрогое представление среза этого итерируемого множества, начинающегося с индекса from и заканчивающегося (но не включая) индексом until.

Definition Classes: TraversableLike

def view: TraversableView[A, Traversable[A]]

Создаёт нестрогую (non-strict) просмотрную коллекцию этого обходимого набора.

возвращает: нестрогую (non-strict) просмотрную коллекцию этого обходимого набора.

Классы-определения: TraversableLike

final def wait(): Unit

Классы-определения: AnyRef
Аннотации: @throws( ... )

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

Классы-определения: AnyRef
Аннотации: @throws( ... )

final def wait(arg0: Long): Unit

Классы-определения: AnyRef
Аннотации: @throws( ... ) @native()

def withFilter(p: (A) ⇒ Boolean): FilterMonadic[A, Traversable[A]]

Создаёт нестрогую (non-strict) фильтрацию этого обходимого набора.

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

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

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

Классы-определения: TraversableLike → FilterMonadic

def →[B](y: B): (Traversable[A], B)

Неявный: Этот член добавлен неявным преобразованием из Traversable[A] в ArrowAssoc[Traversable[A]] посредством метода ArrowAssoc в scala.Predef.
Классы-определения: ArrowAssoc

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

def filter(p: (A) ⇒ Boolean): TraversableOnce[A]

Неявный

Этот член добавлен неявным преобразованием из Traversable[A] в MonadOps[A] выполненным методом MonadOps в scala.collection.TraversableOnce.

Затенение

Этот неявно унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать явное указание типа:

(traversable: MonadOps[A]).filter(p)

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

MonadOps

def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): TraversableOnce[B]

Неявный

Этот член добавлен неявным преобразованием из Traversable[A] в MonadOps[A] выполненным методом MonadOps в scala.collection.TraversableOnce.

Затенение

(traversable: MonadOps[A]).flatMap(f)

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

MonadOps

def map[B](f: (A) ⇒ B): TraversableOnce[B]

Неявный

Этот член добавлен неявным преобразованием из Traversable[A] в MonadOps[A] выполненным методом MonadOps в scala.collection.TraversableOnce.

Затенение

(traversable: MonadOps[A]).map(f)

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

MonadOps

def withFilter(p: (A) ⇒ Boolean): Iterator[A]

Неявный

Этот член добавлен неявным преобразованием из Traversable[A] в MonadOps[A] выполненным методом MonadOps в scala.collection.TraversableOnce.

Затенение

(traversable: MonadOps[A]).withFilter(p)

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

MonadOps

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