Spec-Zone.ru › Scala 2.12 Library

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

Компонент объект StringBuilder

final класс StringBuilder extends AbstractSeq[Символ] with CharSequence with IndexedSeq[Символ] with StringLike[StringBuilder] with ReusableBuilder[Символ, Строка] with Serializable

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

Аннотации
@SerialVersionUID()
Источник
StringBuilder.scala
С

2.7

Линейные надтипы

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

новый StringBuilder(str: Строка)

новый StringBuilder(capacity: Целое)

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

capacity

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

Исключения

NegativeArraySizeException, если capacity < 0.

новый StringBuilder()

новый StringBuilder(initCapacity: Целое, initValue: Строка)

новый StringBuilder(underlying: java.lang.StringBuilder)

Типовые члены

класс Элементы extends AbstractIterator[A] with BufferedIterator[A] with Serializable

Класс итератора, возвращаемого методом iterator. несколько take, drop, и slice операций над этим итератором группируются для повышения эффективности.

Атрибуты
protected
Определяющие классы
IndexedSeqLike
Аннотации
@SerialVersionUID()

класс WithFilter extends FilterMonadic[A, Repr]

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

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

тип Self = StringBuilder

Тип, реализующий этот перебираемый

Атрибуты
protected[this]
Определяющие классы
TraversableLike

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

final def !=(arg0: Any): Boolean

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

возвращает

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

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

final def ##(): Int

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

возвращает

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

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

def *(n: Int): String

Возвращает текущую строку, конкатенированную n раз.

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

def +(x: Char): StringBuilder.this.type

def ++[B >: Char, That](that: GenTraversableOnce[B])(implicit bf: CanBuildFrom[StringBuilder, B, That]): That

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

B

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

That

класс возвращаемой коллекции. Где возможно, That совпадает с классом текущей коллекции Repr, но это зависит от того, допускается ли тип элемента B для этого класса, что означает, что найден неявный экземпляр типа CanBuildFrom[Repr, B, That].

that

коллекция для добавления.

bf

неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.

возвращает

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

Определяющие классы
TraversableLike → GenTraversableLike

def ++:[B >: Char, That](that: collection.Traversable[B])(implicit bf: CanBuildFrom[StringBuilder, B, That]): That

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

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

Пример:

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

scala> val y = LinkedList(2)
y: scala.collection.mutable.LinkedList[Int] = LinkedList(2)

scala> val z = x ++: y
z: scala.collection.mutable.LinkedList[Int] = LinkedList(1, 2)

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

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

B

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

That

класс возвращаемой коллекции. Где возможно, That совпадает с классом текущей коллекции Repr, но это зависит от того, допускается ли тип элемента B для этого класса, что означает, что найден неявный экземпляр типа CanBuildFrom[Repr, B, That].

that

коллекция для добавления.

bf

неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.

возвращает

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

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

def ++:[B](that: TraversableOnce[B]): IndexedSeq[B]

[use case]

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

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

Пример:

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

scala> val y = LinkedList(2)
y: scala.collection.mutable.LinkedList[Int] = LinkedList(2)

scala> val z = x ++: y
z: scala.collection.mutable.LinkedList[Int] = LinkedList(1, 2)
B

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

that

коллекция для добавления.

возвращает

новый объект StringBuilder, содержащий все элементы этого объекта StringBuilder, за которыми следуют все элементы that.

Определяющие классы
TraversableLike
Полная сигнатура

def ++=(s: String): StringBuilder.this.type

def ++=(xs: TraversableOnce[Char]): StringBuilder.this.type

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

xs

TraversableOnce, генерирующий элементы для добавления.

returns

сама коллекция, увеличивающаяся по мере добавления.

Definition Classes
Growable

def +:(elem: A): IndexedSeq[A]

[use case]

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

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

Также исходный StringBuilder не изменяется, поэтому необходимо сохранить результат.

Пример:

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

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

returns

новый StringBuilder, состоящий из elem и всех элементов этого StringBuilder.

Definition Classes
SeqLike → GenSeqLike
Полная сигнатура

def +=(x: Char): StringBuilder.this.type

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

returns

сам билдер.

Definition Classes
StringBuilder → Builder → Growable

def +=(elem1: Char, elem2: Char, elems: Char*): StringBuilder.this.type

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

elem1

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

elem2

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

elems

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

returns

сама коллекция, увеличивающаяся по мере добавления

Definition Classes
Growable

def ->[B](y: B): (StringBuilder, B)

Неявный
Этот член добавлен с помощью неявного преобразования от StringBuilder к ArrowAssoc[StringBuilder], выполненного методом ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc
Аннотации
@inline()

def /:[B](z: B)(op: (B, Char) ⇒ B): B

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

Примечание: /: — это альтернативная синтаксическая конструкция для foldLeft; z /: xs — то же самое, что xs foldLeft z.

Примеры:

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

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

scala> val b = (5 /: a)(_+_)
b: Int = 15

scala> val c = (5 /: a)((x,y) => x + y)
c: Int = 15

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

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

B

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

z

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

op

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

returns

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

op(...op(op(z, x_1), x_2), ..., x_n)

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

Definition Classes
TraversableOnce → GenTraversableOnce

def :+(elem: A): IndexedSeq[A]

[use case]

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

Мемоническое правило для +: против :+ : двоеточие относится к стороне коллекции.

Пример:

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

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

returns

новый StringBuilder, состоящий из всех элементов этого StringBuilder, за которым следует elem.

Definition Classes
SeqLike → GenSeqLike
Полная сигнатура

def :\[B](z: B)(op: (Char, B) ⇒ B): B

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

Примечание: :\ — это альтернативный синтаксис для foldRight; xs :\ z эквивалентно xs foldRight z.

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

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

Примеры:

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

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

scala> val b = (a :\ 5)(_+_)
b: Int = 15

scala> val c = (a :\ 5)((x,y) => x + y)
c: Int = 15
B

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

z

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

op

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

returns

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

op(x_1, op(x_2, ... op(x_n, z)...))

где x1, ..., xn — элементы этого итерируемого объекта или итератора.

Definition Classes
TraversableOnce → GenTraversableOnce

def <(that: String): Boolean

Возвращает true, если this меньше, чем that.

Definition Classes
Ordered

def <=(that: String): Boolean

Возвращает true, если this меньше или равно that.

Definition Classes
Ordered

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

Возвращает true, если this больше, чем that.

Definition Classes
Ordered

def >=(that: String): Boolean

Возвращает true, если this больше или равно that.

Definition Classes
Ordered

def addString(b: scala.StringBuilder): scala.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
TraversableOnce

def addString(b: scala.StringBuilder, sep: String): scala.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
TraversableOnce

def addString(b: scala.StringBuilder, start: String, sep: String, end: String): scala.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
TraversableOnce

def aggregate[B](z: ⇒ B)(seqop: (B, Char) ⇒ B, combop: (B, B) ⇒ B): B

Агрегирует результаты применения оператора к последующим элементам.

Это более общая форма fold и reduce. Она похожа на foldLeft, поскольку не требует, чтобы результат был супертипом типа элемента. Кроме того, она позволяет обрабатывать параллельные коллекции частями и затем комбинировать промежуточные результаты.

aggregate разделяет итерируемый объект или итератор на части и обрабатывает каждую часть последовательным применением seqop, начиная с z (как foldLeft). Затем эти промежуточные результаты объединяются с помощью combop (как fold). Реализация этой операции может работать с произвольным количеством частей коллекции (даже с 1), поэтому combop может вызываться произвольное количество раз (даже 0).

