Трейт scala.collection.IterableFactory

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

трейт IterableFactory[+CC[_]] extends Serializable

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

CC: Конструктор типа коллекции (например, List)

Source: Factory.scala
Линейные супертипы: java.io.Serializable, AnyRef, Any
Известные подклассы: AnyIterableDelegate, AnySeqDelegate, IndexedSeq, Iterable, Delegate, Iterator, LinearSeq, Seq, SeqFactory, Delegate, Set, StrictOptimizedSeqFactory, View, HashSet, IndexedSeq, Iterable, LazyList, LinearSeq, List, ListSet, Queue, Seq, Set, Vector, ArrayBuffer, ArrayDeque, Buffer, HashSet, IndexedBuffer, IndexedSeq, Iterable, LinkedHashSet, ListBuffer, Queue, Seq, Set, Stack, AnyAccumulator, Stream

Абстрактные методы

абстрактный def empty[A]: CC[A]

Пустая коллекция

A: тип элементов коллекции

абстрактный def from[A](source: IterableOnce[A]): CC[A]

Создает целевую коллекцию из существующей исходной коллекции

A: тип элементов коллекции
source: Исходная коллекция
returns: новая коллекция с элементами из source

абстрактный def newBuilder[A]: Builder[A, CC[A]]

A: тип элементов коллекции
returns: Построитель для Iterable объектов.

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

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

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

def ->[B](y: B): (IterableFactory[CC], B)

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

def apply[A](elems: A*): CC[A]

Создаёт коллекцию с указанными элементами.

A: тип элементов коллекции
elems: элементы создаваемой коллекции
возвращает: новую коллекцию с элементами elems

final def asInstanceOf[T0]: T0

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

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

возвращает: объект получателя.

Классы-определения: Any
Исключения: ClassCastException, если объект получателя не является экземпляром стирания типа T0.

def clone(): AnyRef

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

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

возвращает: копию объекта получателя.

Атрибуты: protected[java.lang]
Классы-определения: AnyRef
Аннотации: @throws(classOf[java.lang.CloneNotSupportedException]) @native()
Примечание: не определён SLS как член AnyRef

def concat[A](xss: Iterable[A]*): CC[A]

Конкатенирует все аргументные коллекции в одну коллекцию.

xss: коллекции, которые нужно конкатенировать.
возвращает: конкатенацию всех коллекций.

def ensuring(cond: (IterableFactory[CC]) => Boolean, msg: => Any): IterableFactory[CC]

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

def ensuring(cond: (IterableFactory[CC]) => Boolean): IterableFactory[CC]

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

def ensuring(cond: Boolean, msg: => Any): IterableFactory[CC]

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

def ensuring(cond: Boolean): IterableFactory[CC]

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

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

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

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

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

