java.lang.Object
- java.lang.StringBuilder

Todas las interfaces implementadas

Serializable ， Appendable ， CharSequence ， Comparable<StringBuilder>
```
public final class StringBuilder
extends Object
implements Serializable, Comparable<StringBuilder>, CharSequence
```
Una secuencia de caracteres mutable. Esta clase proporciona una API compatible conStringBufferpero no garantiza la sincronización. Esta clase está diseñada para usarse como reemplazo deStringBuffer, para lugares donde un solo hilo usa un búfer de cadenas (normalmente). Cuando sea posible, se recomienda usar esta clase en lugar deStringBufferporque en la mayoría de las implementaciones es más rápida.
StringBuilder: sus operaciones principales sonappendyinsertmétodos, que están sobrecargados para aceptar datos de cualquier tipo. Cada uno convierte efectivamente los datos dados en una cadena y luego agrega o inserta los caracteres de esa cadena en el constructor de cadenas. appendEl método siempre agrega estos caracteres al final del constructor; insertEl método agrega caracteres en el punto especificado.

Por ejemplo, sizconsidérese un objeto constructor de cadenas cuyo contenido actual es “start”, entonces la llamada al métodoz.append("le")hará que el constructor de cadenas contenga “startle”, mientras quez.insert(4, "le")alterará el constructor de cadenas para que contenga “starlet ”。

En general, si alguien se refiere a una instanciaStringBuilder, entoncessb.append(x)tiene el mismo efectosb.insert(sb.length(), x) 。

Cada StringBuilder tiene una capacidad. Siempre que la longitud de la secuencia de caracteres contenida en el StringBuilder no supere la capacidad, no es necesario asignar un nuevo búfer interno. Si el búfer interno se desborda, se agranda automáticamente.

StringBuilderLas instancias no son adecuadas para el uso con múltiples hilos. Si se necesita dicha sincronización, se recomienda utilizarStringBuffer 。

A menos que se indique lo contrario,nullpasar el parámetro anullsus constructores o métodos provocarán el lanzamientoNullPointerException 。

API Note:

StringBuilderimplementaComparablepero no sobrescribeequals 。 Por lo tanto,StringBuildersu orden natural no es consistente con equals. SiStringBuilderLos objetos se utilizan comoStringBuilderclaves de este oSortedMapelementos,SortedSet 。 véaseComparable ， SortedMap, oSortedSetpara obtener más información.

Desde la versión:

1.5

Véase también:

StringBuffer ， String ， Serialized Form

Resumen de constructores

Método constructor
Constructor	Descripción
`StringBuilder()`	Construye un StringBuilder que no contiene ningún carácter, con una capacidad inicial de 16 caracteres.
`StringBuilder(int capacity)`	Construye un StringBuilder sin caracteres, y que tiene`capacity`la capacidad inicial especificada por el parámetro.
`StringBuilder(CharSequence seq)`	Construye un generador de cadenas que contiene con el especificado`CharSequence`Los mismos caracteres.
`StringBuilder(String str)`	Construye un generador de cadenas inicializado con el contenido de la cadena especificada.

Resumen de métodos