Например, рассмотрим суммирование целочисленных значений списка символов. Начальное значение для суммы равно 0. Сначала seqop преобразует каждый символ ввода в Int и добавляет его к сумме (части). Затем combop просто суммирует промежуточные результаты частей:

List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })
B

тип накапливаемых результатов

z

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

seqop

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

combop

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

C

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

k

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

returns

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

Definition Classes
PartialFunction → Function1

def append(x: Char): StringBuilder

def append(x: Double): StringBuilder

def append(x: Float): StringBuilder

def append(x: Long): StringBuilder

def append(x: Int): StringBuilder

def append(x: Short): StringBuilder

def append(x: Byte): StringBuilder

def append(x: Boolean): StringBuilder

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

x

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

returns

Этот StringBuilder.

def append(sb: StringBuilder): StringBuilder

def append(s: String): StringBuilder

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

s

строка.

returns

этот StringBuilder.

def append(x: Any): StringBuilder

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

x

объект типа Any.

returns

этот StringBuilder.

def appendAll(xs: Array[Char], offset: Int, len: Int): StringBuilder

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

xs

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

offset

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

len

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

returns

этот StringBuilder.

def appendAll(xs: Array[Char]): StringBuilder

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

xs

символы для добавления.

returns

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

def appendAll(xs: TraversableOnce[Char]): StringBuilder

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

xs

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

returns

этот StringBuilder.

def appendAll(xs: String): StringBuilder

def apply(index: Int): Char

Эквивалентно charAt.

returns

элемент этого строкового билдера по индексу idx, где 0 обозначает первый элемент.

Definition Classes
StringBuilder → StringLike → SeqLike → GenSeqLike → Function1

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 оценки. Это может привести к лучшей производительности и более предсказуемому поведению относительно побочных эффектов.

x

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

default

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

returns

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

Definition Classes
PartialFunction
Since

2.10

final def asInstanceOf[T0]: T0

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

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

returns

объект-приемник.

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

ClassCastException, если объект-приемник не является экземпляром стирания типа T0.

def canEqual(that: Any): Boolean

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

that

Объект, с которым эта итеративная коллекция должна быть сравнена.

returns

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

Definition Classes
IterableLike → Equals

def capacity: Int

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

returns

емкость

def capitalize: String

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

Definition Classes
StringLike

def charAt(index: Int): Char

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

index

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

returns

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

Definition Classes
StringBuilder → CharSequence
Исключения

IndexOutOfBoundsException, если индекс находится вне границ.

def chars(): IntStream

Definition Classes
CharSequence

def clear(): Unit

Очищает содержимое билдера.

Definition Classes
StringBuilder → ReusableBuilder → Builder → Growable → Clearable

def clone(): StringBuilder

Создать копию объекта-приемника.

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

returns

копия объекта-приемника.

Definition Classes
StringBuilder → Cloneable → AnyRef
Note

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

def codePoints(): IntStream

Definition Classes
CharSequence

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

[use case]

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

B

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

pf

частичная функция, которая фильтрует и отображает строковый билдер.

returns

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

Definition Classes
TraversableLike → GenTraversableLike
Полная подпись

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

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

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

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

pf

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

returns

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

Definition Classes
TraversableOnce
Пример:

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

def combinations(n: Int): Iterator[StringBuilder]

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

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

returns

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

Definition Classes
SeqLike
Пример:

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

def companion: GenericCompanion[IndexedSeq]

Объект-компаньон-фабрика, создающий экземпляры класса IndexedSeq. (или его Iterable суперкласса, где класс IndexedSeq не является Seq.)

Definition Classes
IndexedSeq → IndexedSeq → Seq → Seq → GenSeq → Iterable → Iterable → GenIterable → Traversable → Traversable → GenTraversable → GenericTraversableTemplate

def compare(other: String): Int

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

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

Возвращает x, где:

    x < 0 когда this < that x == 0 когда this == that x > 0 когда this > that
Definition Classes
StringLike → Ordered

def compareTo(that: String): Int

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

Definition Classes
Ordered → Comparable

def compose[A](g: (A) ⇒ Int): (A) ⇒ Char

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

A

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

g

функция A => T1

returns

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

Definition Classes
Function1
Annotations
@unspecialized()

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

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

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

elem

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

returns

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

Definition Classes
SeqLike

def containsSlice[B](that: GenSeq[B]): Boolean

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

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

that

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

returns

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

Definition Classes
SeqLike

def copyToArray(xs: Array[A], start: Int, len: Int): Unit

[use case]

Копирует элементы этого строкового буфера в массив. Заполняет заданный массив xs не более чем len элементами этого строкового буфера, начиная с позиции start. Копирование завершится, когда будет достигнут либо конец текущего строкового буфера, либо конец целевого массива, или len элементов были скопированы.

xs

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

start

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

len

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

Definition Classes
IndexedSeqOptimized → IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce
Полная подпись

def copyToArray(xs: Array[A]): Unit

[use case]

Копирует элементы этого строкового буфера в массив. Заполняет заданный массив xs значениями этого строкового буфера. Копирование завершится, когда будет достигнут либо конец текущего строкового буфера, либо конец целевого массива.

xs

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

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

[use case]

Копирует элементы этого строкового буфера в массив. Заполняет заданный массив xs значениями этого строкового буфера, начиная с индекса start. Копирование завершится, когда будет достигнут либо конец текущего строкового буфера, либо конец целевого массива.

xs

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

start

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

def copyToBuffer[B >: Char](dest: Buffer[B]): Unit

Копирует все элементы этого обходчика или итератора в буфер.

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

dest

Буфер, в который копируются элементы.

Definition Classes
TraversableOnce

def corresponds[B](that: GenSeq[B])(p: (Char, B) ⇒ Boolean): Boolean

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

B

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

that

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

p

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

returns

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

Definition Classes
SeqLike → GenSeqLike

def count(p: (Char) ⇒ Boolean): Int

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

p

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def delete(start: Int, end: Int): StringBuilder

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

start

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

end

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

returns

Этот StringBuilder.

Exceptions thrown

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

def deleteCharAt(index: Int): StringBuilder

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

index

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

returns

Этот StringBuilder.

Exceptions thrown

IndexOutOfBoundsException, если индекс находится вне границ.

def diff(that: collection.Seq[Char]): IndexedSeq[Char]

[use case]

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

that

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

returns

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

Definition Classes
SeqLike → GenSeqLike
Полная сигнатура

def distinct: StringBuilder

Создает новую последовательность из этой последовательности без каких-либо дублирующих элементов.

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

returns

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

Definition Classes
SeqLike → GenSeqLike

def drop(n: Int): StringBuilder

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

n

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

returns

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

Definition Classes
IndexedSeqOptimized → IterableLike → TraversableLike → GenTraversableLike

def dropRight(n: Int): StringBuilder

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

n

Количество элементов для взятия

returns

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

Definition Classes
IndexedSeqOptimized → IterableLike

def dropWhile(p: (Char) ⇒ Boolean): StringBuilder

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

returns

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

Definition Classes
IndexedSeqOptimized → TraversableLike → GenTraversableLike

def endsWith[B](that: GenSeq[B]): Boolean

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

that

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

returns

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

Definition Classes
IndexedSeqOptimized → SeqLike → GenSeqLike

def ensureCapacity(newCapacity: Int): Unit

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

newCapacity

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

def ensuring(cond: (StringBuilder) ⇒ Boolean, msg: ⇒ Any): StringBuilder

Неявное
Этот член добавлен неявным преобразованием из StringBuilder в Ensuring[StringBuilder] выполненным методом Ensuring в scala.Predef.
Классы-определения
Ensuring

