Spec-Zone.ru › Scala 2.13 Library

Класс scala.collection.mutable.Queue

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

класс Queue[A] extends ArrayDeque[A] with IndexedSeqOps[A, Queue, Queue[A]] with StrictOptimizedSeqOps[A, Queue, Queue[A]] with IterableFactoryDefaults[A, Queue] with ArrayDequeOps[A, Queue, Queue[A]] with Cloneable[Queue[A]] with DefaultSerializable

Queue объекты реализуют структуры данных, которые позволяют вставлять и извлекать элементы в порядке очереди (FIFO).

Источник
Queue.scala
С

2.13

Линейные надтипы
ArrayDeque[A], DefaultSerializable, java.io.Serializable, ArrayDequeOps[A, [_]Queue[_], Queue[A]], StrictOptimizedSeqOps[A, [_]Queue[_], Queue[A]], StrictOptimizedIterableOps[A, [_]Queue[_], Queue[A]], IndexedBuffer[A], IndexedSeq[A], IndexedSeqOps[A, [_]Queue[_], Queue[A]], collection.IndexedSeq[A], collection.IndexedSeqOps[A, [_]Queue[_], Queue[A]], AbstractBuffer[A], Buffer[A], Shrinkable[A], Growable[A], Clearable, AbstractSeq[A], Seq[A], SeqOps[A, [_]Queue[_], Queue[A]], Cloneable[Queue[A]], java.lang.Cloneable, Iterable[A], collection.AbstractSeq[A], collection.Seq[A], Equals, collection.SeqOps[A, [_]Queue[_], Queue[A]], PartialFunction[Int, A], (Int) => A, collection.AbstractIterable[A], collection.Iterable[A], IterableFactoryDefaults[A, [x]Queue[x]], IterableOps[A, [_]Queue[_], Queue[A]], IterableOnceOps[A, [_]Queue[_], Queue[A]], IterableOnce[A], AnyRef, Any

Конструкторы экземпляров

new Queue(initialSize: Int = ArrayDeque.DefaultInitialSize)

new Queue(array: Array[AnyRef], start: Int, end: Int)

Атрибуты
protected

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

final def !=(arg0: Any): Boolean

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

returns

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

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

final def ##(): Int

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

returns

хеш-значение, согласующееся с ==

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

def +(other: String): String

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

final def ++[B >: A](suffix: IterableOnce[B]): Queue[B]

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

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

final def ++:[B >: A](prefix: IterableOnce[B]): Queue[B]

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

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

final def ++=(xs: IterableOnce[A]): Queue.this.type

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

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

final def ++=:(elems: IterableOnce[A]): Queue.this.type

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

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

final def +:[B >: A](elem: B): Queue[B]

Псевдоним для prepended.

Обратите внимание, что операторы, заканчивающиеся на двоеточие, являются правоассоциативными (см. пример). Мнемоническое правило для +: против :+: двоеточие ставится со стороны коллекции.

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

final def +=(elem: A): Queue.this.type

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

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

final def +=:(elem: A): Queue.this.type

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

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

final def --=(xs: IterableOnce[A]): Queue.this.type

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

Definition Classes
Shrinkable
Annotations
@inline()

def -=(elem1: A, elem2: A, elems: A*): Queue.this.type

Удаляет два или более элементов из этого сжимаемого набора.

elem1

первый удаляемый элемент.

elem2

второй удаляемый элемент.

elems

остальные удаляемые элементы.

returns

сам сжимаемый набор

Definition Classes
Shrinkable

final def -=(elem: A): Queue.this.type

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

Definition Classes
Shrinkable
Annotations
@inline()

def ->[B](y: B): (Queue[A], B)

Неявный
Этот член добавлен неявным преобразованием из Queue[A] вArrowAssoc[Queue[A]], выполненное методом ArrowAssoc в scala.Predef.Это преобразование выполнится только в том случае, если A является подклассом Option[Nothing] (A <: Option[Nothing]).
Definition Classes
ArrowAssoc
Annotations
@inline()

final def :+[B >: A](elem: B): Queue[B]

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

Обратите внимание, что операторы с окончанием :- являются правоассоциативными (см. пример). Мнемоника для +: по сравнению с :+ такова: COLon идёт со стороны COLlection.

Definition Classes
SeqOps
Annotations
@inline()

final def :++[B >: A](suffix: IterableOnce[B]): Queue[B]

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

Definition Classes
SeqOps
Annotations
@inline()

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 addAll(elems: IterableOnce[A]): Queue.this.type

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

returns

сам массив дек.

Definition Classes
ArrayDeque → Growable

def addOne(elem: A): Queue.this.type

Добавляет один элемент в этот массив дек.

elem

элемент для добавления.

returns

сам массив дек

Definition Classes
ArrayDeque → Growable

final def addString(b: StringBuilder): 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

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

returns

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

Definition Classes
IterableOnceOps
Annotations
@inline()

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

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

Пример:

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

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

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

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

sep

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

returns

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

Definition Classes
IterableOnceOps
Annotations
@inline()

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

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

Пример:

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

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

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

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

start

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

sep

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

end

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

returns

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

Definition Classes
IterableOnceOps

def andThen[C](k: PartialFunction[A, C]): PartialFunction[Int, C]

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

Обратите внимание, что вызов isDefinedAt на полученной частичной функции может применить первую частичную функцию и выполнить её побочный эффект. Настоятельно рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.

C

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

k

функция преобразования

returns

частичная функция с областью определения этой частичной функции, суженной другой частичной функцией, которая отображает аргументы x в k(this(x)).

Definition Classes
PartialFunction

def andThen[C](k: (A) => C): PartialFunction[Int, C]

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

Если тип выполнения функции является PartialFunction, используется другой метод andThen (обратите внимание на предостережения).

C

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

k

функция преобразования

returns

частичная функция с областью определения этой частичной функции, возможно, суженной указанной функцией, которая отображает аргументы x в k(this(x)).

Definition Classes
PartialFunction → Function1

final def append(elem: A): Queue.this.type

Добавляет заданные элементы в этот буфер.

elem

элемент для добавления.

Definition Classes
Buffer
Annotations
@inline()

final def appendAll(xs: IterableOnce[A]): Queue.this.type

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

xs

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

Definition Classes
Buffer
Annotations
@inline()

def appended[B >: A](elem: B): Queue[B]

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

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

Пример:

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

scala> val b = a :+ 2
b: List[Int] = List(1, 2)

scala> println(a)
List(1)
B

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

elem

добавляемый элемент