Todos los métodos Método de instancia Método específico
Variables y tipos	Método	Descripción
`StringBuilder`	`append(boolean b)`	va a`boolean`La representación de cadena del argumento se añade a la secuencia.
`StringBuilder`	`append(char c)`	va a`char`La representación de cadena del argumento se añade a esta secuencia.
`StringBuilder`	`append(char[] str)`	va a`char`La representación de cadena del argumento array se añade a esta secuencia.
`StringBuilder`	`append(char[] str, int offset, int len)`	va a`char`La representación de cadena del subarray del argumento array se añade a esta secuencia.
`StringBuilder`	`append(double d)`	va a`double`La representación de cadena del argumento se añade a esta secuencia.
`StringBuilder`	`append(float f)`	va a`float`La representación de cadena del argumento se añade a esta secuencia.
`StringBuilder`	`append(int i)`	va a`int`La representación de cadena del argumento se añade a esta secuencia.
`StringBuilder`	`append(long lng)`	va a`long`La representación de cadena del argumento se añade a esta secuencia.
`StringBuilder`	`append(CharSequence s)`	Añade la secuencia de caracteres especificada a este`Appendable` 。
`StringBuilder`	`append(CharSequence s, int start, int end)`	La especificada`CharSequence`La secuencia se añade a esta secuencia.
`StringBuilder`	`append(Object obj)`	Añade`Object`La representación de cadena del argumento.
`StringBuilder`	`append(String str)`	Añade la cadena especificada a esta secuencia de caracteres.
`StringBuilder`	`append(StringBuffer sb)`	La especificada`StringBuffer`Añade a esta secuencia.
`StringBuilder`	`appendCodePoint(int codePoint)`	va a`codePoint`La representación de cadena del argumento se añade a esta secuencia.
`int`	`capacity()`	Devuelve la capacidad actual.
`char`	`charAt(int index)`	Devuelve el de esta secuencia en el índice especificado.`char`valores.
`IntStream`	`chars()`	Devuelve`int`El flujo de, para los de esta secuencia`char`Los valores se extienden con ceros.
`int`	`codePointAt(int index)`	Devuelve el carácter (punto de código Unicode) en el índice especificado.
`int`	`codePointBefore(int index)`	Devuelve el carácter (punto de código Unicode) antes del índice especificado.
`int`	`codePointCount(int beginIndex, int endIndex)`	Devuelve el número de puntos de código Unicode en el rango de texto especificado de esta secuencia.
`IntStream`	`codePoints()`	Devuelve un flujo de valores de puntos de código de esta secuencia.
`int`	`compareTo(StringBuilder another)`	`StringBuilder`Compara dos lexicográficamente`StringBuilder`instancia.
`StringBuilder`	`delete(int start, int end)`	Elimina los caracteres en una subcadena de esta secuencia.
`StringBuilder`	`deleteCharAt(int index)`	Elimina el de la posición especificada en este orden`char` 。
`void`	`ensureCapacity(int minimumCapacity)`	Asegura que la capacidad sea al menos igual al mínimo especificado.
`void`	`getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)`	Copia los caracteres de esta secuencia a la matriz de caracteres de destino`dst` 。
`int`	`indexOf(String str)`	Devuelve el índice en la cadena de la primera aparición de la subcadena especificada.
`int`	`indexOf(String str, int fromIndex)`	Devuelve el índice en la cadena de la primera aparición de la subcadena especificada, comenzando en el índice especificado.
`StringBuilder`	`insert(int offset, boolean b)`	va a`boolean`Inserta la representación de cadena del argumento en esta secuencia.
`StringBuilder`	`insert(int offset, char c)`	va a`char`Inserta la representación de cadena del argumento en esta secuencia.
`StringBuilder`	`insert(int offset, char[] str)`	va a`char`Inserta la representación de cadena del argumento de matriz en esta secuencia.
`StringBuilder`	`insert(int index, char[] str, int offset, int len)`	va a`str`Inserta la representación de cadena de la submatriz del argumento de matriz en esta secuencia.
`StringBuilder`	`insert(int offset, double d)`	va a`double`Inserta la representación de cadena del argumento en esta secuencia.
`StringBuilder`	`insert(int offset, float f)`	va a`float`Inserta la representación de cadena del argumento en esta secuencia.
`StringBuilder`	`insert(int offset, int i)`	El segundo`int`Inserta la representación de cadena del argumento en esta secuencia.
`StringBuilder`	`insert(int offset, long l)`	va a`long`Inserta la representación de cadena del argumento en esta secuencia.
`StringBuilder`	`insert(int dstOffset, CharSequence s)`	La especificada`CharSequence`Inserta en esta secuencia.
`StringBuilder`	`insert(int dstOffset, CharSequence s, int start, int end)`	La especificada`CharSequence`La secuencia se inserta en esta secuencia.
`StringBuilder`	`insert(int offset, Object obj)`	va a`Object`Inserta la representación de cadena del argumento en esta secuencia de caracteres.
`StringBuilder`	`insert(int offset, String str)`	Inserta la cadena en esta secuencia de caracteres.
`int`	`lastIndexOf(String str)`	Devuelve el índice en la cadena de la última aparición de la subcadena especificada.
`int`	`lastIndexOf(String str, int fromIndex)`	Devuelve el índice en la cadena de la última aparición de la subcadena especificada, buscando hacia atrás desde el índice especificado.
`int`	`length()`	Devuelve la longitud (número de caracteres).
`int`	`offsetByCodePoints(int index, int codePointOffset)`	Devuelve el índice en esta secuencia que comienza en el`index`desplazamiento`codePointOffset`puntos de código.
`StringBuilder`	`replace(int start, int end, String str)`	Usando la especificada`String`Los caracteres de la especificada reemplazan los caracteres de una subcadena de esta secuencia.
`StringBuilder`	`reverse()`	Hace que esta secuencia de caracteres sea reemplazada por la inversa de la secuencia.
`void`	`setCharAt(int index, char ch)`	El carácter en el índice especificado se establece a`ch` 。
`void`	`setLength(int newLength)`	Establece la longitud de la secuencia de caracteres.
`CharSequence`	`subSequence(int start, int end)`	Devuelve una nueva secuencia de caracteres que es una subsecuencia de esta secuencia.
`String`	`substring(int start)`	Devuelve una nueva`String`, que contiene una subsecuencia de los caracteres actualmente contenidos en esta secuencia de caracteres.
`String`	`substring(int start, int end)`	Devuelve una nueva`String`, que contiene una subsecuencia de los caracteres actualmente contenidos en esta secuencia.
`void`	`trimToSize()`	Intenta reducir el espacio de almacenamiento utilizado para la secuencia de caracteres.

Clase que declara el método java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Interfaz que declara el método java.lang.CharSequence
charAt, chars, codePoints, length, subSequence, toString

- Detalles del constructor
  - StringBuilder
```
public StringBuilder()
```
    Construye un StringBuilder que no contiene ningún carácter, con una capacidad inicial de 16 caracteres.
  - StringBuilder
```
public StringBuilder(int capacity)
```
    Construye un StringBuilder que no contiene caracteres ycapacityla capacidad inicial especificada por el parámetro.
    
    Parámetros
    
    capacity- Capacidad inicial.
    
    Excepciones
    
    NegativeArraySizeException- sicapacityel parámetro es menor que0 。
  - StringBuilder
```
public StringBuilder(String str)
```
    Construye un generador de cadenas inicializado con el contenido de la cadena especificada. la capacidad inicial de StringBuilder es16más la longitud del parámetro de cadena.
    
    Parámetros
    
    str- El contenido inicial del búfer.
  - StringBuilder
```
public StringBuilder(CharSequence seq)
```
    Construye un generador de cadenas que contiene con el especificadoCharSequenceLos mismos caracteres. la capacidad inicial de StringBuilder es16másCharSequencela longitud del parámetro.
    
    Parámetros
    
    seq- La secuencia a copiar.
- Detalles del método
  - compareTo
```
public int compareTo(StringBuilder another)
```
    StringBuilderCompara dos lexicográficamenteStringBuilderinstancia. Este método sigueCharSequence.compare(this, another)las mismas reglas de comparación lexicográfica definidas en el método.
    Para una comparación de cadenas de grano fino y sensible a la configuración regional, consulteCollator 。
    
    Specified by:
    
    compareToEn la interfazComparable<StringBuilder>
    
    Parámetros
    
    another- con el que se va a comparar.StringBuilder
    
    Resultado
    
    Valor0Si elStringBuildercontiene con el parámetroStringBuilderla misma secuencia de caracteres; Si elStringBuilderlexicográficamente menor queStringBuilderel parámetro,StringBuilderentero negativo; Si elStringBuilderlexicográficamente mayor queStringBuilderel parámetro,StringBuilderentero positivo.
    
    Desde la versión:
    
    11
  - append