def ensuring(cond: (StringBuilder) ⇒ Boolean): StringBuilder

Неявное
Этот член добавлен неявным преобразованием из StringBuilder в Ensuring[StringBuilder] выполненным методом Ensuring в scala.Predef.
Классы-определения
Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): StringBuilder

Неявное
Этот член добавлен неявным преобразованием из StringBuilder в Ensuring[StringBuilder] выполненным методом Ensuring в scala.Predef.
Классы-определения
Ensuring

def ensuring(cond: Boolean): StringBuilder

Неявное
Этот член добавлен неявным преобразованием из StringBuilder в Ensuring[StringBuilder] выполненным методом Ensuring в scala.Predef.
Классы-определения
Ensuring

final def eq(arg0: AnyRef): Boolean

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

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

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

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

возвращает

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

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

def equals(that: Any): Boolean

Метод equals для произвольных последовательностей. Сравнивает эту последовательность с другим объектом.

that

Объект для сравнения с последовательностью

возвращает

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

Классы-определения
GenSeqLike → Equals → Any

def exists(p: (Char) ⇒ Boolean): Boolean

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

p

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

возвращает

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

Классы-определения
IndexedSeqOptimized → IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

def filter(p: (Char) ⇒ Boolean): StringBuilder

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

p

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

возвращает

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

Классы-определения
TraversableLike → GenTraversableLike

def filterNot(p: (Char) ⇒ Boolean): StringBuilder

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

p

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

возвращает

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

Классы-определения
TraversableLike → GenTraversableLike

def finalize(): Unit

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

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

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

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

def find(p: (Char) ⇒ Boolean): Option[Char]

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

p

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

returns

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

Definition Classes
IndexedSeqOptimized → IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): IndexedSeq[B]

[use case]

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

Например:

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

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

// 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 => 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

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

Definition Classes
TraversableLike → GenTraversableLike → FilterMonadic
Полная сигнатура

def flatten[B]: IndexedSeq[B]

[use case]

Преобразует этот объект StringBuilder, содержащий коллекции Traversable, в объект StringBuilder, образованный элементами этих коллекций Traversable.

Тип результирующей коллекции будет определяться статическим типом объекта StringBuilder. Например:

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

тип элементов каждой коллекции Traversable.

returns

новый объект StringBuilder, полученный путём конкатенации всех коллекций элементов.

Definition Classes
GenericTraversableTemplate
Полная сигнатура

def fold[A1 >: Char](z: A1)(op: (A1, A1) ⇒ A1): A1

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

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

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

A1

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

z

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def foldLeft[B](z: B)(op: (B, Char) ⇒ B): B

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

B

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

z

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

op

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

returns

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

op(...op(z, x_1), x_2, ..., x_n)

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

Definition Classes
IndexedSeqOptimized → TraversableOnce → GenTraversableOnce

def foldRight[B](z: B)(op: (Char, B) ⇒ B): B

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

B

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

z

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

op

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

returns

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

op(x_1, op(x_2, ... op(x_n, z)...))

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

Definition Classes
IndexedSeqOptimized → IterableLike → TraversableOnce → GenTraversableOnce

def forall(p: (Char) ⇒ Boolean): Boolean

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

p

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

returns

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

Definition Classes
IndexedSeqOptimized → IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

def foreach(f: (A) ⇒ Unit): Unit

[use case]

Применяет функцию f ко всем элементам этого буфера строк.

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

f

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

Definition Classes
IndexedSeqOptimized → IterableLike → TraversableLike → GenTraversableLike → TraversableOnce → GenTraversableOnce → FilterMonadic
Полная сигнатура

def format(args: Any*): String

Использует базовую строку в качестве шаблона (аналогично printf в C) и использует предоставленные аргументы для заполнения пробелов.

Интерпретация шаблонов форматирования описана в java.util.Formatter, с добавлением, что классы, производные от ScalaNumber (например, scala.BigInt и scala.BigDecimal) распаковываются для передачи типа, который Formatter понимает.

args

аргументы, используемые для создания шаблона.

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

def formatLocal(l: Locale, args: Any*): String

Подобно format(args*) , но принимает начальный Locale параметр, который влияет на форматирование, как в формате java.lang.String.

Интерпретация шаблонов форматирования описана в java.util.Formatter, с добавлением, что классы, производные от ScalaNumber (например, scala.BigInt и scala.BigDecimal ) распаковываются для передачи типа, который Formatter понимает.

l

экземпляр java.util.Locale

args

аргументы, используемые для создания шаблона.

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

def formatted(fmtstr: String): String

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

Неявный
Этот член добавляется неявным преобразованием из StringBuilder в StringFormat[StringBuilder] , выполненным методом StringFormat в scala.Predef.
Definition Classes
StringFormat
Аннотации
@inline()

def genericBuilder[B]: Builder[B, IndexedSeq[B]]

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

Definition Classes
GenericTraversableTemplate

final def getClass(): Class[_]

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

returns

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

Definition Classes
AnyRef → Any
Аннотации
@native()

def groupBy[K](f: (Char) ⇒ K): immutable.Map[K, StringBuilder]

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

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

K

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

f

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

returns

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

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

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

Definition Classes
TraversableLike → GenTraversableLike

def grouped(size: Int): Iterator[StringBuilder]

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

size

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

returns

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

Definition Classes
IterableLike
См. также

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

def hasDefiniteSize: Boolean

Проверяет, известен ли конечный размер этой итерации. Все строгие коллекции известны как конечного размера. Для нестрогой коллекции, такой как Stream, предикат возвращает true если все элементы были вычислены. Он возвращает false если поток еще не вычислен до конца. Непустые итераторы обычно возвращают false даже если они были созданы из коллекции с известным конечным размером.

Примечание: многие методы коллекций не будут работать с коллекциями бесконечных размеров. Типичный режим сбоя – бесконечный цикл. Эти методы всегда пытаются выполнить обход, не проверяя сначала, что hasDefiniteSize возвращает true. Однако проверка hasDefiniteSize может гарантировать, что размер определен и бесконечность не является проблемой.

returns

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

Definition Classes
TraversableLike → TraversableOnce → GenTraversableOnce

def hashCode(): Int

Хеш-коды для IndexedSeq генерируют значение из хеш-кодов всех элементов последовательности.

returns

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

Definition Classes
IndexedSeqLike → GenSeqLike → Any

def head: Char

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

returns

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

Definition Classes
IndexedSeqOptimized → IterableLike → TraversableLike → GenTraversableLike
Исключения

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

def headOption: Option[Char]

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

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def indexOf(str: String, fromIndex: Int): Int

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

str

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

fromIndex

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

returns

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

def indexOf(str: String): Int

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

str

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

returns

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

def indexOf(elem: Char, from: Int): Int

[use case]

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

elem

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

from

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

returns

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

Definition Classes
GenSeqLike
Полная сигнатура

def indexOf(elem: Char): Int

[случай использования]

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

elem

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

возвращает

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

Классы-определения
GenSeqLike
Полная сигнатура

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

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

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

that

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

from

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

возвращает

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

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

def indexOfSlice[B >: Char](that: GenSeq[B]): Int

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

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

that

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

возвращает

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

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

def indexWhere(p: (Char) ⇒ Boolean, from: Int): Int

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

p

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

from

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

возвращает

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

Классы-определения
IndexedSeqOptimized → SeqLike → GenSeqLike

def indexWhere(p: (Char) ⇒ Boolean): Int

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

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

p

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

возвращает

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

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

