Spec-Zone.ru › Scala 2.13 Library

Объект scala.collection.immutable.List

Компаньон класс List

объект List extends StrictOptimizedSeqFactory[List]

Этот объект предоставляет набор операций для создания List значений.

Аннотации
@SerialVersionUID()
Источник
List.scala
Линейные супертипы
StrictOptimizedSeqFactory[List], SeqFactory[List], IterableFactory[List], java.io.Serializable, AnyRef, Any

Члены со значениями

final def !=(arg0: Any): Boolean

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

returns

true если !(this == that), иначе false.

Definition Classes
AnyRef → Any

final def ##(): Int

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

returns

значение хэша, соответствующее ==

Definition Classes
AnyRef → Any

final def ==(arg0: Any): Boolean

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

returns

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

Definition Classes
AnyRef → Any

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

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

A

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

elems

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

returns

новая коллекция с элементами elems

Definition Classes
IterableFactory

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 concat[A](xss: collection.Iterable[A]*): List[A]

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

xss

коллекции, которые необходимо конкатенировать.

returns

конкатенация всех коллекций.

Definition Classes
StrictOptimizedSeqFactory → IterableFactory

def empty[A]: List[A]

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

A

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

Definition Classes
List → IterableFactory

final def eq(arg0: AnyRef): Boolean

Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).

Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef, и имеет три дополнительных свойства:

    Он согласован: для любых не-null экземпляров x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого не-null экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращает false. null.eq(null) возвращает true.

При переопределении методов equals или hashCode важно гарантировать, что их поведение соответствует равенству ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2 ), они должны быть равны друг другу (o1 == o2 ) и они должны хэшироваться к одному и тому же значению (o1.hashCode == o2.hashCode).

returns

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

Definition Classes
AnyRef

def equals(arg0: AnyRef): Boolean

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

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

returns

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

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

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

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

n

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

elem

вычисление элемента

returns

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

Определяющие классы
StrictOptimizedSeqFactory → IterableFactory

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

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

n1

количество элементов в 1-м измерении

n2

количество элементов во 2-м измерении

n3

количество элементов в 3-м измерении

n4

количество элементов в 4-м измерении

n5

количество элементов в 5-м измерении

elem

вычисление элемента

returns

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

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

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

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

n1

количество элементов в 1-м измерении

n2

количество элементов во 2-м измерении

n3

количество элементов в 3-м измерении

n4

количество элементов в 4-м измерении

elem

вычисление элемента

returns

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

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

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

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

n1

количество элементов в 1-м измерении

n2

количество элементов во 2-м измерении

n3

количество элементов в 3-м измерении

elem

вычисление элемента

returns

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

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

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

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

n1

количество элементов в 1-м измерении

n2

количество элементов во 2-м измерении

elem

вычисление элемента

returns

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

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

def finalize(): Unit

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

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

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

не специфицировано SLS как член AnyRef

def from[B](coll: IterableOnce[B]): List[B]

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

returns

новый список с элементами из source

Definition Classes
List → IterableFactory

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

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

def hashCode(): Int

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

final def isInstanceOf[T0]: Boolean

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

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

returns

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

Definition Classes
Any

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

Definition Classes
IterableFactory

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

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

start

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

len

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

f

функция, которая многократно применяется

returns

коллекция со значениями len в последовательности start, f(start), f(f(start)), ...

Definition Classes
IterableFactory

final def ne(arg0: AnyRef): Boolean

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

returns

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

Definition Classes
AnyRef

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

A

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

returns

Построитель для объектов List.

Definition Classes
List → IterableFactory

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Примечание

не специфицировано SLS как член AnyRef

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

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

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

start

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

end

конечное значение коллекции (первое значение, НЕ содержащееся)

step

разница между последовательными элементами коллекции (должна быть положительной или отрицательной)

returns

коллекция со значениями start, start + step, ... до, но не включая end

Definition Classes
IterableFactory

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

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

start

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

end

конечное значение коллекции (первое значение, НЕ содержащееся)

returns

коллекция со значениями start, start + 1, ..., end - 1

Definition Classes
IterableFactory

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

Definition Classes
AnyRef

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

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

n

Количество элементов в коллекции

f

Функция, вычисляющая значения элементов

returns

Коллекция, состоящая из элементов f(0), ..., f(n -1)

Definition Classes
StrictOptimizedSeqFactory → IterableFactory

def tabulate[A](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(f: (Int, Int, Int, Int, Int) => A): List[List[List[List[List[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

Definition Classes
IterableFactory

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

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

n1

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

n2

количество элементов во втором измерении

n3

количество элементов в третьем измерении

n4

количество элементов в четвёртом измерении

f

Функция, вычисляющая значения элементов

returns

Коллекция, состоящая из элементов f(i1, i2, i3, i4) для 0 <= i1 < n1, 0 <= i2 < n2, 0 <= i3 < n3, и 0 <= i4 < n4.

Definition Classes
IterableFactory

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

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

n1

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

n2

количество элементов во втором измерении

n3

количество элементов в третьем измерении

f

Функция, вычисляющая значения элементов

returns

Коллекция, состоящая из элементов f(i1, i2, i3) для 0 <= i1 < n1, 0 <= i2 < n2, и 0 <= i3 < n3.

Definition Classes
IterableFactory

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

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

n1

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

n2

количество элементов во втором измерении

f

Функция, вычисляющая значения элементов

returns

Коллекция, состоящая из элементов f(i1, i2) для 0 <= i1 < n1 и 0 <= i2 < n2.

Definition Classes
IterableFactory

def toString(): String

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

returns

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

Definition Classes
AnyRef → Any

final def unapplySeq[A](x: List[A]): UnapplySeqWrapper[A]

Definition Classes
SeqFactory

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

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

A

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

S

Тип внутреннего состояния

init

Начальное значение состояния

f

Вычисляет следующий элемент (или возвращает None для сигнализации об окончании коллекции)

returns

коллекция, которая производит элементы с использованием f до тех пор, пока f не вернёт None

Definition Classes
IterableFactory

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

Определяющие классы
AnyRef
Аннотации
@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/immutable/List$.html

Spec-Zone.ru

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