```
public StringBuilder append(Object obj)
```
    AñadeObjectLa representación de cadena del argumento.
    El efecto general es el mismo que si el métodoString.valueOf(Object)convirtiera el parámetro en una cadenaExactamente igual，entonces los caracteres de esta cadena sonappended 。
    
    Parámetros
    
    obj - Object 。
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(String str)
```
    Añade la cadena especificada a esta secuencia de caracteres.
    se añaden en ordenStringlos caracteres del parámetro, aumentando la longitud de esta secuencia en la longitud del parámetro. SistrSínull，entonces se añaden cuatro caracteres"null" 。
    
    Seanes ejecutarappendla longitud de esta secuencia de caracteres antes del método. Sikmenor quen，entonces el índice en la nueva secuencia de caractereskel carácter en la posición es igual al índice en la antigua secuencia de caractereskel carácter en la posición; de lo contrario, es igual al parámetrostrel índice enknel carácter en la posición.
    
    Parámetros
    
    str- Una cadena.
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(StringBuffer sb)
```
    La especificadaStringBufferAñade a esta secuencia.
    StringBufferLos caracteres del parámetro se añaden a esta secuencia en orden, aumentando la longitud de esta secuencia en la longitud del parámetro. SisbSínull, entonces los cuatro caracteres"null"se añaden a esta secuencia.
    
    Seanes ejecutarappendla longitud de esta secuencia de caracteres antes del método. Sikmenor quen，entonces el índice en la nueva secuencia de caractereskel carácter en la posición es igual al índice en la antigua secuencia de caractereskel carácter en la posición; de lo contrario, es igual al parámetrosbel índice enknel carácter en la posición.
    
    Parámetros
    
    sb- Lo que se va a añadirStringBuffer 。
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(CharSequence s)
```
    Descripción copiada de la interfaz:Appendable
    
    Añade la secuencia de caracteres especificada a esteAppendable 。
    según qué clase implemente la secuencia de caracterescsq, puede que no se añada la secuencia completa. Por ejemplo, sicsqSíCharBuffer，Entonces, la subsecuencia que se va a añadir está definida por la posición y el límite del búfer.
    
    Specified by:
    
    appendEn la interfazAppendable
    
    Parámetros
    
    s- la secuencia de caracteres que se va a añadir. SicsqSínull, entonces los cuatro caracteres"null"se añadirán a este Appendable.
    
    Resultado
    
    ReferenciaAppendable
  - append
```
public StringBuilder append(CharSequence s,
                            int start,
                            int end)
```
    La especificadaCharSequenceLa secuencia se añade a esta secuencia.
    desde el índicestartel parámetro que comienzaslos caracteres se añaden en orden al contenido de esta secuencia, hasta el índice (exclusivo)end 。 la longitud de esta secuencia aumenta en el valorend - start 。
    
    Seanes ejecutarappendla longitud de esta secuencia de caracteres antes del método. entonces, sikmenor quen, entonces el índice en dicha secuencia de caracteresen la posición kel carácter se vuelve igual al índice en esta secuenciakel carácter en la posición; de lo contrario, es igual al parámetrosel índice enk + start-nen la posicións 。
    
    SisSínull, entonces este método añade caracteres como si el parámetro s contuviera cuatro caracteres"null"la secuencia"null" 。
    
    Specified by:
    
    appendEn la interfazAppendable
    
    Parámetros
    
    s- La secuencia que se va a añadir.
    
    startÍndice inicial de la subsecuencia a agregar.
    
    endÍndice final de la subsecuencia a agregar.
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    IndexOutOfBoundsException- sistartes negativo, ostartmayor queendoendmayor ques.length()
  - append
```
public StringBuilder append(char[] str)
```
    va acharLa representación de cadena del argumento array se añade a esta secuencia.
    Los caracteres del parámetro de matriz se añaden en orden al contenido de esta secuencia. La longitud de esta secuencia aumenta en la longitud del parámetro.
    
    El efecto general es como si mediante el métodoString.valueOf(char[])convirtiera el parámetro en una cadenade la misma manera, y los caracteres de la cadena son luego los de esta secuencia de caracteresappended 。
    
    Parámetros
    
    str- El carácter que se va a añadir.
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(char[] str,
                            int offset,
                            int len)
```
    va acharLa representación de cadena del subarray del argumento array se añade a esta secuencia.
    desde el índiceoffsetinicialcharmatrizstrLos caracteres se añaden en orden al contenido de esta secuencia. La longitud de esta secuencia se incrementa en el valorlen 。
    
    El efecto general es como si mediante el métodoString.valueOf(char[],int,int)convirtiera el parámetro en una cadenade la misma manera, y los caracteres de la cadena con respecto a esta secuencia de caracteresentonces esappended 。
    
    Parámetros
    
    str- El carácter que se va a añadir.
    
    offset- El primero que se va a añadir.charel índice.
    
    len- Lo que se va a añadircharla cantidad.
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    IndexOutOfBoundsException- si esoffset < 0olen < 0ooffset+len > str.length
  - append
