Spec-Zone.ru › Scala 3.1

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

Объект-компаньон • Исходный код

@SerialVersionUID(3L)
final class StringBuilder(val underlying: StringBuilder) extends AbstractSeq[Char] with ReusableBuilder[Char, String] with IndexedSeq[Char] with IndexedSeqOps[Char, IndexedSeq, StringBuilder] with IterableFactoryDefaults[Char, IndexedSeq] with CharSequence with Serializable

Построитель для изменяемой последовательности символов. Этот класс предоставляет API, в основном совместимый с java.lang.StringBuilder, за исключением случаев конфликтов с API коллекций Scala (например, метод reverse).

Этот Построитель может быть повторно использован после вызова result(), без промежуточного вызова clear(), для создания нескольких связанных результатов.

Суператрибуты
31 тип
Интерфейс Serializable
Интерфейс CharSequence
Интерфейс IndexedSeq[Char]
Интерфейс IndexedSeqOps[Char, IndexedSeq, StringBuilder]
Интерфейс IndexedSeq[Char]
Интерфейс IndexedSeqOps[Char, IndexedSeq, StringBuilder]
Интерфейс ReusableBuilder[Char, String]
Интерфейс Builder[Char, String]
Интерфейс Growable[Char]
Интерфейс Clearable
Класс AbstractSeq[Char]
Интерфейс Seq[Char]
Интерфейс SeqOps[Char, IndexedSeq, StringBuilder]
Интерфейс Cloneable[StringBuilder]
Интерфейс Cloneable
Интерфейс Iterable[Char]
Класс AbstractSeq[Char]
Интерфейс Seq[Char]
Интерфейс Equals
Интерфейс SeqOps[Char, IndexedSeq, StringBuilder]
Интерфейс PartialFunction[Int, Char]
Интерфейс Int => Char
Класс AbstractIterable[Char]
Интерфейс Iterable[Char]
Интерфейс IterableFactoryDefaults[Char, IndexedSeq]
Интерфейс IterableOps[Char, IndexedSeq, StringBuilder]
Интерфейс IterableOnceOps[Char, IndexedSeq, StringBuilder]
Интерфейс IterableOnce[Char]
Класс Object
Интерфейс Matchable
Класс Any

Конструкторы

Исходный код
def this()

Исходный код
def this(capacity: Int)

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

Параметры
capacity

начальная емкость.

Исключения
java.lang.NegativeArraySizeException

если capacity < 0.

Исходный код
def this(str: String)

Создает строковый буфер с начальными символами, равными символам str.

Исходный код
def this(initCapacity: Int, initValue: String)

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

Конкретные методы

Исходный код
def ++=(s: String): StringBuilder

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

Исходный код
def addAll(s: String): StringBuilder

Перегруженная версия addAll, принимающая строку

Исходный код
def addOne(x: Char): StringBuilder

Исходный код
def append(x: Any): StringBuilder

Добавляет строковое представление данного аргумента, преобразованного в строку с помощью String.valueOf.

Параметры
x

объект Any.

Возвращает

этот StringBuilder.

Исходный код
def append(s: String): StringBuilder

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

Параметры
s

строка.

Возвращает

этот StringBuilder.

Исходный код
def append(cs: CharSequence): StringBuilder

Добавляет данный CharSequence к этой последовательности.

Параметры
cs

CharSequence.

Возвращает

этот StringBuilder.

Исходный код
def append(s: StringBuilder): StringBuilder

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

Возвращает

Исходный код
def append(x: Boolean): StringBuilder

Добавляет строковое представление данного примитивного типа к этой последовательности. Аргумент преобразуется в строку с помощью String.valueOf.

Параметры значения
x

примитивное значение

Возвращает

Этот StringBuilder.

Источник
def append(x: Byte): StringBuilder

Источник
def append(x: Short): StringBuilder

Источник
def append(x: Int): StringBuilder

Источник
def append(x: Long): StringBuilder

Источник
def append(x: Float): StringBuilder

Источник
def append(x: Double): StringBuilder

Источник
def append(x: Char): StringBuilder

Источник
def appendAll(xs: String): StringBuilder

Источник
def appendAll(xs: IterableOnce[Char]): StringBuilder

Добавляет все символы в заданном IterableOnce[Char] в эту последовательность.

Параметры значения
xs

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

Возвращает

этот StringBuilder.

Источник
def appendAll(xs: Array[Char]): StringBuilder

Добавляет все символы в данном Array[Char] в эту последовательность.

Параметры значения
xs

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

Возвращает

ссылка на этот объект.

Источник
def appendAll(xs: Array[Char], offset: Int, len: Int): StringBuilder

Добавляет часть данного Array[Char] в эту последовательность.

Параметры значения
len

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

offset

индекс первого символа для добавления.

xs

массив, содержащий добавляемые символы.

Возвращает

этот StringBuilder.

Источник
def apply(i: Int): Char

Источник
def capacity: Int

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

Возвращает

емкость

Источник
def charAt(index: Int): Char

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

Параметры значения
index

индекс для поиска

Возвращает

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

Выбрасывает
IndexOutOfBoundsException

если индекс находится за пределами границ.

Источник
def clear(): Unit

Источник
def delete(start: Int, end: Int): StringBuilder

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

Параметры значения
end

Конечный индекс, исключая.

start

Начальный индекс, включая.

Возвращает

Этот StringBuilder.

Выбрасывает
StringIndexOutOfBoundsException

если start < 0 || start > end

Источник
def deleteCharAt(index: Int): StringBuilder

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

Параметры значения
index

индекс для удаления.

Возвращает

Этот StringBuilder.

Выбрасывает
IndexOutOfBoundsException

если индекс находится за пределами границ.

Источник
override def empty: StringBuilder

Классы определений IterableFactoryDefaults -> IterableOps