def indices: immutable.Range

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

возвращает

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

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

def init: StringBuilder

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

возвращает

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

Классы-определения
IndexedSeqOptimized → TraversableLike → GenTraversableLike
Исключения

UnsupportedOperationException, если последовательность пустая.

def inits: Iterator[StringBuilder]

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

возвращает

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

Классы-определения
TraversableLike
Пример:

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

def insert(index: Int, x: Char): StringBuilder

def insert(index: Int, x: Double): StringBuilder

def insert(index: Int, x: Float): StringBuilder

def insert(index: Int, x: Long): StringBuilder

def insert(index: Int, x: Int): StringBuilder

def insert(index: Int, x: Short): StringBuilder

def insert(index: Int, x: Byte): StringBuilder

def insert(index: Int, x: Boolean): StringBuilder

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

index

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

x

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

returns

это StringBuilder.

def insert(index: Int, x: String): StringBuilder

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

index

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

x

строка.

returns

это StringBuilder.

Исключения

StringIndexOutOfBoundsException, если индекс находится вне границ.

def insert(index: Int, x: Any): StringBuilder

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

index

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

x

значение.

returns

это StringBuilder.

Исключения

StringIndexOutOfBoundsException, если индекс находится вне границ.

def insertAll(index: Int, xs: Array[Char]): StringBuilder

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

index

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

xs

массив Array[Char].

returns

это StringBuilder.

Исключения

StringIndexOutOfBoundsException, если индекс находится вне границ.

def insertAll(index: Int, xs: TraversableOnce[Char]): StringBuilder

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

index

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

xs

Seq[Char].

returns

это StringBuilder.

Исключения

StringIndexOutOfBoundsException, если индекс находится вне границ.

def insertAll(index: Int, str: Array[Char], offset: Int, len: Int): StringBuilder

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

index

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

str

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

offset

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

len

количество символов из 'str' для вставки.

returns

Этот StringBuilder.

Исключения

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

def intersect(that: collection.Seq[Char]): IndexedSeq[Char]

[use case]

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

that

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

returns

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

Определяющие классы
SeqLike → GenSeqLike
Полная подпись

def isDefinedAt(idx: Int): Boolean

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

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

idx

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

returns

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

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

def isEmpty: Boolean

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

возвращает

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

Определяющие классы
IndexedSeqOptimized → SeqLike → IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

final def isInstanceOf[T0]: Boolean

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

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

возвращает

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

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

final def isTraversableAgain: Boolean

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

возвращает

true

Определяющие классы
TraversableLike → GenTraversableLike → GenTraversableOnce

def iterator: Iterator[Символ]

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

возвращает

новый итератор

Определяющие классы
IndexedSeqLike → IterableLike → GenIterableLike

def last: Символ

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

возвращает

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

Определяющие классы
IndexedSeqOptimized → TraversableLike → GenTraversableLike
Исключения

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

def lastIndexOf(str: Строка, fromIndex: Целое число): Целое число

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

str

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

fromIndex

наименьший индекс в исходной строке, который необходимо рассмотреть

возвращает

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

def lastIndexOf(str: Строка): Целое число

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

str

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

возвращает

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

def lastIndexOf(elem: Символ, end: Целое число): Целое число

[use case]

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

elem

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

end

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

возвращает

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

Определяющие классы
GenSeqLike
Полная подпись

def lastIndexOf(elem: Символ): Целое число

[use case]

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

elem

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

возвращает

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

Определяющие классы
GenSeqLike
Полная подпись

def lastIndexOfSlice[B >: Символ](that: GenSeq[B], end: Целое число): Целое число

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

that

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

end

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

возвращает

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

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

def lastIndexOfSlice[B >: Символ](that: GenSeq[B]): Целое число

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

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

that

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

returns

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

Definition Classes
SeqLike

def lastIndexWhere(p: (Char) ⇒ Boolean, end: Int): Int

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

p

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

returns

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

Definition Classes
IndexedSeqOptimized → SeqLike → GenSeqLike

def lastIndexWhere(p: (Char) ⇒ Boolean): Int

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

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

p

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

returns

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

Definition Classes
GenSeqLike

def lastOption: Option[Char]

Возвращает последний элемент (если он существует).

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def length: Int

Длина строки-строителя.

Примечание: xs.length и xs.size дают одинаковый результат.

returns

количество элементов в этом строковом буфере.

Definition Classes
StringBuilder → StringLike → CharSequence → SeqLike → GenSeqLike
Exceptions thrown

IllegalArgumentException если длина последовательности не может быть представлена в Int, например, (-1 to Int.MaxValue).length.

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 является недорогим.

Definition Classes
IndexedSeqOptimized → SeqLike

def length_=(n: Int): Unit

def lift: (Int) ⇒ Option[Char]

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

returns

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

Definition Classes
PartialFunction
См. также

Function.unlift

def lines: Iterator[String]

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

Definition Classes
StringLike

def linesIterator: Iterator[String]

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

Definition Classes
StringLike

def linesWithSeparators: Iterator[String]

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

Этот метод аналогичен s.split(EOL).toIterator, за исключением того, что все имеющиеся символы конца строки сохраняются в результатах строк, а пустая строка возвращает пустой итератор.

Символ конца строки — это один из

    LF - символ перевода строки (0x0A) FF - символ перевода страницы (0x0C)
Definition Classes
StringLike

def map[B](f: (A) ⇒ B): IndexedSeq[B]

[use case]

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

B

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

f

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike → FilterMonadic
Полная подпись

def mapResult[NewTo](f: (String) ⇒ NewTo): Builder[Char, NewTo]

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

NewTo

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

f

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

returns

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

Definition Classes
Builder
Примечание

Оригинальный билдер больше не должен использоваться после вызова mapResult.

def max: A

[use case]

Находит максимальный элемент.

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException если этот строковый билдер пуст.

def maxBy[B](f: (A) ⇒ B): A

[use case]

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

B

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

f

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException если этот строковый билдер пуст.

def min: A

[use case]

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException если этот строковый билдер пуст.

def minBy[B](f: (A) ⇒ B): A

[use case]

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

B

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

f

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись
Исключения

UnsupportedOperationException если этот строковый билдер пуст.

def mkString: String

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

returns

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

Definition Classes
StringBuilder → StringLike → TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

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

sep

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

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

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

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

start

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

sep

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

end

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

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

final def ne(arg0: AnyRef): Boolean

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

returns

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

Definition Classes
AnyRef

def newBuilder: GrowingBuilder[Char, StringBuilder]

Создает буфер StringBuilder в качестве билдера для этого класса

Attributes
protected[this]
Definition Classes
StringBuilder → StringLike → GenericTraversableTemplate → TraversableLike → HasNewBuilder

def nonEmpty: Boolean

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

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

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

A1

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

B1

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

that

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

returns

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

Definition Classes
PartialFunction

def padTo(len: Int, elem: A): IndexedSeq[A]

[use case]

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

len

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

elem

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

returns

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

Definition Classes
SeqLike → GenSeqLike
Полная подпись

def par: ParSeq[Char]

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

Для большинства типов коллекций этот метод создает новую параллельную коллекцию, копируя все элементы. Для этих коллекций метод `par` занимает линейное время. Изменяемые коллекции в этой категории не производят изменяемую параллельную коллекцию, которая имеет те же самые основополагающие данные, поэтому изменения в одной коллекции не будут отражены в другой.

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

Все параллельные коллекции возвращают ссылку на себя.

returns

параллельная реализация этой коллекции

Definition Classes
Parallelizable