```
public StringBuilder append(boolean b)
```
    va abooleanLa representación de cadena del argumento se añade a la secuencia.
    El efecto general es como si mediante el métodoString.valueOf(boolean)convirtiera el parámetro en una cadenade la misma manera, y los caracteres de la cadena son luego los de esta secuencia de caracteresappended 。
    
    Parámetros
    
    b - boolean 。
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(char c)
```
    va acharLa representación de cadena del argumento se añade a esta secuencia.
    el parámetro se añade al contenido de esta secuencia. la longitud de esta secuencia aumenta1 。
    
    El efecto general es como si mediante el métodoString.valueOf(char)convirtiera el parámetro en una cadenade la misma manera，y los caracteres de esta cadena son posteriormente los de esta secuencia de caracteresappended 。
    
    Specified by:
    
    appendEn la interfazAppendable
    
    Parámetros
    
    c - a char 。
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(int i)
```
    va aintLa representación de cadena del argumento se añade a esta secuencia.
    El efecto general es el mismo que si el métodoString.valueOf(int)convirtiera el parámetro en una cadenaExactamente igual，entonces los caracteres de esta cadena sonappended 。
    
    Parámetros
    
    i - int 。
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(long lng)
```
    va alongLa representación de cadena del argumento se añade a esta secuencia.
    El efecto general es el mismo que si el métodoString.valueOf(long)convirtiera el parámetro en una cadenaExactamente igual，entonces los caracteres de esta cadena sonappended 。
    
    Parámetros
    
    lng - long 。
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(float f)
```
    va afloatLa representación de cadena del argumento se añade a esta secuencia.
    El efecto general es como si mediante el métodoString.valueOf(float)convirtiera el parámetro en una cadenade la misma manera, y los caracteres de la cadena son luego los de esta secuencia de caracteresappended 。
    
    Parámetros
    
    f - a float 。
    
    Resultado
    
    Una referencia a este objeto.
  - append
```
public StringBuilder append(double d)
```
    va adoubleLa representación de cadena del argumento se añade a esta secuencia.
    El efecto general es como si mediante el métodoString.valueOf(double)convirtiera el parámetro en una cadenade la misma manera, y los caracteres de la cadena son luego los de esta secuencia de caracteresappended 。
    
    Parámetros
    
    d - a double 。
    
    Resultado
    
    Una referencia a este objeto.
  - appendCodePoint
```
public StringBuilder appendCodePoint(int codePoint)
```
    va acodePointLa representación de cadena del argumento se añade a esta secuencia.
    el parámetro se añade al contenido de esta secuencia. la longitud de esta secuencia aumentaCharacter.charCount(codePoint) 。
    
    El efecto general es como si mediante el métodoCharacter.toChars(int)convertir el parámetro como si fueracharun array, y los caracteres de dicho arrayentonces esappended 。
    
    Parámetros
    
    codePoint- Punto de código Unicode
    
    Resultado
    
    Una referencia a este objeto.
    
    Desde la versión:
    
    1.5
  - delete
```
public StringBuilder delete(int start,
                            int end)
```
    Elimina los caracteres en una subcadena de esta secuencia. la subcadena desde el especificadostartcomienza, y si no existe tal carácter, se extiende hasta el índiceend - 1en el carácter o al final de la secuencia. Sistartigual aend，no se realiza ningún cambio.
    
    Parámetros
    
    start- Índice inicial, inclusive.
    
    end- Índice final, exclusivo.
    
    Resultado
    
    este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- sistartes negativo, mayor quelength()，o mayor queend 。
  - deleteCharAt
```
public StringBuilder deleteCharAt(int index)
```
    Elimina el de la posición especificada en este ordenchar 。 esta secuencia por unocharse acorta.
    Nota: si el carácter en el índice dado es un carácter suplementario, este método no elimina el carácter completo. si necesita manejar correctamente los caracteres suplementarios, mediante la llamada aCharacter.charCount(thisSequence.codePointAt(index))Determinar los que se van a eliminarcharel número de s, dondethisSequencees esta secuencia.
    
    Parámetros
    
    index- El número de índice que se va a eliminar.char
    
    Resultado
    
    este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- siindexes negativo o mayor o igual quelength() 。
  - replace
```
public StringBuilder replace(int start,
                             int end,
                             String str)
```
    Usando la especificadaStringLos caracteres de la especificada reemplazan los caracteres de una subcadena de esta secuencia. la subcadena desde el especificadostartComienza; si no existe tal carácter, se extiende hasta el índiceend - 1en el carácter o al final de la secuencia. Primero se eliminan los caracteres de la subcadena, y luego enStringinsertar lo especificadostart 。 (Si es necesario, se ampliará esta secuencia para acomodar la cadena especificada).
    
    Parámetros
    
    start- Índice inicial, inclusive.
    
    end- Índice final, exclusivo.
    
    str- La cadena que reemplazará el contenido anterior.
    
    Resultado
    
    este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- sistartes negativo, mayor quelength()，o mayor queend 。
  - insert
```
public StringBuilder insert(int index,
                            char[] str,
                            int offset,
                            int len)
```
    va astrInserta la representación de cadena de la submatriz del argumento de matriz en esta secuencia. El subarreglo desde el especificadooffsetcomienza y se extiendelen char s. los caracteres del subarreglo enindexen la posición indicada se insertan en esta secuencia. la longitud de esta secuencia aumentalen char s.
    
    Parámetros
    
    index- La posición en la que se inserta la submatriz.
    
    str - charArreglo.
    
    offset- El primero de la submatriz que se va a insertar.charel índice.
    
    len- de la submatriz que se va a insertar.charEl número de s.
    
    Resultado
    
    Este objeto
    
    Excepciones
    
    StringIndexOutOfBoundsException- siindexes negativo o mayor quelength(), ooffsetolenes negativo, o(offset+len)mayor questr.length 。
  - insert
```
public StringBuilder insert(int offset,
                            Object obj)
```
    va aObjectInserta la representación de cadena del argumento en esta secuencia de caracteres.
    El efecto general es como si el segundo parámetro se convirtiera mediante el métodoString.valueOf(Object)convertir en una cadenaExactamente igual, y los caracteres de esa cadena en la secuencia de caracteres en el desplazamiento especificado soninserted 。
    
    offsetEl parámetro debe ser mayor o igual a0, y menor o igual que la de esta secuencialength 。
    
    Parámetros
    
    offset- Desplazamiento.
    
    obj - Object 。
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int offset,
                            String str)