returns

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

Definition Classes
StrictOptimizedSeqOps → SeqOps

def appendedAll[B >: A](suffix: IterableOnce[B]): Queue[B]

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

B

тип элементов возвращаемого набора.

suffix

итерируемый объект для добавления.

returns

новый набор типа CC[B], который содержит все элементы этой последовательности, за которыми следуют все элементы suffix.

Definition Classes
StrictOptimizedSeqOps → SeqOps

def apply(idx: Int): A

Получение элемента по указанному индексу. Эта операция предоставлена для удобства в Seq. Не следует предполагать, что она эффективна, если у вас нет IndexedSeq.

Definition Classes
ArrayDeque → SeqOps → Function1

def applyOrElse[A1 <: Int, B1 >: A](x: A1, default: (A1) => B1): B1

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

Обратите внимание, что выражение pf.applyOrElse(x, default) эквивалентно

if(pf isDefinedAt x) pf(x) else default(x)

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

    комбинирование частичных функций в цепочки orElse/andThen не приводит к чрезмерному вычислению apply/isDefinedAt lift и unlift не вычисляют исходные функции дважды при каждом вызове runWith позволяет эффективно комбинировать частичные функции с условными действиями

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

x

аргумент функции

default

функция обратного вызова

returns

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

Definition Classes
PartialFunction
Since

2.10

var array: Array[AnyRef]

Attributes
protected
Definition Classes
ArrayDeque → ArrayDequeOps

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 canEqual(that: Any): Boolean

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

that

объект, с которым эта последовательность должна быть сравнена

returns

true, если эта последовательность может потенциально быть равна that, false в противном случае. Проверка учитывает только типы объектов во время выполнения, но игнорирует их элементы.

Definition Classes
Seq → Equals

def charAt(index: Int): Char

Неявный
Этот член добавлен неявным преобразованием из Queue[A] вSeqCharSequence, выполненным методом SeqCharSequence в scala.Predef.Это преобразование произойдёт только в том случае, если A является подклассом Char (A <: Char).
Классы определения
SeqCharSequence → CharSequence

def chars(): IntStream

Неявный
Этот член добавлен неявным преобразованием из Queue[A] вSeqCharSequence, выполненным методом SeqCharSequence в scala.Predef.Это преобразование произойдёт только в том случае, если A является подклассом Char (A <: Char).
Классы определения
CharSequence

def className: String

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

Рекомендуется возвращать имя конкретного типа коллекции, но не подклассы реализации. Например, для ListMap этот метод должен возвращать "ListMap", а не "Map" (супертип) или "Node" (подкласс реализации).

По умолчанию реализация возвращает "Iterable". Она переопределена для основных типов коллекций "Seq", "IndexedSeq", "LinearSeq", "Buffer", "Set", "Map", "SortedSet", "SortedMap" и "View".

возвращает

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

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

def clear(): Unit

Примечание: Это не фактически изменяет размер внутренней структуры. См. clearAndShrink, если вы хотите также изменить размер внутри

Классы определения
ArrayDeque → Clearable

def clearAndShrink(size: Int = ArrayDeque.DefaultInitialSize): Queue.this.type

Очищает этот буфер и уменьшает до @param size

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

final def clone(): Queue[A]

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

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

возвращает

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

Классы определения
ArrayDequeOps → AnyRef
Примечание

не указано SLS в качестве члена AnyRef

def codePoints(): IntStream

Неявный
Этот член добавлен неявным преобразованием из Queue[A] вSeqCharSequence, выполненным методом SeqCharSequence в scala.Predef.Это преобразование произойдёт только в том случае, если A является подклассом Char (A <: Char).
Классы определения
CharSequence

final def coll: Queue.this.type

возвращает

Эта коллекция в виде C.

Атрибуты
protected
Классы определения
Iterable → IterableOps

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

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

B

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

pf

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

возвращает

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

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

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

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

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

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

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

pf

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

returns

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

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

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

def combinations(n: Int): Iterator[Queue[A]]

Перебирает комбинации. _Комбинация_ длины n — это подпоследовательность исходной последовательности, элементы которой берутся по порядку. Таким образом, "xy" и "yy" являются комбинациями длины 2 для "xyy", но "yx" — нет. Если существует несколько способов сгенерировать одну и ту же подпоследовательность, будет возвращен только один.

Например, "xyyy" имеет три различных способа генерации "xy" в зависимости от того, выбран ли первый, второй или третий "y". Однако, поскольку все они идентичны, будет выбран только один. Какой из трех будет взят, является деталью реализации, которая не определена.

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

returns

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

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

    "abbbc".combinations(2) = Iterator(ab, ac, bb, bc)

def compose[R](k: PartialFunction[R, Int]): PartialFunction[R, A]

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

Обратите внимание, что вызов isDefinedAt для результирующей частичной функции может применить первую частичную функцию и выполнить ее побочный эффект. Настоятельно рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.

R

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

k

функция преобразования

returns

частичная функция с областью определения другой частичной функции, суженной этой частичной функцией, которая отображает аргументы x на this(k(x)).

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

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

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

A

тип, к которому может быть применена функция g

g

функция A => T1

returns

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

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

final def concat[B >: A](suffix: IterableOnce[B]): Queue[B]

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

B

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

suffix

перебираемый объект для добавления.

returns

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

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

def contains[A1 >: A](elem: A1): Boolean

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

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

elem

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

returns

true если эта последовательность имеет элемент, равный (как определено ==) elem, false в противном случае.

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

def containsSlice[B](that: collection.Seq[B]): Boolean

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

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

that

последовательность для проверки

returns

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

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

def copySliceToArray(srcStart: Int, dest: Array[_], destStart: Int, maxItems: Int): dest.type

Это более общая версия copyToArray - она также принимает srcStart, в отличие от copyToArray. Она копирует maxItems элементов из этой коллекции с позиции srcStart в dest с позиции destStart. Если мы достигнем конца любой из коллекций до того, как сможем скопировать maxItems элементов, мы просто прекратим копирование.

Definition Classes
ArrayDequeOps

def copyToArray[B >: A](dest: Array[B], destStart: Int, len: Int): Int

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

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

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

B

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

len

максимальное количество копируемых элементов.

returns

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

Definition Classes
ArrayDeque → IterableOnceOps
Note

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

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

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

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

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

B

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

xs

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

start

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

returns

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

Definition Classes
IterableOnceOps

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

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

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

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

B

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

xs

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

returns

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

Definition Classes
IterableOnceOps

