Объект scala.Array

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

объект Array extends FallbackArrayBuilding with Serializable

Утилитарные методы для работы с массивами. Например:

val a = Array(1, 2)
val b = Array.ofDim[Int](2)
val c = Array.concat(a, b)

где объекты массивов a, b и c соответственно имеют значения Array(1, 2), Array(0, 0) и Array(1, 2, 0, 0).

Источник: Array.scala
С: 1.0

Линейные супертипы

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

final def !=(arg0: Any): Boolean

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

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

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

final def ##(): Int

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

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

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

final def ==(arg0: Any): Boolean

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

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

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

def apply(x: Unit, xs: Unit*): Array[Unit]

def apply(x: Double, xs: Double*): Array[Double]

def apply(x: Float, xs: Float*): Array[Float]

def apply(x: Long, xs: Long*): Array[Long]

def apply(x: Int, xs: Int*): Array[Int]

def apply(x: Char, xs: Char*): Array[Char]

def apply(x: Short, xs: Short*): Array[Short]

def apply(x: Byte, xs: Byte*): Array[Byte]

def apply(x: Boolean, xs: Boolean*): Array[Boolean]

def apply[T](xs: T*)(implicit arg0: ClassTag[T]): Array[T]

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

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

final def asInstanceOf[T0]: T0

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

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

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

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

implicit def canBuildFrom[T](implicit t: ClassTag[T]): CanBuildFrom[Array[_], T, Array[T]]

def clone(): AnyRef

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

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

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

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

def concat[T](xss: Array[T]*)(implicit arg0: ClassTag[T]): Array[T]

Объединяет все массивы в один массив.

xss: заданные массивы
returns: массив, созданный из объединения xss

def copy(src: AnyRef, srcPos: Int, dest: AnyRef, destPos: Int, length: Int): Unit

Копирует один массив в другой. Эквивалентно Java's System.arraycopy(src, srcPos, dest, destPos, length), за исключением того, что это также работает для полиморфных и упакованных массивов.

Обратите внимание, что переданный dest массив будет изменён этим вызовом.

src: исходный массив.
srcPos: начальная позиция в исходном массиве.
dest: массив назначения.
destPos: начальная позиция в массиве назначения.
length: количество элементов массива, которые должны быть скопированы.

See also: java.lang.System#arraycopy

def empty[T](implicit arg0: ClassTag[T]): Array[T]

val emptyBooleanArray: Array[Boolean]

val emptyByteArray: Array[Byte]

val emptyCharArray: Array[Char]

val emptyDoubleArray: Array[Double]

val emptyFloatArray: Array[Float]

val emptyIntArray: Array[Int]

val emptyLongArray: Array[Long]

val emptyObjectArray: Array[AnyRef]

val emptyShortArray: Array[Short]

final def eq(arg0: AnyRef): Boolean

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

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

x

y

AnyRef

x.eq(y)

true

false

x

AnyRef

x.eq(null)

null.eq(x)

false

null.eq(null)

true

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

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

Definition Classes: AnyRef

def equals(arg0: Any): Boolean

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

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

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

Definition Classes: AnyRef → Any

implicit def fallbackCanBuildFrom[T](implicit m: DummyImplicit): CanBuildFrom[Array[_], T, ArraySeq[T]]

Фабрика билдера, которая генерирует общий массив. Вызывается вместо Array.newBuilder если тип элемента массива не имеет тега класса. Обратите внимание, что фабрика fallbackBuilder требует параметр implicit (иначе она не будет доминировать в поиске implicit параметров Array.canBuildFrom). Мы гарантируем, что поиск implicit параметров всегда успешен.

Definition Classes: FallbackArrayBuilding