def parCombiner: Combiner[Char, ParSeq[Char]]

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

returns

комбинатор для параллельной коллекции типа ParRepr

Attributes
protected[this]
Definition Classes
SeqLike → SeqLike → TraversableLike → Parallelizable

def partition(p: (Char) ⇒ Boolean): (StringBuilder, StringBuilder)

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

p

предикат для разделения.

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def patch(from: Int, that: GenSeq[A], replaced: Int): IndexedSeq[A]

[use case]

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

from

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

replaced

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

returns

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

Definition Classes
SeqLike → GenSeqLike
Полная сигнатура

def permutations: Iterator[StringBuilder]

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

returns

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

Definition Classes
SeqLike
Пример:

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

def prefixLength(p: (Char) ⇒ Boolean): Int

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

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

p

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

returns

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

Definition Classes
GenSeqLike

def product: A

[use case]

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

returns

произведение всех элементов этого строкового билдера чисел типа Int. Вместо Int, может использоваться любой другой тип T с неявной реализацией Numeric[T] в качестве типа элемента строкового билдера и как типа результата product. Примеры таких типов: Long, Float, Double, BigInt.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def r(groupNames: String*): Regex

Вы можете последовать за строкой .r(g1, ... , gn), превращая её в Regex, с именами групп g1 до gn.

"""(\d\d)-(\d\d)-(\d\d\d\d)""".r("month", "day", "year") сопоставляет даты и предоставляет их подкомпоненты через группы с именами «месяц», «день» и «год».

groupNames

Имена групп в шаблоне в порядке их появления.

Definition Classes
StringLike

def r: Regex

Вы можете последовать за строкой .r, превращая её в Regex. Например:

"""A\w*""".r — это регулярное выражение для идентификаторов, начинающихся с A.

Definition Classes
StringLike

def reduce[A1 >: Char](op: (A1, A1) ⇒ A1): A1

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

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

A1

Параметр типа для двоичной операции, надтипа A.

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Exceptions thrown

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

def reduceLeft[B >: Char](op: (B, Char) ⇒ B): B

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

B

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

op

бинарная операция.

возвращает

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

op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)

где x1, ..., xn — это элементы этой последовательности.

Definition Classes
IndexedSeqOptimized → TraversableOnce
Исключения

UnsupportedOperationException, если эта последовательность пустая.

def reduceLeftOption[B >: Char](op: (B, Char) ⇒ B): Option[B]

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

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

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

B

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

op

бинарная операция.

возвращает

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

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceOption[A1 >: Char](op: (A1, A1) ⇒ A1): Option[A1]

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

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

A1

Тип параметра для бинарной операции, надтипом A.

op

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

возвращает

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

Definition Classes
TraversableOnce → GenTraversableOnce

def reduceRight[B >: Char](op: (Char, B) ⇒ B): B

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

B

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

op

бинарная операция.

возвращает

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

op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))

где x1, ..., xn — это элементы этой последовательности.

Definition Classes
IndexedSeqOptimized → IterableLike → TraversableOnce → GenTraversableOnce
Исключения

UnsupportedOperationException, если эта последовательность пустая.

def reduceRightOption[B >: Char](op: (Char, B) ⇒ B): Option[B]

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

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

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

B

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

op

бинарная операция.

возвращает

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

start

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

end

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

str

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

возвращает

Этот StringBuilder.

Исключения

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

def replaceAllLiterally(literal: String, replacement: String): String

Замените все буквальные вхождения literal на строку replacement. Этот метод эквивалентен java.lang.String#replace.

literal

строка, которая должна быть заменена везде, где она встречается

replacement

строка-замена

returns

результирующая строка

Definition Classes
StringLike

def repr: StringBuilder

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

Definition Classes
TraversableLike → GenTraversableLike

def result(): String

Возвращает результат этого билдера (строка).

Если этот метод вызывается несколько раз, каждый вызов приведет к созданию копии буфера на тот момент времени. В частности, StringBuilder можно использовать для построения нескольких независимых строк, опустошая буфер с помощью clear после каждого вызова result.

returns

строка, собранная этим StringBuilder

Definition Classes
StringBuilder → ReusableBuilder → Builder

def reverse: StringBuilder

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

returns

перевёрнутый StringBuilder

Definition Classes
StringBuilder → IndexedSeqOptimized → SeqLike → GenSeqLike
Annotations
@migration
Migration

(Изменено в версии 2.8.0) reverse возвращает новый экземпляр. Используйте reverseContents для обновления на месте и возврата самого StringBuilder.

def reverseContents(): StringBuilder

Подобно методу reverse, но деструктивно обновляет целевой StringBuilder.

returns

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

def reverseIterator: Iterator[Char]

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

Примечание: xs.reverseIterator то же самое, что и xs.reverse.iterator, но может быть более эффективным.

returns

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

Definition Classes
IndexedSeqOptimized → SeqLike

def reverseMap[B](f: (A) ⇒ B): IndexedSeq[B]

[use case]

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

Примечание: xs.reverseMap(f) то же самое, что и xs.reverse.map(f), но может быть более эффективным.

B

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

f

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

returns

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

Definition Classes
SeqLike → GenSeqLike
Полная сигнатура

def reversed: List[Char]

Attributes
protected[this]
Definition Classes
TraversableOnce