```
    Inserta la cadena en esta secuencia de caracteres.
    StringLos caracteres del argumento se insertan en orden en esta secuencia en el desplazamiento especificado, desplazando hacia arriba cualquier carácter que estuviera originalmente por encima de esa posición y aumentando la longitud de esta secuencia en la longitud del argumento. SistrSínull, entonces los cuatro caracteres"null"Insertado en esta secuencia.
    
    el índice en la nueva secuencia de caractereskel carácter en la posición es igual a:
    
    Sikmenor queoffset, entonces el índice en la antigua secuencia de caractereskel carácter en la posición
    
    Parámetrosstrcuyo índice esk -offsetel carácter, sikno es menor queoffsetpero menor queoffset+str.length()
    
    el índice en la antigua secuencia de caracteres esk -str.length()el carácter, sikno es menor queoffset+str.length()
    
    offsetEl parámetro debe ser mayor o igual a0, y menor o igual que la de esta secuencialength 。
    Parámetros
    
    offset- Desplazamiento.
    
    str- Una cadena.
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int offset,
                            char[] str)
```
    va acharInserta la representación de cadena del argumento de matriz en esta secuencia.
    Los caracteres del argumento de matriz enoffsetla posición indicada se insertan en el contenido de esta secuencia. La longitud de esta secuencia aumenta en la longitud del parámetro.
    
    El efecto general es como si el segundo argumento se convirtiera en una cadena mediante el métodoString.valueOf(char[])convertir en una cadenade la misma manera, y los caracteres de esa cadena en el desplazamiento especificado se insertan en esta secuencia de caracteresinserted 。
    
    offsetEl parámetro debe ser mayor o igual a0, y menor o igual que la de esta secuencialength 。
    
    Parámetros
    
    offset- Desplazamiento.
    
    str- Matriz de caracteres.
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int dstOffset,
                            CharSequence s)
```
    La especificadaCharSequenceInserta en esta secuencia.
    CharSequenceLos caracteres del argumento s se insertan en orden en esta secuencia en el desplazamiento especificado, desplazando hacia arriba cualquier carácter que estuviera originalmente por encima de esa posición y aumentando la longitud de esta secuencia en la longitud del argumento s.
    
    El resultado de este método es el mismo que el de invocar el métodoinsert(dstOffset, s, 0, s.length())Exactamente igual 。
    
    SisSínull, entonces los cuatro caracteres"null"insertar en esta secuencia.
    
    Parámetros
    
    dstOffset- Desplazamiento.
    
    s- La secuencia que se va a insertar.
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    IndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int dstOffset,
                            CharSequence s,
                            int start,
                            int end)
```
    La especificadaCharSequenceLa secuencia se inserta en esta secuencia.
    la subsecuencia del argumentosa través de lo especificadostartyendse inserta, de modo que en el desplazamiento de destino especificado de esta secuencia, cualquier carácter que estuviera originalmente por encima de esa posición se desplaza hacia arriba. la longitud de esta secuencia aumenta enend - start 。
    
    el índice en esta secuenciakel carácter en la posición se convierte en igual a:
    
    Sikmenor quedstOffset, entonces el índice en esta secuenciakel carácter en la posición
    
    Parámetrosscuyo índice esk +start-dstOffsetel carácter, sikes mayor o igual quedstOffsetpero menor quedstOffset+end-start
    
    Sikes mayor o igual quedstOffset+end-start, entonces el índice en esta secuencia esk -(end-start)el carácter
    
    dstOffsetEl parámetro debe ser mayor o igual a0, y es menor o igual que la de esta secuencialength 。
    
    El parámetro start debe ser no negativo y no mayor queend 。
    
    El parámetro final debe ser mayor o igual questart, y menor o igual que la longitud de s.
    
    SisSínull, entonces este método inserta caracteres, como si el parámetro s contuviera cuatro caracteres"null"la secuencia"null" 。
    Parámetros
    
    dstOffset- El desplazamiento en esta secuencia.
    
    s- La secuencia que se va a insertar.
    
    startÍndice inicial de la subsecuencia a insertar.
    
    endÍndice final de la subsecuencia a insertar.
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    IndexOutOfBoundsException- sidstOffsetes negativo o mayor quethis.length(), ostartoendes negativo, ostartmayor queendoendmayor ques.length()
  - insert
```
public StringBuilder insert(int offset,
                            boolean b)
```
    va abooleanInserta la representación de cadena del argumento en esta secuencia.
    El efecto general es como si el segundo parámetro se convirtiera mediante el métodoString.valueOf(boolean)convertir en una cadenaExactamente igual, y los caracteres de dicha cadena entran en esta secuencia de caracteres en el desplazamiento especificado, y luegoinserted 。
    
    offsetEl parámetro debe ser mayor o igual a0, y menor o igual que la de esta secuencialength 。
    
    Parámetros
    
    offset- Desplazamiento.
    
    b - a boolean 。
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int offset,
                            char c)
```
    va acharInserta la representación de cadena del argumento en esta secuencia.
    El efecto general es el mismo que mediante el método deString.valueOf(char)convertir el segundo parámetro en una cadenaExactamente igual, y los caracteres de dicha cadena entran en dicha secuencia de caracteres en el desplazamiento especificado, y luegoinserted 。
    
    offsetEl parámetro debe ser mayor o igual a0, y menor o igual que la de esta secuencialength 。
    
    Parámetros
    
    offset- Desplazamiento.
    
    c - a char 。
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    IndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int offset,
                            int i)
```
    El segundointInserta la representación de cadena del argumento en esta secuencia.
    El efecto general es como si el segundo argumento se convirtiera en una cadena mediante el métodoString.valueOf(int)convertir en una cadenade la misma manera, y los caracteres de dicha cadena están en la secuencia de caracteres en el desplazamiento especificadoinserted 。
    
    offsetEl parámetro debe ser mayor o igual a0, y es menor o igual que la de esta secuencialength 。
    
    Parámetros
    
    offset- Desplazamiento.
    
    i - int 。
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int offset,
                            long l)