Источник
def ensureCapacity(newCapacity: Int): Unit

Обеспечивает, что емкость не меньше заданного значения. Если значение больше текущей емкости, будет выделена новая память размером, равным заданному значению или (2 * capacity + 2), что больше.

Параметры значения
newCapacity

минимальная желаемая емкость.

Источник
def indexOf(str: String): Int

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

Параметры значения
str

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

Возвращает

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

Источник
def indexOf(str: String, fromIndex: Int): Int

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

Параметры значения
fromIndex

наименьший индекс в исходной строке для рассмотрения

str

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

Возвращает

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

Исходный код
def insert(index: Int, x: Any): StringBuilder

Вставляет строковое представление (через String.valueOf) данного аргумента в эту последовательность по указанному индексу.

Параметры значения
index

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

x

значение.

Возвращает

этот StringBuilder.

Исключения
StringIndexOutOfBoundsException

если индекс находится вне допустимого диапазона.

Исходный код
def insert(index: Int, x: String): StringBuilder

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

Параметры значения
index

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

x

строка.

Возвращает

этот StringBuilder.

Исключения
StringIndexOutOfBoundsException

если индекс находится вне допустимого диапазона.

Исходный код
def insert(index: Int, x: Boolean): StringBuilder

Вызывает String.valueOf для данного примитивного значения и вставляет строку по указанному индексу.

Параметры значения
index

смещение позиции.

x

примитивное значение.

Возвращает

этот StringBuilder.

Исходный код
def insert(index: Int, x: Byte): StringBuilder

Исходный код
def insert(index: Int, x: Short): StringBuilder

Исходный код
def insert(index: Int, x: Int): StringBuilder

Исходный код
def insert(index: Int, x: Long): StringBuilder

Исходный код
def insert(index: Int, x: Float): StringBuilder

Исходный код
def insert(index: Int, x: Double): StringBuilder

Исходный код
def insert(index: Int, x: Char): StringBuilder

Исходный код
def insertAll(index: Int, str: Array[Char], offset: Int, len: Int): StringBuilder

Вставляет подмассив данного Array[Char] по указанному индексу этой последовательности.

Параметры значения
index

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

len

количество символов из 'str', которые нужно вставить.

offset

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

str

массив, из которого будут взяты символы.

Возвращает

Этот StringBuilder.

Исключения
StringIndexOutOfBoundsException

если index < 0, index > length, offset < 0, len < 0 или (offset + len) > str.length.

Исходный код
def insertAll(index: Int, xs: IterableOnce[Char]): StringBuilder

Вставляет данную Seq[Char] в эту последовательность по указанному индексу.

Параметры значения
index

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

xs

Seq[Char].

Возвращает

этот StringBuilder.

Исключения
StringIndexOutOfBoundsException

если индекс находится вне допустимого диапазона.

Исходный код
def insertAll(index: Int, xs: Array[Char]): StringBuilder

Вставляет данный Array[Char] в эту последовательность по указанному индексу.

Параметры значения
index

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

xs

Array[Char].

Возвращает

этот StringBuilder.

Исключения
StringIndexOutOfBoundsException

если индекс находится вне допустимого диапазона.

Исходный код
override def isEmpty: Boolean

Проверяет, пуст ли этот билдер.

Этот метод требуется для совместимости с JDK15+.

Возвращает

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

Классы определения CharSequence -> SeqOps -> IterableOnceOps

Исходный код
override def knownSize: Int

Классы определения IndexedSeqOps -> Growable -> IterableOnce

Исходный код
def lastIndexOf(str: String): Int

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

Параметры значения
str

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

Возвращает

последний применимый индекс, где встречается целевой текст, или -1, если он не найден.

Исходный код
def lastIndexOf(str: String, fromIndex: Int): Int

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

Параметры значения
fromIndex

наименьший индекс в исходной строке для рассмотрения

str

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

Возвращает

последний применимый индекс, где встречается целевой текст, или -1, если он не найден.

Исходный код@inline
def length: Int

Исходный код
def length_=(n: Int): Unit

Source
def replace(start: Int, end: Int, str: String): StringBuilder

Заменяет подпоследовательность символов заданной строкой. Семантика такая же, как и в методе delete, а затем строка-аргумент вставляется в индекс 'start'.

Параметры
end

Конечный индекс (исключительно).

start

Начальный индекс (включительно).

str

Строка, которая будет вставлена в индекс start.

Возвращает

Этот StringBuilder.

Исключения
StringIndexOutOfBoundsException

если start < 0, start > длина, или start > end

Source
def result(): String

Source
def reverseInPlace(): StringBuilder

Аналогично reverse, но деструктивно обновляет целевой StringBuilder.

Возвращает

перевернутый StringBuilder (то же, что и целевой StringBuilder)

Source
def setCharAt(index: Int, ch: Char): StringBuilder

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

Параметры
ch

новый Char.

index

индекс для изменения.

Исключения
IndexOutOfBoundsException

если индекс вне допустимого диапазона.

Source
def setLength(len: Int): Unit

Устанавливает длину последовательности символов. Если текущая последовательность короче заданной длины, она дополняется null; если длиннее, она усекается.

Параметры
len

новая длина

Исключения
IndexOutOfBoundsException

если аргумент отрицательный.

Source
def subSequence(start: Int, end: Int): CharSequence

Для реализации интерфейса CharSequence.

Source
def substring(start: Int): String

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

target.substring(start) эквивалентно target.drop(start)

Параметры
start

Начальный индекс (включительно).

Возвращает

Новая строка.

Исключения
IndexOutOfBoundsException

если индекс вне допустимого диапазона.

Source
def substring(start: Int, end: Int): String

Возвращает новую строку, состоящую из подпоследовательности этой последовательности, начинающейся с индекса start (включительно) и заканчивающейся индексом end (исключительно).