def corresponds[B](that: collection.Seq[B])(p: (A, B) => Boolean): Boolean

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

B

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

that

другая последовательность

p

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

returns

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

Definition Classes
SeqOps

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

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

B

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

that

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

p

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

returns

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

Definition Classes
IterableOnceOps

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

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

p

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

returns

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

Definition Classes
IterableOnceOps

def dequeue(): A

Удаляет и возвращает элемент из начала очереди

Exceptions thrown

java.util.NoSuchElementException, когда очередь пуста

def dequeueAll(p: (A) => Boolean): immutable.Seq[A]

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

p

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

returns

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

def dequeueFirst(p: (A) => Boolean): Option[A]

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

p

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

returns

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

def dequeueWhile(f: (A) => Boolean): collection.Seq[A]

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

f

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

returns

Удалённые элементы

def diff[B >: A](that: collection.Seq[B]): Queue[A]

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

that

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

returns

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

Definition Classes
StrictOptimizedSeqOps → SeqOps

def distinct: Queue[A]

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

returns

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

Definition Classes
SeqOps

def distinctBy[B](f: (A) => B): Queue[A]

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

B

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

f

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

returns

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

Definition Classes
StrictOptimizedSeqOps → SeqOps

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

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

n

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

returns

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

Definition Classes
IndexedSeqOps → IterableOps → IterableOnceOps
Note

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

def dropInPlace(n: Int): Queue.this.type

Definition Classes
Buffer

def dropRight(n: Int): Queue[A]

Остальная часть коллекции без её n последних элементов. Для линейных неизменяемых коллекций это должно предотвратить создание копии.

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

n

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

def dropRightInPlace(n: Int): Queue.this.type

Definition Classes
Buffer

def dropWhile(p: (A) => Boolean): Queue[A]

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

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

p

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

returns

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

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

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

def dropWhileInPlace(p: (A) => Boolean): Queue.this.type

Definition Classes
Buffer

def elementWise: ElementWiseExtractor[Int, A]

Возвращает объект-экстрактор с методом unapplySeq, который извлекает каждый элемент данных последовательности.

Definition Classes
PartialFunction
Пример:
    val firstChar: String => Option[Char] = _.headOption
    
    Seq("foo", "bar", "baz") match {
      case firstChar.unlift.elementWise(c0, c1, c2) =>
        println(s"$c0, $c1, $c2") // Output: f, b, b
    }

def empty: Queue[A]

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

returns

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

Definition Classes
IterableFactoryDefaults → IterableOps

def endsWith[B >: A](that: collection.Iterable[B]): Boolean

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

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

that

тестируемая последовательность

returns

true если эта последовательность имеет that в качестве суффикса, false в противном случае.

Definition Classes
SeqOps

def enqueue(elem1: A, elem2: A, elems: A*): Queue.this.type

Добавляет два или более элементов в конец очереди. Последний элемент последовательности будет в конце очереди.

elems

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

returns

this

def enqueue(elem: A): Queue.this.type

Добавление элементов в конец этой очереди

returns

this

def enqueueAll(elems: IterableOnce[A]): Queue.this.type

Добавляет все элементы в данный объект-проход в очередь. Последний элемент в объекте-проходе будет в начале новой очереди.

elems

объект-проход.

returns

this

def ensureSize(hint: Int): Unit

Definition Classes
ArrayDeque
Annotations
@inline()

def ensuring(cond: (Очередь[A]) => Boolean, msg: => Любой): Очередь[A]

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

def ensuring(cond: (Очередь[A]) => Boolean): Очередь[A]

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

def ensuring(cond: Boolean, msg: => Любой): Очередь[A]

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

def ensuring(cond: Boolean): Очередь[A]

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

final def eq(arg0: AnyRef): Boolean

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

Метод 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(o: Любой): Boolean

Универсальный метод равенства, определённый в AnyRef.

Определяющие классы
Seq → Equals → AnyRef → Любой

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

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

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

p

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

возвращает

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

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

def filter(pred: (A) => Boolean): Очередь[A]

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps

def filterImpl(pred: (A) => Boolean, isFlipped: Boolean): Queue[A]

Attributes
protected[scala.collection]
Definition Classes
StrictOptimizedIterableOps

def filterInPlace(p: (A) => Boolean): Queue.this.type

Definition Classes
IndexedBuffer

def filterNot(pred: (A) => Boolean): Queue[A]

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

pred

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps

def finalize(): Unit

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

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

Attributes
protected[java.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
IterableOnceOps

def findLast(p: (A) => Boolean): Option[A]

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

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

p

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

returns

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

Definition Classes
SeqOps

def flatMap[B](f: (A) => IterableOnce[B]): Queue[B]

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

Например:

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

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

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

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

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

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

тип элементов возвращаемого набора.

f

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Note

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

def flatMapInPlace(f: (A) => IterableOnce[A]): Queue.this.type

Definition Classes
IndexedBuffer

def flatten[B](implicit toIterableOnce: (A) => IterableOnce[B]): Queue[B]

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

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

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

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

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Note

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

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

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

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

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

A1

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

z

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

op

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

returns

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

Definition Classes
IterableOnceOps

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)

где x1, ..., xn - элементы этого множества. Возвращает z, если это множество пустое.

Definition Classes
IterableOnceOps

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)...))

где x1, ..., xn - элементы этого множества. Возвращает z, если это множество пустое.

Definition Classes
IterableOnceOps

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

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

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

p

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

returns

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

Definition Classes
IterableOnceOps

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

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

Definition Classes
IterableOnceOps

def formatted(fmtstr: String): String

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

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

def fromSpecific(coll: IterableOnce[A]): Queue[A]

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

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

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

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

,

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

final def front: A

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

возвращает

первый элемент.

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

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

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

возвращает

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

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

def groupBy[K](f: (A) => K): immutable.Map[K, Queue[A]]

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

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

K

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

f

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

возвращает

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

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

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

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

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

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

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

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

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

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

K

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

B

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

key

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

f

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

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

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

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

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

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

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

Definition Classes
IterableOps

def grouped(n: Int): Iterator[Queue[A]]

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

returns

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

Definition Classes
ArrayDequeOps → IterableOps
См. также

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

def hashCode(): Int

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

returns

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

Definition Classes
Seq → AnyRef → Any

def head: A

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

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

returns

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

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

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

def headOption: Option[A]

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

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

returns

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

Definition Classes
IterableOps

def indexOf[B >: A](elem: B): Int

Находит индекс первого вхождения некоторого значения в этой последовательности.

