módulo  java.base
paquete  java.lang

Class StringBuffer

  • Todas las interfaces implementadas
    Serializable ， Appendable ， CharSequence ， Comparable<StringBuffer> 
    public final class StringBuffer
extends Object
implements Serializable, Comparable<StringBuffer>, CharSequence
    Seguro para hilos, secuencia de caracteres mutable. El búfer de cadenas es similar aString, pero se puede modificar. En cualquier momento contiene una secuencia de caracteres específica, pero la longitud y el contenido de la secuencia pueden cambiarse mediante ciertas llamadas a métodos.

    El búfer de cadenas puede ser utilizado por varios hilos. Estos métodos se sincronizan cuando es necesario, de modo que todas las operaciones sobre cualquier instancia particular se comportan como si ocurrieran en un orden serial, lo cual es coherente con el orden de las llamadas a métodos realizadas por cada hilo individual involucrado.

    StringBuffer: sus operaciones principales sonappendyinsertMétodos, que están sobrecargados para aceptar cualquier tipo de datos. Cada uno convierte efectivamente los datos proporcionados en una cadena y luego añade o inserta los caracteres de esa cadena en el búfer de cadenas. appendEl método siempre añade estos caracteres al final del búfer; insertEl método agrega caracteres en el punto especificado.

    Por ejemplo, sizrefiriéndose a su contenido actual como"start"el objeto búfer de cadenas, entonces la llamada al métodoz.append("le")hará que el búfer de cadenas contenga"startle", mientras quez.insert(4, "le")cambiará el búfer de cadenas para que contenga"starlet" 。

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

    Cada vez que se produce una operación que involucra una secuencia de origen (por ejemplo, agregar o insertar desde una secuencia de origen), esta clase se sincroniza solo en el búfer de cadenas en el que se ejecuta la operación, no en el origen. Tenga en cuenta que, aunqueStringBufferestá diseñado para ser usado de manera segura por varios hilos al mismo tiempo, pero si el constructor oappendoinsertSi la operación pasa una secuencia de origen compartida entre hilos, el código de llamada debe garantizar que la operación tenga una vista coherente e inmutable de la secuencia de origen durante la duración de la operación. Esto puede satisfacerse mediante el llamante que mantiene un bloqueo durante la llamada a la operación, mediante el uso de una secuencia de origen inmutable, o no compartiendo la secuencia de origen entre hilos.

    Cada búfer de cadenas tiene una capacidad. Siempre que la longitud de la secuencia de caracteres contenida en el búfer de cadenas no exceda la capacidad, no es necesario asignar una nueva matriz de búfer interna. Si el búfer interno se desborda, se agranda automáticamente.

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

    A partir de la versión JDK 5, esta clase ha sido complementada con una clase equivalente diseñada para un solo hilo,StringBuilder 。 Por lo general, se debe preferirStringBuilderclase, porque admite todas las mismas operaciones, pero es más rápida porque no realiza sincronización.

    API Note:
    StringBufferimplementaComparablepero no sobrescribeequals 。 Por lo tanto,StringBuffersu orden natural no es consistente con equals. SiStringBufferLos objetos se utilizan comoStringBufferclaves de este oSortedMapelementos,SortedSet 。 véaseComparable ， SortedMap, oSortedSetpara obtener más información.
    Desde la versión:
    1.0
    Véase también:
    StringBuilder ， String ， Serialized Form

    • Resumen de constructores

      Método constructor  
      Constructor Descripción
      StringBuffer()
      Construye un búfer de cadenas sin caracteres, con una capacidad inicial de 16 caracteres.
      StringBuffer​(int capacity)
      Construye un búfer de cadenas sin caracteres y con la capacidad inicial especificada.
      StringBuffer​(CharSequence seq)
      Construye un búfer de cadenas que contiene los mismos caracteres que el especificado.CharSequenceLos mismos caracteres.
      StringBuffer​(String str)
      Construye un búfer 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
      StringBuffer append​(boolean b)
      va abooleanLa representación de cadena del argumento se añade a la secuencia.
      StringBuffer append​(char c)
      va acharLa representación de cadena del argumento se añade a esta secuencia.
      StringBuffer append​(char[] str)
      va acharLa representación de cadena del argumento array se añade a esta secuencia.
      StringBuffer append​(char[] str, int offset, int len)
      va acharLa representación de cadena del subarray del argumento array se añade a esta secuencia.
      StringBuffer append​(double d)
      va adoubleLa representación de cadena del argumento se añade a esta secuencia.
      StringBuffer append​(float f)
      va afloatLa representación de cadena del argumento se añade a esta secuencia.
      StringBuffer append​(int i)
      va aintLa representación de cadena del argumento se añade a esta secuencia.
      StringBuffer append​(long lng)
      va alongLa representación de cadena del argumento se añade a esta secuencia.
      StringBuffer append​(CharSequence s)
      La especificadaCharSequenceAñade a esta secuencia.
      StringBuffer append​(CharSequence s, int start, int end)
      La especificadaCharSequenceSe añade la secuencia a esta secuencia.
      StringBuffer append​(Object obj)
      AñadeObjectLa representación de cadena del argumento.
      StringBuffer append​(String str)
      Añade la cadena especificada a esta secuencia de caracteres.
      StringBuffer append​(StringBuffer sb)
      La especificadaStringBufferAñade a esta secuencia.
      StringBuffer appendCodePoint​(int codePoint)
      va acodePointLa 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.charvalores.
      IntStream chars()
      DevuelveintEl flujo de, para los de esta secuenciacharLos 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​(StringBuffer another)
      StringBufferCompara dos lexicográficamenteStringBufferinstancia.
      StringBuffer delete​(int start, int end)
      Elimina los caracteres en una subcadena de esta secuencia.
      StringBuffer deleteCharAt​(int index)
      Elimina el de la posición especificada en este ordenchar 。
      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 destinodst 。
      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.
      StringBuffer insert​(int offset, boolean b)
      va abooleanInserta la representación de cadena del argumento en esta secuencia.
      StringBuffer insert​(int offset, char c)
      va acharInserta la representación de cadena del argumento en esta secuencia.
      StringBuffer insert​(int offset, char[] str)
      va acharInserta la representación de cadena del argumento de matriz en esta secuencia.
      StringBuffer 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.
      StringBuffer insert​(int offset, double d)
      va adoubleInserta la representación de cadena del argumento en esta secuencia.
      StringBuffer insert​(int offset, float f)
      va afloatInserta la representación de cadena del argumento en esta secuencia.
      StringBuffer insert​(int offset, int i)
      El segundointLa representación de cadena del argumento se inserta en esta secuencia.
      StringBuffer insert​(int offset, long l)
      va alongInserta la representación de cadena del argumento en esta secuencia.
      StringBuffer insert​(int dstOffset, CharSequence s)
      La especificadaCharSequenceInserta en esta secuencia.
      StringBuffer insert​(int dstOffset, CharSequence s, int start, int end)
      La especificadaCharSequenceLa secuencia se inserta en esta secuencia.
      StringBuffer insert​(int offset, Object obj)
      va aObjectLa representación de cadena del argumento se inserta en esta secuencia de caracteres.
      StringBuffer 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 offsetByCodePoints​(int index, int codePointOffset)
      Devuelve el índice en esta secuencia que comienza en elindexdesplazamientocodePointOffsetpuntos de código.
      StringBuffer replace​(int start, int end, String str)
      Usando la especificadaStringLos caracteres de la especificada reemplazan los caracteres de una subcadena de esta secuencia.
      StringBuffer 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 ach 。
      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 nuevaString, que contiene una subsecuencia de los caracteres actualmente contenidos en esta secuencia de caracteres.
      String substring​(int start, int end)
      Devuelve una nuevaString, 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.

    • Detalles del constructor

      • StringBuffer

        public StringBuffer()
        Construye un búfer de cadenas sin caracteres, con una capacidad inicial de 16 caracteres.

      • StringBuffer

        public StringBuffer​(int capacity)
        Construye un búfer de cadenas sin caracteres y con la capacidad inicial especificada.
        Parámetros
        capacity- Capacidad inicial.
        Excepciones
        NegativeArraySizeException- sicapacityel parámetro es menor que0 。

      • StringBuffer

        public StringBuffer​(String str)
        Construye un búfer de cadenas inicializado con el contenido de la cadena especificada. La capacidad inicial del búfer de cadenas es16más la longitud del parámetro de cadena.
        Parámetros
        str- El contenido inicial del búfer.

      • StringBuffer

        public StringBuffer​(CharSequence seq)
        Construye un búfer de cadenas que contiene los mismos caracteres que el especificado.CharSequenceLos mismos caracteres. La capacidad inicial del búfer de cadenas es16másCharSequencela longitud del parámetro.

        Si el especificadoCharSequencesi la longitud es menor o igual que cero, devuelve la capacidad de16un búfer vacío.

        Parámetros
        seq- La secuencia a copiar.
        Desde la versión:
        1.5

    • Detalles del método

      • compareTo

        public int compareTo​(StringBuffer another)
        StringBufferCompara dos lexicográficamenteStringBufferinstancia. Este método sigueCharSequence.compare(this, another)las mismas reglas de comparación lexicográfica definidas en el método.

        Para comparaciones de String sensibles a la configuración regional y de grano fino, consulteCollator 。

        Specified by:
        compareTo, la interfazComparable<StringBuffer>
        Implementation Note:
        Este método enthisSincronizado en (el objeto actual), pero no conthis StringBufferRealizar la sincronización, yStringBuffer anotherythis StringBufferrealiza la comparación.
        Parámetros
        another - StringBufferla comparaciónStringBuffer
        Resultado
        Valor0Si elStringBuffercontiene con el parámetroStringBufferla misma secuencia de caracteres; Si elStringBufferlexicográficamente menor queStringBufferel parámetro,StringBufferentero negativo; Si elStringBufferlexicográficamente mayor queStringBufferel parámetro,StringBufferentero positivo.
        Desde la versión:
        11

      • 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:
        • minimumCapacityargumento.
        • 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.
        Desde la versión:
        1.5

      • 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'), de modo que length seanewLengthel parámetro.

        newLengthEl parámetro debe ser mayor o igual a0 。

        Parámetros
        newLength- nueva longitud
        Excepciones
        IndexOutOfBoundsException- sinewLengthEl parámetro es negativo.
        Véase también:
        CharSequence.length()

      • 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() 。
        Véase también:
        CharSequence.length()

      • 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 del punto de código del carácter en
        Excepciones
        IndexOutOfBoundsException- siindexEl parámetro es negativo o no menor que la longitud de esta secuencia.
        Desde la versión:
        1.5

      • 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 después del punto de código que se debe devolver
        Resultado
        El valor del punto de código Unicode anterior al índice dado.
        Excepciones
        IndexOutOfBoundsException- siindexEl parámetro es menor que 1 o mayor que la longitud de esta secuencia.
        Desde la versión:
        1.5

      • 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 textocharel índice.
        endIndex- El último del rango de textocharEl índice posterior.
        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 。
        Desde la versión:
        1.5

      • 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 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 encodePointOffsetpunto de código menor quecodePointOffset, ocodePointOffsetes negativo yindexla subcadena anteriorindexmenor que el valor absoluto del valor absoluto decodePointOffsetpuntos de código.
        Desde la versión:
        1.5

      • getChars

        public void getChars​(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)
        Copia los caracteres de esta secuencia a 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 submatriz, desde el índicedstBegincomienza y termina en el índice: 
           dstbegin + (srcEnd-srcBegin) - 1
        Parámetros
        srcBegin- Comenzar la copia en este desplazamiento.
        srcEnd- Detener la copia en este desplazamiento.
        dst- El array al que se copiarán los datos.
        dstBegin- offset 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 。 la secuencia se modifica para representar una nueva secuencia de caracteres, que es la misma que la secuencia de caracteres original, excepto que contiene el carácterchen la posiciónindex 。

        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 a modificar.
        ch- Nuevo carácter.
        Excepciones
        IndexOutOfBoundsException- siindexes negativo o mayor o igual quelength() 。
        Véase también:
        CharSequence.length()

      • append

        public StringBuffer append​(Object obj)
        AñadeObjectLa representación de cadena del argumento.

        El efecto general es el mismo que mediante el método deString.valueOf(Object)convirtiera el parámetro en una cadenaExactamente igual, y los caracteres de esta cadena se añaden luegoappendeda esta secuencia de caracteres.

        Parámetros
        obj - Object 。
        Resultado
        Una referencia a este objeto.

      • append

        public StringBuffer append​(String str)
        Añade la cadena especificada a esta secuencia de caracteres.

        Stringlos caracteres del argumento se añaden en orden, aumentando la longitud de esta secuencia en la longitud del argumento. 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 StringBuffer append​(StringBuffer sb)
        La especificadaStringBufferAñade a esta secuencia.

        los caracteres delStringBufferargumento se añaden, en orden, al contenido de estaStringBuffer, aumentando la longitud de estaStringBufferpor la longitud del argumento. SisbSínull, entonces los cuatro caracteres"null"se añadirá a estaStringBuffer 。

        Seanla longitud de la secuencia de caracteres anterior, es decir, antes de ejecutarappendel métodoStringBufferla longitud de la secuencia de caracteres contenida. 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.

        Este método, en el objeto de destino,thisse sincroniza, pero no en el origen (sb ）。

        Parámetros
        sb- A añadirStringBuffer 。
        Resultado
        Una referencia a este objeto.
        Desde la versión:
        1.4

      • append

        public StringBuffer append​(CharSequence s)
        La especificadaCharSequenceAñade a esta secuencia.

        CharSequencelos caracteres del argumento se añaden en orden, aumentando la longitud de esta secuencia en la longitud del argumento.

        el resultado de este método es exactamente el mismo que el de llamar a this.append(s, 0, s.length());

        Este método, en el objeto de destino,thisse sincroniza, pero no en el origen (s ）。

        SisSínull，entonces se añaden cuatro caracteres"null" 。

        Specified by:
        appendInterfazAppendable
        Parámetros
        s- A añadirCharSequence 。
        Resultado
        Una referencia a este objeto.
        Desde la versión:
        1.5

      • append

        public StringBuffer 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 (sin incluirlo)end 。 la longitud de esta secuencia aumenta enend - startel valor de.

        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 los caracteres como si el parámetro s fuera una cadena que contiene cuatro caracteres"null"la secuencia"null" 。

        Specified by:
        appendEn la interfazAppendable
        Parámetros
        s- La secuencia a agregar.
        start- El índice inicial de la subsecuencia a añadir.
        end- El índice final de la subsecuencia a añadir.
        Resultado
        Una referencia a este objeto.
        Excepciones
        IndexOutOfBoundsException- sistartes negativo, ostartmayor queendoendmayor ques.length()
        Desde la versión:
        1.5

      • append

        public StringBuffer 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 esta cadena se añaden luegoappendeda esta secuencia de caracteres.

        Parámetros
        str- El carácter a agregar.
        Resultado
        Una referencia a este objeto.

      • append

        public StringBuffer 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 esta cadena se añaden luegoappendeda esta secuencia de caracteres.

        Parámetros
        str- El carácter a agregar.
        offset- El primero a agregarcharel índice.
        len- A añadircharEl número de s.
        Resultado
        Una referencia a este objeto.
        Excepciones
        IndexOutOfBoundsException- si esoffset < 0olen < 0ooffset+len > str.length

      • append

        public StringBuffer append​(boolean b)
        va abooleanLa representación de cadena del argumento se añade a la secuencia.

        El efecto general es el mismo que mediante el método deString.valueOf(boolean)convirtiera el parámetro en una cadenaExactamente igual, y los caracteres de esta cadena se añaden luegoappendeda esta secuencia de caracteres.

        Parámetros
        b - a boolean 。
        Resultado
        Una referencia a este objeto.

      • append

        public StringBuffer 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 aumenta en1 。

        El efecto general es el mismo que si el métodoString.valueOf(char)convirtiera el parámetro en una cadenaExactamente igual, y luego los caracteres de esta cadena sonappended 。

        Specified by:
        appendEn la interfazAppendable
        Parámetros
        c - a char 。
        Resultado
        Una referencia a este objeto.

      • append

        public StringBuffer append​(int i)
        va aintLa representación de cadena del argumento se añade a esta secuencia.

        El efecto general es como si mediante el métodoString.valueOf(int)convirtiera el parámetro en una cadenade la misma manera, y los caracteres de esta cadena se añaden luegoappendeda esta secuencia de caracteres.

        Parámetros
        i - int 。
        Resultado
        Una referencia a este objeto.

      • appendCodePoint

        public StringBuffer 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 el mismo que mediante el método deCharacter.toChars(int)convertir el parámetro como si fueracharmatriz.Exactamente igual,y los caracteres de esa matriz son a continuaciónappendeda esta secuencia de caracteres.

        Parámetros
        codePoint- Punto de código Unicode
        Resultado
        Una referencia a este objeto.
        Desde la versión:
        1.5

      • append

        public StringBuffer append​(long lng)
        va alongLa representación de cadena del argumento se añade a esta secuencia.

        El efecto general es el mismo que mediante el método deString.valueOf(long)convirtiera el parámetro en una cadenaExactamente igual, y los caracteres de esta cadena son los de esa secuencia de caracteresappended 。

        Parámetros
        lng - a long 。
        Resultado
        Una referencia a este objeto.

      • append

        public StringBuffer append​(float f)
        va afloatLa representación de cadena del argumento se añade a esta secuencia.

        El efecto general es el mismo que mediante el método deString.valueOf(float)convirtiera el parámetro en una cadenaExactamente igual, y los caracteres de esta cadena son los de esa secuencia de caracteresappended 。

        Parámetros
        f - a float 。
        Resultado
        Una referencia a este objeto.

      • append

        public StringBuffer append​(double d)
        va adoubleLa representación de cadena del argumento se añade a esta secuencia.

        El efecto general es el mismo que si el métodoString.valueOf(double)convirtiera el parámetro en una cadenaExactamente igual，entonces los caracteres de esta cadena sonappended 。

        Parámetros
        d - a double 。
        Resultado
        Una referencia a este objeto.

      • delete

        public StringBuffer delete​(int start,
                           int end)
        Elimina los caracteres en 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. Sistartigual aend，no se realiza ningún cambio.
        Parámetros
        start- El índice inicial, inclusive.
        end- El índice final, exclusivo.
        Resultado
        este objeto.
        Excepciones
        StringIndexOutOfBoundsException- sistartes negativo, mayor quelength()，o mayor queend 。
        Desde la versión:
        1.2

      • deleteCharAt

        public StringBuffer deleteCharAt​(int index)
        Elimina el de la posición especificada en este ordenchar 。 Esta secuencia consta de uncharse 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 se requiere un procesamiento exacto de los caracteres suplementarios, determine la cantidadcharmediante la llamada a deleteCharacter.charCount(thisSequence.codePointAt(index)), dondethisSequencepara esta secuencia.

        Parámetros
        index- El número de índice a eliminarchar
        Resultado
        este objeto.
        Excepciones
        StringIndexOutOfBoundsException- siindexes negativo o mayor o igual quelength() 。
        Desde la versión:
        1.2

      • replace

        public StringBuffer 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, y 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- El índice inicial, inclusive.
        end- El índice final, exclusivo.
        str- La cadena que reemplazará el contenido anterior.
        Resultado
        este objeto.
        Excepciones
        StringIndexOutOfBoundsException- sistartes negativo, mayor quelength()，o mayor queend 。
        Desde la versión:
        1.2

      • 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- El índice inicial, inclusive.
        Resultado
        Nueva cadena.
        Excepciones
        StringIndexOutOfBoundsException- sistartmenor que cero, o mayor que la longitud de este objeto.
        Desde la versión:
        1.2

      • 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,&nbsp;end)
        el comportamiento es exactamente el mismo que llamar a 
           sb.substring(begin,&nbsp;end)
        Este método se proporciona para que esta clase pueda implementarCharSequencela interfaz.
        Specified by:
        subSequence, la interfazCharSequence
        Parámetros
        start- El índice inicial, inclusive.
        end- El índice final, exclusivo.
        Resultado
        La subsecuencia especificada.
        Excepciones
        IndexOutOfBoundsException- sistartoendes negativo, siendmayor quelength(), ostartmayor queend
        Desde la versión:
        1.4

      • 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- El índice inicial, inclusive.
        end- El índice final, exclusivo.
        Resultado
        Nueva cadena.
        Excepciones
        StringIndexOutOfBoundsException- sistartoendes negativo o mayor quelength(), ostartmayor queend 。
        Desde la versión:
        1.2

      • insert

        public StringBuffer 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. La submatriz a partir del especificadooffsetcomienza, y se extiende hastalen char s. los caracteres del subarreglo enindexse inserta en esta secuencia en la posición indicada. la longitud de esta secuencia aumentalen char s.
        Parámetros
        index- La posición donde se inserta la submatriz.
        str - A charArreglo.
        offset- El primero en la submatriz a insertarcharel índice.
        len- En la submatriz a insertarcharEl número de s.
        Resultado
        Este objeto
        Excepciones
        StringIndexOutOfBoundsException- siindexes negativo o mayor quelength(), ooffsetolenes negativo, o(offset+len)mayor questr.length 。
        Desde la versión:
        1.2

      • insert

        public StringBuffer insert​(int offset,
                           Object obj)
        va aObjectInserta la representación de cadena del argumento en esta secuencia de caracteres.

        El efecto general es el mismo que mediante el método deString.valueOf(Object)convertir el segundo parámetro en una cadenaExactamente igual, y luego los caracteres de esta cadena se insertan en la secuencia de caracteres en el desplazamiento especificadoinserted 。

        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 StringBuffer 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 StringBuffer 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 el mismo que mediante el método deString.valueOf(char[])convertir el segundo parámetro en una cadenaExactamente igual, y luego los caracteres de esta cadena se insertan en la secuencia de caracteres en el desplazamiento especificadoinserted 。

        offsetEl parámetro debe ser mayor o igual a0, y menor o igual que la de esta secuencialength 。

        Parámetros
        offset- Desplazamiento.
        str- Array de caracteres.
        Resultado
        Una referencia a este objeto.
        Excepciones
        StringIndexOutOfBoundsException- Si el desplazamiento no es válido.

      • insert

        public StringBuffer 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"Insertado en esta secuencia.

        Parámetros
        dstOffset- Desplazamiento.
        s- La secuencia a insertar
        Resultado
        Una referencia a este objeto.
        Excepciones
        IndexOutOfBoundsException- Si el desplazamiento no es válido.
        Desde la versión:
        1.5

      • insert

        public StringBuffer 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 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 a insertar.
        start- El índice inicial de la subsecuencia a insertar.
        end- El í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()
        Desde la versión:
        1.5

      • insert

        public StringBuffer insert​(int offset,
                           boolean b)
        va abooleanInserta la representación de cadena del argumento en esta secuencia.

        El efecto general es el mismo que mediante el método deString.valueOf(boolean)convertir el segundo parámetro en una cadenaExactamente igual, y luego los caracteres de esta cadena se insertan 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.
        b - a boolean 。
        Resultado
        Una referencia a este objeto.
        Excepciones
        StringIndexOutOfBoundsException- Si el desplazamiento no es válido.

      • insert

        public StringBuffer 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 luego los caracteres de esta cadena se insertan 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.
        c - a char 。
        Resultado
        Una referencia a este objeto.
        Excepciones
        IndexOutOfBoundsException- Si el desplazamiento no es válido.

      • insert

        public StringBuffer insert​(int offset,
                           int i)
        El segundointInserta la representación de cadena del argumento en esta secuencia.

        El efecto general es el mismo que mediante el método deString.valueOf(int)convertir el segundo parámetro en una cadenaExactamente igual, y luego los caracteres de esta cadena se insertan 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 StringBuffer insert​(int offset,
                           long l)
        va alongInserta la representación de cadena del argumento en esta secuencia.

        El efecto general es el mismo que mediante el método deString.valueOf(long)convertir el segundo parámetro en una cadenaExactamente igual, y luego los caracteres de esta cadena se insertan 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.
        l - a long 。
        Resultado
        Una referencia a este objeto.
        Excepciones
        StringIndexOutOfBoundsException- Si el desplazamiento no es válido.

      • insert

        public StringBuffer 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 luego los caracteres de esta cadena se insertan 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.
        f - a float 。
        Resultado
        Una referencia a este objeto.
        Excepciones
        StringIndexOutOfBoundsException- Si el desplazamiento no es válido.

      • insert

        public StringBuffer 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 esta cadena se insertan en el desplazamiento especificado de la secuencia de caracteresinserted 。

        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 a buscar.
        Resultado
        El índice de la primera aparición de la subcadena especificada, si no hay tal caso,-1 。
        Desde la versión:
        1.4

      • 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 a buscar.
        fromIndex- El índice desde el que iniciar la búsqueda.
        Resultado
        El índice de la primera aparición de la subcadena especificada a partir del índice especificado, si no hay tal caso-1 。
        Desde la versión:
        1.4

      • 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 a buscar.
        Resultado
        El índice de la última aparición de la subcadena especificada, si no hay tal caso,-1 。
        Desde la versión:
        1.4

      • 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 a buscar.
        fromIndex- El índice desde el que iniciar 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-1búsqueda.
        Desde la versión:
        1.4

      • reverse

        public StringBuffer 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.
        Desde la versión:
        1.0.2

      • chars

        public IntStream chars()
        DevuelveintEl flujo de, para los de esta secuenciacharLos valores se extienden con ceros. se asigna adel punto de código suplenteTodos los caracteres están sin interpretar.

        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
        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 los caracteres BMP ordinarios, los suplentes no emparejados y las 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 combina con esta secuencia (concretamente, para secuencias mutables, del flujospliteratorSílate-binding ）。 Si la secuencia se modifica durante esa operación, el resultado no está definido.

        Specified by:
        codePointsEnCharSequence
        Resultado
        El IntStream de códigos Unicode apunta a esta secuencia
        Desde la versión:
        9