def runWith[U](action: (Char) ⇒ 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(that: GenIterable[A]): Boolean

[use case]

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

that

коллекция для сравнения.

returns

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

Definition Classes
IndexedSeqOptimized → IterableLike → GenIterableLike
Полная сигнатура

def scan[B >: Char, That](z: B)(op: (B, B) ⇒ B)(implicit cbf: CanBuildFrom[StringBuilder, B, That]): That

Вычисляет префиксное сканирование элементов коллекции.

Примечание: Нейтральный элемент z может применяться более одного раза.

B

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

That

тип результирующей коллекции

z

нейтральный элемент для оператора op

op

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

cbf

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

returns

новая коллекция traversable, содержащая префиксное сканирование элементов в этой traversable-коллекции

Definition Classes
TraversableLike → GenTraversableLike

def scanLeft[B, That](z: B)(op: (B, Char) ⇒ B)(implicit bf: CanBuildFrom[StringBuilder, B, That]): That

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

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

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

B

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

That

фактический тип результирующей коллекции

z

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

op

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

bf

неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.

returns

коллекция с промежуточными результатами

Definition Classes
TraversableLike → GenTraversableLike

def scanRight[B, That](z: B)(op: (Char, B) ⇒ B)(implicit bf: CanBuildFrom[StringBuilder, B, That]): That

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

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

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

Пример:

List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
B

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

That

фактический тип результирующей коллекции

z

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

op

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

bf

неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.

returns

коллекция с промежуточными результатами

Definition Classes
TraversableLike → GenTraversableLike
Annotations
@migration
Migration

(Изменено в версии 2.9.0) Поведение scanRight изменилось. Предыдущее поведение можно воспроизвести с помощью scanRight.reverse.

def segmentLength(p: (Char) ⇒ Boolean, from: Int): Int

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

p

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

from

индекс, с которого начинается поиск.

returns

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

Definition Classes
IndexedSeqOptimized → SeqLike → GenSeqLike

def seq: IndexedSeq[Char]

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

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

returns

последовательный вид коллекции.

Definition Classes
IndexedSeq → IndexedSeq → IndexedSeqLike → Seq → Seq → GenSeq → GenSeqLike → Iterable → Iterable → GenIterable → Traversable → Traversable → GenTraversable → Parallelizable → TraversableOnce → GenTraversableOnce

def setCharAt(index: Int, ch: Char): Unit

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

index

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

ch

новый символ Char.

Исключения

IndexOutOfBoundsException, если индекс находится вне границ.

def setLength(len: Int): Unit

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

len

новая длина

Исключения

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

def size: Int

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

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

returns

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

Definition Classes
SeqLike → GenTraversableLike → TraversableOnce → GenTraversableOnce

def sizeHint(coll: TraversableLike[_, _], delta: Int): Unit

Подсказка о том, что ожидается, что result этого билдера будет иметь такой же размер, как и заданная коллекция, плюс некоторый дельта. Эта подсказка будет дана только в том случае, если для коллекции известно, что метод size является дешёвым. В настоящее время это предполагается только если и только если коллекция типа IndexedSeqLike. Некоторые классы билдеров оптимизируют своё представление на основе подсказки. Тем не менее, реализации билдеров всё ещё должны работать правильно, даже если подсказка неверна, т.е. добавляется другое количество элементов.

coll

коллекция, которая служит подсказкой для размера результата.

delta

поправка, которая добавляется к coll.size для создания подсказки размера.

Definition Classes
Builder

def sizeHint(coll: TraversableLike[_, _]): Unit

Подсказка о том, что ожидается, что result этого билдера будет иметь такой же размер, как и заданная коллекция, плюс некоторый дельта. Эта подсказка будет дана только в том случае, если для коллекции известно, что метод size является дешёвым, что определяется вызовом sizeHint.

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

coll

коллекция, которая служит подсказкой для размера результата.

Definition Classes
Builder

def sizeHint(size: Int): Unit

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

size

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

Definition Classes
Builder

def sizeHintBounded(size: Int, boundingColl: TraversableLike[_, _]): Unit

Подсказка о том, сколько элементов ожидается добавить при вызове следующего result вместе с верхним пределом, заданным размером какой-либо другой коллекции. Некоторые классы билдеров оптимизируют своё представление на основе подсказки. Тем не менее, реализации билдеров всё ещё должны работать правильно, даже если подсказка неверна, т.е. добавляется другое количество элементов.

size

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

boundingColl

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

Definition Classes
Builder

def sizeHintIfCheap: Int

Размер этой последовательности, если его можно вычислить без особых затрат.

returns

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

Attributes
protected[collection]
Definition Classes
IndexedSeqLike → GenTraversableOnce

def slice(from: Int, until: Int): StringBuilder

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

from <= indexOf(x) < until
returns

строка, содержащая элементы, большие или равные индексу from, и заканчивающаяся (но не включая) индекс until этой строки.

Definition Classes
StringLike → IndexedSeqOptimized → IterableLike → TraversableLike → GenTraversableLike

def sliding(size: Int, step: Int): Iterator[StringBuilder]

Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» по ним (в отличие от разделения их, как это делается в grouped.)

size

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

step

расстояние между первыми элементами последовательных групп

returns

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

Definition Classes
IterableLike
See also

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

def sliding(size: Int): Iterator[StringBuilder]

Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» по ним (в отличие от разделения их, как это делается в grouped.) Шаг «скользящего окна» установлен в единицу.

size

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

returns

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

Definition Classes
IterableLike
See also

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

def sortBy[B](f: (Char) ⇒ B)(implicit ord: math.Ordering[B]): StringBuilder

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

B

целевой тип преобразования f, и тип, где определено упорядочивание ord.

f

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

ord

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

returns

последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с упорядочиванием, где x < y если ord.lt(f(x), f(y)).

Definition Classes
SeqLike
Пример:
    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)
See also

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

def sortWith(lt: (Char, Char) ⇒ Boolean): StringBuilder

Сортирует эту последовательность согласно функции сравнения.

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

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

lt

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

returns

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

Definition Classes
SeqLike
Пример:
    List("Steve", "Tom", "John", "Bob").sortWith(_.compareTo(_) < 0) =
    List("Bob", "John", "Steve", "Tom")

def sorted[B >: Char](implicit ord: math.Ordering[B]): StringBuilder

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

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

ord

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

returns

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

Definition Classes
SeqLike
See also

scala.math.Ordering

def span(p: (Char) ⇒ Boolean): (StringBuilder, StringBuilder)

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

Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не приводит к побочным эффектам.

returns

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

Definition Classes
IndexedSeqOptimized → TraversableLike → GenTraversableLike

def split(separators: Array[Char]): Array[String]

Definition Classes
StringLike
Annotations
@throws( clazz = ... )

def split(separator: Char): Array[String]

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

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

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

Поведение следует и реализуется с помощью String.split(re: String)

separator

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

Definition Classes
StringLike
Пример:
    "a.b".split('.') //returns Array("a", "b")
    
    //splitting the empty string always returns the array with a single
    //empty string
    "".split('.') //returns Array("")
    
    //only trailing empty substrings are removed
    "a.".split('.') //returns Array("a")
    ".a.".split('.') //returns Array("", "a")
    "..a..".split('.') //returns Array("", "", "a")
    
    //all parts are empty and trailing
    ".".split('.') //returns Array()
    "..".split('.') //returns Array()
    
    //surrogate pairs
    val high = 0xD852.toChar
    val low = 0xDF62.toChar
    val highstring = high.toString
    val lowstring = low.toString
    
    //well-formed surrogate pairs are not split
    val highlow = highstring + lowstring
    highlow.split(high) //returns Array(highlow)
    
    //bare surrogate characters are split
    val bare = "_" + highstring + "_"
    bare.split(high) //returns Array("_", "_")

def splitAt(n: Int): (StringBuilder, StringBuilder)

Разделяет эту последовательность на две части в заданной позиции. Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).

n

позиция разделения.

returns

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

Definition Classes
IndexedSeqOptimized → TraversableLike → GenTraversableLike

def startsWith[B](that: GenSeq[B], offset: Int): Boolean

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

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

that

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

offset

индекс, где ищется последовательность.

returns

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

Definition Classes
IndexedSeqOptimized → SeqLike → GenSeqLike

def startsWith[B](that: GenSeq[B]): Boolean

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

that

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

returns

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

Definition Classes
GenSeqLike

def stringPrefix: String

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def stripLineEnd: String

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

Символ окончания строки — один из

    LF - перевод строки (0x0A шестнадцатеричный) FF - подача страницы (0x0C шестнадцатеричный)

Если символ перевода строки LF предшествует символу возврата каретки CR (0x0D шестнадцатеричный), символ CR также удаляется (конвенция Windows).

Definition Classes
StringLike

def stripMargin: String

Для каждой строки в этой строке:

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

Definition Classes
StringLike

def stripMargin(marginChar: Char): String

Для каждой строки в этой строке:

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

Definition Classes
StringLike

def stripPrefix(prefix: String): String

Возвращает эту строку со строкой prefix, удаленной. Если эта строка не начинается с prefix, она возвращается без изменений.

Definition Classes
StringLike

def stripSuffix(suffix: String): String

Возвращает эту строку с удалённым указанным suffix. Если эта строка не заканчивается на suffix, она возвращается без изменений.

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

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

Для реализации CharSequence.

Определяющие классы
StringBuilder → CharSequence

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

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

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

start

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

end

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

возвращает

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

Исключения

StringIndexOutOfBoundsException Если любой из индексов находится вне границ, или если start > end.

def substring(start: Int): String

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

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

start

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

возвращает

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

Исключения

IndexOutOfBoundsException если индекс находится вне границ.

def sum: A

[use case]

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

возвращает