B

тип элемента elem.

elem

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

returns

индекс >= 0 первого элемента этой последовательности, который равен (как определяется ==) элементу elem, или -1, если такового не существует.

Definition Classes
SeqOps
Аннотации
@deprecatedOverriding("Override indexOf(elem, from) вместо этого - indexOf(elem) вызывает indexOf(elem, 0)", "2.13.0")

def indexOf[B >: A](elem: B, from: Int): Int

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

B

тип элемента elem.

elem

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

from

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

returns

индекс >= from первого элемента этой последовательности, который равен (как определяется ==) элементу elem, или -1, если такового не существует.

Definition Classes
SeqOps

def indexOfSlice[B >: A](that: collection.Seq[B]): Int

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

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

that

последовательность для проверки

returns

первый индекс >= 0 такой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательности that, или -1 если такой подпоследовательности не существует.

Definition Classes
SeqOps
Аннотации
@deprecatedOverriding("Override indexOfSlice(that, from) вместо этого - indexOfSlice(that) вызывает indexOfSlice(that, 0)", "2.13.0")

def indexOfSlice[B >: A](that: collection.Seq[B], from: Int): Int

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

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

that

последовательность для проверки

from

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

returns

первый индекс >= from, такой, что элементы этой последовательности, начинающиеся с этого индекса, совпадают с элементами последовательности that, или -1, если такая подпоследовательность отсутствует.

Definition Classes
SeqOps

def indexWhere(p: (A) => Boolean): Int

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

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

p

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

returns

индекс >= 0 первого элемента этой последовательности, который удовлетворяет предикату p, или -1, если такового нет.

Definition Classes
SeqOps
Annotations
@deprecatedOverriding("Override indexWhere(p, from) instead - indexWhere(p) calls indexWhere(p, 0)", "2.13.0")

def indexWhere(p: (A) => Boolean, from: Int): Int

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

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

p

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

from

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

returns

индекс >= from первого элемента этой последовательности, который удовлетворяет предикату p, или -1, если такового нет.

Definition Classes
SeqOps

def indices: immutable.Range

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

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

returns

значение Range от 0 до значения, на единицу меньшего, чем длина этой последовательности.

Definition Classes
SeqOps

def init: Queue[A]

Начальная часть коллекции без её последнего элемента.

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

Definition Classes
IterableOps

def inits: Iterator[Queue[A]]

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

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

returns

итератор по всем начальным частям (inits) этой итерируемой коллекции

Definition Classes
IterableOps
Пример:

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

def insert(idx: Int, elem: A): Unit

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

idx

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

elem

элемент для вставки.

Definition Classes
ArrayDeque → Buffer
Исключения

IndexOutOfBoundsException, если индекс idx не находится в допустимом диапазоне 0 <= idx <= length.

def insertAll(idx: Int, elems: IterableOnce[A]): Unit

Вставляет новые элементы в индекс idx. В отличие от метода update, этот метод не заменит элемент новым. Вместо этого он вставит новый элемент в индекс idx.

idx

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

elems

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

Definition Classes
ArrayDeque → Buffer
Исключения

IndexOutOfBoundsException, если idx выходит за пределы.

def intersect[B >: A](that: collection.Seq[B]): Queue[A]

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

that

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

returns

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

Definition Classes
StrictOptimizedSeqOps → SeqOps

def isDefinedAt(idx: Int): Boolean

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

Реализации методов apply и isDefinedAt преобразуют Seq[A] в PartialFunction[Int, A].

idx

индекс для проверки

returns

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

Definition Classes
SeqOps

def isEmpty: Boolean

Проверяет, пуста ли очередь с массивом.

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

returns

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

Definition Classes
ArrayDeque → SeqOps → IterableOnceOps

final def isInstanceOf[T0]: Boolean

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

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

returns

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

Definition Classes
Any

def isTraversableAgain: Boolean

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

returns

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

Definition Classes
IterableOps → IterableOnceOps

def iterableFactory: SeqFactory[Queue]

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

Definition Classes
Queue → ArrayDeque → IndexedBuffer → IndexedSeq → IndexedSeq → Buffer → Seq → Iterable → Seq → Iterable → IterableOps
Note

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

def iterator: Iterator[A]

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

Definition Classes
IndexedSeqOps → IterableOnce

def klone(): Queue[A]

Attributes
protected
Definition Classes
Queue → ArrayDeque → ArrayDequeOps

def knownSize: Int

returns

Количество элементов в этой очереди с массивом, если оно может быть вычислено дёшево, -1 в противном случае. Дёшево обычно означает: не требует обхода коллекции.

Definition Classes
ArrayDeque → IndexedSeqOps → Buffer → Growable → IterableOnce

def last: A

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

returns

Последний элемент этой последовательности.

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

NoSuchElementException Если последовательность пуста.

def lastIndexOf[B >: A](elem: B, end: Int = length - 1): Int

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

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

B

тип элемента elem.

elem

значение элемента, который нужно найти.

end

конечный индекс.

returns

индекс <= end последнего элемента этой последовательности, который равен (как определено ==) elem, или -1, если такового не существует.

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

def lastIndexOfSlice[B >: A](that: collection.Seq[B]): Int

Находит последний индекс, где эта последовательность содержит данную последовательность как срез.

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

that

последовательность для проверки

returns

последний индекс, такой что элементы этой последовательности, начинающиеся с этого индекса, совпадают с элементами последовательности that, или -1, если такой подпоследовательности не существует.

Определяющие классы
SeqOps
Аннотации
@deprecatedOverriding("Override lastIndexOfSlice(that, end) instead - lastIndexOfSlice(that) calls lastIndexOfSlice(that, Int.MaxValue)", "2.13.0")

def lastIndexOfSlice[B >: A](that: collection.Seq[B], end: Int): Int

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

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

that

последовательность для проверки

end

конечный индекс

returns

последний индекс <= end такой, что элементы этой последовательности, начинающиеся с этого индекса, совпадают с элементами последовательности that, или -1, если такой подпоследовательности не существует.

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

def lastIndexWhere(p: (A) => Boolean): Int

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

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

p

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

returns

индекс последнего элемента этой последовательности, который удовлетворяет предикату p, или -1, если такового не существует.

Определяющие классы
SeqOps
Аннотации
@deprecatedOverriding("Override lastIndexWhere(p, end) instead - lastIndexWhere(p) calls lastIndexWhere(p, Int.MaxValue)", "2.13.0")

def lastIndexWhere(p: (A) => Boolean, end: Int): Int

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

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