def fill[T](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(elem: ⇒ T)(implicit arg0: ClassTag[T]): Array[Array[Array[Array[Array[T]]]]]

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

n1: число элементов в 1-м измерении
n2: число элементов во 2-м измерении
n3: число элементов в 3-м измерении
n4: число элементов в 4-м измерении
n5: число элементов в 5-м измерении
elem: вычисление элемента

def fill[T](n1: Int, n2: Int, n3: Int, n4: Int)(elem: ⇒ T)(implicit arg0: ClassTag[T]): Array[Array[Array[Array[T]]]]

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

n1: число элементов в 1-м измерении
n2: число элементов во 2-м измерении
n3: число элементов в 3-м измерении
n4: число элементов в 4-м измерении
elem: вычисление элемента

def fill[T](n1: Int, n2: Int, n3: Int)(elem: ⇒ T)(implicit arg0: ClassTag[T]): Array[Array[Array[T]]]

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

n1: число элементов в 1-м измерении
n2: число элементов во 2-м измерении
n3: число элементов в 3-м измерении
elem: вычисление элемента

def fill[T](n1: Int, n2: Int)(elem: ⇒ T)(implicit arg0: ClassTag[T]): Array[Array[T]]

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

n1: число элементов в 1-м измерении
n2: число элементов во 2-м измерении
elem: вычисление элемента

def fill[T](n: Int)(elem: ⇒ T)(implicit arg0: ClassTag[T]): Array[T]

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

Обратите внимание, что это означает, что elem вычисляется в общей сложности n раз:

scala> Array.fill(3){ math.random }
res3: Array[Double] = Array(0.365461167592537, 1.550395944913685E-4, 0.7907242137333306)

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

def finalize(): Unit

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

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

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

final def getClass(): Class[_]

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

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

def iterate[T](start: T, len: Int)(f: (T) ⇒ T)(implicit arg0: ClassTag[T]): Array[T]

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

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

final def ne(arg0: AnyRef): Boolean

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

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

Definition Classes: AnyRef

def newBuilder[T](implicit t: ClassTag[T]): ArrayBuilder[T]

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 ofDim[T](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(implicit arg0: ClassTag[T]): Array[Array[Array[Array[Array[T]]]]]

def ofDim[T](n1: Int, n2: Int, n3: Int, n4: Int)(implicit arg0: ClassTag[T]): Array[Array[Array[Array[T]]]]

def ofDim[T](n1: Int, n2: Int, n3: Int)(implicit arg0: ClassTag[T]): Array[Array[Array[T]]]

def ofDim[T](n1: Int, n2: Int)(implicit arg0: ClassTag[T]): Array[Array[T]]

def ofDim[T](n1: Int)(implicit arg0: ClassTag[T]): Array[T]

def range(start: Int, end: Int, step: Int): Array[Int]

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

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

def range(start: Int, end: Int): Array[Int]

Возвращает массив, содержащий последовательность возрастающих целых чисел в диапазоне.

start: начальное значение массива
end: конечное значение массива, исключающее (другими словами, это первое значение, не возвращаемое)
returns: массив со значениями в диапазоне start, start + 1, ..., end - 1 до, но не включая, end.

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

Definition Classes: AnyRef

def tabulate[T](n1: Int, n2: Int, n3: Int, n4: Int, n5: Int)(f: (Int, Int, Int, Int, Int) ⇒ T)(implicit arg0: ClassTag[T]): Array[Array[Array[Array[Array[T]]]]]

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

n1: количество элементов в 1-м измерении
n2: количество элементов во 2-м измерении
n3: количество элементов в 3-м измерении
n4: количество элементов в 4-м измерении
n5: количество элементов в 5-м измерении
f: Функция вычисления значений элементов

def tabulate[T](n1: Int, n2: Int, n3: Int, n4: Int)(f: (Int, Int, Int, Int) ⇒ T)(implicit arg0: ClassTag[T]): Array[Array[Array[Array[T]]]]

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

n1: количество элементов в 1-м измерении
n2: количество элементов во 2-м измерении
n3: количество элементов в 3-м измерении
n4: количество элементов в 4-м измерении
f: Функция вычисления значений элементов

def tabulate[T](n1: Int, n2: Int, n3: Int)(f: (Int, Int, Int) ⇒ T)(implicit arg0: ClassTag[T]): Array[Array[Array[T]]]

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

n1: количество элементов в 1-м измерении
n2: количество элементов во 2-м измерении
n3: количество элементов в 3-м измерении
f: Функция вычисления значений элементов

def tabulate[T](n1: Int, n2: Int)(f: (Int, Int) ⇒ T)(implicit arg0: ClassTag[T]): Array[Array[T]]

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

n1: количество элементов в 1-м измерении
n2: количество элементов во 2-м измерении
f: Функция вычисления значений элементов

def tabulate[T](n: Int)(f: (Int) ⇒ T)(implicit arg0: ClassTag[T]): Array[T]

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

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

def toString(): String

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

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

Definition Classes: AnyRef → Any

def unapplySeq[T](x: Array[T]): Option[IndexedSeq[T]]

Вызывается в шаблоне сопоставления, как { case Array(x,y,z) => println('3 elements')}.

x: значение селектора
returns: последовательность, заключённая в scala.Some, если x является Seq, иначе None

final def wait(): Unit

Definition Classes: AnyRef
Annotations: @throws( ... )

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

Definition Classes: AnyRef
Annotations: @throws( ... )

final def wait(arg0: Long): Unit

Definition Classes: AnyRef
Annotations: @throws( ... ) @native()

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