Класс scala.collection.mutable.StringBuilder
Компаньон объект StringBuilder
final класс StringBuilder extends AbstractSeq[Char] with ReusableBuilder[Char, String] with IndexedSeq[Char] with IndexedSeqOps[Char, IndexedSeq, StringBuilder] with IterableFactoryDefaults[Char, IndexedSeq] with CharSequence with Serializable
Конструкторы экземпляров
new StringBuilder(initCapacity: Int, initValue: String)
new StringBuilder(str: String)
new StringBuilder(capacity: Int)
Создаёт строковый буфер без символов и заданной начальной ёмкостью, определяемой аргументом capacity.
- capacity
начальная ёмкость.
- Исключения
NegativeArraySizeException, если capacity < 0.
new StringBuilder()
new StringBuilder(underlying: java.lang.StringBuilder)
Члены значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), false в противном случае.
- Определяющие классы
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел возвращает хэш-значение, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## будет создавать одно и то же хэш-значение для каждого из них. Для null возвращает хэш-код, где null.hashCode вызывает NullPointerException.
- returns
хэш-значение, согласованное с ==
- Определяющие классы
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавляется неявным преобразованием из StringBuilder в any2stringadd[StringBuilder] с помощью метода any2stringadd в scala.Predef.
- Определяющие классы
- any2stringadd
final def ++[B >: Char](suffix: IterableOnce[B]): IndexedSeq[B]
Псевдоним для concat
- Определяющие классы
- IterableOps
- Аннотации
- @inline()
final def ++:[B >: Char](prefix: IterableOnce[B]): IndexedSeq[B]
Псевдоним для prependedAll
- Определяющие классы
- SeqOps → IterableOps
- Аннотации
- @inline()
def ++=(s: String): StringBuilder.this.type
final def ++=(xs: IterableOnce[Char]): StringBuilder.this.type
final def +:[B >: Char](elem: B): IndexedSeq[B]
Псевдоним для prepended.
Обратите внимание, что операторы, заканчивающиеся на :- , являются правоассоциативными (см. пример). Мнемоническое правило для +: против :+: двоеточие идет на стороне коллекции.
final def +=(elem: Char): StringBuilder.this.type
def ->[B](y: B): (StringBuilder, B)
- Неявный
- Этот член добавляется неявным преобразованием из StringBuilder в ArrowAssoc[StringBuilder] с помощью метода ArrowAssoc в scala.Predef.
- Определяющие классы
- ArrowAssoc
- Аннотации
- @inline()
final def :+[B >: Char](elem: B): IndexedSeq[B]
Псевдоним для appended
Обратите внимание, что операторы, заканчивающиеся на :, являются правоассоциативными (см. пример). Мнемоническое правило для +: против :+: двоеточие ставится со стороны коллекции.
final def :++[B >: Char](suffix: IterableOnce[B]): IndexedSeq[B]
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- возвращает
true, если принимаемый объект эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
def addAll(s: String): StringBuilder.this.type
def addAll(xs: IterableOnce[Char]): StringBuilder.this.type
Добавляет все элементы, созданные IterableOnce, в эту расширяемую коллекцию.
- xs
IterableOnce, генерирующий элементы для добавления.
- возвращает
сама расширяемая коллекция.
- Определяющие классы
- Growable
def addOne(x: Char): StringBuilder.this.type
Добавляет один элемент в этот строитель строк.
- возвращает
сам строитель строк
- Определяющие классы
- StringBuilder → Growable
final def addString(b: StringBuilder): StringBuilder
Добавляет все элементы этой коллекции в строитель строк. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этой коллекции без каких-либо разделительных строк.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> val h = a.addString(b) h: StringBuilder = 1234
- b
строитель строк, к которому добавляются элементы.
- возвращает
строитель строк
b, к которому были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
final def addString(b: StringBuilder, sep: String): StringBuilder
Добавляет все элементы этой коллекции в строитель строк, используя разделительную строку. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этой коллекции, разделенных строкой sep.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> a.addString(b, ", ") res0: StringBuilder = 1, 2, 3, 4
- b
строитель строк, к которому добавляются элементы.
- sep
разделительная строка.
- возвращает
строитель строк
b, к которому были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
def addString(b: StringBuilder, start: String, sep: String, end: String): StringBuilder
Добавляет все элементы этой коллекции в строитель строк, используя начальную, конечную и разделительные строки. Записанный текст начинается со строки start и заканчивается строкой end. Внутри, строковые представления (относительно метода toString) всех элементов этой коллекции разделены строкой sep.
Пример:
scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)
scala> val b = new StringBuilder()
b: StringBuilder =
scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
- b
строитель строк, к которому добавляются элементы.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- возвращает
строитель строк
b, к которому были добавлены элементы.
- Определяющие классы
- IterableOnceOps
def andThen[C](k: PartialFunction[Char, C]): PartialFunction[Int, C]
Комбинирует эту частичную функцию с другой частичной функцией, которая применяется к результатам этой частичной функции.
Обратите внимание, что вызов isDefinedAt для результирующей частичной функции может применить первую частичную функцию и выполнить её побочный эффект. Настоятельно рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, суженной другой частичной функцией, которая отображает аргументы
xнаk(this(x)).
- Определяющие классы
- PartialFunction
def andThen[C](k: (Char) => C): PartialFunction[Int, C]
Комбинирует эту частичную функцию с функцией преобразования, которая применяется к результатам этой частичной функции.
Если тип функции во время выполнения является PartialFunction, то используется другой метод andThen (обратите внимание на его предостережения).
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, возможно, суженной указанной функцией, которая отображает аргументы
xнаk(this(x)).
- Определяющие классы
- 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(s: StringBuilder): StringBuilder
def append(cs: CharSequence): StringBuilder
Добавляет данную CharSequence к этой последовательности.
- cs
CharSequence.
- returns
этот 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
массив, содержащий символы Char, которые нужно добавить.
- offset
индекс первого символа Char для добавления.
- len
количество символов Char для добавления.
- returns
этот StringBuilder.
def appendAll(xs: Array[Char]): StringBuilder
Добавляет все символы Char из заданного массива Array[Char] в эту последовательность.
- xs
символы, которые нужно добавить.
- returns
ссылка на этот объект.
def appendAll(xs: IterableOnce[Char]): StringBuilder
Добавляет все символы Char из заданного IterableOnce[Char] в эту последовательность.
- xs
символы, которые нужно добавить.
- returns
этот StringBuilder.
def appendAll(xs: String): StringBuilder
def appended[B >: Char](elem: B): IndexedSeq[B]
Копия этой последовательности с добавленным элементом.
Примечание: не завершается для последовательностей бесконечного размера.
Пример:
scala> val a = List(1) a: List[Int] = List(1) scala> val b = a :+ 2 b: List[Int] = List(1, 2) scala> println(a) List(1)
- B
тип элемента возвращаемой последовательности.
- elem
добавляемый элемент
- returns
новая последовательность, состоящая из всех элементов этой последовательности, за которыми следует
value.
- Definition Classes
- SeqOps
def appendedAll[B >: Char](suffix: IterableOnce[B]): IndexedSeq[B]
Возвращает новую последовательность, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента последовательности — наиболее общий суперкласс, охватывающий типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
повторяемая последовательность для добавления.
- returns
новая коллекция типа
CC[B], которая содержит все элементы этой последовательности, за которыми следуют все элементыsuffix.
- Definition Classes
- SeqOps
def apply(i: Int): Char
Получение элемента по указанному индексу. Эта операция предоставляется для удобства в Seq. Не следует полагать, что она эффективна, если у вас нет IndexedSeq.
- Definition Classes
- StringBuilder → SeqOps → 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]] не вызовет его. В последнем примере, так как аргумент типа стирается во время компиляции, невозможно проверить, относятся ли элементы списка к запрошенному типу.
- возвращает
объект-получатель.
- Определяющие классы
- Any
- Исключения
ClassCastException, если объект-получатель не является экземпляром стирания типаT0.
def canEqual(that: Any): Boolean
Метод, вызываемый методами равенства, чтобы пользовательские подклассы могли отказать в равенстве с другими коллекциями того же типа.
- that
Объект, с которым должна быть сравнена эта последовательность
- возвращает
true, если эта последовательность может быть равнаthat,falseв противном случае. Тест учитывает только типы объектов во время выполнения, но игнорирует их элементы.
def capacity: Int
Возвращает текущую вместимость, которая является размером базового массива. Новый массив будет выделен, если текущая вместимость будет превышена.
- возвращает
емкость
def charAt(index: Int): Char
Возвращает Char по указанному индексу, считая с 0, как в массивах.
- index
индекс для поиска
- возвращает
Char по заданному индексу.
- Определяющие классы
- StringBuilder → CharSequence
- Исключения
IndexOutOfBoundsException, если индекс находится за пределами границ.
def chars(): IntStream
- Определяющие классы
- CharSequence
def className: String
Определяет префикс представления этого объекта в toString.
Рекомендуется возвращать имя конкретного типа коллекции, а не подклассы реализации. Например, для ListMap этот метод должен возвращать "ListMap", а не "Map" (супертип) или "Node" (подкласс реализации).
По умолчанию реализация возвращает "Iterable". Она переопределяется для основных типов коллекций "Seq", "IndexedSeq", "LinearSeq", "Buffer", "Set", "Map", "SortedSet", "SortedMap" и "View".
- возвращает
строковое представление, которое начинается с результата
toString, примененного к этой итерируемой коллекции. По умолчанию префикс строки — простое имя класса коллекции — итерируемой коллекции.
- Атрибуты
- protected[this]
- Определяющие классы
- Iterable
def clear(): Unit
Очищает содержимое этого билдера. После выполнения этого метода билдер не будет содержать элементов.
Если выполняется сразу после вызова result(), это позволяет создать новый экземпляр того же типа коллекции.
- Определяющие классы
- StringBuilder → ReusableBuilder → Builder → Clearable
def clone(): StringBuilder
Создает копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- возвращает
копию объекта-получателя.
def codePoints(): IntStream
- Определяющие классы
- CharSequence
final def coll: StringBuilder.this.type
- возвращает
Эта коллекция как
C.
- Атрибуты
- protected
- Определяющие классы
- Iterable → IterableOps
def collect[B](pf: PartialFunction[Char, B]): IndexedSeq[B]
Создает новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, для которых функция определена.
- B
тип элемента возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- returns
новая итерируемая коллекция, полученная в результате применения данной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def collectFirst[B](pf: PartialFunction[Char, B]): Option[B]
Находит первый элемент коллекции, для которого определена данная частичная функция, и применяет к нему частичную функцию.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- pf
частичная функция
- returns
опциональное значение, содержащее pf, примененное к первому значению, для которого оно определено, или
None, если такового не существует.
- Определяющие классы
- IterableOnceOps
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-элементным комбинациям этой последовательности.
- Определяющие классы
- SeqOps
"abbbc".combinations(2) = Iterator(ab, ac, bb, bc)
def compose[R](k: PartialFunction[R, Int]): PartialFunction[R, Char]
Компонует другую частичную функцию k с этой частичной функцией так, что эта частичная функция применяется к результатам k.
Обратите внимание, что вызов isDefinedAt для результирующей частичной функции может применить первую частичную функцию и выполнить ее побочный эффект. Настоятельно рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- R
тип параметра функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения другой частичной функции, суженной этой частичной функцией, которая отображает аргументы
xнаthis(k(x)).
- Определяющие классы
- PartialFunction
def compose[A](g: (A) => Int): (A) => Char
Компонует два экземпляра Function1 в новый Function1, при этом эта функция применяется последней.
- A
тип, к которому может быть применена функция
g- g
функция A => T1
- returns
новая функция
fтакая, чтоf(x) == apply(g(x))
- Определяющие классы
- Function1
- Аннотации
- @unspecialized()
final def concat[B >: Char](suffix: IterableOnce[B]): IndexedSeq[B]
Возвращает новую последовательность, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента последовательности — наиболее специфический суперкласс, охватывающий типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
добавляемая траверсабельная структура.
- returns
новая последовательность, которая содержит все элементы этой последовательности, за которыми следуют все элементы
suffix.
- Определяющие классы
- SeqOps → IterableOps
- Аннотации
- @inline()
def contains[A1 >: Char](elem: A1): Boolean
Проверяет, содержит ли эта последовательность заданное значение в качестве элемента.
Примечание: может не завершиться для коллекций бесконечного размера.
- elem
элемент для проверки.
- returns
true, если эта последовательность имеет элемент, равный (как определено==)elem,falseв противном случае.
- Определяющие классы
- SeqOps
def containsSlice[B](that: collection.Seq[B]): Boolean
Проверяет, содержит ли эта последовательность заданную последовательность в качестве среза.
Примечание: может не завершиться для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
true, если эта последовательность содержит срез с теми же элементами, что иthat, иначеfalse.
- Определяющие классы
- SeqOps
def copyToArray[B >: Char](xs: Array[B], start: Int, len: Int): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs, начиная с индекса start, не более чем len элементами этой коллекции.
Копирование остановится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива, или будет скопировано len элементов.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- len
максимальное количество элементов для копирования.
- returns
количество элементов, записанных в массив
- Определяющие классы
- IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван. Его использование не определено и может измениться. Примечание: не будет завершаться для коллекций бесконечного размера.
def copyToArray[B >: Char](xs: Array[B], start: Int): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs, начиная с индекса start, значениями этой коллекции.
Копирование остановится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- returns
количество элементов, записанных в массив Примечание: не будет завершаться для коллекций бесконечного размера.
- Определяющие классы
- IterableOnceOps
def copyToArray[B >: Char](xs: Array[B]): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs, начиная с индекса start, значениями этой коллекции.
Копирование остановится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- returns
количество элементов, записанных в массив Примечание: не будет завершаться для коллекций бесконечного размера.
- Определяющие классы
- IterableOnceOps
def corresponds[B](that: collection.Seq[B])(p: (Char, B) => Boolean): Boolean
Проверяет, соответствует ли каждый элемент этой последовательности соответствующему элементу другой последовательности, удовлетворяя тестовому предикату.
- B
тип элементов
that- that
другая последовательность
- p
тестовый предикат, который связывает элементы из обеих последовательностей
- returns
true, если обе последовательности имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтой последовательности иyизthat, иначеfalse.
- Определяющие классы
- SeqOps
def corresponds[B](that: IterableOnce[B])(p: (Char, B) => Boolean): Boolean
Проверяет, соответствует ли каждый элемент итератора этой коллекции соответствующему элементу другой коллекции, удовлетворяя тестовому предикату.
- B
тип элементов
that- that
другая коллекция
- p
тестовый предикат, который связывает элементы из обеих коллекций
- returns
true, если обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иyизthat, иначеfalse
- Определяющие классы
- IterableOnceOps
def count(p: (Char) => Boolean): Int
Подсчитывает количество элементов в коллекции, удовлетворяющих предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- IterableOnceOps
def delete(start: Int, end: Int): StringBuilder
Удаляет подпоследовательность символов из этой последовательности, начиная с указанного индекса начала (включительно) и до индекса конца (исключительно) или до конца строки, что произойдет раньше.
- start
Начальный индекс, включая.
- end
Конечный индекс, исключая.
- returns
Этот StringBuilder.
- Exceptions thrown
StringIndexOutOfBoundsException, если start < 0 || start > end
def deleteCharAt(index: Int): StringBuilder.this.type
Удаляет символ по указанному индексу. Последовательность укорачивается на один элемент.
- index
Индекс для удаления.
- returns
Этот StringBuilder.
- Exceptions thrown
IndexOutOfBoundsException, если индекс находится вне границ.
def diff[B >: Char](that: collection.Seq[B]): StringBuilder
Вычисляет разность мультимножеств между этой последовательностью и другой последовательностью.
- that
последовательность элементов для удаления
- returns
новая последовательность, которая содержит все элементы этой последовательности, за исключением некоторых вхождений элементов, которые также появляются в
that. Если значение элементаxпоявляется n раз вthat, то первые n вхожденийxне будут частью результата, но любые последующие вхождения будут.
- Definition Classes
- SeqOps
def distinct: StringBuilder
Выбирает все элементы этой последовательности, игнорируя дубликаты.
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Definition Classes
- SeqOps
def distinctBy[B](f: (Char) => B): StringBuilder
Выбирает все элементы этой последовательности, игнорируя дубликаты, как определено в == после применения функции преобразования f.
- B
тип элементов после преобразования с помощью
f- f
Функция преобразования, результат которой используется для определения уникальности каждого элемента
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Definition Classes
- SeqOps
def drop(n: Int): StringBuilder
Выбирает все элементы, кроме первых n.
- n
количество элементов, подлежащих удалению из этой последовательности.
- returns
последовательность, состоящая из всех элементов этой последовательности, кроме первых
nэлементов, или пустая последовательность, если эта последовательность содержит менееnэлементов. Еслиnотрицательно, не удалять никаких элементов.
- Definition Classes
- IndexedSeqOps → IterableOps → IterableOnceOps
- Note
Использование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def dropRight(n: Int): StringBuilder
Выбирает все элементы, кроме последних n.
- n
количество элементов, подлежащих удалению из этой последовательности.
- returns
последовательность, состоящая из всех элементов этой последовательности, кроме последних
nэлементов, или пустая последовательность, если эта последовательность содержит менееnэлементов. Еслиnотрицательно, не удалять никаких элементов.
- Definition Classes
- IndexedSeqOps → IterableOps
def dropWhile(p: (Char) => Boolean): StringBuilder
Удаляет самый длинный префикс элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базового контейнера не упорядочен.
- p
Предикат для проверки элементов.
- returns
самый длинный суффикс этого итерируемого набора, первый элемент которого не удовлетворяет предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только тот итератор, который был возвращен. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def elementWise: ElementWiseExtractor[Int, Char]
Возвращает объект-экстрактор с методом unapplySeq, который извлекает каждый элемент данных последовательности.
- Definition Classes
- PartialFunction
val firstChar: String => Option[Char] = _.headOption
Seq("foo", "bar", "baz") match {
case firstChar.unlift.elementWise(c0, c1, c2) =>
println(s"$c0, $c1, $c2") // Output: f, b, b
}
def empty: StringBuilder
Пустая итерируемая коллекция того же типа, что и эта итерируемая коллекция.
- returns
пустую итерируемую коллекцию типа
C.
- Definition Classes
- StringBuilder → IterableFactoryDefaults → IterableOps
def endsWith[B >: Char](that: collection.Iterable[B]): Boolean
Проверяет, заканчивается ли эта последовательность заданной последовательностью.
Примечание: не завершит работу для коллекций бесконечного размера.
- that
тестируемая последовательность
- returns
true, если эта последовательность имеетthatв качестве суффикса,falseв противном случае.
- Definition Classes
- SeqOps
def ensureCapacity(newCapacity: Int): Unit
Обеспечивает, что емкость не меньше заданного аргумента. Если аргумент больше текущей емкости, будет выделена новая память размером, равным заданному аргументу или (2 * capacity + 2), что больше.
- newCapacity
минимальная желаемая емкость.
def ensuring(cond: (StringBuilder) => Boolean, msg: => Any): StringBuilder
- Неявный
- Этот член добавлен неявным преобразованием из StringBuilder в Ensuring[StringBuilder] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (StringBuilder) => Boolean): StringBuilder
- Неявный
- Этот член добавлен неявным преобразованием из StringBuilder в Ensuring[StringBuilder] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: => Any): StringBuilder
- Неявный
- Этот член добавлен неявным преобразованием из StringBuilder в Ensuring[StringBuilder] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean): StringBuilder
- Неявный
- Этот член добавлен неявным преобразованием из StringBuilder в Ensuring[StringBuilder] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- 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).
- returns
true, если аргумент является ссылкой на объект получателя;falseв противном случае.
- Определяющие классы
- AnyRef
def equals(o: Any): Boolean
Универсальный метод равенства, определенный в AnyRef.
def exists(p: (Char) => Boolean): Boolean
Проверяет, выполняется ли предикат хотя бы для одного элемента этой коллекции.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
true, если данный предикатpудовлетворяется хотя бы одним элементом этой коллекции, в противном случаеfalse
- Определяющие классы
- IterableOnceOps
def filter(pred: (Char) => Boolean): StringBuilder
Выбирает все элементы этой итерируемой коллекции, которые удовлетворяют предикату.
- returns
новый итератор, состоящий из всех элементов этой итерируемой коллекции, которые удовлетворяют данному предикату
p. Порядок элементов сохраняется.
- Определяющие классы
- IterableOps → IterableOnceOps
def filterNot(pred: (Char) => Boolean): StringBuilder
Выбирает все элементы этой итерируемой коллекции, которые не удовлетворяют предикату.
- pred
предикат, используемый для проверки элементов.
- returns
новая итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, которые не удовлетворяют данному предикату
pred. Их порядок может не сохраняться.
- Определяющие классы
- IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора для объекта получателя, когда больше нет ссылок на объект.
Подробности о том, когда и если вызывается метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.
def find(p: (Char) => Boolean): Option[Char]
Находит первый элемент коллекции, удовлетворяющий предикату, если таковой существует.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
необязательное значение, содержащее первый элемент в коллекции, который удовлетворяет
p, илиNone, если такового не существует.
- Определяющие классы
- IterableOnceOps
def findLast(p: (Char) => Boolean): Option[Char]
Находит последний элемент последовательности, удовлетворяющий предикату, если таковой существует.
Примечание: не будет завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
необязательное значение, содержащее последний элемент в последовательности, который удовлетворяет
p, илиNone, если такового не существует.
- Определяющие классы
- SeqOps
def flatMap[B](f: (Char) => IterableOnce[B]): IndexedSeq[B]
Построение новой итерируемой коллекции путем применения функции ко всем элементам этой итерируемой коллекции и использования элементов результирующих коллекций.
Например:
def getWords(lines: Seq[String]): Seq[String] = lines flatMap (line => line split "\\W+")
Тип результирующей коллекции определяется статическим типом итерируемой коллекции. Это иногда может приводить к неожиданным результатам. Например:
// lettersOf will return a Seq[Char] of likely repeated letters, instead of a Set
def lettersOf(words: Seq[String]) = words flatMap (word => word.toSet)
// lettersOf will return a Set[Char], not a Seq
def lettersOf(words: Seq[String]) = words.toSet flatMap ((word: String) => word.toSeq)
// xs will be an Iterable[Int]
val xs = Map("a" -> List(11,111), "b" -> List(22,222)).flatMap(_._2)
// ys will be a Map[Int, Int]
val ys = Map("a" -> List(1 -> 11,1 -> 111), "b" -> List(2 -> 22,2 -> 222)).flatMap(_._2)
- B
тип элемента возвращаемой коллекции.
- f
функция, применяемая к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения заданной функции со значениями в виде коллекции
fк каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def flatten[B](implicit asIterable: (Char) => IterableOnce[B]): IndexedSeq[B]
Преобразует эту итерируемую коллекцию итерируемых коллекций в итерируемую коллекцию, образованную элементами этих итерируемых коллекций.
Тип результирующей коллекции будет определяться типом итерируемой коллекции. Например:
val xs = List(
Set(1, 2, 3),
Set(1, 2, 3)
).flatten
// xs == List(1, 2, 3, 1, 2, 3)
val ys = Set(
List(1, 2, 3),
List(3, 2, 1)
).flatten
// ys == Set(1, 2, 3)
- B
тип элементов каждой итерируемой коллекции.
- asIterable
неявное преобразование, которое утверждает, что тип элемента этой итерируемой коллекции является
GenTraversable.- returns
новая итерируемая коллекция, полученная путем конкатенации всех итерируемых коллекций элементов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def fold[A1 >: Char](z: A1)(op: (A1, A1) => A1): A1
Сворачивает элементы этой коллекции, используя указанный ассоциативный бинарный оператор. Реализация по умолчанию в IterableOnce эквивалентна foldLeft, но может быть переопределена для более эффективных порядков обхода.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
Примечание: не будет завершаться для коллекций бесконечного размера.
- A1
типовой параметр для бинарного оператора, супертип
A.- z
нейтральный элемент для операции сворачивания; может быть добавлен к результату произвольное количество раз и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- returns
результат применения оператора сворачивания
opмежду всеми элементами иz, илиz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
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, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
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, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def forall(p: (Char) => Boolean): Boolean
Проверяет, выполняется ли предикат для всех элементов этой коллекции.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
true, если эта коллекция пуста или заданный предикатpвыполняется для всех элементов этой коллекции, в противном случаеfalse.
- Определяющие классы
- IterableOnceOps
def foreach[U](f: (Char) => U): Unit
Применяет f к каждому элементу для получения побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типов scalac.
- Definition Classes
- IterableOnceOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой format. Строки форматирования аналогичны строкам форматирования в String.format (@см. java.lang.String.format).
- Implicit
- Этот член добавляется неявным преобразованием из StringBuilder в StringFormat[StringBuilder] с помощью метода StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
def fromSpecific(coll: IterableOnce[Char]): StringBuilder
Определяет, как преобразовать заданный Iterable[A] в коллекцию типа C.
Этот процесс может быть выполнен строго или нестрого (т.е. без оценки элементов результирующих коллекций). Другими словами, этот метод определяет модель оценки коллекции.
- Attributes
- protected
- Definition Classes
- StringBuilder → IterableFactoryDefaults → IterableOps
- Note
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, смешав в себе трайт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, пока он вызывается сIterable[A], полученным изthisколлекции (как это происходит в реализациях операций, где мы используемView[A]), он безопасен.
final def getClass(): Class[_ <: AnyRef]
Возвращает представление класса объекта в среде выполнения.
- returns
объект класса, соответствующий типу получателя в среде выполнения.
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
- IterableOps
def groupMap[K, B](key: (Char) => K)(f: (Char) => B): immutable.Map[K, IndexedSeq[B]]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с функцией дискриминатора key. Каждый элемент в группе преобразуется в значение типа B с использованием функции value.
Это эквивалентно groupBy(key).mapValues(_.map(f)), но более эффективно.
case class User(name: String, age: Int) def namesByAge(users: Seq[User]): Map[Int, Seq[String]] = users.groupMap(_.age)(_.name)
Примечание: даже при применении к представлению или ленивой коллекции элементы будут всегда принудительно вычисляться.
- K
тип ключей, возвращаемых функцией дискриминатора
- B
тип значений, возвращаемых функцией преобразования
- key
функция дискриминатора
- f
функция преобразования элементов
- Definition Classes
- IterableOps
def groupMapReduce[K, B](key: (Char) => K)(f: (Char) => B)(reduce: (B, B) => B): immutable.Map[K, B]
Разделяет эту итерируемую коллекцию на карту в соответствии с функцией-дискриминатором key. Все значения, имеющие одинаковый дискриминатор, затем преобразуются функцией value, а затем сводятся к одному значению с помощью функции reduce.
Это эквивалентно groupBy(key).mapValues(_.map(f).reduce(reduce)), но более эффективно.
def occurrences[A](as: Seq[A]): Map[A, Int] = as.groupMapReduce(identity)(_ => 1)(_ + _)
Примечание: Даже при применении к представлению или ленивой коллекции она всегда будет принуждать элементы.
- Definition Classes
- IterableOps
def grouped(size: Int): Iterator[StringBuilder]
Разделяет элементы в итерируемых коллекциях фиксированного размера.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последней, которая будет меньше размераsize, если элементы не делятся равномерно.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Метод hashCode для типов ссылок. См. hashCode в scala.Any.
- returns
значение хэш-кода для этого объекта.
def head: Char
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Исключения
NoSuchElementException, если итерируемая коллекция пуста.
def headOption: Option[Char]
Возвращает опционально первый элемент.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции, если она не пуста,
None, если она пуста.
- Definition Classes
- IterableOps
def indexOf(str: String, fromIndex: Int): Int
Находит индекс первого вхождения указанной подстроки.
- str
целевая строка для поиска
- fromIndex
минимальный индекс в исходной строке для рассмотрения
- returns
первый подходящий индекс, где целевой элемент встречается, или -1, если он не найден.
def indexOf(str: String): Int
Находит индекс первого вхождения указанной подстроки.
- str
целевая строка для поиска
- returns
первый подходящий индекс, где целевой элемент встречается, или -1, если он не найден.
def indexOf[B >: Char](elem: B): Int
Находит индекс первого вхождения некоторого значения в эту последовательность.
- B
тип элемента
elem.- elem
значение элемента для поиска.
- returns
индекс
>= 0первого элемента этой последовательности, который равен (определяется по==)elem, или-1, если такового нет.
- Definition Classes
- SeqOps
- Аннотации
- @deprecatedOverriding("Override indexOf(elem, from) instead - indexOf(elem) calls indexOf(elem, 0)", "2.13.0")
def indexOf[B >: Char](elem: B, from: Int): Int
Находит индекс первого вхождения некоторого значения в эту последовательность после или на некотором начальном индексе.
- B
тип элемента
elem.- elem
значение элемента для поиска.
- from
начальный индекс
- returns
индекс
>= fromпервого элемента этой последовательности, который равен (определяется по==)elem, или-1, если такового нет.
- Definition Classes
- SeqOps
def indexOfSlice[B >: Char](that: collection.Seq[B]): Int
Находит первый индекс, где эта последовательность содержит заданную последовательность в качестве фрагмента.
Примечание: может не завершаться для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
первый индекс
>= 0, такой что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override indexOfSlice(that, from) вместо этого - indexOfSlice(that) вызывает indexOfSlice(that, 0)", "2.13.0")
def indexOfSlice[B >: Char](that: collection.Seq[B], from: Int): Int
Находит первый индекс после или на стартовом индексе, где эта последовательность содержит заданную последовательность в качестве фрагмента.
Примечание: может не завершаться для коллекций бесконечного размера.
- that
последовательность для проверки
- from
стартовый индекс
- returns
первый индекс
>= from, такой что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
- Definition Classes
- SeqOps
def indexWhere(p: (Char) => Boolean): Int
Находит индекс первого элемента, удовлетворяющего некоторому предикату.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс
>= 0первого элемента этой последовательности, удовлетворяющего предикатуp, или-1, если такового нет.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override indexWhere(p, from) вместо этого - indexWhere(p) вызывает indexWhere(p, 0)", "2.13.0")
def indexWhere(p: (Char) => Boolean, from: Int): Int
Находит индекс первого элемента, удовлетворяющего некоторому предикату после или на некотором стартовом индексе.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- from
стартовый индекс
- returns
индекс
>= fromпервого элемента этой последовательности, удовлетворяющего предикатуp, или-1, если такового нет.
- Definition Classes
- SeqOps
def indices: immutable.Range
Создаёт диапазон всех индексов этой последовательности.
Примечание: даже при применении к представлению или ленивой коллекции она всегда принудительно вызывает элементы.
- returns
значение
Rangeот0до значения, на единицу меньшего, чем длина этой последовательности.
- Definition Classes
- SeqOps
def init: StringBuilder
Начальная часть коллекции без последнего элемента.
Примечание: даже при применении к представлению или ленивой коллекции она всегда принудительно вызывает элементы.
- Definition Classes
- IterableOps
def inits: Iterator[StringBuilder]
Итерирует по начальным фрагментам этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, при этом промежуточные значения будут результатами последовательных применений init.
Примечание: даже при применении к представлению или ленивой коллекции она всегда принудительно вызывает элементы.
- returns
итератор по всем начальным фрагментам этой итерируемой коллекции
- Definition Classes
- IterableOps
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: IterableOnce[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
массив, из которого будут взяты Chars.
- offset
индекс первого Char для вставки.
- len
количество Chars из 'str' для вставки.
- returns
Этот StringBuilder.
- Выбрасываемые исключения
StringIndexOutOfBoundsExceptionесли index < 0, index > length, offset < 0, len < 0, или (offset + len) > str.length.
def intersect[B >: Char](that: collection.Seq[B]): StringBuilder
Вычисляет пересечение мультисетов между этой последовательностью и другой последовательностью.
- that
последовательность элементов для пересечения.
- returns
новая последовательность, которая содержит все элементы этой последовательности, которые также присутствуют в
that. Если значение элементаxвстречается n раз вthat, то первые n вхожденийxбудут сохранены в результате, но любые последующие вхождения будут опущены.
- Определяющие классы
- SeqOps
def isDefinedAt(idx: Int): Boolean
Проверяет, содержит ли эта последовательность заданный индекс.
Реализации методов apply и isDefinedAt преобразуют Seq[A] в PartialFunction[Int, A].
- idx
индекс для проверки
- returns
true, если эта последовательность содержит элемент в позицииidx,falseв противном случае.
- Definition Classes
- SeqOps
def isEmpty: Boolean
Проверяет, пуста ли последовательность.
Примечание: Реализации в подклассах, которые не являются многократно проходимыми, должны следить за тем, чтобы не потреблять никаких элементов, когда вызывается isEmpty.
- returns
true, если последовательность не содержит элементов,falseв противном случае.
- Definition Classes
- SeqOps → IterableOnceOps
final def isInstanceOf[T0]: Boolean
Проверка, является ли динамический тип объекта-получателя T0.
Обратите внимание, что результат теста модулирован семантикой стирания Scala. Поэтому выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку тип аргумента стирается во время компиляции, проверить, содержат ли элементы списка указанный тип, невозможно.
- returns
true, если объект-получатель является экземпляром стирания типаT0;falseв противном случае.
- Definition Classes
- Any
def isTraversableAgain: Boolean
Проверка, может ли этот итерируемый набор быть многократно пройден. Всегда истинно для Iterables и ложно для Iterators, если не переопределено.
- returns
true, если он многократно проходим,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def iterableFactory: SeqFactory[IndexedSeq]
Компаньон-объект этой изменяемой последовательности, предоставляющий различные методы фабрики.
- Definition Classes
- IndexedSeq → IndexedSeq → Seq → Seq → Iterable → Iterable → IterableOps
- Note
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (иначе компилятор выдаст ошибку).
def iterator: Iterator[Char]
Итератор может быть использован только один раз
- Definition Classes
- IndexedSeqOps → IterableOnce
def knownSize: Int
- returns
Количество элементов в этом строчном буфере, если его можно легко вычислить, -1 в противном случае. Легко, обычно означает: не требует обхода коллекции.
- Definition Classes
- StringBuilder → IndexedSeqOps → Growable → IterableOnce
def last: Char
Выбирает последний элемент.
- returns
Последний элемент этой последовательности.
- Definition Classes
- IndexedSeqOps → IterableOps
- Exceptions thrown
NoSuchElementExceptionЕсли последовательность пуста.
def lastIndexOf(str: String, fromIndex: Int): Int
Находит индекс последнего вхождения указанной подстроки.
- str
целевая строка для поиска
- fromIndex
наименьший индекс в исходной строке для рассмотрения
- returns
последний применимый индекс, где целевой объект встречается, или -1, если не найден.
def lastIndexOf(str: String): Int
Находит индекс последнего вхождения указанной подстроки.
- str
целевая строка для поиска
- returns
последний применимый индекс, где целевой объект встречается, или -1, если не найден.
def lastIndexOf[B >: Char](elem: B, end: Int = length - 1): Int
Находит индекс последнего вхождения значения в этой последовательности перед или на заданном индексе конца.
Примечание: не будет завершаться для коллекций бесконечного размера.
- B
тип элемента
elem.- elem
значение элемента для поиска.
- end
индекс конца.
- returns
индекс
<= endпоследнего элемента этой последовательности, который равен (определяется по==) элементуelem, или-1, если такого элемента нет.
- Definition Classes
- SeqOps
def lastIndexOfSlice[B >: Char](that: collection.Seq[B]): Int
Находит последний индекс, где эта последовательность содержит заданную последовательность как срез.
Примечание: не будет завершаться для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
последний индекс, такой что элементы этой последовательности, начиная с этого индекса, соответствуют элементам последовательности
that, или-1, если такой подпоследовательности нет.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override lastIndexOfSlice(that, end) instead - lastIndexOfSlice(that) calls lastIndexOfSlice(that, Int.MaxValue)", "2.13.0")
def lastIndexOfSlice[B >: Char](that: collection.Seq[B], end: Int): Int
Находит последний индекс перед или на заданном индексе конца, где эта последовательность содержит заданную последовательность как срез.
Примечание: не будет завершаться для коллекций бесконечного размера.
- that
последовательность для проверки
- end
индекс конца
- returns
последний индекс
<= end, такой что элементы этой последовательности, начиная с этого индекса, соответствуют элементам последовательностиthat, или-1, если такой подпоследовательности нет.
- Definition Classes
- SeqOps
def lastIndexWhere(p: (Char) => Boolean): Int
Находит индекс последнего элемента, удовлетворяющего некоторому предикату.
Примечание: не будет завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс последнего элемента этой последовательности, удовлетворяющего предикату
p, или-1, если такого элемента нет.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override lastIndexWhere(p, end) instead - lastIndexWhere(p) calls lastIndexWhere(p, Int.MaxValue)", "2.13.0")
def lastIndexWhere(p: (Char) => Boolean, end: Int): Int
Находит индекс последнего элемента, удовлетворяющего некоторому предикату перед или на заданном индексе конца.
Примечание: не будет завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс
<= endпоследнего элемента этой последовательности, удовлетворяющего предикатуp, или-1, если такого элемента нет.
- Definition Classes
- SeqOps
def lastOption: Option[Char]
Возвращает последнее значение элемента.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не является упорядоченным.
- returns
последний элемент этой итерируемой коллекции$ если она не пустая,
Noneесли она пустая.
- Definition Classes
- IterableOps
def lazyZip[B](that: collection.Iterable[B]): LazyZip2[Char, B, StringBuilder.this.type]
Аналогично zip, но элементы в каждой коллекции не потребляются до тех пор, пока не будет вызвана строгая операция над возвращаемым LazyZip2 декорирователем.
Вызовы к lazyZip могут быть объединены для поддержки более высокого арности (до 4) без затрат на построение и декомпозицию промежуточных кортежей.
val xs = List(1, 2, 3) val res = (xs lazyZip xs lazyZip xs lazyZip xs).map((a, b, c, d) => a + b + c + d) // res == List(4, 8, 12)
- B
тип второго элемента в каждой потенциальной паре
- that
итерируемый объект, предоставляющий второй элемент каждой потенциальной пары
- returns
декоратор
LazyZip2, который позволяет выполнять строгие операции над лениво вычисляемыми парами или объединять вызовы кlazyZip. Также поддерживается неявное преобразование кIterable[(A, B)].
- Definition Classes
- Iterable
def length(): Int
Длина (количество элементов) строки-строителя. size является псевдонимом для length в коллекциях Seq.
- Определяющие классы
- StringBuilder → CharSequence → SeqOps
- Аннотации
- @inline()
final def lengthCompare(that: collection.Iterable[_]): Int
Сравнивает длину этой последовательности с размером другой Iterable.
- that
Iterable, размер которой сравнивается с длиной этой последовательности.- возвращает
-
Значение
x, гдеx < 0 if this.length < that.size x == 0 if this.length == that.size x > 0 if this.length > that.size
Реализация данного метода не вызывает напрямую
lengthилиsize; время его выполнения составляетO(this.length min that.size)вместоO(this.length + that.size). Метод следует переопределять, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Определяющие классы
- IndexedSeqOps → SeqOps
final def lengthCompare(len: Int): Int
Сравнивает длину этой последовательности со значением.
- len
тестовое значение, которое сравнивается с длиной.
- возвращает
-
Значение
x, гдеx < 0 if this.length < len x == 0 if this.length == len x > 0 if this.length > len
Реализация данного метода не вызывает напрямую
length; время его выполнения составляетO(length min len)вместоO(length). Метод следует переопределять, если вычислениеlengthявляется быстрым, иknownSizeвозвращает-1.
- Определяющие классы
- IndexedSeqOps → SeqOps
- См. также
final def lengthIs: SizeCompareOps
Возвращает значение класса, содержащее операции для сравнения длины этой последовательности со значением.
Эти операции реализуются с помощью lengthCompare(Int) и позволяют использовать более читабельный синтаксис:
this.lengthIs < len // this.lengthCompare(len) < 0 this.lengthIs <= len // this.lengthCompare(len) <= 0 this.lengthIs == len // this.lengthCompare(len) == 0 this.lengthIs != len // this.lengthCompare(len) != 0 this.lengthIs >= len // this.lengthCompare(len) >= 0 this.lengthIs > len // this.lengthCompare(len) > 0
def length_=(n: Int): Unit
def lift: (Int) => Option[Char]
Преобразует эту частичную функцию в обычную функцию, возвращающую результат Option.
- возвращает
функцию, которая принимает аргумент
xи возвращаетSome(this(x)), еслиthisопределена дляx, иNoneв противном случае.
- Определяющие классы
- PartialFunction
- См. также
Function.unlift
def map[B](f: (Char) => B): IndexedSeq[B]
Создаёт новую последовательность, применяя функцию ко всем элементам этой последовательности.
- B
тип элементов возвращаемой последовательности.
- f
функция, применяемая к каждому элементу.
- возвращает
новая последовательность, полученная путём применения заданной функции
fк каждому элементу этой последовательности и сбора результатов.
- Определяющие классы
- IndexedSeqOps → IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def mapInPlace(f: (Char) => Char): StringBuilder.this.type
Изменяет эту изменяемую последовательность, применяя функцию ко всем элементам этой изменяемой последовательности.
- f
функция, применяемая к каждому элементу.
- возвращает
изменённая изменяемая последовательность, в которой все элементы заменены результатом применения заданной функции
fк каждому элементу этой изменяемой последовательности.
- Определяющие классы
- IndexedSeqOps
def mapResult[NewTo](f: (String) => NewTo): Builder[Char, NewTo]
Строитель, полученный из этого строителя с применением преобразования f.
- Определяющие классы
- Builder
def max[B >: Char](implicit ord: math.Ordering[B]): Char
Находит наибольший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наибольший элемент этого набора относительно порядка
ord.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationException, если этот набор пуст.
def maxBy[B](f: (Char) => B)(implicit cmp: math.Ordering[B]): Char
Находит первый элемент, который возвращает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этого набора с наибольшим значением, измеренным функцией f, относительно порядка
cmp.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationException, если этот набор пуст.
def maxByOption[B](f: (Char) => B)(implicit cmp: math.Ordering[B]): Option[Char]
Находит первый элемент, который возвращает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
значение Option, содержащее первый элемент этого набора с наибольшим значением, измеренным функцией f, относительно порядка
cmp.
- Definition Classes
- IterableOnceOps
def maxOption[B >: Char](implicit ord: math.Ordering[B]): Option[Char]
Находит наибольший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
значение Option, содержащее наибольший элемент этого набора относительно порядка
ord.
- Definition Classes
- IterableOnceOps
def min[B >: Char](implicit ord: math.Ordering[B]): Char
Находит наименьший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наименьший элемент этого набора относительно порядка
ord.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationException, если этот набор пуст.
def minBy[B](f: (Char) => B)(implicit cmp: math.Ordering[B]): Char
Находит первый элемент, который возвращает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этого набора с наименьшим значением, измеренным функцией f, относительно порядка
cmp.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationException, если этот набор пуст.
def minByOption[B](f: (Char) => B)(implicit cmp: math.Ordering[B]): Option[Char]
Находит первый элемент, который возвращает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
значение Option, содержащее первый элемент этого набора с наименьшим значением, измеренным функцией f, относительно порядка
cmp.
- Definition Classes
- IterableOnceOps
def minOption[B >: Char](implicit ord: math.Ordering[B]): Option[Char]
Находит наименьший элемент.
- B
Тип, для которого определено упорядочение.
- ord
Упорядочение, используемое для сравнения элементов.
- returns
значение типа Option, содержащее наименьший элемент этого набора данных относительно упорядочения
ord.
- Definition Classes
- IterableOnceOps
final def mkString: String
Отображает все элементы этого набора данных в строке.
Делегирует к addString, которое может быть переопределено.
- returns
строковое представление этого набора данных. В результирующей строке строковые представления (согласно методу
toString) всех элементов этого набора данных следуют друг за другом без разделителя.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
final def mkString(sep: String): String
Отображает все элементы этого набора данных в строке с разделителем.
Делегирует к addString, которое может быть переопределено.
- sep
строка-разделитель.
- returns
строковое представление этого набора данных. В результирующей строке строковые представления (согласно методу
toString) всех элементов этого набора данных разделены строкойsep.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
List(1, 2, 3).mkString("|") = "1|2|3"
final def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого набора данных в строке с начальной, конечной и разделительной строками.
Делегирует к addString, которое может быть переопределено.
- start
начальная строка.
- sep
строка-разделитель.
- end
конечная строка.
- returns
строковое представление этого набора данных. Результирующая строка начинается со строки
startи заканчивается строкойend. Между ними строковые представления (согласно методуtoString) всех элементов этого набора данных разделены строкойsep.
- Definition Classes
- IterableOnceOps
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- returns
true, если аргумент не является ссылкой на объект-получатель;falseв противном случае.
- Definition Classes
- AnyRef
def newSpecificBuilder: Builder[Char, StringBuilder]
- returns
строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList), реализация этого метода возможна, но полученный
Builderнарушит ленивость. Вследствие этого операции предпочтительно реализовывать с помощьюfromSpecificвместо этого метода.
- Attributes
- protected
- Definition Classes
- StringBuilder → IterableFactoryDefaults → IterableOps
- Note
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, добавив трейт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, до тех пор, пока возвращаемый билдер будет получать толькоAзначения, взятые отthisэкземпляра, он будет безопасным.
def nonEmpty: Boolean
Проверяет, не пуста ли коллекция.
- returns
true, если коллекция содержит хотя бы один элемент,falseв противном случае.
- Definition Classes
- IterableOnceOps
- Annotations
- @deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
final def notify(): Unit
Разбуживает единственную нить, ожидающую монитора объекта-приемника.
- Классы-определения
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS как член AnyRef
final def notifyAll(): Unit
Разбуживает все нити, ожидающие монитора объекта-приемника.
- Классы-определения
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS как член AnyRef
def occCounts[B](sq: collection.Seq[B]): Map[B, Int]
- Атрибуты
- protected[scala.collection]
- Классы-определения
- SeqOps
def orElse[A1 <: Int, B1 >: Char](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]
Компонует данную частичную функцию с резервной частичной функцией, которая применяется, когда данная частичная функция не определена.
- A1
тип аргумента резервной функции
- B1
тип результата резервной функции
- that
резервная функция
- возвращает
частичная функция, которая имеет в качестве области определения объединение областей определения данной частичной функции и
that. Полученная частичная функция принимаетxкthis(x), гдеthisопределена, и кthat(x), где она не определена.
- Классы-определения
- PartialFunction
def padTo[B >: Char](len: Int, elem: B): IndexedSeq[B]
Копия этой последовательности с добавленным элементом до тех пор, пока не будет достигнута заданная целевая длина.
- B
тип элемента возвращаемой последовательности.
- len
целевая длина
- elem
значение для заполнения
- возвращает
новая последовательность, состоящая из всех элементов этой последовательности, за которыми следует минимальное количество вхождений
elem, чтобы результирующий набор имел длину не менееlen.
- Классы-определения
- SeqOps
def partition(p: (Char) => Boolean): (StringBuilder, StringBuilder)
Пара, во-первых, всех элементов, удовлетворяющих предикату p, и, во-вторых, всех элементов, которые не удовлетворяют. Интересно, потому что она разделяет коллекцию на две части.
Представленная здесь реализация по умолчанию должна дважды пройти по коллекции. Строгие коллекции имеют переопределенную версию partition в StrictOptimizedIterableOps, которая требует только одного прохода.
- Классы-определения
- IterableOps
def partitionMap[A1, A2](f: (Char) => Either[A1, A2]): (IndexedSeq[A1], IndexedSeq[A2])
Применяет функцию f к каждому элементу итерируемой коллекции и возвращает пару итерируемых коллекций: первая — из значений, возвращенных f, которые были обернуты в scala.util.Left, вторая — из значений, обернутых в scala.util.Right.
Пример:
val xs = Iterable(1, "one", 2, "two", 3, "three") partitionMap {
case i: Int => Left(i)
case s: String => Right(s)
}
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип элемента первой результирующей коллекции
- A2
тип элемента второй результирующей коллекции
- f
функция «разделения», сопоставляющая элементы этой итерируемой коллекции с scala.util.Either
- возвращает
пару итерируемых коллекций: первая — из значений, возвращенных
f, которые были обернуты в scala.util.Left, вторая — из значений, обернутых в scala.util.Right.
- Классы-определения
- IterableOps
def patch[B >: Char](from: Int, other: IterableOnce[B], replaced: Int): IndexedSeq[B]
Создаёт новую последовательность, где часть элементов этой последовательности заменяется другой последовательностью.
Замена по отрицательным индексам такая же, как замена, начинающаяся с 0. Замена по индексам, равным или большим длины исходной последовательности, добавляет замену в конец. Если заменяемых значений больше, чем фактически существует, избыток игнорируется.
- B
тип элемента возвращаемой последовательности.
- from
индекс первого заменяемого элемента
- other
заменяющая последовательность
- replaced
количество элементов для удаления в исходной последовательности
- returns
новая последовательность, состоящая из всех элементов этой последовательности, за исключением
replacedэлементов, начинающихся сfrom, которые заменены всеми элементамиother.
- Definition Classes
- SeqOps
def permutations: Iterator[StringBuilder]
Итерируется по различным перестановкам.
Примечание: Даже когда применяется к представлению или ленивой коллекции, он всегда будет принудительно выполнять элементы.
- returns
Итератор, который проходит по различным перестановкам этой последовательности.
- Definition Classes
- SeqOps
"abb".permutations = Iterator(abb, bab, bba)
def prepended[B >: Char](elem: B): IndexedSeq[B]
Копия последовательности с добавленным элементом в начало.
Также исходная последовательность не изменяется, поэтому вам следует захватить результат.
Пример:
scala> val x = List(1) x: List[Int] = List(1) scala> val y = 2 +: x y: List[Int] = List(2, 1) scala> println(x) List(1)
- B
тип элемента возвращаемой последовательности.
- elem
элемент, добавляемый в начало
- returns
новая последовательность, состоящая из
value, за которым следуют все элементы этой последовательности.
- Definition Classes
- IndexedSeqOps → SeqOps
def prependedAll[B >: Char](prefix: IterableOnce[B]): IndexedSeq[B]
Как и :++, возвращает новую коллекцию, содержащую элементы левого операнда, за которыми следуют элементы правого операнда.
Отличается от :++ тем, что правый операнд определяет тип результирующей коллекции, а не левый. Мемоническая подсказка: двоеточие находится на стороне нового типа коллекции.
- B
тип элемента возвращаемой коллекции.
- prefix
итерируемый объект для добавления в начало.
- returns
новая последовательность, содержащая все элементы
prefix, за которыми следуют все элементы этой последовательности.
- Definition Classes
- SeqOps
def product[B >: Char](implicit num: math.Numeric[B]): B
Перемножает элементы этой коллекции.
- B
тип результата
*оператора.- num
неявный параметр, определяющий набор арифметических операций, который включает в себя
*оператор, используемый для вычисления произведения.- returns
произведение всех элементов этой коллекции относительно
*оператора вnum.
- Definition Classes
- IterableOnceOps
def reduce[B >: Char](op: (B, B) => B): B
Сводит элементы этой коллекции с помощью указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
- B
Параметр типа для бинарного оператора, надтипа
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения reduce-оператора
opмежду всеми элементами, если коллекция не пуста.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceLeft[B >: Char](op: (B, Char) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции слева направо.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только тип коллекции не является упорядоченным, или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции слева направо:op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)где
x1, ..., xn— элементы этой коллекции.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceLeftOption[B >: Char](op: (B, Char) => B): Option[B]
Применяет бинарный оператор ко всем элементам этой коллекции слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
необязательное значение, содержащее результат
reduceLeft(op), если эта коллекция не пуста,Noneв противном случае.
- Определяющие классы
- IterableOnceOps
def reduceOption[B >: Char](op: (B, B) => B): Option[B]
Сводит элементы этой коллекции, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
- B
Типовой параметр для бинарного оператора, надтип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Необязательное значение, содержащее результат применения оператора reduce
opмежду всеми элементами, если коллекция не пуста, иNoneв противном случае.
- Определяющие классы
- IterableOnceOps
def reduceRight[B >: Char](op: (Char, B) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn- элементы этой коллекции.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceRightOption[B >: Char](op: (Char, B) => B): Option[B]
Применяет бинарный оператор ко всем элементам этой коллекции справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
необязательное значение, содержащее результат
reduceRight(op), если эта коллекция не пуста,Noneв противном случае.
- Определяющие классы
- IterableOnceOps
def replace(start: Int, end: Int, str: String): StringBuilder
Заменяет подпоследовательность символов на заданную строку. Семантика такая же, как в delete, с тем отличием, что строковый аргумент затем вставляется в индекс 'start'.
- start
Начальный индекс, включительно.
- end
Конечный индекс, не включительно.
- str
Строка, которая будет вставлена в начальный индекс.
- returns
Этот StringBuilder.
- Выбрасываемые исключения
StringIndexOutOfBoundsExceptionесли start < 0, start > length, или start > end
def result(): String
Создает коллекцию из добавленных элементов.
После вызова result поведение всех других методов не определено, за исключением clear(). Если вызывается clear(), то строитель сбрасывается и может использоваться для построения другого экземпляра.
- returns
коллекция, содержащая элементы, добавленные в этот строитель.
- Определяющие классы
- StringBuilder → ReusableBuilder → Builder
def reverse: StringBuilder
Возвращает новую последовательность с элементами в обратном порядке.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно получать элементы.
- returns
Новая последовательность со всеми элементами этой последовательности в обратном порядке.
- Определяющие классы
- IndexedSeqOps → SeqOps
def reverseInPlace(): StringBuilder.this.type
Как reverse, но деструктивно обновляет целевой StringBuilder.
- returns
обращённый StringBuilder (такой же, как целевой StringBuilder)
def reverseIterator: Iterator[Символ]
Итератор, возвращающий элементы в обратном порядке.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: xs.reverseIterator аналогично xs.reverse.iterator, но может быть более эффективным.
- returns
итератор, возвращающий элементы этой последовательности в обратном порядке
- Definition Classes
- IndexedSeqOps → SeqOps
def reversed: collection.Iterable[Символ]
- Attributes
- protected
- Definition Classes
- IndexedSeqOps → IterableOnceOps
def runWith[U](action: (Символ) => U): (Целое) => Булево
Комбинирует эту частичную функцию с функцией действия, которая применяется к результатам этой частичной функции. Функция действия вызывается только для побочных эффектов; её результат игнорируется.
Обратите внимание, что выражение pf.runWith(action)(x) эквивалентно
if(pf isDefinedAt x) { action(pf(x)); true } else false
за исключением того, что runWith реализована через applyOrElse и, следовательно, потенциально более эффективна. Использование runWith избегает двойной оценки согласующих функций и условий для литералов частичных функций.
- action
функция действия
- returns
функция, отображающая аргументы
xвisDefinedAt(x). Результирующая функция выполняетaction(this(x)), гдеthisопределено.
- Definition Classes
- PartialFunction
- Since
2.10
- See also
applyOrElse.
def sameElements[B >: Символ](that: IterableOnce[B]): Булево
Являются ли элементы этой коллекции такими же (и в том же порядке), как элементы that?
- Definition Classes
- SeqOps
def scan[B >: Символ](z: B)(op: (B, B) => B): IndexedSeq[B]
Вычисляет префиксное сканирование элементов коллекции.
Примечание: нейтральный элемент z может применяться более одного раза.
- B
тип элементов результирующей коллекции
- z
нейтральный элемент для оператора
op- op
ассоциативный оператор для сканирования
- returns
новая итерируемая коллекция, содержащая префиксное сканирование элементов в этой итерируемой коллекции
- Definition Classes
- IterableOps
def scanLeft[B](z: B)(op: (B, Символ) => B): IndexedSeq[B]
Создаёт итерируемую коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def scanRight[B](z: B)(op: (Символ, B) => B): IndexedSeq[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции — последний кумулятивный результат.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
Примечание: Даже при применении к представлению или ленивой коллекции она всегда будет принудительно применять элементы.
Пример:
List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Definition Classes
- IterableOps
def search[B >: Char](elem: B, from: Int, to: Int)(implicit ord: math.Ordering[B]): SearchResult
Поиск в интервале в этом отсортированном последовательности для определённого элемента. Если эта последовательность является IndexedSeq, используется двоичный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с помощью того же Ordering перед вызовом; в противном случае результаты неопределённы.
- elem
элемент, который нужно найти.
- from
индекс, с которого начинается поиск.
- to
индекс, следующий за тем, где поиск заканчивается.
- ord
упорядочение, используемое для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где элемент был бы вставлен, если элемент не находится в последовательности.
- Definition Classes
- IndexedSeqOps → SeqOps
- Note
если
to <= from, пространство поиска пусто, и возвращаетсяInsertionPointвfrom- See also
-
scala.collection.SeqOps, метод
sorted
def search[B >: Char](elem: B)(implicit ord: math.Ordering[B]): SearchResult
Поиск в этой отсортированной последовательности определённого элемента. Если последовательность является IndexedSeq, используется двоичный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с использованием того же Ordering перед вызовом; в противном случае результаты неопределённы.
- elem
элемент, который нужно найти.
- ord
упорядочение, используемое для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где элемент был бы вставлен, если элемент не находится в последовательности.
- Definition Classes
- IndexedSeqOps → SeqOps
- See also
-
scala.collection.SeqOps, метод
sorted
def segmentLength(p: (Char) => Boolean, from: Int): Int
Вычисляет длину самой длинной последовательности, элементы которой удовлетворяют некоторому предикату.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- from
индекс, с которого начинается поиск.
- returns
длина самой длинной последовательности в этой последовательности, начинающейся с индекса
from, такая, что каждый элемент последовательности удовлетворяет предикатуp.
- Definition Classes
- SeqOps
final def segmentLength(p: (Char) => Boolean): Int
Вычисляет длину самой длинной последовательности, элементы которой все удовлетворяют некоторому предикату.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
длина самой длинной последовательности в этой последовательности, такая, что каждый элемент последовательности удовлетворяет предикату
p.
- Definition Classes
- SeqOps
def setCharAt(index: Int, ch: Char): StringBuilder.this.type
Обновить последовательность в заданном индексе, чтобы она содержала указанный символ.
- index
индекс для изменения.
- ch
новый символ.
- Exceptions thrown
IndexOutOfBoundsException, если индекс находится вне границ.
def setLength(len: Int): Unit
Устанавливает длину последовательности символов. Если текущая последовательность короче заданной длины, она дополняется нулями; если она длиннее, она усекается.
- len
новая длина
- Exceptions thrown
IndexOutOfBoundsException, если аргумент отрицательный.
final def size: Int
Размер этой последовательности.
Примечание: не будет завершаться для коллекций бесконечного размера.
- returns
количество элементов в этой последовательности.
- Definition Classes
- SeqOps → IterableOnceOps
final def sizeCompare(that: collection.Iterable[_]): Int
Сравнивает размер этой последовательности с размером другой Iterable.
- that
Iterable, размер которой сравнивается с размером этой последовательности.- returns
-
Значение
x, гдеx < 0 if this.size < that.size x == 0 if this.size == that.size x > 0 if this.size > that.size
Реализация этого метода не вызывает
sizeнапрямую; его время выполнения составляетO(this.size min that.size)вместоO(this.size + that.size). Метод должен быть переопределен, если вычислениеsizeявляется дешёвым, иknownSizeвозвращает-1.
- Definition Classes
- SeqOps → IterableOps
final def sizeCompare(otherSize: Int): Int
Сравнивает размер этой последовательности со значением.
- otherSize
тестовое значение, которое сравнивается с размером.
- returns
-
Значение
x, гдеx < 0 if this.size < otherSize x == 0 if this.size == otherSize x > 0 if this.size > otherSize
Реализация этого метода не вызывает
sizeнапрямую; его время выполнения составляетO(size min otherSize)вместоO(size). Метод должен быть переопределён, если вычислениеsizeявляется дешёвым, иknownSizeвозвращает-1.
- Definition Classes
- SeqOps → IterableOps
- See also
final def sizeHint(coll: IterableOnce[_], delta: Int = 0): Unit
Указывает, что ожидается, что размер этого билдера будет равен размеру заданной коллекции, плюс некоторая величина. Это будет предоставлено в качестве подсказки только в том случае, если коллекция имеет известный размер. Некоторые классы билдеров будут оптимизировать свое представление на основе подсказки. Однако реализации билдеров по-прежнему должны работать правильно, даже если подсказка неверна, т.е. добавлено другое количество элементов.
- coll
коллекция, которая служит подсказкой для размера результата.
- delta
поправка, которая добавляется к размеру для получения подсказки размера.
- Definition Classes
- Builder
def sizeHint(size: Int): Unit
Указывает, сколько элементов ожидается добавить, когда будет вызван следующий result. Некоторые классы билдеров будут оптимизировать свое представление на основе подсказки. Однако реализации билдеров по-прежнему должны работать правильно, даже если подсказка неверна, т.е. добавлено другое количество элементов.
- size
подсказка, сколько элементов будет добавлено.
- Definition Classes
- Builder
final def sizeHintBounded(size: Int, boundingColl: collection.Iterable[_]): Unit
Указывает, сколько элементов ожидается добавить, когда будет вызван следующий result, а также верхнюю границу, заданную размером другой коллекции. Некоторые классы билдеров будут оптимизировать свое представление на основе подсказки. Однако реализации билдеров по-прежнему должны работать правильно, даже если подсказка неверна, т.е. добавлено другое количество элементов.
- size
подсказка, сколько элементов будет добавлено.
- boundingColl
ограничивающая коллекция. Если это IndexedSeqLike, то размеры, большие, чем размер коллекции, уменьшаются.
- Definition Classes
- Builder
final def sizeIs: SizeCompareOps
Возвращает значение класса, содержащего операции для сравнения размера этой итерируемой коллекции со значением.
Эти операции реализуются с помощью sizeCompare(Int), и позволяют следующие более читаемые использования:
this.sizeIs < size // this.sizeCompare(size) < 0 this.sizeIs <= size // this.sizeCompare(size) <= 0 this.sizeIs == size // this.sizeCompare(size) == 0 this.sizeIs != size // this.sizeCompare(size) != 0 this.sizeIs >= size // this.sizeCompare(size) >= 0 this.sizeIs > size // this.sizeCompare(size) > 0
- Definition Classes
- IterableOps
- Annotations
- @inline()
def slice(from: Int, until: Int): StringBuilder
Выбирает интервал элементов. Возвращаемая последовательность состоит из всех элементов x, которые удовлетворяют инварианту:
from <= indexOf(x) < until
- from
наименьший индекс для включения из этой последовательности.
- until
наименьший индекс для исключения из этой последовательности.
- returns
последовательность, содержащая элементы, большие или равные индексу
from, продолжающаяся до (но не включая) индексаuntilэтой последовательности.
- Definition Classes
- IndexedSeqOps → IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора является неопределенным, может измениться и может привести к изменениям в новом итераторе также.
def sliding(size: Int, step: Int): Iterator[StringBuilder]
Группирует элементы в блоки фиксированного размера, проходя по ним «скользящим окном» (в отличие от разбиения, как это делается в grouped).
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, создающий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если осталось меньшеsizeэлементов для группировки.
- Определяющие классы
- IterableOps
- См. также
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[StringBuilder]
Группирует элементы в блоки фиксированного размера, проходя по ним «скользящим окном» (в отличие от разбиения, как это делается в grouped.) Шаг «скользящего окна» установлен в один.
- size
количество элементов в группе
- returns
Итератор, создающий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если осталось меньшеsizeэлементов для группировки.
- Определяющие классы
- IterableOps
- См. также
scala.collection.Iterator, метод
sliding
def sortBy[B](f: (Char) => B)(implicit ord: Ordering[B]): StringBuilder
Сортирует эту последовательность в соответствии с Ordering, который получается в результате преобразования неявно заданного Ordering с помощью функции преобразования.
Примечание: не будет завершаться для бесконечно больших коллекций.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно обрабатывать элементы.
Сортировка стабильна. То есть элементы, которые равны (как определено ord.compare), появляются в отсортированной последовательности в том же порядке, что и в исходной.
- B
целевой тип преобразования
fи тип, где определен порядокord.- f
функция преобразования, отображающая элементы в некоторую другую область
B.- ord
порядок, предполагаемый в области
B.- returns
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с порядком, где
x < y, еслиord.lt(f(x), f(y)).
- Определяющие классы
- SeqOps
- См. также
val words = "The quick brown fox jumped over the lazy dog".split(' ')
// this works because scala.Ordering will implicitly provide an Ordering[Tuple2[Int, Char]]
words.sortBy(x => (x.length, x.head))
res0: Array[String] = Array(The, dog, fox, the, lazy, over, brown, quick, jumped)
def sortInPlace[B >: Char]()(implicit ord: Ordering[B]): StringBuilder.this.type
Сортирует эту изменяемую последовательность на месте в соответствии с Ordering.
- ord
порядок, который будет использоваться для сравнения элементов.
- returns
измененная входная изменяемая последовательность, отсортированная в соответствии с порядком
ord.
- Определяющие классы
- IndexedSeqOps
- См. также
def sortInPlaceBy[B](f: (Char) => B)(implicit ord: Ordering[B]): StringBuilder.this.type
Сортирует эту изменяемую последовательность на месте в соответствии с Ordering, который получается в результате преобразования неявно заданного Ordering с помощью функции преобразования.
- Определяющие классы
- IndexedSeqOps
- См. также
def sortInPlaceWith(lt: (Char, Char) => Boolean): StringBuilder.this.type
Сортирует эту изменяемую последовательность на месте в соответствии с функцией сравнения.
- Определяющие классы
- IndexedSeqOps
- См. также
def sortWith(lt: (Char, Char) => Boolean): StringBuilder
Сортирует эту последовательность в соответствии с функцией сравнения.
Примечание: не будет завершаться для бесконечно больших коллекций.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно обрабатывать элементы.
Сортировка стабильна. То есть элементы, которые равны (как определено lt), появляются в отсортированной последовательности в том же порядке, что и в исходной.
- lt
функция сравнения, которая проверяет, предшествует ли ее первый аргумент второму аргументу в желаемом порядке.
- returns
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с функцией сравнения
lt.
- Определяющие классы
- SeqOps
List("Steve", "Tom", "John", "Bob").sortWith(_.compareTo(_) < 0) =
List("Bob", "John", "Steve", "Tom")
def sorted[B >: Char](implicit ord: Ordering[B]): StringBuilder
Сортирует эту последовательность в соответствии с Ordering.
Сортировка стабильна. То есть элементы, которые равны (как определяется ord.compare), появляются в том же порядке в отсортированной последовательности, что и в исходной.
- ord
упорядочение, используемое для сравнения элементов.
- returns
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с упорядочением
ord.
- Definition Classes
- SeqOps
- See also
scala.math.Ordering Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
def span(p: (Char) => Boolean): (StringBuilder, StringBuilder)
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.
Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не приводит к побочным эффектам.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции по умолчанию не упорядочен.
- p
предикат проверки
- returns
пара, состоящая из самого длинного префикса этой итерируемой коллекции, чьи элементы все удовлетворяют
p, и остаток этой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода нужно отказаться от итератора, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора неопределенно, может измениться и может привести к изменениям в новых итераторах также.
def splitAt(n: Int): (StringBuilder, StringBuilder)
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции по умолчанию не упорядочен.
- n
позиция, в которой необходимо разделить.
- returns
пара итерируемых коллекций, состоящая из первых
nэлементов этой итерируемой коллекции и других элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода нужно отказаться от итератора, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора неопределенно, может измениться и может привести к изменениям в новых итераторах также.
def startsWith[B >: Char](that: IterableOnce[B], offset: Int = 0): Boolean
Проверяет, содержит ли эта последовательность данную последовательность в указанном индексе.
Примечание: Если и получаемый объект this, и аргумент that являются бесконечными последовательностями, этот метод может не завершиться.
- that
тестируемая последовательность
- offset
индекс, где ищется последовательность.
- returns
true, если последовательностьthatсодержится в этой последовательности в индексеoffset, в противном случаеfalse.
- Definition Classes
- SeqOps
def stepper[S <: Stepper[_]](implicit shape: StepperShape[Char, S]): S with EfficientSplit
Возвращает Stepper для элементов этой коллекции.
Stepper позволяет создавать Java-поток для работы с коллекцией, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться как итератор, который не упаковывает элементы.
Неявный параметр StepperShape определяет тип результирующего Stepper в соответствии с типом элементов этой коллекции.
-
Для коллекций
Int, Short, Byte или Char возвращается IntStepperДля коллекций Double или Float возвращается DoubleStepperДля коллекций Long возвращается LongStepperДля любого другого типа элементов возвращается AnyStepperОбратите внимание, что этот метод переопределяется в подклассах, и тип возвращаемого значения уточняется до S with EfficientSplit, например, IndexedSeqOps.stepper. Для Stepper, помеченных scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Stepper можно преобразовать только в последовательные потоки.
- Definition Classes
- IndexedSeqOps → IterableOnce
def stringPrefix: String
- Атрибуты
- protected[this]
- Определяющие классы
- IndexedSeq → Seq → Iterable
- Аннотации
- @deprecatedOverriding("Совместимость перезаписи", "2.13.0")
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
Конечный индекс, исключающий.
- returns
Новая строка.
- Исключения
StringIndexOutOfBoundsExceptionЕсли какой-либо из индексов находится за пределами границ, или если start > end.
def substring(start: Int): String
Возвращает новую строку, состоящую из подпоследовательности этой последовательности, начиная с заданного индекса и до конца последовательности.
target.substring(start) эквивалентно target.drop(start)
- start
Начальный индекс, включительно.
- returns
Новая строка.
- Исключения
IndexOutOfBoundsException, если индекс находится за пределами границ.
def sum[B >: Char](implicit num: math.Numeric[B]): B
Вычисляет сумму элементов этого набора.
- B
тип результата оператора
+.- num
явный параметр, определяющий набор арифметических операций, включающий оператор
+, используемый для вычисления суммы.- returns
сумма всех элементов этого набора относительно оператора
+вnum.
- Определяющие классы
- IterableOnceOps
final def synchronized[T0](arg0: => T0): T0
- Определяющие классы
- AnyRef
def tail: StringBuilder
Остальная часть набора без первого элемента.
- Определяющие классы
- IterableOps
def tails: Iterator[StringBuilder]
Итерируется по хвостам этого набора. Первое значение будет этим набором, а последнее — пустым, промежуточные значения будут результатами последовательных применений tail.
- returns
итератор по всем хвостам этого набора
- Определяющие классы
- IterableOps
List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)
def take(n: Int): StringBuilder
Выбирает первые n элементов.
- n
количество элементов для выбора из этой последовательности.
- returns
последовательность, содержащая только первые
nэлементов этой последовательности, или же всю последовательность, если она содержит меньше чемnэлементов. Еслиnотрицательно, возвращает пустую последовательность.
- Определяющие классы
- IndexedSeqOps → IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует удалить вызываемый итератор и использовать только возвращенный. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def takeRight(n: Int): StringBuilder
Выбирает последние n элементов.
- n
количество элементов для выбора из этой последовательности.
- returns
последовательность, содержащая только последние
nэлементы этой последовательности, или же всю последовательность, если она содержит меньше чемnэлементов. Еслиnотрицательно, возвращает пустую последовательность.
- Определяющие классы
- IndexedSeqOps → IterableOps
def takeWhile(p: (Char) => Boolean): StringBuilder
Берёт самую длинную префиксную последовательность элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный префикс этого итерируемого набора элементов, все из которых удовлетворяют предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
def tapEach[U](f: (Char) => U): StringBuilder
Применяет функцию с побочным эффектом к каждому элементу в этом наборе. Строгие коллекции будут применять f к своим элементам немедленно, в то время как ленивые коллекции, такие как Views и LazyLists, будут применять f только к каждому элементу, если и когда этот элемент оценивается, и каждый раз, когда этот элемент оценивается.
- U
тип возвращаемого значения f
- f
функция, которую нужно применить к каждому элементу в этой итерируемой коллекции
- returns
Такая же логическая коллекция, как и эта
- Definition Classes
- IterableOps → IterableOnceOps
def to[C1](factory: Factory[Char, C1]): C1
Учитывая фабрику коллекций factory, преобразуйте эту коллекцию в соответствующую представление для текущего типа элемента A. Примеры использования:
xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]
- Definition Classes
- IterableOnceOps
def toArray[B >: Char](implicit ct: ClassTag[B]): Array[B]
Преобразовать коллекцию в массив.
- Definition Classes
- StringBuilder → IterableOnceOps
final def toBuffer[B >: Char]: Buffer[B]
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def toCharArray: Array[Char]
Возвращает содержимое этого StringBuilder в виде Array[Char].
- returns
Массив с символами из этого билдера.
def toIndexedSeq: immutable.IndexedSeq[Char]
- Definition Classes
- IterableOnceOps
final def toIterable: StringBuilder.this.type
- returns
Эта коллекция в виде
Iterable[A]. Новая коллекция не будет создана, еслиthisуже являетсяIterable[A].
- Definition Classes
- Iterable → IterableOps
def toList: immutable.List[Char]
- Definition Classes
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[Char, (K, V)]): immutable.Map[K, V]
- Definition Classes
- IterableOnceOps
def toSeq: immutable.Seq[Char]
- returns
Эта коллекция в виде
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Definition Classes
- IterableOnceOps
def toSet[B >: Char]: immutable.Set[B]
- Definition Classes
- IterableOnceOps
def toString(): String
Создаёт строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.
- returns
строковое представление объекта.
- Definition Classes
- StringBuilder → CharSequence → Seq → Function1 → Iterable → AnyRef → Any
def toVector: immutable.Vector[Char]
- Definition Classes
- IterableOnceOps
def transpose[B](implicit asIterable: (Char) => collection.Iterable[B]): IndexedSeq[IndexedSeq[B]]
Транспонирует это итерируемое множество итерируемых множеств в итерируемое множество итерируемых множеств.
Тип результирующего множества будет определяться статическим типом итерируемого множества. Например:
val xs = List(
Set(1, 2, 3),
Set(4, 5, 6)).transpose
// xs == List(
// List(1, 4),
// List(2, 5),
// List(3, 6))
val ys = Vector(
List(1, 2, 3),
List(4, 5, 6)).transpose
// ys == Vector(
// Vector(1, 4),
// Vector(2, 5),
// Vector(3, 6))
Примечание: Даже при применении к представлению или ленивому множеству элементы всегда будут принудительно вычисляться.
- B
тип элементов каждого итерируемого множества.
- asIterable
неявное преобразование, которое утверждает, что тип элемента этого итерируемого множества является
Iterable.- returns
двумерное итерируемое множество итерируемых множеств, в котором n-я строка — это n-й столбец этого итерируемого множества.
- Definition Classes
- IterableOps
- Exceptions thrown
IllegalArgumentException, если все множества в этом итерируемом множестве не имеют одинаковый размер.
def unapply(a: Int): Option[Char]
Попытка извлечь B из A в выражении сопоставления с образцом.
- Definition Classes
- PartialFunction
val underlying: java.lang.StringBuilder
def unzip[A1, A2](implicit asPair: (Char) => (A1, A2)): (IndexedSeq[A1], IndexedSeq[A2])
Преобразует это итерируемое множество пар в два множества первой и второй половины каждой пары.
val xs = Iterable(
(1, "one"),
(2, "two"),
(3, "three")).unzip
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип первой половины пар элементов
- A2
тип второй половины пар элементов
- asPair
неявное преобразование, которое утверждает, что тип элемента этого итерируемого множества является парой.
- returns
пара итерируемых множеств, содержащих первую и соответственно вторую половину каждой пары элементов этого итерируемого множества.
- Definition Classes
- IterableOps
def unzip3[A1, A2, A3](implicit asTriple: (Char) => (A1, A2, A3)): (IndexedSeq[A1], IndexedSeq[A2], IndexedSeq[A3])
Преобразует это итерируемое множество троек в три множества первого, второго и третьего элемента каждой тройки.
val xs = Iterable(
(1, "one", '1'),
(2, "two", '2'),
(3, "three", '3')).unzip3
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three),
// Iterable(1, 2, 3))
- A1
тип первого члена троек элементов
- A2
тип второго члена троек элементов
- A3
тип третьего члена троек элементов
- asTriple
неявное преобразование, которое утверждает, что тип элемента этого итерируемого множества является тройкой.
- returns
тройка итерируемых множеств, содержащих первый, второй и соответственно третий член каждой тройки элементов этого итерируемого множества.
- Definition Classes
- IterableOps
def update(idx: Int, elem: Char): Unit
Заменяет элемент в заданном индексе новым значением.
- idx
индекс элемента, который нужно заменить.
- elem
новое значение.
- Definition Classes
- StringBuilder → SeqOps
- Исключения
IndexOutOfBoundsException, если индекс недействителен.
def updated[B >: Char](index: Int, elem: B): IndexedSeq[B]
Копия этого последовательности с одним заменённым элементом.
- B
тип элементов возвращаемой последовательности.
- index
положение замены
- elem
элемент замены
- возвращает
новую последовательность, которая является копией этой последовательности с элементом в позиции
index, заменённым наelem.
- Definition Classes
- SeqOps
- Исключения
IndexOutOfBoundsException, еслиindexне удовлетворяет0 <= index < length. В случае ленивой коллекции это исключение может быть выброшено в более позднее время или вообще не выброшено (если конец коллекции никогда не оценивается).
def view: IndexedSeqView[Char]
Представление над элементами этой коллекции.
- Definition Classes
- IndexedSeqOps → SeqOps → IterableOps
final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long): Unit
def withFilter(p: (Char) => Boolean): WithFilter[Char, [_]IndexedSeq[_]]
Создаёт нестрогий фильтр этой коллекции.
Примечание: разница между c filter p и c withFilter p заключается в том, что первый создаёт новую коллекцию, а второй только ограничивает область применения последующих map, flatMap, foreach и withFilter операций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- возвращает
объект класса
WithFilter, который поддерживаетmap,flatMap,foreachиwithFilterоперации. Все эти операции применяются к элементам этой итерируемой коллекции, которые удовлетворяют предикатуp.
- Definition Classes
- IterableOps
def zip[B](that: IterableOnce[B]): IndexedSeq[(Char, B)]
Возвращает коллекцию, сформированную из этой итерируемой коллекции и другой итерируемой коллекции путём объединения соответствующих элементов в пары. Если одна из двух коллекций длиннее другой, её оставшиеся элементы игнорируются.
- B
тип второй половины возвращаемых пар
- that
Итерируемая коллекция, обеспечивающая вторую половину каждой пары результатов
- возвращает
новая итерируемая коллекция, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции и
that. Длина возвращаемой коллекции равна минимальной из длин этой итерируемой коллекции иthat.
- Definition Classes
- IterableOps
def zipAll[A1 >: Char, B](that: collection.Iterable[B], thisElem: A1, thatElem: B): IndexedSeq[(A1, B)]
Возвращает итерируемую коллекцию, образованную из этой итерируемой коллекции и другой итерируемой коллекции путём объединения соответствующих элементов парами. Если одна из двух коллекций короче другой, используются заполнители для расширения более короткой коллекции до длины более длинной.
- that
итерируемый объект, предоставляющий вторую половину каждой пары результата
- thisElem
элемент, используемый для заполнения результата, если эта итерируемая коллекция короче
that.- thatElem
элемент, используемый для заполнения результата, если
thatкороче этой итерируемой коллекции.- returns
новая коллекция типа
That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции иthat. Длина возвращаемой коллекции — это максимальная из длин этой итерируемой коллекции иthat. Если эта итерируемая коллекция корочеthat, используются значенияthisElemдля заполнения результата. Еслиthatкороче этой итерируемой коллекции, используются значенияthatElemдля заполнения результата.
- Definition Classes
- IterableOps
def zipWithIndex: IndexedSeq[(Char, Int)]
Объединяет эту итерируемую коллекцию со своими индексами.
- returns
Новая итерируемая коллекция, содержащая пары, состоящие из всех элементов этой итерируемой коллекции, соединённых с их индексом. Индексы начинаются с
0.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора является неопределённым, может изменяться и может привести к изменениям в новом итераторе тоже.
List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))
Затенённые неявные члены значения
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 length(): Int
- Неявный
- Этот член добавлен неявным преобразованием из StringBuilder в SeqCharSequence, выполненным методом SeqCharSequence в scala.Predef.
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(stringBuilder: SeqCharSequence).length()
- Определяющие классы
- SeqCharSequence → CharSequence
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
© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/collection/mutable/StringBuilder.html
Построитель для изменяемой последовательности символов. Этот класс предоставляет API, в основном совместимый с
java.lang.StringBuilder, за исключением случаев конфликта с API коллекций Scala (например, методreverse.)Этот построитель может быть повторно использован после вызова
result()без промежуточного вызоваclear()для построения нескольких связанных результатов.2.7