p

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

returns

индекс <= end последнего элемента этой последовательности, который удовлетворяет предикату p, или -1, если такового не существует.

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

def lastOption: Option[A]

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

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

returns

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

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

def lazyZip[B](that: collection.Iterable[B]): LazyZip2[A, B, Queue.this.type]

Аналогично zip за исключением того, что элементы в каждом наборе не потребляются до тех пор, пока на возвращаемом LazyZip2 декораторе не будет вызвана строгая операция.

Вызовы lazyZip можно объединять, чтобы поддерживать более высокие арности (до 4) без затрат на построение и разбор промежуточных кортежей.

val xs = List(1, 2, 3)
val res = (xs lazyZip xs lazyZip xs lazyZip xs).map((a, b, c, d) => a + b + c + d)
// res == List(4, 8, 12)
B

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

that

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

returns

декоратор LazyZip2, который позволяет выполнять строгие операции над лениво вычисляемыми парами или объединёнными вызовами lazyZip. Поддерживается также неявное преобразование в Iterable[(A, B)].

Definition Classes
Iterable

def length: Int

Длина (количество элементов) массива очереди. size является псевдонимом для length в Seq коллекциях.

Definition Classes
ArrayDeque → SeqOps

final def lengthCompare(that: collection.Iterable[_]): Int

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

that

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

returns

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

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

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

Definition Classes
IndexedSeqOps → SeqOps

final def lengthCompare(len: Int): Int

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

len

значение теста, которое сравнивается с длиной.

returns

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

x <  0       if this.length <  len
x == 0       if this.length == len
x >  0       if this.length >  len

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

Definition Classes
IndexedSeqOps → SeqOps
См. также

lengthIs

final def lengthIs: SizeCompareOps

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

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

this.lengthIs < len     // this.lengthCompare(len) < 0
this.lengthIs <= len    // this.lengthCompare(len) <= 0
this.lengthIs == len    // this.lengthCompare(len) == 0
this.lengthIs != len    // this.lengthCompare(len) != 0
this.lengthIs >= len    // this.lengthCompare(len) >= 0
this.lengthIs > len     // this.lengthCompare(len) > 0
Definition Classes
SeqOps
Аннотации
@inline()

def lift: (Int) => Option[A]

Преобразует эту частичную функцию в обычную функцию, возвращающую результат Option.

returns

функция, которая принимает аргумент x и возвращает Some(this(x)), если this определена для x, и None в противном случае.

Definition Classes
PartialFunction
См. также

Function.unlift

def map[B](f: (A) => B): Queue[B]

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

B

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

f

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

returns

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

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

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

def mapInPlace(f: (A) => A): Queue.this.type

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

f

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

returns

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

Definition Classes
IndexedSeqOps

def max[B >: A](implicit ord: math.Ordering[B]): A

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

B

Тип, для которого определен порядок.

ord

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

returns

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

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

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

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

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

B

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

f

Измеряющая функция.

cmp

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

returns

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

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

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

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

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

B

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

f

Измеряющая функция.

cmp

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

returns

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

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

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

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

B

Тип, для которого определен порядок.

ord

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

returns

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

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

def min[B >: A](implicit ord: math.Ordering[B]): A

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

B

Тип, для которого определен порядок.

ord

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

returns

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

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

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

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

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

B

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

f

Измеряющая функция.

cmp

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

returns

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

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

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

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

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

B

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

f

Измеряющая функция.

cmp

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

returns

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

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

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

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

B

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

ord

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

returns

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

Definition Classes
IterableOnceOps

final def mkString: String

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

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

returns

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

Definition Classes
IterableOnceOps
Annotations
@inline()

final def mkString(sep: String): String

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

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

sep

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

returns

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

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

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

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

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

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

start

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

sep

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

end

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

returns

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

Definition Classes
IterableOnceOps
Пример:

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

final def ne(arg0: AnyRef): Boolean

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

returns

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

Definition Classes
AnyRef

def newSpecificBuilder: Builder[A, Queue[A]]

returns

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

Attributes
protected
Definition Classes
IterableFactoryDefaults → IterableOps
Note

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

,

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

def nonEmpty: Boolean

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

returns

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

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

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

не указано SLS в качестве члена AnyRef

final def notifyAll(): Unit

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

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

не указано SLS как члена AnyRef

def occCounts[B](sq: collection.Seq[B]): Map[B, Int]

Attributes
protected[scala.collection]
Definition Classes
SeqOps

def ofArray(array: Array[AnyRef], end: Int): Queue[A]

Attributes
protected
Definition Classes
Queue → ArrayDeque → ArrayDequeOps

def orElse[A1 <: Int, B1 >: A](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]

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

A1

тип аргумента резервной функции

B1

тип результата резервной функции

that

резервная функция

returns

частичная функция, область определения которой является объединением областей определения данной частичной функции и that. Результирующая частичная функция принимает x к this(x), где this определена, и к that(x) в противном случае.

Definition Classes
PartialFunction

def padTo[B >: A](len: Int, elem: B): Queue[B]

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

B

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

len

целевая длина

elem

значение дополнения

returns

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

Definition Classes
StrictOptimizedSeqOps → SeqOps

def padToInPlace(len: Int, elem: A): Queue.this.type

Definition Classes
Buffer

def partition(p: (A) => Boolean): (Queue[A], Queue[A])

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

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

def partitionMap[A1, A2](f: (A) => Either[A1, A2]): (Queue[A1], Queue[A2])

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

Пример:

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

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

A2

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

f

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

def patch[B >: A](from: Int, other: IterableOnce[B], replaced: Int): Queue[B]

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

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

B

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

from

индекс первого заменяемого элемента

other

замещающая последовательность

replaced

количество элементов для удаления в исходной последовательности

returns

новая последовательность, состоящая из всех элементов этой последовательности, за исключением того, что replaced элементы, начиная с from, заменяются всеми элементами other.

Definition Classes
SeqOps

def patchInPlace(from: Int, patch: IterableOnce[A], replaced: Int): Queue.this.type

Definition Classes
IndexedBuffer → Buffer

def permutations: Iterator[Queue[A]]

Перебирает все возможные перестановки.

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

returns

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

Definition Classes
SeqOps
Пример:

    "abb".permutations = Iterator(abb, bab, bba)

def prepend(elem: A): Queue.this.type

Добавляет элемент в начало этой очереди.

elem

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

returns

сама очередь

Definition Classes
ArrayDeque → Buffer

def prependAll(elems: IterableOnce[A]): Queue.this.type