def fill[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(elem: => A): CC[CC[CC[CC[CC[A]]]]]

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

n1: количество элементов в первом измерении
n2: количество элементов во втором измерении
n3: количество элементов в третьем измерении
n4: количество элементов в четвёртом измерении
n5: количество элементов в пятом измерении
elem: вычисление элемента
returns: Коллекция, содержащая результаты n1 x n2 x n3 x n4 x n5 вычислений elem.

def fill[A](n1: Int, n2: Int, n3: Int, n4: Int)(elem: => A): CC[CC[CC[CC[A]]]]

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

n1: количество элементов в первом измерении
n2: количество элементов во втором измерении
n3: количество элементов в третьем измерении
n4: количество элементов в четвёртом измерении
elem: вычисление элемента
returns: Коллекция, содержащая результаты n1 x n2 x n3 x n4 вычислений elem.

def fill[A](n1: Int, n2: Int, n3: Int)(elem: => A): CC[CC[CC[A]]]

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

n1: количество элементов в первом измерении
n2: количество элементов во втором измерении
n3: количество элементов в третьем измерении
elem: вычисление элемента
returns: Коллекция, содержащая результаты n1 x n2 x n3 вычислений elem.

def fill[A](n1: Int, n2: Int)(elem: => A): CC[CC[A]]

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

n1: количество элементов в первом измерении
n2: количество элементов во втором измерении
elem: вычисление элемента
returns: Коллекция, содержащая результаты n1 x n2 вычислений elem.

def fill[A](n: Int)(elem: => A): CC[A]

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

n: количество элементов в коллекции
elem: вычисление элемента
returns: Коллекция, содержащая результаты n вычислений elem.

def finalize(): Unit

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

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

Attributes: protected[java.lang]
Definition Classes: AnyRef
Annotations: @throws(classOf[java.lang.Throwable])
Note: не указано SLS в качестве члена AnyRef

def formatted(fmtstr: String): String

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

Implicit: Этот член добавлен неявно посредством преобразования из IterableFactory[CC] вStringFormat[IterableFactory[CC]] посредством метода StringFormat в scala.Predef.
Definition Classes: StringFormat
Annotations: @inline()

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

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

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

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

def hashCode(): Int

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

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

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

final def isInstanceOf[T0]: Boolean

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

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

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

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

implicit def iterableFactory[A]: Factory[A, CC[A]]

def iterate[A](start: A, len: Int)(f: (A) => A): CC[A]

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

start: начальное значение коллекции
len: количество элементов в коллекции
f: функция, которая многократно применяется
возвращает: коллекцию со значениями len в последовательности start, f(start), f(f(start)), ...

final def ne(arg0: AnyRef): Boolean

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

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

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

final def notify(): Unit

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

Определяющие классы: AnyRef
Аннотации: @native()
Примечание: не указано SLS как член AnyRef

final def notifyAll(): Unit

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

Определяющие классы: AnyRef
Аннотации: @native()
Примечание: не указано SLS как член AnyRef

def range[A](start: A, end: A, step: A)(implicit arg0: Integral[A]): CC[A]

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

start: начальное значение коллекции
end: конечное значение коллекции (первое значение, НЕ включённое)
step: разница между последовательными элементами коллекции (должна быть положительной или отрицательной)
возвращает: коллекция со значениями start, start + step, ... до, но не включая end

def range[A](start: A, end: A)(implicit arg0: Integral[A]): CC[A]

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

start: первый элемент коллекции
end: конечное значение коллекции (первое значение, НЕ включённое)
возвращает: коллекция со значениями start, start + 1, ..., end - 1

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

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

def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(f: (Int, Int, Int, Int, Int) => A): CC[CC[CC[CC[CC[A]]]]]

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

n1: число элементов в 1-м измерении
n2: число элементов во 2-м измерении
n3: число элементов в 3-м измерении
n4: число элементов в 4-м измерении
n5: число элементов в 5-м измерении
f: Функция вычисления значений элементов
returns: Коллекция, состоящая из элементов f(i1, i2, i3, i4, i5) для 0 <= i1 < n1, 0 <= i2 < n2, 0 <= i3 < n3, 0 <= i4 < n4, и 0 <= i5 < n5.

def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int)(f: (Int, Int, Int, Int) => A): CC[CC[CC[CC[A]]]]

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

n1: число элементов в 1-м измерении
n2: число элементов во 2-м измерении
n3: число элементов в 3-м измерении
n4: число элементов в 4-м измерении
f: Функция вычисления значений элементов
returns: Коллекция, состоящая из элементов f(i1, i2, i3, i4) для 0 <= i1 < n1, 0 <= i2 < n2, 0 <= i3 < n3, и 0 <= i4 < n4.

def tabulate[A](n1: Int, n2: Int, n3: Int)(f: (Int, Int, Int) => A): CC[CC[CC[A]]]

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

n1: число элементов в 1-м измерении
n2: число элементов во 2-м измерении
n3: число элементов в 3-м измерении
f: Функция вычисления значений элементов
returns: Коллекция, состоящая из элементов f(i1, i2, i3) для 0 <= i1 < n1, 0 <= i2 < n2, и 0 <= i3 < n3.

def tabulate[A](n1: Int, n2: Int)(f: (Int, Int) => A): CC[CC[A]]

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

n1: число элементов в 1-м измерении
n2: число элементов во 2-м измерении
f: Функция вычисления значений элементов
returns: Коллекция, состоящая из элементов f(i1, i2) для 0 <= i1 < n1 и 0 <= i2 < n2.

def tabulate[A](n: Int)(f: (Int) => A): CC[A]

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

n: Число элементов в коллекции
f: Функция вычисления значений элементов
returns: Коллекция, состоящая из элементов f(0), ..., f(n -1)

def toString(): String

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

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

Definition Classes: AnyRef → Any

def unfold[A, S](init: S)(f: (S) => Option[(A, S)]): CC[A]

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

A: Тип элементов
S: Тип внутреннего состояния
init: Начальное значение состояния
f: Вычисляет следующий элемент (или возвращает None для обозначения конца коллекции)
returns: коллекция, которая генерирует элементы с помощью f до тех пор, пока f не вернёт None

final def wait(): Unit

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

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

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

final def wait(arg0: Long): Unit

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

© 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/IterableFactory.html