```
    va alongInserta la representación de cadena del argumento en esta secuencia.
    El efecto total es exactamente el mismo que si el segundo parámetro se convirtiera en una cadena mediante el métodoString.valueOf(long), y los caracteres de dicha cadena luegoinsertedse insertan en la secuencia de caracteres en el desplazamiento indicado.
    
    offsetEl parámetro debe ser mayor o igual a0, y es menor o igual que la de esta secuencialength 。
    
    Parámetros
    
    offset- Desplazamiento.
    
    l - long 。
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int offset,
                            float f)
```
    va afloatInserta la representación de cadena del argumento en esta secuencia.
    El efecto general es el mismo que mediante el método deString.valueOf(float)convertir el segundo parámetro en una cadenaExactamente igual, y los caracteres de esa cadena en la secuencia de caracteres en el desplazamiento especificado soninserted 。
    
    offsetEl parámetro debe ser mayor o igual a0, y menor o igual que la de esta secuencialength 。
    
    Parámetros
    
    offset- Desplazamiento.
    
    f - float 。
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- Si el desplazamiento no es válido.
  - insert
```
public StringBuilder insert(int offset,
                            double d)
```
    va adoubleInserta la representación de cadena del argumento en esta secuencia.
    El efecto general es el mismo que mediante el método deString.valueOf(double)convertir el segundo parámetro en una cadenaExactamente igual, y los caracteres de esa cadena en la secuencia de caracteres en el desplazamiento especificado soninserted 。
    
    offsetEl parámetro debe ser mayor o igual a0, y es menor o igual que la de esta secuencialength 。
    
    Parámetros
    
    offset- Desplazamiento.
    
    d - a double 。
    
    Resultado
    
    Una referencia a este objeto.
    
    Excepciones
    
    StringIndexOutOfBoundsException- Si el desplazamiento no es válido.
  - indexOf
```
public int indexOf(String str)
```
    Devuelve el índice en la cadena de la primera aparición de la subcadena especificada.
    El índice devuelto es el valor mínimok, donde:
    
    this.toString().startsWith(str, k)
    Si no existe tal valork, entonces-1devueltos.
    Parámetros
    
    str- La subcadena que se va a buscar.
    
    Resultado
    
    El índice de la primera aparición de la subcadena especificada, si no existe tal caso,-1 。
  - indexOf
```
public int indexOf(String str,
                   int fromIndex)
```
    Devuelve el índice en la cadena de la primera aparición de la subcadena especificada, comenzando en el índice especificado.
    El índice devuelto es el valor mínimok, donde:
    
    k >= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)
    Si no existe tal valork, entonces-1devueltos.
    Parámetros
    
    str- La subcadena que se va a buscar.
    
    fromIndex- El índice desde el que se inicia la búsqueda.
    
    Resultado
    
    El índice de la primera aparición de la subcadena especificada a partir del índice especificado, si no existe tal caso,-1 。
  - lastIndexOf
```
public int lastIndexOf(String str)
```
    Devuelve el índice en la cadena de la última aparición de la subcadena especificada. La última aparición de la cadena vacía “” se considera que ocurre en el valor de índicethis.length() 。
    El índice devuelto es el valor máximok, donde:
    
    this.toString().startsWith(str, k)
    Si no existe tal valork, entonces-1devueltos.
    Parámetros
    
    str- La subcadena que se va a buscar.
    
    Resultado
    
    El índice de la última aparición de la subcadena especificada, si no existe tal caso,-1 。
  - lastIndexOf
```
public int lastIndexOf(String str,
                       int fromIndex)
```
    Devuelve el índice en la cadena de la última aparición de la subcadena especificada, buscando hacia atrás desde el índice especificado.
    El índice devuelto es el valor máximok, donde:
    
    k <= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)
    Si no existe tal valork, entonces-1devueltos.
    Parámetros
    
    str- La subcadena que se va a buscar.
    
    fromIndex- El índice desde el que se inicia la búsqueda.
    
    Resultado
    
    El índice de la última aparición de la subcadena especificada, buscando hacia atrás desde el índice especificado, si no existe tal caso,-1 。
  - reverse
```
public StringBuilder reverse()
```
    Hace que esta secuencia de caracteres sea reemplazada por la inversa de la secuencia. Si la secuencia contiene algún par de sustitutos, estos pares de sustitutos se tratan como un único carácter para la operación inversa. Por lo tanto, el orden de los sustitutos altos y bajos nunca se invierte. Seanes ejecutarreverseLa longitud en caracteres de dicha secuencia de caracteres antes del método (nocharla longitud en valores). Luego, el índice en la nueva secuencia de caractereskel carácter en la posición es igual al índice en la antigua secuencia de caracteresnk-1el carácter en la posición.
    Tenga en cuenta que la operación inversa puede producir pares de sustitutos que, antes de la operación, eran sustitutos bajos y altos no emparejados. Por ejemplo, invertir “\ uDC00 \ uD800” genera “\ uD800 \ uDC00”, que es un par de sustitutos válido.
    
    Resultado
    
    Una referencia a este objeto.
  - length
```
public int length()
```
    Devuelve la longitud (número de caracteres).
    
    Specified by:
    
    lengthEn la interfazCharSequence
    
    Resultado
    
    La longitud de la secuencia de caracteres representada actualmente por este objeto
  - capacity
```
public int capacity()
```
    Devuelve la capacidad actual. La capacidad es la cantidad de almacenamiento disponible para los caracteres recién insertados; si se excede dicha capacidad, se realizará una asignación.
    
    Resultado
    
    La capacidad actual.
  - ensureCapacity
```
public void ensureCapacity(int minimumCapacity)
```
    Asegura que la capacidad sea al menos igual al mínimo especificado. Si la capacidad actual es menor que el parámetro, se asigna una nueva matriz interna con mayor capacidad. La nueva capacidad es la mayor de:
    
    minimumCapacityel parámetro.
    
    el doble de la capacidad anterior, más2 。
    
    SiminimumCapacitySi el parámetro no es positivo, este método no realiza ninguna operación y simplemente regresa. Tenga en cuenta que las operaciones posteriores sobre este objeto pueden reducir la capacidad real por debajo de la capacidad solicitada aquí.
    Parámetros
    
    minimumCapacity- La capacidad mínima requerida.
  - trimToSize