target.substring(start, end) эквивалентно target.slice(start, end).mkString

Параметры
end

Конечный индекс (исключительно).

start

Начальный индекс (включительно).

Возвращает

Новая строка.

Исключения
StringIndexOutOfBoundsException

Если любой из индексов вне допустимого диапазона или если start > end.

Source
override def toArray[B >: Char](implicit ct: ClassTag[B]): Array[B]

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

Source
def toCharArray: Array[Char]

Возвращает содержимое этого StringBuilder в виде массива.

Возвращает

Массив с символами из этого билдера.

Source
override def toString: String

Определения классов CharSequence -> Seq -> Function1 -> Iterable -> Any

Source
def update(idx: Int, elem: Char): Unit

Наследуемые методы

Source@inline
final def ++[B >: Char](suffix: IterableOnce[B]): IndexedSeq[B]

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

Наследуется от IterableOps

Source@inline
final override def ++:[B >: Char](prefix: IterableOnce[B]): IndexedSeq[B]

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

Определения классов SeqOps -> IterableOps
Наследуется от SeqOps

Source@inline
final def ++=(xs: IterableOnce[Char]): StringBuilder

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

Наследуется от Growable

Source@inline
final def +:[B >: Char](elem: B): IndexedSeq[B]

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

Наследуется от SeqOps

Source@inline
final def +=(elem: Char): StringBuilder

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

Наследуется от Growable

Source@inline
final def :+[B >: Char](elem: B): IndexedSeq[B]

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

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

Унаследовано от SeqOps

Source@inline
final def :++[B >: Char](suffix: IterableOnce[B]): IndexedSeq[B]

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

Унаследовано от SeqOps

Source
def addAll(xs: IterableOnce[Char]): StringBuilder

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

Параметры значения
xs

IterableOnce, производящий элементы для добавления.

Возвращаемое значение

сама изменяемая коллекция.

Унаследовано от Growable

Source@inline
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

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

Возвращаемое значение

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

Унаследовано от IterableOnceOps

Source@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

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

Возвращаемое значение

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

Унаследовано от IterableOnceOps

Source
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

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

end

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

sep

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

start

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

Возвращаемое значение

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

Унаследовано от IterableOnceOps

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

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

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

Параметры типа
C

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

Параметры значения
k

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

Возвращаемое значение

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

Унаследовано от PartialFunction

Source
override def andThen[C](k: Char => C): PartialFunction[Int, C]

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

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

Параметры типа
C

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

Параметры значения
k

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

Возвращаемое значение

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

Классы определения PartialFunction -> Function1
Унаследовано от PartialFunction