Definition Classes
ArrayDeque → Buffer

def prepended[B >: A](elem: B): Queue[B]

Копия последовательности с добавленным элементом в начало.

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

Пример:

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

scala> val y = 2 +: x
y: List[Int] = List(2, 1)

scala> println(x)
List(1)
B

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

elem

элемент, добавляемый в начало

returns

новая последовательность, состоящая из value и всех элементов этой последовательности.

Definition Classes
StrictOptimizedSeqOps → SeqOps

def prependedAll[B >: A](prefix: IterableOnce[B]): Queue[B]

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

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

B

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

prefix

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

returns

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

Definition Classes
StrictOptimizedSeqOps → SeqOps

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

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

B

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

num

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

returns

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

Definition Classes
IterableOnceOps

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

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

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

B

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

op

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

returns

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

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

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)

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

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

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

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

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

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

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

B

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

op

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

returns

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

Definition Classes
IterableOnceOps

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

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

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

B

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

op

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

returns

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

Definition Classes
IterableOnceOps

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)...))

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

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

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

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

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

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

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

B

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

op

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

returns

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

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

def remove(idx: Int): A

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

idx

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

returns

элемент, который раньше находился в индексе idx.

Определяющие классы
ArrayDeque → Buffer

def remove(idx: Int, count: Int): Unit

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

idx

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

count

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

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

IllegalArgumentException если count < 0.

IndexOutOfBoundsException если индекс idx не находится в допустимом диапазоне 0 <= idx <= length - count (с count > 0).

def removeAll(p: (A) => Boolean): immutable.Seq[A]

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

p

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

returns

последовательность всех элементов в очереди, для которых p дает true.

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

def removeAll(): immutable.Seq[A]

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

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

def removeAllReverse(): immutable.Seq[A]

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

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

def removeFirst(p: (A) => Boolean, from: Int = 0): Option[A]

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

p

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

from

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

returns

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

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

def removeHead(resizeInternalRepr: Boolean = false): A

Небезопасно удаляет первый элемент (выбрасывает исключение, когда пусто). См. также removeHeadOption()

resizeInternalRepr

Если это установлено, измените внутреннее представление, чтобы время от времени освобождать место

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

NoSuchElementException когда пусто

def removeHeadOption(resizeInternalRepr: Boolean = false): Option[A]

resizeInternalRepr

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

Definition Classes
ArrayDeque

def removeHeadWhile(f: (A) => Boolean): immutable.Seq[A]

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

f

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

Definition Classes
ArrayDeque

def removeLast(resizeInternalRepr: Boolean = false): A

Небезопасно удаляет последний элемент (бросает исключение при пустом очереди) См. также removeLastOption()

resizeInternalRepr

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

Definition Classes
ArrayDeque
Exceptions thrown

NoSuchElementException при пустом очереди

def removeLastOption(resizeInternalRepr: Boolean = false): Option[A]

resizeInternalRepr

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

Definition Classes
ArrayDeque

def removeLastWhile(f: (A) => Boolean): immutable.Seq[A]

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

f

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

Definition Classes
ArrayDeque

final def requireBounds(idx: Int, until: Int = length): Unit

Attributes
protected
Definition Classes
ArrayDequeOps
Annotations
@inline()

def reverse: Queue[A]

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

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

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

returns

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

Definition Classes
ArrayDequeOps → SeqOps

def reverseIterator: Iterator[A]

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

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

Примечание: xs.reverseIterator это то же самое, что и xs.reverse.iterator, но может быть более эффективным.

returns

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

Definition Classes
IndexedSeqOps → SeqOps

def reversed: collection.Iterable[A]

Attributes
protected
Definition Classes
IndexedSeqOps → IterableOnceOps

def runWith[U](action: (A) => U): (Int) => Boolean

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

Обратите внимание, что выражение pf.runWith(action)(x) эквивалентно

if(pf isDefinedAt x) { action(pf(x)); true } else false

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

action

функция действия

returns

функция, которая отображает аргументы x на isDefinedAt(x). Результирующая функция выполняет action(this(x)), где this определено.

Definition Classes
PartialFunction
Since

2.10

See also

applyOrElse.

def sameElements[B >: A](that: IterableOnce[B]): Boolean

Являются ли элементы этой коллекции такими же (и в том же порядке), как и элементы that?

Definition Classes
SeqOps

def scan[B >: A](z: B)(op: (B, B) => B): Queue[B]

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

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

B

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

z

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

op

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

returns

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

Definition Classes
IterableOps

def scanLeft[B](z: B)(op: (B, A) => B): Queue[B]

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

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

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

B

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

z

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

op

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Note

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

def scanRight[B](z: B)(op: (A, B) => B): Queue[B]

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

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

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

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

Пример:

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

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

z

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

op

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

returns

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

Definition Classes
IterableOps

def search[B >: A](elem: B, from: Int, to: Int)(implicit ord: math.Ordering[B]): SearchResult

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

Последовательность должна быть отсортирована с тем же Ordering перед вызовом; в противном случае результаты не определены.

elem

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

from

индекс, с которого начинается поиск.

to

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

ord

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

returns

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

Definition Classes
IndexedSeqOps → SeqOps
Note

если to <= from, область поиска пуста, и возвращается InsertionPoint в from

See also

scala.collection.IndexedSeq

scala.math.Ordering

scala.collection.SeqOps, метод sorted

def search[B >: A](elem: B)(implicit ord: math.Ordering[B]): SearchResult

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

Последовательность должна быть отсортирована с тем же Ordering перед вызовом; в противном случае результаты не определены.

elem

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

ord

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

returns

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

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

scala.collection.IndexedSeq

scala.math.Ordering

scala.collection.SeqOps, метод sorted

def segmentLength(p: (A) => Boolean, from: Int): Int

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

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

p

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

from

индекс, с которого начинается поиск.

returns

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

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

final def segmentLength(p: (A) => Boolean): Int

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

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

p

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

returns

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

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

final def size: Int

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

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

returns

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

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

final def sizeCompare(that: collection.Iterable[_]): Int

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

that

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

returns

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

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

Реализация этого метода не вызывает size напрямую; его время выполнения составляет O(this.size min that.size) вместо O(this.size + that.size). Метод должен быть переопределен, если вычисление size является недорогим, а knownSize возвращает -1.

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

final def sizeCompare(otherSize: Int): Int

Сравнивает размер этой последовательности с тестовым значением.

otherSize

тестовое значение, которое сравнивается с размером.

returns

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

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