```
public void trimToSize()
```
    Intenta reducir el espacio de almacenamiento utilizado para la secuencia de caracteres. Si el búfer es más grande de lo necesario para contener su secuencia de caracteres actual, se puede ajustar su tamaño para que sea más eficiente en espacio. Llamar a este método puede (pero no necesariamente) afectar a llamadas posteriorescapacity()El valor devuelto por el método.
  - setLength
```
public void setLength(int newLength)
```
    Establece la longitud de la secuencia de caracteres. La secuencia se cambia a una nueva secuencia de caracteres cuya longitud está especificada por el parámetro. Para cada índice no negativo menor quek newLength, en el índice de la nueva secuencia de caractereskel carácter en esa posición es el mismo que en el índice de la secuencia antiguakSikmenor que la longitud de la secuencia de caracteres original; de lo contrario, es un carácter nulo'\u0000' 。 En otras palabras, sinewLengthSi el parámetro es menor que la longitud actual, la longitud se cambiará a la longitud especificada.
    SinewLengthSi el parámetro es mayor o igual que la longitud actual, se añadirán suficientes caracteres nulos ('\u0000'), para que la longitud seanewLengthel parámetro.
    
    newLengthEl parámetro debe ser mayor o igual a0 。
    
    Parámetros
    
    newLength- nueva longitud
    
    Excepciones
    
    IndexOutOfBoundsException- sinewLengthEl parámetro es negativo.
  - charAt
```
public char charAt(int index)
```
    Devuelve el de esta secuencia en el índice especificado.charvalores. El primercharvalor en el índice0, el siguiente en el índice1, y así sucesivamente, como se muestra en la indexación de matrices.
    El parámetro index debe ser mayor o igual que0, y menor que la longitud de esta secuencia.
    
    Si el valor especificado por el índicecharessurrogate, se devuelve el valor sustituto.
    
    Specified by:
    
    charAtEn la interfazCharSequence
    
    Parámetros
    
    index- el índice delcharvalor deseado.
    
    Resultado
    
    en el índice especificadocharvalores.
    
    Excepciones
    
    IndexOutOfBoundsException- siindexes negativo o mayor o igual quelength() 。
  - codePointAt
```
public int codePointAt(int index)
```
    Devuelve el carácter (punto de código Unicode) en el índice especificado. El índice hace referencia acharvalor (unidad de código Unicode), en el rango desde0llegarCharSequence.length() - 1 。
    Si el valor especificado en el índice dadocharestá en el rango de sustituto alto, y el índice siguiente es menor que la longitud de esta secuencia, y elcharvalor está en el rango de sustituto bajo, entonces se devuelve el punto de código complementario correspondiente a este par de sustitutos. De lo contrario, se devuelve elcharvalores.
    
    Parámetros
    
    index - charíndice del valor.
    
    Resultado
    
    indexel valor de punto de código del carácter en
    
    Excepciones
    
    IndexOutOfBoundsException- siindexEl argumento es negativo o no menor que la longitud de esta secuencia.
  - codePointBefore
```
public int codePointBefore(int index)
```
    Devuelve el carácter (punto de código Unicode) antes del índice especificado. El índice hace referencia acharvalor (unidad de código Unicode), en el rango desde1llegarCharSequence.length() 。
    SicharSi el valor(index - 1)está en el rango de sustituto bajo,(index - 2)no es negativo, ycharSi el valor(index - 2)está en el rango de sustituto alto, entonces se devuelve el valor de punto de código complementario del par de sustitutos. SicharSi el valorindex - 1Si es un sustituto bajo no emparejado o un sustituto alto, se devuelve el valor sustituto mencionado.
    
    Parámetros
    
    index- El índice posterior al punto de código que se debe devolver.
    
    Resultado
    
    El valor del punto de código Unicode anterior al índice dado.
    
    Excepciones
    
    IndexOutOfBoundsException- siindexEl argumento es menor que 1 o mayor que la longitud de esta secuencia.
  - codePointCount
```
public int codePointCount(int beginIndex,
                          int endIndex)
```
    Devuelve el número de puntos de código Unicode en el rango de texto especificado de esta secuencia. El rango de texto comienza en el especificadobeginIndex, y se extiende hasta el caráctercharen el índiceendIndex - 1 。 Por lo tanto, la longitud del rango de texto (encharcaracteres) esendIndex-beginIndex 。 Los sustitutos no emparejados en esta secuencia se cuentan como un punto de código cada uno.
    
    Parámetros
    
    beginIndex- El primero del rango de texto.charel índice.
    
    endIndex- El último del rango de texto.charEl índice posterior a.
    
    Resultado
    
    El número de puntos de código Unicode en el rango de texto especificado
    
    Excepciones
    
    IndexOutOfBoundsException- sibeginIndexes negativo, oendIndexmayor que la longitud de esta secuencia, obeginIndexmayor queendIndex 。
  - offsetByCodePoints
```
public int offsetByCodePoints(int index,
                              int codePointOffset)
```
    Devuelve el índice en esta secuencia que comienza en elindexdesplazamientocodePointOffsetpuntos de código. indexycodePointOffsetLos sustitutos no emparejados en el rango de texto dado se cuentan como un punto de código cada uno.
    
    Parámetros
    
    index- El índice que se va a desplazar.
    
    codePointOffset- El desplazamiento en puntos de código.
    
    Resultado
    
    el índice en esta secuencia
    
    Excepciones
    
    IndexOutOfBoundsException- siindexes negativo o mayor que la longitud de esta secuencia, o sicodePointOffsetes positivo y desdeindexla subcadena que comienza enindextiene menos decodePointOffsetpunto de código, o sicodePointOffsetes negativo yindexla subcadena anteriorindexmenor que el valor absolutocodePointOffsetpuntos de código.
  - getChars