Source
def appended[B >: Char](elem: B): IndexedSeq[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

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

Возвращаемое значение

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

Унаследовано от SeqOps

Source
def appendedAll[B >: Char](suffix: IterableOnce[B]): IndexedSeq[B]

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

Параметры типа
B

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

Параметры значения
suffix

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

Возвращаемое значение

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

Унаследовано от SeqOps

Source
def applyOrElse[A1 <: Int, B1 >: Char](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. Это может привести к лучшей производительности и более предсказуемому поведению в отношении побочных эффектов.

Параметры значения
default

функция по умолчанию

x

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

Возвращает

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

Унаследовано от PartialFunction

Источник
def canEqual(that: Any): Boolean

Унаследовано от Seq

def chars(): IntStream

Унаследовано от CharSequence

Источник
override def clone(): StringBuilder

Классы-предки SeqOps -> Cloneable -> Object
Унаследовано от SeqOps

def codePoints(): IntStream

Унаследовано от CharSequence

Источник
def collect[B](pf: PartialFunction[Char, B]): IndexedSeq[B]

Унаследовано от IterableOps

Источник
def collectFirst[B](pf: PartialFunction[Char, B]): Option[B]

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

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

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

Параметры значения
pf

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

Возвращает

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

Пример

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

Унаследовано от IterableOnceOps

Источник
def combinations(n: Int): Iterator[StringBuilder]

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

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

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

Возвращает

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

Пример

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

Унаследовано от SeqOps

Источник
def compose[R](k: PartialFunction[R, Int]): PartialFunction[R, Char]

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

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

Параметры типа
R

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

Параметры значения
k

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

Возвращает

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

Унаследовано от PartialFunction

Источник@unspecialized
def compose[A](g: A => Int): A => Char

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

Параметры типа
A

тип, к которому можно применить функцию g

Параметры значения
g

функция A => T1

Возвращает

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

Унаследовано от Function1

Источник@inline
final override def concat[B >: Char](suffix: IterableOnce[B]): IndexedSeq[B]

Классы-предки SeqOps -> IterableOps
Унаследовано от SeqOps

Источник
def contains[A1 >: Char](elem: A1): Boolean

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

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

Параметры значения
elem

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

Возвращает

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

Унаследовано от SeqOps

Источник
def containsSlice[B >: Char](that: Seq[B]): Boolean

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

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

END_OF_DOCUMENT_MARKER
Параметры значения
that

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

Возвращает

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

Унаследовано от SeqOps

Источник
def copyToArray[B >: Char](xs: Array[B], start: Int, len: Int): Int

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

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

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

Параметры типа
B

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

Параметры значения
len

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

start

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

xs

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

Возвращает

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

Примечание

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

Унаследовано от IterableOnceOps

Источник@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")
def copyToArray[B >: Char](xs: Array[B], start: Int): Int

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

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

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

Параметры типа
B

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

Параметры значения
start

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

xs

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

Возвращает

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

Примечание

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

Унаследовано от IterableOnceOps

Источник@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")
def copyToArray[B >: Char](xs: Array[B]): Int

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

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

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

Параметры типа
B

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

Параметры значения
xs

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

Возвращает

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

Примечание

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

Унаследовано от IterableOnceOps

Источник
def corresponds[B](that: IterableOnce[B])(p: (Char, B) => Boolean): Boolean

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

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

Параметры типа
B

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

Параметры значения
p

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

that

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def corresponds[B](that: Seq[B])(p: (Char, B) => Boolean): Boolean

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

Параметры типа
B

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

Параметры значения
p

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

that

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

Возвращает

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

Унаследовано от SeqOps

Источник
def count(p: Char => Boolean): Int

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def diff[B >: Char](that: Seq[B]): StringBuilder

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

Параметры значения
that

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

Возвращает

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

Унаследовано от SeqOps

Источник
def distinct: StringBuilder

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

Возвращает

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

Унаследовано от SeqOps

Источник
def distinctBy[B](f: Char => B): StringBuilder

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

Параметры типа
B

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

Параметры значения
f

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

Возвращает

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

Унаследовано от SeqOps

Исходный код
override def drop(n: Int): StringBuilder

Классы-предки IndexedSeqOps -> IterableOps -> IterableOnceOps
Унаследовано от IndexedSeqOps

Исходный код
override def dropRight(n: Int): StringBuilder

Классы-предки IndexedSeqOps -> IterableOps
Унаследовано от IndexedSeqOps

Исходный код
def dropWhile(p: Char => Boolean): StringBuilder

Унаследовано от IterableOps

Исходный код
def elementWise: ElementWiseExtractor[Int, Char]

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

Пример
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
}
Унаследовано от PartialFunction

Исходный код
def endsWith[B >: Char](that: Iterable[B]): Boolean

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

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

Параметры значения
that

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

Возвращает

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

Унаследовано от SeqOps

Исходный код
override def equals(o: Any): Boolean

Классы-предки Seq -> Equals -> Any
Унаследовано от Seq

Исходный код
def exists(p: Char => Boolean): Boolean

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOnceOps

Исходный код
def filter(pred: Char => Boolean): StringBuilder

Унаследовано от IterableOps

Исходный код
def filterNot(pred: Char => Boolean): StringBuilder

Унаследовано от IterableOps

Исходный код
def find(p: Char => Boolean): Option[Char]

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

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOnceOps

Исходный код
def findLast(p: Char => Boolean): Option[Char]

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от SeqOps

Исходный код
def flatMap[B](f: Char => IterableOnce[B]): IndexedSeq[B]

Унаследовано от IterableOps

Исходный код
def flatten[B](implicit asIterable: Char => IterableOnce[B]): IndexedSeq[B]

Унаследовано от IterableOps

Исходный код
def fold[A1 >: Char](z: A1)(op: (A1, A1) => A1): A1

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

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

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

Параметры типа
A1

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

Параметры значения
op

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

z

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

Возвращает

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

Унаследовано от IterableOnceOps

Исходный код
def foldLeft[B](z: B)(op: (B, Char) => B): B

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

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

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

Параметры типа
B

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

Параметры значения
op

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

z

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

Возвращает

результат вставки op между последовательными элементами этой коллекции, слева направо с начальным значением z слева: op(...op(z, x1), x2, ..., xn) где x1, ..., xn являются элементами этой коллекции. Возвращает z если эта коллекция пуста.

Унаследовано от IterableOnceOps

Источник
override def foldRight[B](z: B)(op: (Char, B) => B): B

Классы определения IndexedSeqOps -> IterableOnceOps
Унаследовано от IndexedSeqOps

Источник
def forall(p: Char => Boolean): Boolean

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def foreach[U](f: Char => U): Unit

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

Унаследовано от IterableOnceOps

Источник
def groupBy[K](f: Char => K): Map[K, StringBuilder]

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

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

Параметры типа
K

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

Параметры значения
f

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

Возвращает

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

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

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

Унаследовано от IterableOps

Источник
def groupMap[K, B](key: Char => K)(f: Char => B): Map[K, IndexedSeq[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)

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

Параметры типа
B

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

K

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

Параметры значения
f

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

key

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

Унаследовано от IterableOps

Источник
def groupMapReduce[K, B](key: Char => K)(f: Char => B)(reduce: (B, B) => B): Map[K, B]

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

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

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

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

Унаследовано от IterableOps

Источник
def grouped(size: Int): Iterator[StringBuilder]

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

Параметры значения
size

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

Возвращает

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

См. также

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

Унаследовано от IterableOps

Источник
override def hashCode(): Int

Классы определения Seq -> Any
Унаследовано от Seq

Источник
override def head: Char

Классы определения IndexedSeqOps -> IterableOps
Унаследовано от IndexedSeqOps

Источник
override def headOption: Option[Char]

Классы определения IndexedSeqOps -> IterableOps
Унаследовано от IndexedSeqOps

Источник@deprecatedOverriding("Override indexOf(elem, from) instead - indexOf(elem) calls indexOf(elem, 0)", "2.13.0")
def indexOf[B >: Char](elem: B): Int

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

Параметры типа
B

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

Параметры значения
elem

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

Возвращает

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

Унаследовано от SeqOps

Источник
def indexOf[B >: Char](elem: B, from: Int): Int

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

Type parameters
B

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

Value parameters
elem

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

from

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

Returns

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

Inherited from SeqOps

Source@deprecatedOverriding("Override indexOfSlice(that, from) instead - indexOfSlice(that) calls indexOfSlice(that, 0)", "2.13.0")
def indexOfSlice[B >: Char](that: Seq[B]): Int

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

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

Value parameters
that

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

Returns

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

Inherited from SeqOps

Source
def indexOfSlice[B >: Char](that: Seq[B], from: Int): Int

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

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

Value parameters
from

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

that

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

Returns

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

Inherited from SeqOps

Source@deprecatedOverriding("Override indexWhere(p, from) instead - indexWhere(p) calls indexWhere(p, 0)", "2.13.0")
def indexWhere(p: Char => Boolean): Int

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

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

Value parameters
p

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

Returns

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

Inherited from SeqOps

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

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

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

Value parameters
from

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

p

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

Returns

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

Inherited from SeqOps

Source
def indices: Range

Создаёт диапазон всех индексов этой последовательности.

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

Returns

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

Inherited from SeqOps

Source
def init: StringBuilder

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

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

Inherited from IterableOps

Source
def inits: Iterator[StringBuilder]

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

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

Returns

итератор по всем начальным частям этой коллекции итерабельных элементов

Example

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

Inherited from IterableOps

Source
def intersect[B >: Char](that: Seq[B]): StringBuilder

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

Value parameters
that

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

Returns

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

Inherited from SeqOps

Source
def isDefinedAt(idx: Int): Boolean

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

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

Value parameters
idx

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

Returns

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

Inherited from SeqOps

Source
override def isTraversableAgain: Boolean

Definition Classes IterableOps -> IterableOnceOps
Inherited from IterableOps

Source
override def iterableFactory: SeqFactory[IndexedSeq]

Definition Classes IndexedSeq -> IndexedSeq -> Seq -> Seq -> Iterable -> Iterable -> IterableOps
Inherited from IndexedSeq

Source
def iterator: Iterator[Char]

Inherited from IndexedSeqOps

Source
override def last: Char

Definition Classes IndexedSeqOps -> IterableOps
Inherited from IndexedSeqOps

Source
def lastIndexOf[B >: Char](elem: B, end: Int): Int

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

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

Type parameters
B

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

Value parameters
elem

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

end

индекс окончания.

Returns

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

Inherited from SeqOps

Source@deprecatedOverriding("Override lastIndexOfSlice(that, end) instead - lastIndexOfSlice(that) calls lastIndexOfSlice(that, Int.MaxValue)", "2.13.0")
def lastIndexOfSlice[B >: Char](that: Seq[B]): Int

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

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

Value parameters
that

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

Returns

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

Inherited from SeqOps

Source
def lastIndexOfSlice[B >: Char](that: Seq[B], end: Int): Int

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

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

Value parameters
end

индекс окончания

that

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

Returns

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

Inherited from SeqOps

Source@deprecatedOverriding("Override lastIndexWhere(p, end) instead - lastIndexWhere(p) calls lastIndexWhere(p, Int.MaxValue)", "2.13.0")
def lastIndexWhere(p: Char => Boolean): Int

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

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

Value parameters
p

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

Returns

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

Inherited from SeqOps

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

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

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

Value parameters
p

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

Returns

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

Inherited from SeqOps

Source
def lastOption: Option[Char]

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

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

Returns

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

Inherited from IterableOps

Source
def lazyZip[B](that: Iterable[B]): LazyZip2[Char, B, StringBuilder]

Аналогично 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)
Type parameters
B

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

Value parameters
that

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

Returns

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

Inherited from Iterable

Source
final override def lengthCompare(that: Iterable[_]): Int

Definition Classes IndexedSeqOps -> SeqOps
Inherited from IndexedSeqOps

Source
final override def lengthCompare(len: Int): Int

Definition Classes IndexedSeqOps -> SeqOps
Inherited from IndexedSeqOps

Source@inline
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
Inherited from SeqOps

Source
def lift: Int => Option[Char]

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

Returns

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

See also

Function.unlift

Inherited from PartialFunction

Source
override def map[B](f: Char => B): IndexedSeq[B]

Классы-определения IndexedSeqOps -> IterableOps -> IterableOnceOps
Унаследовано от IndexedSeqOps

Исходный код
def mapInPlace(f: Char => Char): StringBuilder

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

Параметры значения
f

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

Возвращает

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

Унаследовано от IndexedSeqOps

Исходный код
def mapResult[NewTo](f: String => NewTo): Builder[Char, NewTo]

Строитель, полученный из этого строителя путём отображения результата с помощью f.

Унаследовано от Builder

Исходный код
def max[B >: Char](implicit ord: Ordering[B]): Char

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

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

Параметры типа
B

Тип, над которым определено упорядочение.

Параметры значения
ord

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

Возвращает

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

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

Исходный код
def maxBy[B](f: Char => B)(implicit cmp: Ordering[B]): Char

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

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

Параметры типа
B

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

Параметры значения
cmp

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

f

Функция измерения.

Возвращает

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

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

Исходный код
def maxByOption[B](f: Char => B)(implicit cmp: Ordering[B]): Option[Char]

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

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

Параметры типа
B

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

Параметры значения
cmp

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

f

Функция измерения.

Возвращает

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

Унаследовано от IterableOnceOps

Исходный код
def maxOption[B >: Char](implicit ord: Ordering[B]): Option[Char]

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

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

Параметры типа
B

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

Параметры значения
ord

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

Возвращает

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

Унаследовано от IterableOnceOps

Исходный код
def min[B >: Char](implicit ord: Ordering[B]): Char

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

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

Параметры типа
B

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

Параметры значения
ord

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

Возвращает

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

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

Исходный код
def minBy[B](f: Char => B)(implicit cmp: Ordering[B]): Char

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

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

Параметры типа
B

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

Параметры значения
cmp

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

f

Функция измерения.

Возвращает

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

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

Исходный код
def minByOption[B](f: Char => B)(implicit cmp: Ordering[B]): Option[Char]

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

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

Параметры типа
B

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

Параметры значения
cmp

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

f

Функция измерения.

Возвращает

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

Унаследовано от IterableOnceOps

Исходный код
def minOption[B >: Char](implicit ord: Ordering[B]): Option[Char]

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

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

Параметры типа
B

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

Параметры значения
ord

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

Возвращает

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

Унаследовано от IterableOnceOps

Source@inline
final def mkString: String

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

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

Возвращает

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

Унаследовано от IterableOnceOps

Source@inline
final def mkString(sep: String): String

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

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

Параметры
sep

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

Возвращает

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

Пример

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

Унаследовано от IterableOnceOps

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

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

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

Параметры
end

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

sep

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

start

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

Возвращает

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

Пример

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

Унаследовано от IterableOnceOps

Source@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
def nonEmpty: Boolean

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

Возвращает

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

Унаследовано от IterableOnceOps

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

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

Параметры типа
A1

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

B1

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

Параметры
that

вспомогательная функция

Возвращает

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

Унаследовано от PartialFunction

Source
def padTo[B >: Char](len: Int, elem: B): IndexedSeq[B]

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

Параметры типа
B

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

Параметры
elem

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

len

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

Возвращает

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

Унаследовано от SeqOps

Source
def partition(p: Char => Boolean): (StringBuilder, StringBuilder)

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

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

Унаследовано от IterableOps

Source
def partitionMap[A1, A2](f: Char => Either[A1, A2]): (IndexedSeq[A1], IndexedSeq[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

Возвращает

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

Унаследовано от IterableOps

Source
def patch[B >: Char](from: Int, other: IterableOnce[B], replaced: Int): IndexedSeq[B]

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

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

Параметры типа
B

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

Параметры
from

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

other

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

replaced

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

Возвращает

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

Унаследовано от SeqOps

Source
def permutations: Iterator[StringBuilder]

Итерирует по различным перестановкам.

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

Возвращает

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

Пример

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

Унаследовано от SeqOps

Источник
override def prepended[B >: Char](elem: B): IndexedSeq[B]

Классы-предки IndexedSeqOps -> SeqOps
Унаследовано от IndexedSeqOps

Источник
def prependedAll[B >: Char](prefix: IterableOnce[B]): IndexedSeq[B]

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

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

Параметры типа
B

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

Параметры значения
prefix

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

Возвращает

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

Унаследовано от SeqOps

Источник
def product[B >: Char](implicit num: Numeric[B]): B

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

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

Параметры типа
B

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

Параметры значения
num

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def reduce[B >: Char](op: (B, B) => B): B

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращает

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

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

Источник
def reduceLeft[B >: Char](op: (B, Char) => B): B

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращает

результат вставки op между последовательными элементами этой коллекции слева направо: op( op( ... op(x1, x2) ..., xn-1), xn) где x1, ..., xn - элементы этой коллекции.

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

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

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращает

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

Унаследовано от IterableOnceOps

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

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

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

Параметры типа
B

Параметр типа для бинарного оператора, являющийся надтипом A.

Параметры значения
op

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

Возвращает

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

Унаследовано от IterableOnceOps

Source
def reduceRight[B >: Char](op: (Char, B) => B): B

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращает

результат вставки op между последовательными элементами этой коллекции справа налево: op(x1, op(x2, ..., op(xn-1, xn)...)), где x1, ..., xn являются элементами этой коллекции.

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

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

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращает

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

Унаследовано от IterableOnceOps

Source
override def reverse: StringBuilder

Definition Classes IndexedSeqOps -> SeqOps
Inherited from IndexedSeqOps

Source
override def reverseIterator: Iterator[Символ]

Definition Classes IndexedSeqOps -> SeqOps
Inherited from IndexedSeqOps

Source
override protected def reversed: Iterable[Символ]

Definition Classes IndexedSeqOps -> IterableOnceOps
Inherited from IndexedSeqOps

Source
def runWith[U](action: Символ => U): Целое => Булево

Composes this partial function with an action function which gets applied to results of this partial function. The action function is invoked only for its side effects; its result is ignored.

Note that expression pf.runWith(action)(x) is equivalent to

if(pf isDefinedAt x) { action(pf(x)); true } else false

except that runWith is implemented via applyOrElse and thus potentially more efficient. Using runWith avoids double evaluation of pattern matchers and guards for partial function literals.

Value parameters
action

the action function

Returns

a function which maps arguments x to isDefinedAt(x). The resulting function runs action(this(x)) where this is defined.

See also

applyOrElse.

Inherited from PartialFunction

Source
def sameElements[B >: Символ](that: IterableOnce[B]): Булево

Are the elements of this collection the same (and in the same order) as those of that?

Inherited from SeqOps

Source
def scan[B >: Символ](z: B)(op: (B, B) => B): IndexedSeq[B]

Computes a prefix scan of the elements of the collection.

Note: The neutral element z may be applied more than once.

Type parameters
B

element type of the resulting collection

Value parameters
op

the associative operator for the scan

z

neutral element for the operator op

Returns

a new iterable collection containing the prefix scan of the elements in this iterable collection

Inherited from IterableOps

Source
def scanLeft[B](z: B)(op: (B, Символ) => B): IndexedSeq[B]

Inherited from IterableOps

Source
def scanRight[B](z: B)(op: (Символ, B) => B): IndexedSeq[B]

Produces a collection containing cumulative results of applying the operator going right to left. The head of the collection is the last cumulative result.

Note: will not terminate for infinite-sized collections.

Note: might return different results for different runs, unless the underlying collection type is ordered.

Note: Even when applied to a view or a lazy collection it will always force the elements.

Example:

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

the type of the elements in the resulting collection

Value parameters
op

the binary operator applied to the intermediate result and the element

z

the initial value

Returns

collection with intermediate results

Inherited from IterableOps

Source
override def search[B >: Символ](elem: B, from: Целое, to: Целое)(implicit ord: Ordering[B]): SearchResult

Definition Classes IndexedSeqOps -> SeqOps
Inherited from IndexedSeqOps

Source
override def search[B >: Символ](elem: B)(implicit ord: Ordering[B]): SearchResult

Definition Classes IndexedSeqOps -> SeqOps
Inherited from IndexedSeqOps

Source
def segmentLength(p: Символ => Булево, from: Целое): Целое

Computes the length of the longest segment that starts from some index and whose elements all satisfy some predicate.

Note: may not terminate for infinite-sized collections.

Value parameters
from

the index where the search starts.

p

the predicate used to test elements.

Returns

the length of the longest segment of this sequence starting from index from such that every element of the segment satisfies the predicate p.

Inherited from SeqOps

Source
final def segmentLength(p: Символ => Булево): Целое

Computes the length of the longest segment that starts from the first element and whose elements all satisfy some predicate.

Note: may not terminate for infinite-sized collections.

Value parameters
p

the predicate used to test elements.

Returns

the length of the longest segment of this sequence that starts from the first element such that every element of the segment satisfies the predicate p.

Inherited from SeqOps

Source
final override def size: Целое

Definition Classes SeqOps -> IterableOnceOps
Inherited from SeqOps

Source
final override def sizeCompare(that: Iterable[_]): Целое

Definition Classes SeqOps -> IterableOps
Inherited from SeqOps

Источник
final override def sizeCompare(otherSize: Int): Int

Классы определения SeqOps -> IterableOps
Унаследовано от SeqOps

Источник
final def sizeHint(coll: IterableOnce[_], delta: Int): Unit

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

Параметры значения
coll

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

delta

исправление, которое нужно добавить к coll.size для получения подсказки размера.

Унаследовано от Builder

Источник
def sizeHint(size: Int): Unit

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

Параметры значения
size

подсказка о том, сколько элементов будет добавлено.

Унаследовано от Builder

Источник
final def sizeHintBounded(size: Int, boundingColl: Iterable[_]): Unit

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

Параметры значения
boundingColl

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

size

подсказка о том, сколько элементов будет добавлено.

Унаследовано от Builder

Источник@inline
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

Источник
override def slice(from: Int, until: Int): StringBuilder

Классы определения IndexedSeqOps -> IterableOps -> IterableOnceOps
Унаследовано от IndexedSeqOps

Источник
def sliding(size: Int, step: Int): Iterator[StringBuilder]

Группирует элементы в блоки фиксированного размера, передавая "скользящее окно" по ним (в отличие от разбиения их, как это делается в grouped.)

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

Параметры значения
size

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

step

расстояние между первыми элементами последовательных групп

Возвращает

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

См. также

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

Пример

List(1, 2, 3, 4, 5).sliding(2, 2) = Iterator(List(1, 2), List(3, 4), List(5))

List(1, 2, 3, 4, 5, 6).sliding(2, 3) = Iterator(List(1, 2), List(4, 5))

Унаследовано от IterableOps

Источник
def sliding(size: Int): Iterator[StringBuilder]

Группирует элементы в блоки фиксированного размера, передавая "скользящее окно" по ним (в отличие от разбиения их, как это делается в grouped.)

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

Параметры значения
size

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

Возвращает

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

См. также

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

Пример

List().sliding(2) = empty iterator

List(1).sliding(2) = Iterator(List(1))

List(1, 2).sliding(2) = Iterator(List(1, 2))

List(1, 2, 3).sliding(2) = Iterator(List(1, 2), List(2, 3))

Унаследовано от IterableOps

Источник
def sortBy[B](f: Char => B)(implicit ord: Ordering[B]): StringBuilder

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

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

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

Сортировка устойчивая. То есть элементы, которые равны (как определено ord.compare), появляются в отсортированной последовательности в том же порядке, что и в исходной.

Параметры типа
B

целевой тип преобразования f, и тип, где определено упорядочение ord.

Параметры значения
f

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

ord

упорядочение, предполагаемое в домене B.

Возвращает

последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с упорядочением, где x < y если ord.lt(f(x), f(y)).

См. также

scala.math.Ordering

Пример
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)
Унаследовано от SeqOps

Источник
def sortInPlace[B >: Char]()(implicit ord: Ordering[B]): StringBuilder

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

Параметры значения
ord

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

Возвращает

изменённый входной изменяемый набор данных, отсортированный в соответствии с упорядочением ord.

См. также

scala.collection.SeqOps.sorted

Унаследовано от IndexedSeqOps
END_OF_DOCUMENT_MARKER

Source
def sortInPlaceBy[B](f: Char => B)(implicit ord: Ordering[B]): StringBuilder

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

См. также

scala.collection.SeqOps.sortBy

Унаследовано от IndexedSeqOps

Source
def sortInPlaceWith(lt: (Char, Char) => Boolean): StringBuilder

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

См. также

scala.collection.SeqOps.sortWith

Унаследовано от IndexedSeqOps

Source
def sortWith(lt: (Char, Char) => Boolean): StringBuilder

Сортирует эту последовательность в соответствии с функцией сравнения.

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

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

Сортировка устойчивая. То есть элементы, которые равны (как определено в lt), появляются в отсортированной последовательности в том же порядке, что и в исходной.

Параметры
lt

функция сравнения, которая проверяет, предшествует ли ее первый аргумент второму аргументу в желаемом порядке.

Возвращает

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

Пример
List("Steve", "Tom", "John", "Bob").sortWith(_.compareTo(_) < 0) =
List("Bob", "John", "Steve", "Tom")
Унаследовано от SeqOps

Source
def sorted[B >: Char](implicit ord: Ordering[B]): StringBuilder

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

Сортировка устойчивая. То есть элементы, которые равны (как определено в ord.compare), появляются в отсортированной последовательности в том же порядке, что и в исходной.

Параметры
ord

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

Возвращает

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

См. также

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

Унаследовано от SeqOps

Source
def span(p: Char => Boolean): (StringBuilder, StringBuilder)

Унаследовано от IterableOps

Source
override def splitAt(n: Int): (StringBuilder, StringBuilder)

Классы-родители IterableOps -> IterableOnceOps
Унаследовано от IterableOps

Source
def startsWith[B >: Char](that: IterableOnce[B], offset: Int): Boolean

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

Примечание: Если оба объекта-получателя this и аргумент that являются бесконечными последовательностями, этот метод может не завершиться.

Параметры
offset

индекс, где производится поиск последовательности.

that

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

Возвращает

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

Унаследовано от SeqOps

Source
override def stepper[S <: Stepper[_]](implicit shape: StepperShape[Char, S]): S & EfficientSplit

Классы-родители IndexedSeqOps -> IterableOnce
Унаследовано от IndexedSeqOps

Source
def sum[B >: Char](implicit num: Numeric[B]): B

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

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

Параметры типа
B

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

Параметры
num

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

Возвращает

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

Унаследовано от IterableOnceOps

Source
def tail: StringBuilder

Остаток коллекции без ее первого элемента.

Унаследовано от IterableOps

Source
def tails: Iterator[StringBuilder]

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

Возвращает

итератор по всем хвостам этой коллекции итерабельного типа

Пример

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

Унаследовано от IterableOps

Source
override def take(n: Int): StringBuilder

Классы-родители IndexedSeqOps -> IterableOps -> IterableOnceOps
Унаследовано от IndexedSeqOps

Source
override def takeRight(n: Int): StringBuilder

Классы-родители IndexedSeqOps -> IterableOps
Унаследовано от IndexedSeqOps

Source
def takeWhile(p: Char => Boolean): StringBuilder

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

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

END_OF_DOCUMENT_MARKER
Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOps

Исходный код
override def tapEach[U](f: Char => U): StringBuilder

Классы определения IterableOps -> IterableOnceOps
Унаследовано от IterableOps

Исходный код
def to[C1](factory: Factory[Char, C1]): C1

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

xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]

Унаследовано от IterableOnceOps

Исходный код@inline
final def toBuffer[B >: Char]: Buffer[B]

Унаследовано от IterableOnceOps

Исходный код
def toIndexedSeq: IndexedSeq[Char]

Унаследовано от IterableOnceOps

Исходный код
def toList: List[Char]

Унаследовано от IterableOnceOps

Исходный код
def toMap[K, V](implicit ev: Char <:< (K, V)): Map[K, V]

Унаследовано от IterableOnceOps

Исходный код
def toSeq: Seq[Char]

Возвращает

Эта коллекция как Seq[A]. Это эквивалентно to(Seq), но может быть быстрее.

Унаследовано от IterableOnceOps

Исходный код
def toSet[B >: Char]: Set[B]

Унаследовано от IterableOnceOps

Исходный код
def toVector: Vector[Char]

Унаследовано от IterableOnceOps

Исходный код
def transpose[B](implicit asIterable: Char => Iterable[B]): IndexedSeq[IndexedSeq[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-м столбцом этой итерируемой коллекции.

Исключения
IllegalArgumentException

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

Унаследовано от IterableOps

Исходный код
def unapply(a: Int): Option[Char]

Попытка извлечь B из A в выражении сопоставления с образцом.

Унаследовано от PartialFunction

Исходный код
def unzip[A1, A2](implicit asPair: Char => (A1, A2)): (IndexedSeq[A1], IndexedSeq[A2])

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

val xs = Iterable(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (Iterable(1, 2, 3),
//        Iterable(one, two, three))
Параметры типа
A1

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

A2

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

Параметры значения
asPair

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

Возвращает

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

Унаследовано от IterableOps

Исходный код
def unzip3[A1, A2, A3](implicit asTriple: Char => (A1, A2, A3)): (IndexedSeq[A1], IndexedSeq[A2], IndexedSeq[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

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

Возвращает

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

Унаследовано от IterableOps

Исходный код
def updated[B >: Char](index: Int, elem: B): IndexedSeq[B]

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

Параметры типа
B

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

Параметры значения
elem

заменяющий элемент

index

позиция замены

Возвращает

новая последовательность, являющаяся копией этой последовательности с элементом в позиции index заменённым на elem.

Исключения
IndexOutOfBoundsException

если index не удовлетворяет 0 <= index < length. В случае ленивой коллекции это исключение может быть выброшено позже или вообще не выброшено (если конец коллекции никогда не оценивается).

Унаследовано от SeqOps

Источник
override def view: IndexedSeqView[Символ]

Классы-определения IndexedSeqOps -> SeqOps -> IterableOps
Унаследовано от IndexedSeqOps

Источник
def withFilter(p: Символ => Boolean): WithFilter[Символ, IndexedSeq]

Создаёт нестрогий фильтр этого итерируемого набора.

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

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

Параметры значений
p

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

Возвращает

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

Унаследовано от IterableOps

Источник
def zip[B](that: IterableOnce[B]): IndexedSeq[(Символ, B)]

Возвращает итерируемый набор, образованный из этого итерируемого набора и другого итерируемого набора путём объединения соответствующих элементов парами. Если один из двух наборов длиннее другого, его оставшиеся элементы игнорируются.

Параметры типа
B

тип второй половины возвращаемых пар

Параметры значений
that

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

Возвращает

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

Унаследовано от IterableOps

Источник
def zipAll[A1 >: Символ, B](that: Iterable[B], thisElem: A1, thatElem: B): IndexedSeq[(A1, B)]

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

Параметры значений
that

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

thatElem

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

thisElem

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

Возвращает

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

Унаследовано от IterableOps

Источник
def zipWithIndex: IndexedSeq[(Символ, ЦелоеЧисло)]

Унаследовано от IterableOps

Конкретные поля

Источник
val underlying: StringBuilder

© 2002-2022 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://scala-lang.org/api/3.1.1/scala/collection/mutable/StringBuilder.html

Spec-Zone.ru

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