Реализация этого метода не вызывает size напрямую; его время выполнения составляет O(size min otherSize) вместо O(size). Метод должен быть переопределен, если вычисление size является недорогим, а knownSize возвращает -1.

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

sizeIs

final def sizeIs: SizeCompareOps

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

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

this.sizeIs < size     // this.sizeCompare(size) < 0
this.sizeIs <= size    // this.sizeCompare(size) <= 0
this.sizeIs == size    // this.sizeCompare(size) == 0
this.sizeIs != size    // this.sizeCompare(size) != 0
this.sizeIs >= size    // this.sizeCompare(size) >= 0
this.sizeIs > size     // this.sizeCompare(size) > 0
Определяющие классы
IterableOps
Аннотации
@inline()

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

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

from <= indexOf(x) < until
from

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

until

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

returns

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

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

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

def sliceInPlace(start: Int, end: Int): Queue.this.type

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

def sliding(window: Int, step: Int): Iterator[Queue[A]]

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

step

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

возвращает

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

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

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

def sliding(size: Int): Iterator[Queue[A]]

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

size

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

возвращает

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

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

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

def sortBy[B](f: (A) => B)(implicit ord: Ordering[B]): Queue[A]

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

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

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

Сортировка стабильна. То есть элементы, которые равны (как определяется ord.compare), появляются в отсортированной последовательности в том же порядке, что и в исходной.

B

целевой тип преобразования f, и тип, где определен порядок ord.

f

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

ord

порядок, предполагаемый в области B.

возвращает

последовательность, состоящую из элементов этой последовательности, отсортированных в соответствии с порядком, где x < y если ord.lt(f(x), f(y)).

Определяющие классы
SeqOps
Пример:
    val words = "The quick brown fox jumped over the lazy dog".split(' ')
    // this works because scala.Ordering will implicitly provide an Ordering[Tuple2[Int, Char]]
    words.sortBy(x => (x.length, x.head))
    res0: Array[String] = Array(The, dog, fox, the, lazy, over, brown, quick, jumped)
См. также

scala.math.Ordering

def sortInPlace[B >: A]()(implicit ord: Ordering[B]): Queue.this.type

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

ord

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

возвращает

измененная входная изменяемая последовательность, отсортированная в соответствии с порядком ord.

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

scala.collection.SeqOps.sorted

def sortInPlaceBy[B](f: (A) => B)(implicit ord: Ordering[B]): Queue.this.type

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

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

scala.collection.SeqOps.sortBy

def sortInPlaceWith(lt: (A, A) => Boolean): Queue.this.type

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

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

scala.collection.SeqOps.sortWith

def sortWith(lt: (A, A) => Boolean): Queue[A]

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

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

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

Сортировка устойчивая. То есть элементы, которые равны (как определяется lt), появляются в отсортированной последовательности в том же порядке, что и в исходной.

lt

функция сравнения, которая проверяет, предшествует ли её первый аргумент её второму аргументу в желаемой упорядоченности.

returns

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

Definition Classes
SeqOps
Пример:
    List("Steve", "Tom", "John", "Bob").sortWith(_.compareTo(_) < 0) =
    List("Bob", "John", "Steve", "Tom")

def sorted[B >: A](implicit ord: Ordering[B]): Queue[A]

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

Сортировка устойчивая. То есть элементы, которые равны (как определяется ord.compare), появляются в отсортированной последовательности в том же порядке, что и в исходной.

ord

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

returns

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

Definition Classes
SeqOps
См. также

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

def span(p: (A) => Boolean): (Queue[A], Queue[A])

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

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

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

p

предикат проверки

returns

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

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

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

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

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

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

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

n

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

returns

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

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

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

def start_+(idx: Int): Int

Attributes
protected
Definition Classes
ArrayDeque → ArrayDequeOps
Annotations
@inline()

def startsWith[B >: A](that: IterableOnce[B], offset: Int = 0): Boolean

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

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

that

тестируемая последовательность

offset

индекс, где ищется последовательность.

returns

true если последовательность that содержится в этой последовательности в индексе offset, иначе false.

Definition Classes
SeqOps

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

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

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

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

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

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

Definition Classes
ArrayDeque → IndexedSeqOps → IterableOnce

final def strictOptimizedCollect[B, C2](b: Builder[B, C2], pf: PartialFunction[A, B]): C2

B

Тип элементов результирующего набора (например, String)

C2

Тип результирующего набора (например, List[String])

b

Библиотека для построения результирующего набора

pf

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

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

final def strictOptimizedConcat[B >: A, C2](that: IterableOnce[B], b: Builder[B, C2]): C2

B

Тип элементов результирующих наборов (например, Int)

C2

Тип результирующего набора (например, List[Int])

that

Элементы, которые необходимо добавить к этому набору

b

Библиотека для построения результирующего набора

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

final def strictOptimizedFlatMap[B, C2](b: Builder[B, C2], f: (A) => IterableOnce[B]): C2

B

Тип элементов результирующего набора (например, String)

C2

Тип результирующего набора (например, List[String])

b

Библиотека для построения результирующего набора

f

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

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

final def strictOptimizedFlatten[B, C2](b: Builder[B, C2])(implicit toIterableOnce: (A) => IterableOnce[B]): C2

B

Тип элементов результирующего набора (например, Int)

C2

Тип результирующего набора (например, List[Int])

b

Билдэр для построения результирующего набора

toIterableOnce

Доказательство того, что A можно рассматривать как IterableOnce[B]

returns

Результирующий набор

Атрибуты
protected[this]
Определяющие классы
StrictOptimizedIterableOps
Аннотации
@inline()

final def strictOptimizedMap[B, C2](b: Builder[B, C2], f: (A) => B): C2

B

Тип элементов результирующего набора (например, String)

C2

Тип результирующего набора (например, List[String])

b

Билдэр для построения результирующего набора

f

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

returns

Результирующий набор

Атрибуты
protected[this]
Определяющие классы
StrictOptimizedIterableOps
Аннотации
@inline()

final def strictOptimizedZip[B, C2](that: IterableOnce[B], b: Builder[(A, B), C2]): C2

B

Тип элементов второго набора (например, String)

C2

Тип результирующего набора (например, List[(Int, String)])

that

Набор для объединения с этим набором

b

Билдэр для построения результирующего набора

returns

Результирующий набор

Атрибуты
protected[this]
Определяющие классы
StrictOptimizedIterableOps
Аннотации
@inline()

def stringPrefix: String