```
public void getChars(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)
```
    Copia los caracteres de esta secuencia en la matriz de caracteres de destinodst 。 El primer carácter a copiar es el índicesrcBegin ; El último carácter a copiar está en el índicesrcEnd-1 。 El número total de caracteres a copiar essrcEnd-srcBegin 。 Los caracteres se copian adstde la subcadenadstdesde el índicedstBegincomienza y termina en el índice:
    dstbegin + (srcEnd-srcBegin) - 1
    Parámetros
    
    srcBegin- Inicia la copia en este desplazamiento.
    
    srcEnd- Detiene la copia en este desplazamiento.
    
    dst- La matriz a la que se copiarán los datos.
    
    dstBegin- desplazamiento adst 。
    
    Excepciones
    
    IndexOutOfBoundsException- si se cumple cualquiera de las siguientes condiciones:
    
    srcBegines negativo
    
    dstBegines negativo
    
    srcBeginel parámetro es mayor quesrcEndel parámetro.
    
    srcEndmayor quethis.length() 。
    
    dstBegin+srcEnd-srcBeginmayor quedst.length
  - setCharAt
```
public void setCharAt(int index,
                      char ch)
```
    El carácter en el índice especificado se establece ach 。 Esta secuencia se modifica para representar una nueva secuencia de caracteres igual a la anterior, excepto que contiene enchel carácterindex 。
    El parámetro index debe ser mayor o igual que0, y menor que la longitud de esta secuencia.
    
    Parámetros
    
    index- El índice del carácter que se va a modificar.
    
    ch- Nuevo carácter.
    
    Excepciones
    
    IndexOutOfBoundsException- siindexes negativo o mayor o igual quelength() 。
  - substring
```
public String substring(int start)
```
    Devuelve una nuevaString, que contiene una subsecuencia de los caracteres actualmente contenidos en esta secuencia de caracteres. La subcadena comienza en el índice especificado y se extiende hasta el final de esta secuencia.
    
    Parámetros
    
    start- Índice inicial, inclusive.
    
    Resultado
    
    - Nueva cadena.
    
    Excepciones
    
    StringIndexOutOfBoundsException- sistartmenor que cero, o mayor que la longitud de este objeto.
  - subSequence
```
public CharSequence subSequence(int start,
                                int end)
```
    Devuelve una nueva secuencia de caracteres que es una subsecuencia de esta secuencia.
    La forma de llamar a este método
    
    sb.subSequence(begin, end)
    el comportamiento es exactamente el mismo que llamar a
    sb.substring(begin, end)
    Se proporciona este método para que esta clase pueda implementarCharSequencela interfaz.
    Specified by:
    
    subSequenceEn la interfazCharSequence
    
    Parámetros
    
    start- Índice inicial, inclusive.
    
    end- Índice final, exclusivo.
    
    Resultado
    
    La subsecuencia especificada.
    
    Excepciones
    
    IndexOutOfBoundsException- sistartoendes negativo, siendmayor quelength(), o sistartmayor queend
  - substring
```
public String substring(int start,
                        int end)
```
    Devuelve una nuevaString, que contiene una subsecuencia de los caracteres actualmente contenidos en esta secuencia. la subcadena desde el especificadostartcomienza y se extiende al índiceend - 1el carácter en la posición.
    
    Parámetros
    
    start- Índice inicial, inclusive.
    
    end- Índice final, exclusivo.
    
    Resultado
    
    Nueva cadena.
    
    Excepciones
    
    StringIndexOutOfBoundsException- sistartoendes negativo o mayor quelength(), ostartmayor queend 。
  - chars
```
public IntStream chars()
```
    DevuelveintEl flujo de, para los de esta secuenciacharLos valores se extienden con ceros. cualquiera que se asigne acarácter de punto de código sustitutoson no interpretados.
    Cuando comienza la operación de flujo terminal, el flujo se vincula a esta secuencia (específicamente, para secuencias mutables, elspliteratorSílate-binding ）。 Si la secuencia se modifica durante esa operación, el resultado no está definido.
    
    Specified by:
    
    charsEn la interfazCharSequence
    
    Resultado
    
    Un IntStream de valores char de esta secuencia
    
    Desde la versión:
    
    9
  - codePoints
```
public IntStream codePoints()
```
    Devuelve un flujo de valores de puntos de código de esta secuencia. Cualquier par de sustitutos encontrado en la secuencia se combina, igual queCharacter.toCodePoint, y el resultado se pasa al flujo. Cualquier otra unidad de código (incluidos caracteres BMP normales, sustitutos no emparejados y unidades de código no definidas) se extiende con ceros aintvalor, y luego se pasa al flujo.
    Cuando comienza la operación de flujo terminal, el flujo se vincula a esta secuencia (específicamente, para secuencias mutables, elspliteratorSílate-binding ）。 Si la secuencia se modifica durante esa operación, el resultado no está definido.
    
    Specified by:
    
    codePointsEn la interfazCharSequence
    
    Resultado
    
    El IntStream de códigos Unicode apunta a esta secuencia.
    
    Desde la versión:
    
    9

Class StringBuilder

Resumen de constructores

Resumen de métodos

Clase que declara el método java.lang.Object

Interfaz que declara el método java.lang.CharSequence

Detalles del constructor

StringBuilder

StringBuilder

StringBuilder

StringBuilder

Detalles del método

compareTo

append

append

append

append

append

append

append

append

append

append

append

append

append

appendCodePoint

delete

deleteCharAt

replace

insert

insert

insert

insert

insert

insert

insert

insert

insert

insert

insert

insert

indexOf

indexOf

lastIndexOf

lastIndexOf

reverse

length

capacity

ensureCapacity

trimToSize

setLength

charAt

codePointAt

codePointBefore

codePointCount

offsetByCodePoints

getChars

setCharAt

substring

subSequence

substring

chars

codePoints