сумма всех элементов в этом строковом буфере чисел типа Int. Вместо Int, любой другой тип T с неявным Numeric[T] реализацией может быть использован в качестве типа элементов строкового буфера и в качестве типа результата sum. Примерами таких типов являются: Long, Float, Double, BigInt.

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура

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

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

def tail: StringBuilder

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

возвращает

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

Определяющие классы
IndexedSeqOptimized → TraversableLike → GenTraversableLike
Исключения

java.lang.UnsupportedOperationException если последовательность пустая.

def tails: Iterator[StringBuilder]

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

возвращает

итератор по всем хвостам этой коллекции

Определяющие классы
TraversableLike
Пример:

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

def take(n: Int): StringBuilder

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

n

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

возвращает

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

Определяющие классы
IndexedSeqOptimized → IterableLike → TraversableLike → GenTraversableLike

def takeRight(n: Int): StringBuilder

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

n

количество элементов для выбора

возвращает

последовательность, содержащую только последние n элементов этой последовательности, или всю последовательность, если она содержит меньше n элементов.

Определяющие классы
IndexedSeqOptimized → IterableLike

def takeWhile(p: (Char) ⇒ Boolean): StringBuilder

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

возвращает

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

Определяющие классы
IndexedSeqOptimized → IterableLike → TraversableLike → GenTraversableLike

def thisCollection: StringBuilder

Базовое хранилище, рассматриваемое как экземпляр mutable.IndexedSeq. По умолчанию это реализуется как сам текущий объект коллекции, но это можно переопределить.

Attributes
protected[this]
Definition Classes
StringBuilder → IndexedSeqLike → IndexedSeqLike → SeqLike → IterableLike → TraversableLike

def to[Col[_]]: Col[A]

[use case]

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

Col

Тип коллекции, подлежащий построению.

returns

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

Definition Classes
TraversableLike → TraversableOnce → GenTraversableOnce
Полная сигнатура

def toArray: Array[Char]

def toArray: Array[A]

[use case]

Преобразует этот буфер строк в массив.

returns

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

Definition Classes
StringLike → TraversableOnce → GenTraversableOnce
Полная сигнатура

def toBoolean: Boolean

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

java.lang.IllegalArgumentException Если строка не содержит разбираемого Boolean.

def toBuffer[A1 >: Char]: Buffer[A1]

Использует содержимое этой последовательности для создания нового изменяемого буфера.

returns

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

Definition Classes
IndexedSeqLike → TraversableOnce → GenTraversableOnce

def toByte: Byte

Разбирается как Byte (строка должна содержать только десятичные цифры и необязательное ведущее -).

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

java.lang.NumberFormatException Если строка не содержит разбираемого Byte.

def toCollection(repr: StringBuilder): StringBuilder

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

Attributes
protected[this]
Definition Classes
StringBuilder → IndexedSeqLike → SeqLike → IterableLike → TraversableLike

def toCollection(repr: IndexedSeq[Char]): IndexedSeq[Char]

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

Attributes
protected[this]
Definition Classes
IndexedSeqLike → IndexedSeqLike → SeqLike → IterableLike → TraversableLike

def toDouble: Double

Разбирается как Double (окружающие пробелы удаляются с помощью trim).

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

java.lang.NullPointerException Если строка null.

java.lang.NumberFormatException Если строка не содержит разбираемого Double.

def toFloat: Float

Разбирается как Float (окружающие пробелы удаляются с помощью trim).

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

java.lang.NullPointerException Если строка null.

java.lang.NumberFormatException Если строка не содержит разбираемого Float.

def toIndexedSeq: immutable.IndexedSeq[Символ]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toInt: Int

Парсинг в целое число Int (строка должна содержать только десятичные цифры и необязательный ведущий -).

Definition Classes
StringLike
Exceptions thrown

java.lang.NumberFormatException Если строка не содержит Int.

def toIterable: collection.Iterable[Символ]

Возвращает это итерируемое множество как итерируемое множество.

Новая коллекция не будет построена; ленивые коллекции останутся ленивыми.

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

returns

итерируемое множество, содержащее все элементы этого итерируемого множества.

Definition Classes
IterableLike → TraversableOnce → GenTraversableOnce

def toIterator: Iterator[Символ]

Возвращает итератор по элементам в этом итерируемом множестве. Производит тот же результат, что и iterator.

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableOnce
Annotations
@deprecatedOverriding( message = ... , since = "2.11.0" )

def toList: List[Символ]

Преобразует эту последовательность в список.

returns

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

Definition Classes
IndexedSeqOptimized → TraversableOnce → GenTraversableOnce

def toLong: Long

Парсинг в длинное целое число Long (строка должна содержать только десятичные цифры и необязательный ведущий -).

Definition Classes
StringLike
Exceptions thrown

java.lang.NumberFormatException Если строка не содержит Long.

def toMap[T, U]: collection.Map[T, U]

[use case]

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

returns

карта типа immutable.Map[T, U], содержащая все пары ключ/значение типа (T, U) этого строкового буфера.

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toParArray: ParArray[T]

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в CollectionsHaveToParArray[StringBuilder, T] реализованный методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдет только в том случае, если в области видимости есть неявное значение типа (StringBuilder) ⇒ GenTraversableOnce[T].
Definition Classes
CollectionsHaveToParArray

def toSeq: collection.Seq[Символ]

Преобразует эту последовательность в последовательность.

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

Новая коллекция не будет построена; в частности, ленивые последовательности останутся ленивыми.

returns

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

Definition Classes
SeqLike → GenSeqLike → TraversableOnce → GenTraversableOnce

def toSet[B >: Символ]: immutable.Set[B]

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

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce

def toShort: Short

Парсинг как Short (строка должна содержать только десятичные цифры и необязательный ведущий -).

Определяющие классы
StringLike
Исключения

java.lang.NumberFormatException Если строка не содержит разбираемого Short.

def toStream: immutable.Stream[Char]

Преобразует эту итерируемую коллекцию в поток.

возвращает

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

Определяющие классы
IterableLike → TraversableLike → GenTraversableOnce

def toString(): String

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

возвращает

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

Определяющие классы
StringBuilder → CharSequence → SeqLike → Function1 → TraversableLike → AnyRef → Any
Примечание

поскольку toString унаследован от AnyRef и используется для многих целей, лучше использовать метод mkString для получения результата StringBuilder.

def toTraversable: collection.Traversable[Char]

Преобразует эту итерируемую коллекцию в неспецифическое Traversable. Вернёт ту же коллекцию, если текущий экземпляр уже Traversable.

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

возвращает

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

Определяющие классы
TraversableLike → TraversableOnce → GenTraversableOnce
Аннотации
@deprecatedOverriding( message = ... , since = "2.11.0" )

def toVector: Vector[Char]

Преобразует этот итерируемый объект или итератор в Vector.

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce

def transform(f: (Char) ⇒ Char): StringBuilder.this.type

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

f

преобразование для применения

возвращает

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

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