Атрибуты
protected[this]
Определяющие классы
Queue → ArrayDeque → IndexedSeq → Buffer → Seq → Iterable
Аннотации
@deprecatedOverriding("Compatibility override", "2.13.0")

def subSequence(start: Int, end: Int): CharSequence

Неявный
Этот член добавлен неявным преобразованием из Queue[A] в SeqCharSequence, выполненным методом SeqCharSequence в scala.Predef. Это преобразование произойдёт только если A является подклассом Char (A <: Char).
Определяющие классы
SeqCharSequence → CharSequence

def subtractAll(xs: IterableOnce[A]): Queue.this.type

Удаляет все элементы, сгенерированные итератором, из этого изменяемого набора.

xs

итератор, генерирующий элементы для удаления.

returns

сам изменяемый набор

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

def subtractOne(elem: A): Queue.this.type

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

returns

сам буфер

Определяющие классы
ArrayDeque → Buffer → Shrinkable

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

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

B

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

num

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

returns

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

Definition Classes
IterableOnceOps

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

Definition Classes
AnyRef

def tail: Queue[A]

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

Definition Classes
IterableOps

def tails: Iterator[Queue[A]]

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

returns

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

Definition Classes
IterableOps
Пример:

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

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

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

n

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

returns

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

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

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

def takeInPlace(n: Int): Queue.this.type

Definition Classes
Buffer

def takeRight(n: Int): Queue[A]

Набор, содержащий последние n элементы этого набора.

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

n

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

def takeRightInPlace(n: Int): Queue.this.type

Definition Classes
Buffer

def takeWhile(p: (A) => Boolean): Queue[A]

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

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

p

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

returns

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

Definition Classes
IterableOps → IterableOnceOps

def takeWhileInPlace(p: (A) => Boolean): Queue.this.type

Definition Classes
Buffer

def tapEach[U](f: (A) => U): Queue[A]

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

U

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

f

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

возвращает

Тот же логический набор, что и этот

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

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

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

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

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

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

Преобразование набора в массив.

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

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

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

def toIndexedSeq: immutable.IndexedSeq[A]

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

final def toIterable: Queue.this.type

возвращает

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

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

def toList: immutable.List[A]

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

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

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

def toSeq: immutable.Seq[A]

возвращает

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

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

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

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

def toString(): String

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

возвращает

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

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

def toVector: immutable.Vector[A]

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

def transpose[B](неявный asIterable: (A) => collection.Iterable[B]): Queue[Queue[B]]

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

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

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

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

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

B

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

asIterable

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

возвращает

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

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

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

def trimEnd(n: Int): Unit

Удаляет последние n элементов этого буфера.

n

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

Definition Classes
Buffer

def trimStart(n: Int): Unit

Удаляет первые n элементов этого буфера.

n

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

Definition Classes
Buffer

def trimToSize(): Unit

Уменьшает емкость экземпляра этого ArrayDeque до текущего размера

Definition Classes
ArrayDeque

def unapply(a: Int): Option[A]

Попытка извлечь B из A в выражении сопоставления с образцом.

Definition Classes
PartialFunction

def unlift: PartialFunction[Int, B]

Преобразует необязательную функцию в частичную функцию.

Неявный
Этот член добавлен неявным преобразованием из Queue[A] вUnliftOps[Int, B] выполняемое методом UnliftOps в scala.Function1.Это преобразование произойдет только в том случае, если A является подклассом Option[B] (A <: Option[B]).
Definition Classes
UnliftOps
Пример:

    В отличие от Function.unlift, этот метод UnliftOps.unlift может использоваться в экстрактных методах.

    val of: Int => Option[String] = { i =>
      if (i == 2) {
        Some("matched by an optional function")
      } else {
        None
      }
    }
    
    util.Random.nextInt(4) match {
      case of.unlift(m) => // Convert an optional function to a pattern
        println(m)
      case _ =>
        println("Not matched")
    }

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

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

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

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

A2

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

asPair

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

возвращает

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

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

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

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

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

A2

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

A3

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

asTriple

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

def update(idx: Int, elem: A): Unit

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

idx

индекс элемента для замены.

elem

новое значение.

Definition Classes
ArrayDeque → SeqOps
Exceptions thrown

IndexOutOfBoundsException, если индекс некорректен.

def updated[B >: A](index: Int, elem: B): Queue[B]

Копия этого последовательности с одним измененным элементом.

B

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

index

позиция замены

elem

элемент замены

returns

новая последовательность, являющаяся копией этой последовательности с элементом на позиции index заменённым на elem.

Definition Classes
SeqOps
Exceptions thrown

IndexOutOfBoundsException, если index не удовлетворяет условию 0 <= index < length. В случае ленивой коллекции это исключение может быть выброшено позже или вообще не выброшено (если конец коллекции никогда не оценивается).

def view: IndexedSeqView[A]

Вид на элементы этой коллекции.

Definition Classes
IndexedSeqOps → SeqOps → IterableOps

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()

def withFilter(p: (A) => Boolean): WithFilter[A, [_]Queue[_]]

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

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

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

p

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

returns

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

Definition Classes
IterableOps

def writeReplace(): AnyRef

Attributes
protected[this]
Definition Classes
DefaultSerializable

def zip[B](that: IterableOnce[B]): Queue[(A, B)]

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

B

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

that

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

def zipAll[A1 >: A, B](that: collection.Iterable[B], thisElem: A1, thatElem: B): Queue[(A1, B)]

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

that

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

thisElem

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

thatElem

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

returns

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

Definition Classes
IterableOps

def zipWithIndex: Queue[(A, Int)]

Объединяет эту итерируемую коллекцию со своими индексами.

returns

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

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

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

Note

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

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

def length(): Int

Неявный
Этот член добавлен неявным преобразованием из Queue[A] в SeqCharSequence, выполненным методом SeqCharSequence в scala.Predef. Это преобразование будет происходить только если A является подклассом Char (A <: Char).
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать явное указание типа:
(queue: SeqCharSequence).length()
Definition Classes
SeqCharSequence → CharSequence

def toString(): String

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

returns

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

Неявный
Этот член добавлен неявным преобразованием из Queue[A] в SeqCharSequence, выполненным методом SeqCharSequence в scala.Predef. Это преобразование будет происходить только если A является подклассом Char (A <: Char).
Затенение
Этот неявно унаследованный член затенено одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать явное указание типа:
(queue: SeqCharSequence).toString()
Definition Classes
SeqCharSequence → CharSequence → AnyRef → Any

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

Spec-Zone.ru

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