def transpose[B](implicit asTraversable: (Char) ⇒ GenTraversableOnce[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

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

asTraversable

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

возвращает

двумерная коллекция коллекций, в которой n-я строка соответствует n-му столбцу этой коллекции.

Определяющие классы
GenericTraversableTemplate
Аннотации
@migration
Миграция

(Изменено в версии 2.9.0) transpose выбрасывает IllegalArgumentException если коллекции не имеют одинаковый размер.

Исключения

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

def union(that: collection.Seq[Char]): IndexedSeq[Char]

[пример использования]

Создаёт новую последовательность, которая содержит все элементы этого string builder и все элементы заданной последовательности. xs union ys эквивалентно xs ++ ys.

Другой способ выразить это, xs union ys вычисляет порядок сохранения объединения множества xs и ys. union является поэтому аналогом diff и intersect , которые также работают с множествами.

that

последовательность для добавления.

возвращает

новый string builder, который содержит все элементы этого string builder, за которыми следуют все элементы that.

Определяющие классы
SeqLike → GenSeqLike
Полная сигнатура

def unzip[A1, A2](implicit asPair: (Char) ⇒ (A1, A2)): (IndexedSeq[A1], IndexedSeq[A2])

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

val xs = Traversable(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (Traversable(1, 2, 3),
//        Traversable(one, two, three))
A1

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

A2

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

asPair

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

returns

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

Definition Classes
GenericTraversableTemplate

def unzip3[A1, A2, A3](implicit asTriple: (Char) ⇒ (A1, A2, A3)): (IndexedSeq[A1], IndexedSeq[A2], IndexedSeq[A3])

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

val xs = Traversable(
           (1, "one", '1'),
           (2, "two", '2'),
           (3, "three", '3')).unzip3
// xs == (Traversable(1, 2, 3),
//        Traversable(one, two, three),
//        Traversable(1, 2, 3))
A1

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

A2

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

A3

тип третьего члена троек элементов

asTriple

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

returns

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

Definition Classes
GenericTraversableTemplate

def update(i: Int, c: Char): Unit

Эквивалентно setCharAt.

Definition Classes
StringBuilder → IndexedSeqLike → SeqLike

def updated(index: Int, elem: A): IndexedSeq[A]

[use case]

Копия этого буфера строк с одним заменённым элементом.

index

позиция замены

elem

элемент замены

returns

копию этого буфера строк с элементом в позиции index заменённым на elem.

Definition Classes
SeqLike → GenSeqLike
Полная сигнатура

def view(from: Int, until: Int): IndexedSeqView[Char, IndexedSeq[Char]]

Представление подпоследовательности, начинающейся с индекса from и продолжающейся до (но не включая) индекса until.

from

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

until

Индекс элемента, следующего за срезом

returns

нестрогое представление среза этого изменяемого индексированного последовательности, начинающегося с индекса from и продолжающегося до (но не включая) индекса until. Примечание Разница между view и slice заключается в том, что view создаёт представление текущей последовательности, а slice создаёт новую последовательность.

Definition Classes
IndexedSeqLike → SeqLike → IterableLike → TraversableLike
Примечание

view(from, to) эквивалентно view.slice(from, to)

def view: IndexedSeqView[Char, IndexedSeq[Char]]

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

returns

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

Definition Classes
IndexedSeqLike → SeqLike → IterableLike → TraversableLike

final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )

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

Definition Classes
AnyRef
Annotations
@throws( ... )

final def wait(arg0: Long): Unit

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

def withFilter(p: (Char) ⇒ Boolean): FilterMonadic[Char, StringBuilder]

Создаёт нестрогий фильтр этого коллекции-объекта.

Примечание: разница между c filter p и c withFilter p заключается в том, что первый создаёт новую коллекцию, а второй только ограничивает область действия последующих map, flatMap, foreach, и withFilter операций.

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

p

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

returns

объект класса WithFilter, который поддерживает map, flatMap, foreach, и withFilter операции. Все эти операции применяются к тем элементам этого коллекции-объекта, которые удовлетворяют предикату p.

Definition Classes
TraversableLike → FilterMonadic

def zip[B](that: GenIterable[B]): IndexedSeq[(A, B)]

[use case]

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

B

тип второй половины возвращаемых пар

that

коллекция-объект, предоставляющая вторую половину каждой пары результата

returns

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

Definition Classes
IndexedSeqOptimized → IterableLike → GenIterableLike
Полная подпись

def zipAll[B](that: collection.Iterable[B], thisElem: A, thatElem: B): IndexedSeq[(A, B)]

[use case]

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

B

тип второй половины возвращаемых пар

that

коллекция-объект, предоставляющая вторую половину каждой пары результата

thisElem

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

thatElem

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

returns

новый строковый буфер, содержащий пары, состоящие из соответствующих элементов этого строкового буфера и that. Длина возвращаемой коллекции — максимальное значение из длин этого строкового буфера и that. Если этот строковый буфер короче that, значения thisElem используются для дополнения результата. Если that короче этого строкового буфера, значения thatElem используются для дополнения результата.

Definition Classes
IterableLike → GenIterableLike
Полная подпись

def zipWithIndex: IndexedSeq[(A, Int)]

[use case]

Объединяет этот строковый буфер с его индексами.

returns

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

Definition Classes
IndexedSeqOptimized → IterableLike → GenIterableLike
Полная подпись
Пример:

    List("a", "b", "c").zipWithIndex = List(("a", 0), ("b", 1), ("c", 2))

def →[B](y: B): (StringBuilder, B)

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в ArrowAssoc[StringBuilder] выполненное методом ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc

Затенённые неявные члены-значения

def +(other: String): String

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в any2stringadd[StringBuilder] с помощью метода any2stringadd в scala.Predef.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: any2stringadd[StringBuilder]).+(other)
Классы-определения
any2stringadd

def charAt(index: Int): Char

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в SeqCharSequence с помощью метода SeqCharSequence в scala.Predef.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: SeqCharSequence).charAt(index)
Классы-определения
SeqCharSequence → CharSequence

def chars(): IntStream

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в SeqCharSequence с помощью метода SeqCharSequence в scala.Predef.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: SeqCharSequence).chars()
Классы-определения
CharSequence

def codePoints(): IntStream

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в SeqCharSequence с помощью метода SeqCharSequence в scala.Predef.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: SeqCharSequence).codePoints()
Классы-определения
CharSequence

def filter(p: (Char) ⇒ Boolean): TraversableOnce[Char]

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в MonadOps[Char] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: MonadOps[Char]).filter(p)
Классы-определения
MonadOps

def flatMap[B](f: (Char) ⇒ GenTraversableOnce[B]): TraversableOnce[B]

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в MonadOps[Char] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: MonadOps[Char]).flatMap(f)
Классы-определения
MonadOps

def length(): Int

Неявный
Этот член добавлен неявным преобразованием из StringBuilder в SeqCharSequence с помощью метода SeqCharSequence в scala.Predef.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: SeqCharSequence).length()
Классы-определения
SeqCharSequence → CharSequence

def map[B](f: (Char) ⇒ B): TraversableOnce[B]

Неявное
Этот член добавлен с помощью неявного преобразования из StringBuilder в MonadOps[Символ] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: MonadOps[Char]).map(f)
Классы определения
MonadOps

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

Неявное
Этот член добавлен с помощью неявного преобразования из StringBuilder в SeqCharSequence с помощью метода SeqCharSequence в scala.Predef.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: SeqCharSequence).subSequence(start, end)
Классы определения
SeqCharSequence → CharSequence

def toString(): String

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

возвращает

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

Неявное
Этот член добавлен с помощью неявного преобразования из StringBuilder в SeqCharSequence с помощью метода SeqCharSequence в scala.Predef.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: SeqCharSequence).toString()
Классы определения
SeqCharSequence → CharSequence → AnyRef → Any

def withFilter(p: (Символ) ⇒ Boolean): Iterator[Символ]

Неявное
Этот член добавлен с помощью неявного преобразования из StringBuilder в MonadOps[Символ] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затенение
Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(stringBuilder: MonadOps[Char]).withFilter(p)
Классы определения
MonadOps

© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.12.9/scala/collection/mutable/StringBuilder.html

Spec-Zone.ru

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