módulo  java.base
paquete  java.lang

Class String

  • Todas las interfaces implementadas
    Serializable ， CharSequence ， Comparable<String> 
    public final class String
extends Object
implements Serializable, Comparable<String>, CharSequence
    StringLa clase representa cadenas. Todos los literales de cadena en los programas Java (por ejemplo"abc") se implementan como instancias de esta clase.

    Las cadenas son inmutables; Sus valores no se pueden modificar después de su creación. Los búferes de cadenas admiten cadenas mutables. Debido a que los objetos String son inmutables, pueden compartirse. Por ejemplo: 

         String str = "abc";

    Equivale a: 

         char data[] = {'a', 'b', 'c'};
     String str = new String(data);

    A continuación se muestran algunos ejemplos de cómo usar cadenas: 

         System.out.println("abc");
     String cde = "cde";
     System.out.println("abc" + cde);
     String c = "abc".substring(2,3);
     String d = cde.substring(1, 2);

    ClaseStringIncluye métodos para examinar los caracteres individuales de la secuencia, comparar cadenas, buscar cadenas, extraer subcadenas y crear copias de cadenas con todos los caracteres convertidos a mayúsculas o minúsculas. El mapeo de mayúsculas y minúsculas se basa enCharacterla versión del estándar Unicode especificada por la clase.

    El lenguaje Java proporciona soporte especial para el operador de concatenación de cadenas (+) y para la conversión de otros objetos a cadenas. Para obtener más información sobre la concatenación y conversión de cadenas, consultela especificación del lenguaje Java 。

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

    AStringrepresenta, dondecaracteres suplementariosRazónpares de sustitutosla cadena en formato UTF-16 representada (ver la secciónUnicode Character RepresentationsEnCharacterpara obtener más información de la clase). Los valores de índice se refieren acharunidades de código, por lo tanto, los caracteres suplementarios enStringocupan dos posiciones.

    StringLa clase proporciona métodos para tratar puntos de código Unicode (es decir, caracteres) y para tratar unidades de código Unicode (es decir,charvalores).

    Salvo que se indique lo contrario, los métodos de comparación de cadenas no tienen en cuenta la configuración regional. CollatorLa clase proporciona métodos de comparación de cadenas más granulares y sensibles a la configuración regional.

    Implementation Note:
    Siempre que el compilador cumpla en última instancia conla especificación del lenguaje Java, la implementación del operador de concatenación de cadenas está determinada por el compilador de Java. Por ejemplo,javacEl compilador puede implementar el operadorStringBuffer ， StringBuilder, ojava.lang.invoke.StringConcatFactorydependiendo de la versión del JDK. La implementación de la conversión de cadenas normalmente se realiza mediante el métodotoString, porObjectdefinido y heredado por todas las clases en Java.
    Desde la versión:
    1.0
    Véase también:
    Object.toString() ， StringBuffer ， StringBuilder ， Charset ， Serialized Form
    See The Java™ Language Specification:
    15.18.1 Operador de concatenación de cadenas +

    • Resumen de campos

      Campo  
      Variables y tipos Campo Descripción
      static Comparator<String> CASE_INSENSITIVE_ORDER
      RazóncompareToIgnoreCaseOrdenamientoStringde la comparación de objetoscompareToIgnoreCase 。

    • Resumen de constructores

      Método constructor  
      Constructor Descripción
      String()
      Inicializa el recién creadoStringobjeto, de modo que represente una secuencia vacía de caracteres.
      String​(byte[] bytes)
      Construye una nueva cadena decodificando la matriz de bytes especificada mediante el conjunto de caracteres predeterminado de la plataforma.String 。
      String​(byte[] ascii, int hibyte)
      Obsoleto.
      Este método no puede convertir correctamente los bytes en caracteres.
      String​(byte[] bytes, int offset, int length)
      Construye una nueva cadena decodificando la submatriz de bytes especificada mediante el conjunto de caracteres predeterminado de la plataforma.String 。
      String​(byte[] ascii, int hibyte, int offset, int count)
      Obsoleto.
      Este método no puede convertir correctamente los bytes en caracteres.
      String​(byte[] bytes, int offset, int length, String charsetName)
      decodificando la submatriz de bytes especificada utilizando el conjunto de caracteres especificadoStringConstruye una nueva cadenaString 。
      String​(byte[] bytes, int offset, int length, Charset charset)
      utilizando el especificadocharsetdecodificar la submatriz de bytes especificadaStringConstruye una nueva cadenaString 。
      String​(byte[] bytes, String charsetName)
      Construye un nuevoStringdecodificado por la matriz de bytes especificada utilizando el especificadocharset 。
      String​(byte[] bytes, Charset charset)
      Construye un nuevoStringdecodificado por la matriz de bytes especificada utilizando el especificadocharset 。
      String​(char[] value)
      Asigna una nueva cadenaString, de modo que represente la secuencia de caracteres actualmente contenida en el argumento de matriz de caracteres.
      String​(char[] value, int offset, int count)
      Asigna una nueva cadenaString, que contiene los caracteres de la submatriz del argumento de matriz de caracteres.
      String​(int[] codePoints, int offset, int count)
      Asigna una nueva cadenaString, que contieneUnicode code pointlos caracteres de la submatriz del argumento de matriz.
      String​(String original)
      Inicializa el recién creadoStringobjeto, de modo que represente la misma secuencia de caracteres que el argumento; en otras palabras, la cadena recién creada es una copia de la cadena del argumento.
      String​(StringBuffer buffer)
      Asigna una nueva cadena que contiene la secuencia de caracteres actualmente contenida en el argumento de búfer de cadenas.
      String​(StringBuilder builder)
      Asigna una nueva cadena que contiene la secuencia de caracteres actualmente contenida en el argumento del generador de cadenas.

    • Resumen de métodos

      Todos los métodos  Método estático  Método de instancia Método específico  Método obsoleto 
      Variables y tipos Método Descripción
      char charAt​(int index)
      Devuelve el carácter en el índice especificado.charvalores.
      IntStream chars()
      Devuelveintel flujo de esta secuenciacharvalores extendidos 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 esteStringel número de puntos de código Unicode en el rango de texto especificado.
      IntStream codePoints()
      Devuelve un flujo de valores de puntos de código de esta secuencia.
      int compareTo​(String anotherString)
      Compara dos cadenas lexicográficamente.
      int compareToIgnoreCase​(String str)
      Compara dos cadenas lexicográficamente, ignorando las diferencias de mayúsculas y minúsculas.
      String concat​(String str)
      Concatena la cadena especificada al final de esta cadena.
      boolean contains​(CharSequence s)
      Devuelve true si y solo si esta cadena contiene la secuencia de valores char especificada.
      boolean contentEquals​(CharSequence cs)
      Compara esta cadena con el especificado.CharSequence 。
      boolean contentEquals​(StringBuffer sb)
      Compara esta cadena con el especificado.StringBuffer 。
      static String copyValueOf​(char[] data)
      equivalente avalueOf(char[]) 。
      static String copyValueOf​(char[] data, int offset, int count)
      equivalente avalueOf(char[], int, int) 。
      boolean endsWith​(String suffix)
      Prueba si esta cadena termina con el sufijo especificado.
      boolean equals​(Object anObject)
      Compara esta cadena con el objeto especificado.
      boolean equalsIgnoreCase​(String anotherString)
      estoStringCon otroStringCompara, ignorando mayúsculas y minúsculas.
      static String format​(String format, Object... args)
      Devuelve una cadena formateada usando la cadena de formato y los argumentos especificados.
      static String format​(Locale l, String format, Object... args)
      Devuelve una cadena formateada usando el locale, la cadena de formato y los argumentos especificados.
      byte[] getBytes()
      Usando el conjunto de caracteres predeterminado de la plataforma, estaStringCodifica en una secuencia de bytes, almacenando el resultado en un nuevo arreglo de bytes.
      void getBytes​(int srcBegin, int srcEnd, byte[] dst, int dstBegin)
      Obsoleto.
      Este método no puede convertir caracteres a bytes correctamente.
      byte[] getBytes​(String charsetName)
      Usando el conjunto de caracteres nombrado, estaStringCodifica en una secuencia de bytes, almacenando el resultado en un nuevo arreglo de bytes.
      byte[] getBytes​(Charset charset)
      Usando el valor dadocharsetestoStringCodifica en una secuencia de bytes, almacenando el resultado en un nuevo arreglo de bytes.
      void getChars​(int srcBegin, int srcEnd, char[] dst, int dstBegin)
      Copia los caracteres de esta cadena en el arreglo de caracteres de destino.
      int hashCode()
      Devuelve el código hash de esta cadena.
      int indexOf​(int ch)
      Devuelve el índice dentro de esta cadena de la primera aparición del carácter especificado.
      int indexOf​(int ch, int fromIndex)
      Devuelve el índice dentro de esta cadena de la primera ocurrencia del carácter especificado, comenzando la búsqueda en el índice especificado.
      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.
      String intern()
      Devuelve la representación canónica del objeto String.
      boolean isBlank()
      Si la cadena está vacía o contiene solowhite spacepuntos de código, entonces devuelvetrue, de lo contrariofalse 。
      boolean isEmpty()
      Devuelvetrue, si y solo si,length()Sí0 。
      static String join​(CharSequence delimiter, CharSequence... elements)
      Devuelve unCharSequence elementsnuevo String compuesto de copias de, dichas copias con la especificadadelimitercopias unidas entre sí.
      static String join​(CharSequence delimiter, Iterable<? extends CharSequence> elements)
      Devuelve unStringnuevo compuesto de copias deString, dondeCharSequence elementslo especificadodelimitercopias de.
      int lastIndexOf​(int ch)
      Devuelve el índice en esta cadena de la última ocurrencia del carácter especificado.
      int lastIndexOf​(int ch, int fromIndex)
      Devuelve el índice en esta cadena de la última ocurrencia del carácter especificado, buscando hacia atrás desde el índice especificado.
      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 de esta cadena.
      Stream<String> lines()
      Devuelve un flujo de líneas extraídas de esta cadena, separadas por terminadores de línea.
      boolean matches​(String regex)
      Determina si esta cadena con lo dadoregular expressioncoincide.
      int offsetByCodePoints​(int index, int codePointOffset)
      Devuelve esteStringel índice en, el cual comienza desde el dadoindexdesplazamientocodePointOffsetpuntos de código.
      boolean regionMatches​(boolean ignoreCase, int toffset, String other, int ooffset, int len)
      Comprueba si dos regiones de cadena son iguales.
      boolean regionMatches​(int toffset, String other, int ooffset, int len)
      Comprueba si dos regiones de cadena son iguales.
      String repeat​(int count)
      Devuelve una cadena cuyo valor es la concatenación de esta cadena repetidacountveces.
      String replace​(char oldChar, char newChar)
      Devuelve una cadena que resulta de reemplazar todas las apariciones deoldCharen esta cadenanewChar 。
      String replace​(CharSequence target, CharSequence replacement)
      Reemplaza cada subcadena de esta cadena que coincide con la secuencia objetivo literal por la secuencia de reemplazo literal especificada.
      String replaceAll​(String regex, String replacement)
      sustituir el dado por el reemplazo dadoregular expressionReemplaza cada subcadena de esta cadena que coincida.
      String replaceFirst​(String regex, String replacement)
      sustituir el dado por el reemplazo dadoregular expressionReemplaza la primera subcadena de esta cadena que coincida.
      String[] split​(String regex)
      Divide esta cadena en torno a la dadade la expresión regular.coincidenciaelemento 。
      String[] split​(String regex, int limit)
      Divide esta cadena en torno a la dadade la expresión regular.coincidenciaelemento 。
      boolean startsWith​(String prefix)
      Prueba si esta cadena comienza con el prefijo especificado.
      boolean startsWith​(String prefix, int toffset)
      Prueba si la subcadena de esta cadena que comienza en el índice especificado comienza con el prefijo especificado.
      String strip()
      Devuelve una cadena cuyo valor es esta cadena, con todos los espacios en blanco iniciales y finales eliminados.white space 。
      String stripLeading()
      Devuelve una cadena cuyo valor es esta cadena, con todos los espacios en blanco iniciales eliminados.white space 。
      String stripTrailing()
      Devuelve una cadena cuyo valor es esta cadena, y elimina todos los espacios en blanco finales.white space 。
      CharSequence subSequence​(int beginIndex, int endIndex)
      Devuelve una secuencia de caracteres que es una subsecuencia de esta secuencia.
      String substring​(int beginIndex)
      Devuelve una cadena que es una subcadena de esta cadena.
      String substring​(int beginIndex, int endIndex)
      Devuelve una cadena que es una subcadena de esta cadena.
      char[] toCharArray()
      Convierte esta cadena en una nueva matriz de caracteres.
      String toLowerCase()
      Usando las reglas de la configuración regional predeterminada, esta cadenaStringConvierte todos los caracteres a minúsculas.
      String toLowerCase​(Locale locale)
      Usando la configuración regional dadaLocalelas reglas de esta cadenaStringtodos los caracteres se convierten aLocale 。
      String toString()
      Este objeto (¡ya es una cadena!)
      String toUpperCase()
      Usando las reglas de la configuración regional predeterminada, esta cadenaStringConvierte todos los caracteres a mayúsculas.
      String toUpperCase​(Locale locale)
      Usando la configuración regional dadaLocalelas reglas de esta cadenaStringConvierte todos los caracteres a mayúsculas.
      String trim()
      Devuelve una cadena cuyo valor es esta cadena, con todos los espacios en blanco iniciales y finales eliminados, donde space se define como cualquier carácter cuyo punto de código es menor o igual a'U+0020'cualquier carácter (el carácter de espacio).
      static String valueOf​(boolean b)
      DevuelvebooleanLa representación de cadena del argumento.
      static String valueOf​(char c)
      DevuelvecharLa representación de cadena del argumento.
      static String valueOf​(char[] data)
      DevuelvecharRepresentación de cadena del parámetro de matriz.
      static String valueOf​(char[] data, int offset, int count)
      DevuelvecharRepresentación de cadena de la submatriz especificada del parámetro de matriz.
      static String valueOf​(double d)
      DevuelvedoubleLa representación de cadena del argumento.
      static String valueOf​(float f)
      DevuelvefloatLa representación de cadena del argumento.
      static String valueOf​(int i)
      DevuelveintLa representación de cadena del argumento.
      static String valueOf​(long l)
      DevuelvelongLa representación de cadena del argumento.
      static String valueOf​(Object obj)
      DevuelveObjectLa representación de cadena del argumento.

    • Detalles de campos

      • CASE_INSENSITIVE_ORDER

        public static final Comparator<String> CASE_INSENSITIVE_ORDER
        RazóncompareToIgnoreCaseOrdenamientoStringde la comparación de objetoscompareToIgnoreCase 。 Este comparador es serializable.

        Tenga en cuenta que este comparadornoConsidera la configuración regional y puede dar lugar a una ordenación no satisfactoria en determinadas configuraciones regionales. CollatorLa clase proporciona una comparación sensible a la configuración regional.

        Desde la versión:
        1.2
        Véase también:
        Collator

    • Detalles de constructores

      • String

        public String()
        Inicializa el recién creadoStringobjeto, de modo que represente una secuencia vacía de caracteres. Tenga en cuenta que, dado que las cadenas son inmutables, no es necesario utilizar este constructor.

      • String

        public String​(String original)
        Inicializa el recién creadoStringobjeto, de modo que represente la misma secuencia de caracteres que el argumento; en otras palabras, la cadena recién creada es una copia de la cadena del argumento. A menos que se necesiteoriginaluna copia explícita de,originalno es necesario utilizar este constructor, porque las cadenas son inmutables.
        Parámetros
        original - A String

      • String

        public String​(char[] value)
        Asigna una nueva cadenaString, de modo que represente la secuencia de caracteres actualmente contenida en el argumento de matriz de caracteres. Copia el contenido de la matriz de caracteres; Las modificaciones posteriores de la matriz de caracteres no afectan a la cadena recién creada.
        Parámetros
        valueValor inicial de la cadena.

      • String

        public String​(char[] value,
              int offset,
              int count)
        Asigna una nueva cadenaString, que contiene los caracteres de la submatriz del argumento de matriz de caracteres. offsetEl parámetro es la submatrizcountel índice del primer carácter de la submatriz,countEl parámetro especifica la submatrizcountla longitud de la submatriz. Copia el contenido de la submatriz; Las modificaciones posteriores de la matriz de caracteres no afectan a la cadena recién creada.
        Parámetros
        valueMatriz como fuente de caracteres.
        offset- desplazamiento inicial
        count- Longitud
        Excepciones
        IndexOutOfBoundsException- sioffsetsi es negativo, entoncescountes negativo, ooffsetes mayor quevalue.length - count

      • String

        public String​(int[] codePoints,
              int offset,
              int count)
        Asigna una nueva cadenaString, que contieneUnicode code pointlos caracteres de la submatriz del argumento de matriz. offsetEl parámetro es la submatrizcountel índice del primer punto de código de la submatriz,countEl parámetro especifica la submatrizcountla longitud de la submatriz. el contenido de la submatriz se convierte enchar s; La modificación posteriorintLa matriz no afecta a la cadena recién creada.
        Parámetros
        codePoints- Una matriz como fuente de puntos de código Unicode
        offset- desplazamiento inicial
        count- Longitud
        Excepciones
        IllegalArgumentException- Si encodePointsEncontrar cualquier punto de código Unicode no válido
        IndexOutOfBoundsException- sioffsetsi es negativo, entoncescountes negativo, ooffsetes mayor quecodePoints.length - count
        Desde la versión:
        1.5

      • String

        public String​(byte[] bytes,
              int offset,
              int length,
              String charsetName)
       throws UnsupportedEncodingException
        decodificando la submatriz de bytes especificada utilizando el conjunto de caracteres especificadoStringConstruye una nueva cadenaString 。 la nuevaStringLa longitud es una función del conjunto de caracteres, por lo que puede no ser igual a la longitud de la submatriz.

        Cuando los bytes dados no son válidos en el conjunto de caracteres dado, el comportamiento de este constructor no está especificado. Cuando se necesite un mayor control sobre el proceso de decodificación, se debe usarCharsetDecoderla clase.

        Parámetros
        bytesBytes que se van a decodificar en caracteres.
        offsetÍndice del primer byte que se va a decodificar.
        lengthNúmero de bytes que se van a decodificar.
        charsetName- Soportadoscharsetlos nombres de
        Excepciones
        UnsupportedEncodingExceptionSi no se admite el conjunto de caracteres especificado.
        IndexOutOfBoundsException- sioffsetes un número negativo,lengthes negativo, ooffsetes mayor quebytes.length - length
        Desde la versión:
        1.1

      • String

        public String​(byte[] bytes,
              int offset,
              int length,
              Charset charset)
        Construye un nuevoStringdecodificando la submatriz de bytes especificada usando el conjunto de caracteres especificadocharset 。 NuevoStringLa longitud es una función del conjunto de caracteres, por lo que puede no ser igual a la subStringla longitud de la submatriz.

        Este método siempre utiliza la cadena de reemplazo predeterminada de este charset para reemplazar la entrada malformada y las secuencias de caracteres no mapeables. Cuando se necesite un mayor control sobre el proceso de decodificación, se debe usarCharsetDecoderla clase.

        Parámetros
        bytesBytes que se van a decodificar en caracteres.
        offsetÍndice del primer byte que se va a decodificar.
        lengthNúmero de bytes que se van a decodificar.
        charset- Estecharsetse utiliza para decodificarbytes
        Excepciones
        IndexOutOfBoundsException- sioffsetes un número negativo,lengthes negativo, ooffsetes mayor quebytes.length - length
        Desde la versión:
        1.6

      • String

        public String​(byte[] bytes,
              String charsetName)
       throws UnsupportedEncodingException
        Construye un nuevoStringdecodificado por la matriz de bytes especificada utilizando el especificadocharset 。 NuevoStringLa longitud es función del conjunto de caracteres, por lo que puede no ser igual a la longitud de la matriz de bytes.

        Cuando los bytes dados no son válidos en el conjunto de caracteres dado, el comportamiento de este constructor no está especificado. Cuando se necesite un mayor control sobre el proceso de decodificación, se debe usarCharsetDecoderla clase.

        Parámetros
        bytesBytes que se van a decodificar en caracteres.
        charsetName- Soportadoscharsetlos nombres de
        Excepciones
        UnsupportedEncodingExceptionSi no se admite el conjunto de caracteres especificado.
        Desde la versión:
        1.1

      • String

        public String​(byte[] bytes,
              Charset charset)
        Construye un nuevoStringdecodificado por la matriz de bytes especificada utilizando el especificadocharset 。 NuevoStringLa longitud es función del conjunto de caracteres, por lo que puede no ser igual a la longitud de la matriz de bytes.

        Este método siempre utiliza la cadena de reemplazo predeterminada de este charset para reemplazar la entrada malformada y las secuencias de caracteres no mapeables. Cuando se necesite un mayor control sobre el proceso de decodificación, se debe usarCharsetDecoderla clase.

        Parámetros
        bytesBytes que se van a decodificar en caracteres.
        charset- Estecharsetse utiliza para decodificarbytes
        Desde la versión:
        1.6

      • String

        public String​(byte[] bytes,
              int offset,
              int length)
        Construye una nueva cadena decodificando la submatriz de bytes especificada mediante el conjunto de caracteres predeterminado de la plataforma.String 。 NuevoStringLa longitud es una función del conjunto de caracteres, por lo que puede no ser igual a la subStringla longitud de la submatriz.

        No se especifica el comportamiento de este constructor cuando los bytes dados no son válidos en el conjunto de caracteres predeterminado. Cuando se necesite un mayor control sobre el proceso de decodificación, se debe usarCharsetDecoderla clase.

        Parámetros
        bytesBytes que se van a decodificar en caracteres.
        offsetÍndice del primer byte que se va a decodificar.
        lengthNúmero de bytes que se van a decodificar.
        Excepciones
        IndexOutOfBoundsException- sioffsetsi es negativo, entonceslengthes negativo, ooffsetes mayor quebytes.length - length
        Desde la versión:
        1.1

      • String

        public String​(byte[] bytes)
        Utilizando el conjunto de caracteres predeterminado de la plataforma para decodificar la matriz de bytes especificada, se construye un nuevoString 。 NuevoStringLa longitud es función del conjunto de caracteres, por lo que puede no ser igual a la longitud de la matriz de bytes.

        No se especifica el comportamiento de este constructor cuando los bytes dados no son válidos en el conjunto de caracteres predeterminado. Cuando se necesite un mayor control sobre el proceso de decodificación, se debe usarCharsetDecoderla clase.

        Parámetros
        bytesBytes que se van a decodificar en caracteres.
        Desde la versión:
        1.1

      • String

        public String​(StringBuffer buffer)
        Asigna una nueva cadena que contiene la secuencia de caracteres actualmente contenida en el argumento de búfer de cadenas. Copia el contenido del búfer de cadena; Las modificaciones posteriores del búfer de cadena no afectarán a la cadena recién creada.
        Parámetros
        buffer - A StringBuffer

      • String

        public String​(StringBuilder builder)
        Asigna una nueva cadena que contiene la secuencia de caracteres actualmente contenida en el argumento del generador de cadenas. El contenido del generador de cadenas se copia; Las modificaciones posteriores del generador de cadenas no afectarán a la cadena recién creada.

        Este constructor se proporciona para facilitar la migración aStringBuilder 。 MediantetoStringEl método para obtener una cadena desde el generador de cadenas puede ejecutarse más rápido y, por lo general, es el preferido.

        Parámetros
        builder - A StringBuilder
        Desde la versión:
        1.5

    • Detalles de métodos

      • length

        public int length()
        Devuelve la longitud de esta cadena. La longitud es igual al número de unidades de código en la cadenaUnicode code unitsla cantidad.
        Specified by:
        lengthEn la interfazCharSequence
        Resultado
        Longitud de la secuencia de caracteres representada por este objeto.

      • isEmpty

        public boolean isEmpty()
        Devuelvetrue, si y solo si,length()Sí0 。
        Resultado
        trueSilength()Sí0, de lo contrariofalse
        Desde la versión:
        1.6

      • charAt

        public char charAt​(int index)
        Devuelve el carácter en el índice especificado.charvalores. El rango de índices es de0hastalength() - 1 。 el primero de la secuenciacharvalor en el índice0, el siguiente en el índice1, y así sucesivamente, al igual que los índices de arreglo.

        SicharEl valor especificado por el índice essurrogate, entonces se devuelve el valor de reemplazo mencionado.

        Specified by:
        charAtEn la interfazCharSequence
        Parámetros
        index - charvalor deseado.
        Resultado
        El valor char en el índice especificado de esta cadenacharvalores. El primercharvalor en el índice0 。
        Excepciones
        IndexOutOfBoundsException- siindexEl argumento es negativo o no es menor que la longitud de esta cadena.

      • 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 desde0llegarlength() - 1 。

        Si el valor especificado en el índice dadocharestá en el rango de sustitutos altos, y si el índice siguiente es menor que laStringlongitud de esta cadena, y el valor char en el índice siguientecharvalor 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
        indexValor de punto de código del carácter en la posición especificada.
        Excepciones
        IndexOutOfBoundsException- siindexEl argumento es negativo o no es menor que la longitud de esta cadena.
        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 desde1llegarlength 。

        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. Sicharesindex - 1es un sustituto bajo no emparejado o un sustituto alto, entonces se devuelve el valor sustituto.

        Parámetros
        indexÍ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 cadena.
        Desde la versión:
        1.5

      • codePointCount

        public int codePointCount​(int beginIndex,
                          int endIndex)
        Devuelve esteStringel número de puntos de código Unicode en el rango de texto especificado. El rango de texto desde el índice especificadobeginIndexcomienza y se extiende hastachar, con el índiceendIndex - 1 。 Por lo tanto, la longitud del rango de texto (encharcaracteres) esendIndex-beginIndex 。 Los sustitutos no emparejados dentro del rango de texto se cuentan como un punto de código cada uno.
        Parámetros
        beginIndexEl primero del rango de texto.charel índice.
        endIndexEl último del rango de texto.charel índice posterior.
        Resultado
        El número de puntos de código Unicode en el rango de texto especificado
        Excepciones
        IndexOutOfBoundsException- sibeginIndexes negativo, oendIndexmayor que estaStringla longitud de, obeginIndexmayor queendIndex 。
        Desde la versión:
        1.5

      • offsetByCodePoints

        public int offsetByCodePoints​(int index,
                              int codePointOffset)
        Devuelve esteStringel índice en, el cual comienza desde el dadoindexdesplazamientocodePointOffsetpuntos de código. RazónindexycodePointOffsetLos sustitutos no emparejados en el rango de texto dado se cuentan como un punto de código cada uno.
        Parámetros
        indexÍndice que se va a desplazar.
        codePointOffsetDesplazamiento en puntos de código.
        Resultado
        El índice está enString
        Excepciones
        IndexOutOfBoundsException- siindexes negativo o mayor que estaStringla longitud de, o sicodePointOffsetes positivo y desdeindexla subcadena inicial tiene menos decodePointOffsetpuntos de código, o sicodePointOffsetes negativo yindexla subcadena anterior tiene menos del valor absolutocodePointOffsetpuntos 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 cadena en el arreglo de caracteres de destino.

        El primer carácter a copiar es el índicesrcBegin ; El último carácter a copiar está en el índicesrcEnd-1(Por lo tanto, 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Índice del primer carácter de la cadena que se va a copiar.
        srcEndÍndice posterior al último carácter de la cadena que se va a copiar.
        dst- matriz de destino.
        dstBeginDesplazamiento inicial en la matriz de destino.
        Excepciones
        IndexOutOfBoundsException- si se cumple cualquiera de las siguientes condiciones:
        • srcBegines negativo.
        • srcBeginmayor quesrcEnd
        • srcEndmayor que la longitud de esta cadena
        • dstBegines negativo
        • dstBegin+(srcEnd-srcBegin)mayor quedst.length

      • getBytes

        @Deprecated(since="1.1")
public void getBytes​(int srcBegin,
                     int srcEnd,
                     byte[] dst,
                     int dstBegin)
        Deprecated.
        This method does not properly convert characters into bytes. As of JDK 1.1, the preferred way to do this is via the getBytes() method, which uses the platform's default charset.
        Copia los caracteres de esta cadena en la matriz de bytes de destino. Cada byte recibe los 8 bits de orden inferior del carácter correspondiente. Los ocho bits de orden superior de cada carácter no se copian ni participan de ningún modo en la transferencia.

        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 convertidos en bytes se copian endstde la subcadenadstdesde el índicedstBegincomienza y termina en el índice: 

             dstBegin + (srcEnd-srcBegin) - 1
        Parámetros
        srcBeginÍndice del primer carácter de la cadena que se va a copiar.
        srcEndÍndice posterior al último carácter de la cadena que se va a copiar.
        dst- matriz de destino
        dstBeginDesplazamiento inicial en la matriz de destino.
        Excepciones
        IndexOutOfBoundsException- si se cumple cualquiera de las siguientes condiciones:
        • srcBegines negativo
        • srcBeginmayor quesrcEnd
        • srcEndmayor que la longitud de este String
        • dstBegines negativo
        • dstBegin+(srcEnd-srcBegin)mayor quedst.length

      • getBytes

        public byte[] getBytes​(String charsetName)
                throws UnsupportedEncodingException
        Usando el conjunto de caracteres especificado, esteStringCodifica en una secuencia de bytes, almacenando el resultado en un nuevo arreglo de bytes.

        No se especifica el comportamiento de este método cuando esta cadena no se puede codificar en el conjunto de caracteres dado. Cuando se necesite un mayor control sobre el proceso de codificación, se debe utilizarCharsetEncoderla clase.

        Parámetros
        charsetName- Soportadoscharsetlos nombres de
        Resultado
        matriz de bytes resultante
        Excepciones
        UnsupportedEncodingException- Si no se admite el juego de caracteres especificado
        Desde la versión:
        1.1

      • getBytes

        public byte[] getBytes​(Charset charset)
        Usando el valor dadocharsetestoStringCodifica en una secuencia de bytes, almacenando el resultado en un nuevo arreglo de bytes.

        Este método siempre utiliza la matriz de bytes de reemplazo predeterminada de este charset para reemplazar la entrada mal formada y las secuencias de caracteres no asignables. Cuando se necesite un mayor control sobre el proceso de codificación, se debe utilizarCharsetEncoderla clase.

        Parámetros
        charset- EsteCharsetse utiliza para codificarString
        Resultado
        matriz de bytes resultante
        Desde la versión:
        1.6

      • getBytes

        public byte[] getBytes()
        Usando el conjunto de caracteres predeterminado de la plataforma, estaStringCodifica en una secuencia de bytes, almacenando el resultado en un nuevo arreglo de bytes.

        No se especifica el comportamiento de este método cuando esta cadena no se puede codificar en el conjunto de caracteres predeterminado. Cuando se necesite un mayor control sobre el proceso de codificación, se debe utilizarCharsetEncoderla clase.

        Resultado
        matriz de bytes resultante
        Desde la versión:
        1.1

      • equals

        public boolean equals​(Object anObject)
        Compara esta cadena con el objeto especificado. si y sólo si el argumento no esnully esStringcuando el objeto representa la misma secuencia de caracteres que este objeto, el resultado estrue 。

        Para una comparación de cadenas más detallada, consulteCollator 。

        Sobrescribe:
        equalsEn la claseObject
        Parámetros
        anObject- comparar conStringdel objeto
        Resultado
        trueSi el objeto dado representaStringuna cadena equivalente a esta cadena,falsede lo contrario
        Véase también:
        compareTo(String) ， equalsIgnoreCase(String)

      • contentEquals

        public boolean contentEquals​(StringBuffer sb)
        Compara esta cadena con el especificado.StringBuffer 。 el resultado estrue, si, si esto sóloStringrepresenta los caracteres como la misma secuencia especificadaStringBuffer 。 Este método enStringBuffersincroniza en.

        Para una comparación de cadenas más detallada, consulteCollator 。

        Parámetros
        sb- UtiliceStringBufferpara comparar estoString
        Resultado
        trueSi elStringrepresenta con la especificadaStringBufferla misma secuencia de caracteres; de lo contrario,false
        Desde la versión:
        1.4

      • contentEquals

        public boolean contentEquals​(CharSequence cs)
        Compara esta cadena con el especificado.CharSequence 。 si y sólo si esteStringcuando representa la misma secuencia de valores char que la secuencia especificada, el resultado estrue 。 Tenga en cuenta que siCharSequenceSíStringBufferentonces el método se sincronizará en él.

        Para una comparación de cadenas de grano fino, consulteCollator 。

        Parámetros
        cs- compara esteStringla secuencia
        Resultado
        trueSi elStringRepresenta la misma secuencia de valores char que la secuencia especificada; de lo contrario,false
        Desde la versión:
        1.5

      • equalsIgnoreCase

        public boolean equalsIgnoreCase​(String anotherString)
        estoStringCon otroStringCompara, ignorando mayúsculas y minúsculas. Si dos cadenas tienen la misma longitud y los caracteres correspondientes en las dos cadenas son iguales ignorando mayúsculas y minúsculas, entonces se consideran iguales ignorando mayúsculas y minúsculas.

        Si se cumple al menos una de las siguientes condiciones, dos caracteresc1yc2se consideran iguales ignorando mayúsculas y minúsculas:

        • Los dos caracteres son iguales (por==comparación mediante el operador)
        • Invocar sobre cada carácterCharacter.toLowerCase(Character.toUpperCase(char))produce el mismo resultado

        Tenga en cuenta que este métodoNoes sensible a la configuración regional y puede dar lugar a resultados insatisfactorios para determinadas configuraciones regionales. CollatorLa clase proporciona una comparación sensible a la configuración regional.

        Parámetros
        anotherString- UtiliceStringpara comparar estoStringComparación
        Resultado
        trueSi el argumento no esnully representa un equivalenteStringignorando mayúsculas y minúsculas; de lo contrario,false
        Véase también:
        equals(Object)

      • compareTo

        public int compareTo​(String anotherString)
        Compara dos cadenas lexicográficamente. La comparación se basa en el valor Unicode de cada carácter de la cadena. EsteStringLa secuencia de caracteres representada por el objeto se compara lexicográficamente con la secuencia de caracteres representada por la cadena del argumento. Si elStringSi el objeto precede lexicográficamente a la cadena del argumento, el resultado es un entero negativo. Si elStringSi el objeto sigue lexicográficamente a la cadena del argumento, el resultado es un entero positivo. Si las cadenas son iguales, el resultado es cero; compareToEnequals(Object)El método devuelve0devuelve exactamentetrue 。

        Esta es la definición de orden lexicográfico. Si dos cadenas son diferentes, entonces tienen caracteres diferentes en algún índice que sea un índice válido para ambas cadenas, o sus longitudes son diferentes, o ambas cosas. Si tienen caracteres diferentes en una o más posiciones de índice, seakel índice más pequeño; entonces, mediante el uso de<El operador determina su posiciónkla cadena cuyo carácter en esa posición tiene el valor menor precede lexicográficamente a la otra cadena. En este caso,compareTodevuelve la posición en las dos cadenaskde los valores de los dos caracteres en esa posiciónk- es decir, el valor: 

         this.charAt(k)-anotherString.charAt(k)
        Si no hay ninguna posición de índice en la que difieran, entonces la cadena más corta precede lexicográficamente a la cadena más larga. En este caso,compareTodevuelve la diferencia de las longitudes de las cadenas - es decir, el valor: 
         this.length()-anotherString.length()

        Para una comparación de cadenas más detallada, consulteCollator 。

        Specified by:
        compareToEnComparable<String>
        Parámetros
        anotherString- la cadena a compararString 。
        Resultado
        Si la cadena del argumento es igual a esta cadena, el valor es0 ; Si esta cadena es lexicográficamente menor que la cadena del argumento, entonces el valor es menor que0 ; Si esta cadena es lexicográficamente mayor que la cadena del argumento, el valor es mayor que0 。

      • compareToIgnoreCase

        public int compareToIgnoreCase​(String str)
        Compara dos cadenas lexicográficamente, ignorando las diferencias de mayúsculas y minúsculas. Este método devuelve un entero cuyo signo es el de llamar acompareTocon las versiones normalizadas de las cadenas, en las que las diferencias de mayúsculas y minúsculas se eliminan llamando aCharacter.toLowerCase(Character.toUpperCase(character))en cada carácter.

        Tenga en cuenta que este métodoNoconsideración de la configuración regional, y puede dar lugar a una ordenación insatisfactoria para determinadas configuraciones regionales. CollatorLa clase proporciona una comparación sensible a la configuración regional.

        Parámetros
        str- la cadena a compararString 。
        Resultado
        Un entero negativo, cero o un entero positivo, ya que la cadena especificada es mayor, igual o menor que esta cadena, ignorando el caso.
        Desde la versión:
        1.2
        Véase también:
        Collator

      • regionMatches

        public boolean regionMatches​(int toffset,
                             String other,
                             int ooffset,
                             int len)
        Comprueba si dos regiones de cadena son iguales.

        estoStringLa subcadena de este objeto se compara con la subcadena del argumento other. Si estas subcadenas representan la misma secuencia de caracteres, el resultado es verdadero. la subcadena de esteStringobjeto que se va a comparar comienza en el índicetoffsety tiene una longitud delen 。 la otra subcadena que se va a comparar comienza en el índiceooffsety tiene una longitud delen 。 el resultado es falso si y solo si se cumple al menos una de las siguientes condiciones:false ：

        • toffsetes negativo.
        • ooffsetes negativo.
        • toffset+lenmayor que estaStringla longitud del objeto.
        • ooffset+lenmayor que la longitud del otro argumento.
        • hay algún entero no negativokmenor quelen, tal que:this.charAt(toffset + k ) != other.charAt(ooffset + k )

        Tenga en cuenta que este métodoNoconsideraciones de configuración regional. CollatorLa clase proporciona una comparación sensible a la configuración regional.

        Parámetros
        toffset- esta cadenatoffsetDesplazamiento inicial de la región.
        otherEl argumento de cadena.
        ooffset- argumento de cadenaooffsetDesplazamiento inicial de la región.
        lenNúmero de caracteres que se van a comparar.
        Resultado
        trueSi la subregión especificada de esta cadena coincide exactamente con la subregión especificada del parámetro de cadena; de lo contrario,false 。

      • regionMatches

        public boolean regionMatches​(boolean ignoreCase,
                             int toffset,
                             String other,
                             int ooffset,
                             int len)
        Comprueba si dos regiones de cadena son iguales.

        estoStringLa subcadena del objeto y el parámetrootherde la subcadena se realizaother 。 Si estas subcadenas representan la misma secuencia de caracteres, el resultado estrue, si y solo siignoreCasecuando sea verdadero, se ignoran mayúsculas y minúsculas. la subcadena de esteStringobjeto que se va a comparar comienza en el índicetoffsety tiene una longitud delen 。 La subcadena a compararotherdesde el índiceooffsety tiene una longitud delen 。 El resultado esfalsesi y solo si se cumple al menos una de las siguientes condiciones:

        • toffsetes negativo.
        • ooffsetes negativo.
        • toffset+lenmayor que estaStringla longitud del objeto.
        • ooffset+lenmayor que la longitud del otro argumento.
        • ignoreCaseSífalsey existen algunos números enteros no negativoskmenor quelentales que: 
           this.charAt(toffset+k) != other.charAt(ooffset+k)
        • ignoreCaseSítruey existen algunos números enteros no negativoskmenor quelentales que: 
           Character.toLowerCase(Character.toUpperCase(this.charAt(toffset+k))) !=
     Character.toLowerCase(Character.toUpperCase(other.charAt(ooffset+k)))

        Tenga en cuenta que este métodoNoconsideraciones de configuración regional, y cuando causaría resultados no deseados para configuraciones regionales específicas.ignoreCaseParatrue 。 CollatorLa clase proporciona una comparación sensible a la configuración regional.

        Parámetros
        ignoreCase- si estrue, ignore las mayúsculas y minúsculas al comparar caracteres.
        toffset- esta cadenatoffsetDesplazamiento inicial de la región.
        otherEl argumento de cadena.
        ooffset- argumento de cadenaooffsetDesplazamiento inicial de la región.
        lenNúmero de caracteres que se van a comparar.
        Resultado
        trueSi la subregión especificada de esta cadena coincide con la subregión especificada del parámetro de cadena; de lo contrario,false 。 Que la coincidencia sea exacta o no distinga mayúsculas y minúsculas depende deignoreCaseel parámetro.

      • startsWith

        public boolean startsWith​(String prefix,
                          int toffset)
        Prueba si la subcadena de esta cadena que comienza en el índice especificado comienza con el prefijo especificado.
        Parámetros
        prefix- Prefijo.
        toffsetDesde dónde empezar a buscar en esta cadena.
        Resultado
        trueSi la secuencia de caracteres representada por el parámetro es, desde el índicetoffsetque comienza, un prefijo de la subcadena de este objeto; de lo contrario,false 。 Sitoffsetes negativo o mayor queStringla longitud del objeto, entonces el resultado esfalse ; de lo contrario, el resultado es el mismo que el de la expresión 
          this.substring(toffset).startsWith(prefix)

      • startsWith

        public boolean startsWith​(String prefix)
        Prueba si esta cadena comienza con el prefijo especificado.
        Parámetros
        prefix- Prefijo.
        Resultado
        trueSi la secuencia de caracteres representada por el parámetro es un prefijo de la secuencia de caracteres representada por esta cadena; de lo contrario,false 。 También se debe tener en cuenta quetrueSi el argumento es una cadena vacía o igual a esta, se devolveráStringsegún lo determinado por el objetoequals(Object)método.
        Desde la versión:
        1.0

      • endsWith

        public boolean endsWith​(String suffix)
        Prueba si esta cadena termina con el sufijo especificado.
        Parámetros
        suffix- Sufijo.
        Resultado
        trueSi la secuencia de caracteres representada por el parámetro es un sufijo de la secuencia de caracteres representada por este objeto; de lo contrario,false 。 Tenga en cuenta que el resultado serátrueSi el argumento es una cadena vacía o igual a estaStringsegún lo determinado por el objetoequals(Object)método.

      • hashCode

        public int hashCode()
        Devuelve el código hash de esta cadena. StringEl código hash del objeto se calcula como 
         s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]
        Usarintaritmética, dondes[i]es el enésimo de la cadenaicarácter,nes la longitud de la cadena,^Representa la potenciación. (El valor hash de la cadena vacía es cero.)
        Sobrescribe:
        hashCodeEn la claseObject
        Resultado
        Valor del código hash de este objeto.
        Véase también:
        Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

      • indexOf

        public int indexOf​(int ch)
        Devuelve el índice dentro de esta cadena de la primera aparición del carácter especificado. Si en laStringsecuencia de caracteres representada por el objeto, aparece un valor dechel carácter, se devuelve el índice de la primera aparición de este tipo (en unidades de código Unicode). Para valores en el rango de 0 a 0xFFFF (inclusive)ch, este es el valor mínimok, tal que: 
         this.charAt(k) == ch
        es verdadero. Parachotros valores, es el mínimok, tal que: 
         this.codePointAt(k) == ch
        es verdadero. En cualquier caso, si no aparece dicho carácter en esta cadena, se devuelve-1 。
        Parámetros
        ch- Carácter (punto de código Unicode).
        Resultado
        El índice de la primera aparición del carácter en la secuencia de caracteres representada por este objeto, si el carácter no aparece,-1 。

      • indexOf

        public int indexOf​(int ch,
                   int fromIndex)
        Devuelve el índice dentro de esta cadena de la primera ocurrencia del carácter especificado, comenzando la búsqueda en el índice especificado.

        Si en un índice no menor quefromIndex, esteStringsecuencia de caracteres representada por el objeto, aparece un valor dechel carácter, se devuelve el índice de la primera aparición de este tipo. Para el rango de 0 a 0xFFFF (inclusive)chvalor, este es el mínimok, tal que: 

         (this.charAt(k) == ch) && (k >= fromIndex)
        es verdadero. Parachotros valores, es el mínimok, tal que: 
         (this.codePointAt(k) == ch) && (k >= fromIndex)
        es verdadero. En cualquier caso, si en la posiciónfromIndexo después, la cadena no contiene dicho carácter, se devuelve-1 。

        fromIndexel valor no tiene límite. Si es negativo, tiene el mismo efecto que cero: puede buscar en toda la cadena. Si es mayor que la longitud de esta cadena, tiene el mismo efecto que ser igual a la longitud de esta cadena: devolver-1 。

        Todos los índices se especifican encharvalor (unidades de código Unicode) especificado.

        Parámetros
        ch- Carácter (punto de código Unicode).
        fromIndex- el índice a partir del cual se inicia la búsqueda.
        Resultado
        El índice de la primera aparición del carácter en la secuencia de caracteres representada por este objeto, mayor o igual quefromIndex, si el carácter no aparece,-1 。

      • lastIndexOf

        public int lastIndexOf​(int ch)
        Devuelve el índice en esta cadena de la última ocurrencia del carácter especificado. Para el rango de 0 a 0xFFFF (inclusive)chvalor,chel índice (en unidades de código Unicode) es el máximok，tales que: 
         this.charAt(k) == ch
        es verdadero. Parachotros valores, es el máximok, tal que: 
         this.codePointAt(k) == ch
        es verdadero. En cualquier caso, si no aparece dicho carácter en esta cadena, se devuelve-1 。 Buscar hacia atrás desde el último carácterString 。
        Parámetros
        ch- Carácter (punto de código Unicode).
        Resultado
        El índice de la última aparición del carácter en la secuencia de caracteres representada por este objeto, si el carácter no aparece,-1 。

      • lastIndexOf

        public int lastIndexOf​(int ch,
                       int fromIndex)
        Devuelve el índice en esta cadena de la última ocurrencia del carácter especificado, buscando hacia atrás desde el índice especificado. Para el rango de 0 a 0xFFFF (inclusive)chvalor, el índice devuelto es el máximok, tal que: 
         (this.charAt(k) == ch) && (k <= fromIndex)
        es verdadero. Parachotros valores, es el máximok, tal que: 
         (this.codePointAt(k) == ch) && (k <= fromIndex)
        es verdadero. En cualquier caso, si en la posiciónfromIndexsi no aparece ningún carácter de este tipo en esta cadena en o antes de la posición, devuelve-1 。

        Todos los índices se especifican encharvalor (unidades de código Unicode) especificado.

        Parámetros
        ch- Un carácter (punto de código Unicode).
        fromIndexEl índice desde el cual comenzar la búsqueda. fromIndexel valor no tiene límite. Si es mayor o igual que la longitud de esta cadena, tiene el mismo efecto que si fuera igual a uno menos que la longitud de esta cadena: se puede buscar toda la cadena. Si es negativo, tiene el mismo efecto que -1: devuelve -1.
        Resultado
        El índice de la última aparición del carácter en la secuencia de caracteres representada por este objeto, que es menor o igual quefromIndex, si el carácter no aparece antes de ese punto,-1 。

      • 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.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 ocurre 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.startsWith(str, k)
        Si no existe tal valork, entonces-1devueltos.
        Parámetros
        str- la subcadena a buscar.
        fromIndex- el índice a partir del cual se inicia la búsqueda.
        Resultado
        El índice de la primera aparición de la subcadena especificada, comenzando en el índice especificado, si no ocurre 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.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 ocurre 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.startsWith(str, k)
        Si no existe tal valork, entonces-1devueltos.
        Parámetros
        str- la subcadena a buscar.
        fromIndex- el índice a partir del cual se inicia la búsqueda.
        Resultado
        Índice de la última aparición de la subcadena especificada, buscando hacia atrás desde el índice especificado; si no se produce tal caso,-1 。

      • substring

        public String substring​(int beginIndex)
        Devuelve una cadena que es una subcadena de esta cadena. La subcadena comienza con el carácter en el índice especificado y se extiende hasta el final de esta cadena.

        Ejemplo: 

         "unhappy".substring(2) returns "happy"
 "Harbison".substring(3) returns "bison"
 "emptiness".substring(9) returns "" (an empty string)
        Parámetros
        beginIndexÍndice inicial, inclusive.
        Resultado
        La subcadena especificada.
        Excepciones
        IndexOutOfBoundsException- sibeginIndexes negativo o mayor que estaStringla longitud del objeto.

      • substring

        public String substring​(int beginIndex,
                        int endIndex)
        Devuelve una cadena que es una subcadena de esta cadena. la subcadena desde el especificadobeginIndexcomienza y se extiende al índiceendIndex - 1el carácter en la posición. Por lo tanto, la longitud de la subcadena esendIndex-beginIndex 。

        Ejemplo: 

         "hamburger".substring(4, 8) returns "urge"
 "smiles".substring(1, 5) returns "mile"
        Parámetros
        beginIndexÍndice inicial, inclusive.
        endIndexÍndice final, exclusivo.
        Resultado
        La subcadena especificada.
        Excepciones
        IndexOutOfBoundsException- sibeginIndexes negativo, oendIndexmayor que estaStringla longitud del objeto, obeginIndexmayor queendIndex 。

      • subSequence

        public CharSequence subSequence​(int beginIndex,
                                int endIndex)
        Devuelve una secuencia de caracteres que es una subsecuencia de esta secuencia.

        La forma de llamar a este método 

         str.subSequence(begin, end)
        el comportamiento es exactamente el mismo que llamar a 
         str.substring(begin, end)
        Specified by:
        subSequenceEn la interfazCharSequence
        API Note:
        Se define este método para queStringlas clases puedan implementarloCharSequencela interfaz.
        Parámetros
        beginIndexÍndice inicial inclusive.
        endIndexÍndice final, exclusivo.
        Resultado
        la subsecuencia especificada.
        Excepciones
        IndexOutOfBoundsException- sibeginIndexoendIndexes negativo, siendIndexmayor quelength(), obeginIndexmayor queendIndex
        Desde la versión:
        1.4

      • concat

        public String concat​(String str)
        Concatena la cadena especificada al final de esta cadena.

        Si la longitud de la cadena del argumento es0, se devuelve esteStringobjeto. De lo contrario, se devuelve unStringobjeto, que representa una secuencia de caracteres, la cual está representada por esteStringla concatenación de la secuencia de caracteres representada por este objeto y la secuencia de caracteres representada por la cadena del argumento.

        Ejemplo: 

         "cares".concat("s") returns "caress"
 "to".concat("get").concat("her") returns "together"
        Parámetros
        str- EsteStringse concatena al final de esta cadena.String 。
        Resultado
        Una cadena que representa la concatenación de los caracteres de este objeto seguidos de los caracteres del argumento de cadena.

      • replace

        public String replace​(char oldChar,
                      char newChar)
        Devuelve una cadena que resulta de reemplazar todas las apariciones deoldCharen esta cadenanewChar 。

        Si el carácteroldCharno aparece en la secuencia de caracteres representada por esteStringobjeto, entonces el objeto de referenciaStringse devuelve. De lo contrario,StringEl objeto devuelto, que representa una secuencia de caracteres igual a la secuencia de caracteres representada por esteStringExcepto cada aparición del objeto,oldCharmediante el reemplazo de las apariciones denewChar 。

        Ejemplo: 

         "mesquite in your cellar".replace('e', 'o')
         returns "mosquito in your collar"
 "the war of baronets".replace('r', 'y')
         returns "the way of bayonets"
 "sparring with a purple porpoise".replace('p', 't')
         returns "starring with a turtle tortoise"
 "JonL".replace('q', 'x') returns "JonL" (no change)
        Parámetros
        oldChar- el carácter antiguo.
        newChar- el nuevo carácter.
        Resultado
        reemplazandooldCharCada coincidencia se reemplaza conoldChar ， newCharla cadena derivada de esta cadena.

      • matches

        public boolean matches​(String regex)
        Determina si esta cadena con lo dadoregular expressioncoincide.

        La llamadastr .matches( regex )una forma de este método produce el mismo resultado queexpresiónexactamente el mismo resultado

        Pattern. matches(regex, str)
        Parámetros
        regex- La expresión regular con la que se debe comparar esta cadena
        Resultado
        truesi y solo si esta cadena coincide con la expresión regular dada
        Excepciones
        PatternSyntaxExceptionSi la sintaxis de la expresión regular no es válida.
        Desde la versión:
        1.4
        Véase también:
        Pattern

      • contains

        public boolean contains​(CharSequence s)
        Devuelve true si y solo si esta cadena contiene la secuencia de valores char especificada.
        Parámetros
        s- la secuencia a buscar.
        Resultado
        Si esta cadena contienes, devuelve true; de lo contrario,s false
        Desde la versión:
        1.5

      • replaceFirst

        public String replaceFirst​(String regex,
                           String replacement)
        sustituir el dado por el reemplazo dadoregular expressionReemplaza la primera subcadena de esta cadena que coincida.

        La llamadastr .replaceFirst(una forma de este métodoregex , repl )produce exactamente el mismo resultado que la expresión

        Pattern.compile(regex).matcher(str).replaceFirst(repl)

        Tenga en cuenta que las barras invertidas (\) y el signo de dólar ($）puede provocar que el resultado difiera del que se obtendría si se tratara como una cadena de reemplazo literal; véaseMatcher.replaceFirst(java.lang.String) 。 Si es necesario, utiliceMatcher.quoteReplacement(java.lang.String)para suprimir el significado especial de estos caracteres.

        Parámetros
        regex- La expresión regular con la que se debe comparar esta cadena
        replacement- La cadena para reemplazar la primera coincidencia
        Resultado
        La cadena resultanteString
        Excepciones
        PatternSyntaxExceptionSi la sintaxis de la expresión regular no es válida.
        Desde la versión:
        1.4
        Véase también:
        Pattern

      • replaceAll

        public String replaceAll​(String regex,
                         String replacement)
        sustituir el dado por el reemplazo dadoregular expressionReemplaza cada subcadena de esta cadena que coincida.

        La llamadastr .replaceAll(una forma de este métodoregex , repl )produce exactamente el mismo resultado que la expresión

        Pattern.compile(regex).matcher(str).replaceAll(repl)

        Tenga en cuenta que las barras invertidas (\) y el signo de dólar ($）puede dar lugar a un resultado distinto del que se obtendría si se tratara como una cadena de reemplazo literal; véaseMatcher.replaceAll 。 Si es necesario, utiliceMatcher.quoteReplacement(java.lang.String)para suprimir el significado especial de estos caracteres.

        Parámetros
        regex- La expresión regular con la que se debe comparar esta cadena
        replacementLa cadena que se sustituirá por cada coincidencia.
        Resultado
        La cadena resultanteString
        Excepciones
        PatternSyntaxExceptionSi la sintaxis de la expresión regular no es válida.
        Desde la versión:
        1.4
        Véase también:
        Pattern

      • replace

        public String replace​(CharSequence target,
                      CharSequence replacement)
        Reemplaza cada subcadena de esta cadena que coincide con la secuencia objetivo literal por la secuencia de reemplazo literal especificada. La sustitución se realiza desde el principio hasta el final de la cadena; por ejemplo, en la cadena “aaa”, sustituir “aa” por “b” produce “ba”, no “ab”.
        Parámetros
        targetLa secuencia de valores char que se va a reemplazar.
        replacementLa secuencia de reemplazo de valores char.
        Resultado
        Cadena resultante
        Desde la versión:
        1.5

      • split

        public String[] split​(String regex,
                      int limit)
        Divide esta cadena en torno a la dadade la expresión regular.coincidenciaelemento 。

        La matriz devuelta por este método contiene cada subcadena de esta cadena que está terminada por otra subcadena que coincide con la expresión dada o por el final de la cadena. Las subcadenas de la matriz se ordenan según el orden en que aparecen en esta cadena. Si la expresión no coincide con ninguna parte de la entrada, la matriz resultante tiene un solo elemento, que es esta cadena.

        Cuando existe una coincidencia de ancho positivo al principio de esta cadena, se incluye una subcadena inicial vacía al principio de la matriz resultante. Sin embargo, una coincidencia de ancho cero al principio nunca produce una subcadena inicial vacía de ese tipo.

        limitEl parámetro controla el número de veces que se aplica el patrón y, por lo tanto, afecta a la longitud de la matriz resultante.

        • SiLímiteSi es positivo, el patrón se aplicará como máximoLímite- 1 veces, la longitud de la matriz no excederá deLímite, y el último elemento del array contendrá toda la entrada que quede después del último delimitador coincidente.

        • SiLímiteSi es cero, el patrón se aplicará tantas veces como sea posible, el array puede tener cualquier longitud y se descartarán las cadenas vacías finales.

        • SiLímiteSi es negativo, el patrón se aplicará tantas veces como sea posible y el array puede tener cualquier longitud.

        Por ejemplo, la cadena"boo:and:foo"Con los siguientes parámetros se generan los siguientes resultados:

        Split example showing regex, limit, and result
        Regex Limit Result
        : 2 { "boo", "and:foo" }
        5 { "boo", "and", "foo" }
        -2 { "boo", "and", "foo" }
        o 5 { "b", "", ":and:f", "", "" }
        -2 { "b", "", ":and:f", "", "" }
        0 { "b", "", ":and:f" }

        La llamadastrEsta forma del método。 split( regex , n )produce el mismo resultado que la expresión

        Pattern.compile(regex).split(str, n)
        Parámetros
        regexExpresión regular delimitadora.
        limit- el umbral resultante, como se mencionó anteriormente.
        Resultado
        Una matriz de cadenas calculada dividiendo esta cadena alrededor de las coincidencias de la expresión regular dada
        Excepciones
        PatternSyntaxExceptionSi la sintaxis de la expresión regular no es válida.
        Desde la versión:
        1.4
        Véase también:
        Pattern

      • split

        public String[] split​(String regex)
        Divide esta cadena en torno a la dadade la expresión regular.coincidenciaelemento 。

        Este método actúa como si se invocara el método de dos parámetros usando la expresión dada y el parámetro limit igual a cerosplitel método es el mismo. Por lo tanto, las cadenas vacías finales no se incluyen en el array resultante.

        Por ejemplo, la cadena"boo:and:foo"Con la siguiente expresión se generan los siguientes resultados:

        Split examples showing regex and result
        Regex Result
        : { "boo", "and", "foo" }
        o { "b", "", ":and:f" }
        Parámetros
        regexExpresión regular delimitadora.
        Resultado
        Una matriz de cadenas calculada dividiendo esta cadena alrededor de las coincidencias de la expresión regular dada
        Excepciones
        PatternSyntaxExceptionSi la sintaxis de la expresión regular no es válida.
        Desde la versión:
        1.4
        Véase también:
        Pattern

      • join

        public static String join​(CharSequence delimiter,
                          CharSequence... elements)
        Devuelve unCharSequence elementsnuevo String compuesto de copias de, dichas copias con la especificadadelimitercopias unidas entre sí.
        For example, 
        
     String message = String.join("-", "Java", "is", "cool");
     // message returned is: "Java-is-cool"
        Tenga en cuenta que si el elemento es null, se añade"null" 。
        Parámetros
        delimiterEl delimitador que se utiliza para separar cada elemento.
        elementsLos elementos que se van a unir.
        Resultado
        un nuevoString, que consta del mencionadoelementsseparado pordelimiter
        Excepciones
        NullPointerException- sidelimiteroelementsSínull
        Desde la versión:
        1.8
        Véase también:
        StringJoiner

      • join

        public static String join​(CharSequence delimiter,
                          Iterable<? extends CharSequence> elements)
        Devuelve unStringnuevo compuesto de copias deString, dondeCharSequence elementslo especificadodelimitercopias de.
        For example, 
        
     List<String> strings = List.of("Java", "is", "cool");
     String message = String.join(" ", strings);
     //message returned is: "Java is cool"

     Set<String> strings =
         new LinkedHashSet<>(List.of("Java", "is", "very", "cool"));
     String message = String.join("-", strings);
     //message returned is: "Java-is-very-cool"
        Tenga en cuenta que si un solo elemento esnull, se añade"null" 。
        Parámetros
        delimiter- La secuencia de caracteres utilizada para separar cada unoelementsen el resultadoString
        elements - Iterableloelementsconcatenados entre sí.
        Resultado
        Razónelementsnueva compuesta por los parámetrosString
        Excepciones
        NullPointerException- sidelimiteroelementsSínull
        Desde la versión:
        1.8
        Véase también:
        join(CharSequence,CharSequence...) ， StringJoiner

      • toLowerCase

        public String toLowerCase​(Locale locale)
        Usando la configuración regional dadaLocalelas reglas de esta cadenaStringtodos los caracteres se convierten aLocale 。 El mapeo de mayúsculas y minúsculas se basa enCharacterla versión del estándar Unicode especificada por la clase. Dado que el mapeo de mayúsculas y minúsculas no siempre es una correspondencia de caracteres 1:1, el resultado generadoStringpuede tener una longitudStringdiferente de la original.

        Los ejemplos del mapeo a minúsculas se muestran en la siguiente tabla:

        Lowercase mapping examples showing language code of locale, upper case, lower case, and description Language Code of Locale Upper Case Lower Case Description tr (Turkish) \u0130 \u0069 capital letter I with dot above -> small letter i tr (Turkish) \u0049 \u0131 capital letter I -> small letter dotless i (all) French Fries french fries lowercased all chars in String (all) ΙΧΘΥΣ ιχθυσ lowercased all chars in String
        Parámetros
        locale- Utilizando las reglas de conversión de mayúsculas y minúsculas de esta configuración regional
        Resultado
        String, convertida a minúsculas.
        Desde la versión:
        1.1
        Véase también:
        toLowerCase() ， toUpperCase() ， toUpperCase(Locale)

      • toLowerCase

        public String toLowerCase()
        Usando las reglas de la configuración regional predeterminada, esta cadenaStringConvierte todos los caracteres a minúsculas. Esto es equivalente a llamartoLowerCase(Locale.getDefault()) 。

        Nota:Este método es sensible a la configuración regional y, si se utiliza en cadenas que deben interpretarse independientemente de la configuración regional, puede producir resultados inesperados. Ejemplos son identificadores de lenguajes de programación, claves de protocolo y etiquetas HTML. Por ejemplo,"TITLE".toLowerCase()en la configuración regional turca devuelve"t\u0131tle", donde “\u0131” es el carácter de la i latina minúscula sin punto. Para obtener resultados correctos de cadenas insensibles a la configuración regional, utilicetoLowerCase(Locale.ROOT) 。

        Resultado
        String, convertida a minúsculas.
        Véase también:
        toLowerCase(Locale)

      • toUpperCase

        public String toUpperCase​(Locale locale)
        Usando la configuración regional dadaLocalelas reglas de esta cadenaStringConvierte todos los caracteres a mayúsculas. El mapeo de mayúsculas y minúsculas se basa enCharacterla versión del estándar Unicode especificada por la clase. Dado que la asignación de mayúsculas y minúsculas no siempre es una asignación de caracteres 1:1, el resultadoStringpuede tener una longitudStringdiferente de la original.

        En la siguiente tabla se muestran ejemplos de asignaciones de mayúsculas y minúsculas sensibles a la configuración regional y de asignaciones 1:M.

        Examples of locale-sensitive and 1:M case mappings. Shows Language code of locale, lower case, upper case, and description. Language Code of Locale Lower Case Upper Case Description tr (Turkish) \u0069 \u0130 small letter i -> capital letter I with dot above tr (Turkish) \u0131 \u0049 small letter dotless i -> capital letter I (all) \u00df \u0053 \u0053 small letter sharp s -> two letters: SS (all) Fahrvergnügen FAHRVERGNÜGEN
        Parámetros
        locale- Utilizando las reglas de conversión de mayúsculas y minúsculas de esta configuración regional
        Resultado
        String, convertida a mayúsculas.
        Desde la versión:
        1.1
        Véase también:
        toUpperCase() ， toLowerCase() ， toLowerCase(Locale)

      • toUpperCase

        public String toUpperCase()
        Usando las reglas de la configuración regional predeterminada, esta cadenaStringConvierte todos los caracteres a mayúsculas. Este método equivale atoUpperCase(Locale.getDefault()) 。

        Nota:Este método es sensible a la configuración regional y, si se utiliza en cadenas que deben interpretarse independientemente de la configuración regional, puede producir resultados inesperados. Ejemplos son identificadores de lenguajes de programación, claves de protocolo y etiquetas HTML. Por ejemplo,"title".toUpperCase()en la configuración regional turca devuelve"T\u0130TLE", donde “\u0130” es el carácter de la I latina mayúscula con punto arriba. Para obtener resultados correctos de cadenas insensibles a la configuración regional, utilicetoUpperCase(Locale.ROOT) 。

        Resultado
        String, convertida a mayúsculas.
        Véase también:
        toUpperCase(Locale)

      • trim

        public String trim()
        Devuelve una cadena cuyo valor es esta cadena, con todos los espacios iniciales y finales eliminados, donde espacio se define como cualquier carácter cuyo punto de código sea menor o igual a'U+0020'cualquier carácter (el carácter de espacio).

        Si elStringobjeto representa una secuencia de caracteres vacía, o los primeros y últimos caracteres de la secuencia de caracteres representada por este objetoStringEl objeto tiene ambos códigos que no son espacio (como se definió anteriormente), entonces esta referenciaStringse devuelve.

        De lo contrario, si todos los caracteres de esta cadena son espacio (como se indicó anteriormente), se devuelve un objeto que representa la cadena vacíaStringobjeto.

        De lo contrario, seaksea el índice del primer carácter en la cadena cuyo código no es espacio (como se definió anteriormente), y seamsea el índice del último carácter en la cadena cuyo código no es espacio (como se definió anteriormente). Devuelve unStringobjeto, que representa una subcadena de esta cadena, que en el índicekcomienza con el carácter en el índicemy termina con el carácter en el índice, es decirthis.substring(k, m + 1)el resultado de.

        Este método se puede utilizar para recortar espacios desde el principio y el final de la cadena (como se mencionó anteriormente).

        Resultado
        Una cadena cuyo valor es esta cadena, con todos los espacios en blanco iniciales y finales eliminados, o esta cadena si no tiene espacios en blanco iniciales ni finales.

      • strip

        public String strip()
        Devuelve una cadena cuyo valor es esta cadena, con todos los espacios en blanco iniciales y finales eliminados.white space 。

        Si elStringEl objeto representa una cadena vacía, o todos los puntos de código en esta cadena sonwhite spaceentonces se devuelve una cadena vacía.

        De lo contrario, devuelve una subcadena de esta cadena, que comienza con el primer punto de código que no eswhite spacedepunto de código, incluyendo el último que no eswhite spacedepuntos de código.

        Este método se puede utilizar para eliminar desde el principio y el final de la cadenawhite space 。

        Resultado
        Una cadena cuyo valor es esta cadena, con todos los espacios en blanco iniciales y finales eliminados
        Desde la versión:
        11
        Véase también:
        Character.isWhitespace(int)

      • stripLeading

        public String stripLeading()
        Devuelve una cadena cuyo valor es esta cadena, con todos los espacios en blanco iniciales eliminados.white space 。

        Si elStringEl objeto representa una cadena vacía, o todos los puntos de código en esta cadena sonwhite spaceentonces se devuelve una cadena vacía.

        De lo contrario, devuelve una subcadena de esta cadena, que comienza con el primer punto de código que no eswhite spacedecomienza con el punto de código, e incluye el último punto de código de la cadena.

        Este método se puede utilizar para recortar desde el principio de la cadenawhite space 。

        Resultado
        Una cadena cuyo valor es esta cadena, con todos los espacios en blanco iniciales eliminados
        Desde la versión:
        11
        Véase también:
        Character.isWhitespace(int)

      • stripTrailing

        public String stripTrailing()
        Devuelve una cadena cuyo valor es esta cadena, y elimina todos los espacios en blanco finales.white space 。

        Si elStringEl objeto representa una cadena vacía, o todos los caracteres de esta cadena sonwhite spaceentonces se devuelve una cadena vacía.

        De lo contrario, devuelve una subcadena de esta cadena, comenzando con el primer punto de código de la cadena, incluyendo el último que no eswhite spacedepuntos de código.

        Este método se puede utilizar para recortar desde el final de la cadenawhite space 。

        Resultado
        Una cadena cuyo valor es esta cadena, con todos los espacios en blanco finales eliminados
        Desde la versión:
        11
        Véase también:
        Character.isWhitespace(int)

      • isBlank

        public boolean isBlank()
        Si la cadena está vacía o contiene solowhite spaceunidadpuntos de código, entonces devuelvetrue, de lo contrariofalse 。
        Resultado
        trueSi la cadena está vacía o contiene solowhite spacepunto de código, de lo contrariofalse
        Desde la versión:
        11
        Véase también:
        Character.isWhitespace(int)

      • lines

        public Stream<String> lines()
        Devuelve un flujo de líneas extraídas de esta cadena, separadas por terminadores de línea.

        Terminador de líneaes uno de los siguientes: un carácter de nueva línea"\n"(U + 000A), un carácter de retorno de carro"\r"(U + 000D), o un retorno de carro seguido inmediatamente de"\r\n" （U + 000D U + 000A） 。

        una líneaes una secuencia de cero o más caracteres, seguida de un terminador de línea, o una secuencia de uno o más caracteres, seguida del final de la cadena. Una línea no incluye el terminador de línea.

        El flujo devuelto por este método contiene las líneas que aparecen en esta cadena.

        API Note:
        Estede la líneaLa definición significa que una cadena vacía tiene cero líneas, y que un terminador de línea al final de la cadena no va seguido de una línea vacía.
        Implementation Note:
        Al proporcionar los elementos de forma perezosa y buscar nuevos terminadores de línea más rápido, este método ofrece un mejor rendimiento que split("\R").
        Resultado
        Flujo de líneas extraído de esta cadena.
        Desde la versión:
        11

      • toString

        public String toString()
        Este objeto (¡que ya es una cadena!) se devuelve a sí mismo.
        Specified by:
        toStringEn la interfazCharSequence
        Sobrescribe:
        toStringEn la claseObject
        Resultado
        la propia cadena.

      • 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.
        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 los caracteres BMP normales, los sustitutos no emparejados y las unidades de código no definidas) se extenderá con ceros aintvalor, y luego se pasa al flujo.
        Specified by:
        codePointsEn la interfazCharSequence
        Resultado
        IntStream de códigos Unicode apunta a esta secuencia.
        Desde la versión:
        9

      • toCharArray

        public char[] toCharArray()
        Convierte esta cadena en una nueva matriz de caracteres.
        Resultado
        Una matriz de caracteres recién asignada cuya longitud es la longitud de esta cadena y cuyo contenido se inicializa para contener la secuencia de caracteres representada por esta cadena.

      • format

        public static String format​(String format,
                            Object... args)
        Devuelve una cadena formateada usando la cadena de formato y los argumentos especificados.

        El locale que se utiliza siempre es el devuelto porLocale.getDefault(Locale.Category)el locale devuelto, en el que se especifica laFORMATcategoría.

        Parámetros
        format - A format string
        args- Los argumentos referenciados por los especificadores de formato en la cadena de formato. Si hay más argumentos que especificadores de formato, se ignoran los argumentos adicionales. El número de argumentos es variable y puede ser cero. El número máximo de argumentos está sujeto aThe Java™ Virtual Machine Specificationla limitación de la dimensión máxima de los arrays de Java definida. nullEl comportamiento de los argumentos depende deconversion 。
        Resultado
        cadena formateada
        Excepciones
        IllegalFormatException- Si la cadena de formato contiene sintaxis ilegal, un especificador de formato incompatible con los argumentos dados, argumentos insuficientes para la cadena de formato dada u otras condiciones ilegales. Para una explicación de todos los posibles errores de formato, consulte la especificación de la clase formatter,Detailssección.
        Desde la versión:
        1.5
        Véase también:
        Formatter

      • format

        public static String format​(Locale l,
                            String format,
                            Object... args)
        Devuelve una cadena formateada usando el locale, la cadena de formato y los argumentos especificados.
        Parámetros
        l- La que se aplica durante el formato.locale 。 SilSínullentonces no se aplica la localización.
        format - A format string
        args- Los argumentos referenciados por los especificadores de formato en la cadena de formato. Si hay más argumentos que especificadores de formato, se ignoran los argumentos adicionales. El número de argumentos es variable y puede ser cero. El número máximo de argumentos está sujeto aThe Java™ Virtual Machine Specificationla limitación de la dimensión máxima de los arrays de Java definida. nullEl comportamiento sobre el argumento depende de laconversion 。
        Resultado
        cadena formateada
        Excepciones
        IllegalFormatException- Si la cadena de formato contiene sintaxis ilegal, un especificador de formato incompatible con los argumentos dados, argumentos insuficientes para la cadena de formato dada u otras condiciones ilegales. Para una explicación de todos los posibles errores de formato, consulte la especificación de la clase formatter,Detailssección.
        Desde la versión:
        1.5
        Véase también:
        Formatter

      • valueOf

        public static String valueOf​(Object obj)
        DevuelveObjectLa representación de cadena del argumento.
        Parámetros
        obj - Object 。
        Resultado
        Si el argumento esnull, entonces la cadena es igual a"null" ; de lo contrario, el valor de retornoobj.toString() 。
        Véase también:
        Object.toString()

      • valueOf

        public static String valueOf​(char[] data)
        DevuelvecharRepresentación de cadena del parámetro de matriz. Copia el contenido de la matriz de caracteres; Las modificaciones posteriores de la matriz de caracteres no afectan a la cadena devuelta.
        Parámetros
        data- matriz de caracteres.
        Resultado
        a String, que contiene los caracteres de la matriz de caracteres.

      • valueOf

        public static String valueOf​(char[] data,
                             int offset,
                             int count)
        DevuelvecharRepresentación de cadena de la submatriz especificada del parámetro de matriz.

        offsetEl parámetro es la submatrizoffsetel índice del primer carácter. countEl parámetro especifica la submatrizcountla longitud de la submatriz. Copia el contenido de la submatriz; Las modificaciones posteriores de la matriz de caracteres no afectan a la cadena devuelta.

        Parámetros
        data- matriz de caracteres.
        offsetDesplazamiento inicial de la submatriz.
        countLongitud de la submatriz.
        Resultado
        a String, que contiene los caracteres de la submatriz especificada de la matriz de caracteres.
        Excepciones
        IndexOutOfBoundsException- sioffsetes negativo, ocountes negativo, ooffset+countmayor quedata.length 。

      • copyValueOf

        public static String copyValueOf​(char[] data,
                                 int offset,
                                 int count)
        equivalente avalueOf(char[], int, int) 。
        Parámetros
        data- matriz de caracteres.
        offsetDesplazamiento inicial de la submatriz.
        countLongitud de la submatriz.
        Resultado
        a String, que contiene los caracteres de la submatriz especificada de la matriz de caracteres.
        Excepciones
        IndexOutOfBoundsException- sioffsetes negativo, ocountes negativo, ooffset+countmayor quedata.length 。

      • copyValueOf

        public static String copyValueOf​(char[] data)
        equivalente avalueOf(char[]) 。
        Parámetros
        data- matriz de caracteres.
        Resultado
        que contiene los caracteres de la matriz de caracteresString 。

      • valueOf

        public static String valueOf​(boolean b)
        DevuelvebooleanLa representación de cadena del argumento.
        Parámetros
        b - a boolean 。
        Resultado
        Si el argumento estrue, entonces devuelve una cadena igual a"true"la cadena; de lo contrario, devuelve una cadena igual a"false"la cadena.

      • valueOf

        public static String valueOf​(char c)
        DevuelvecharLa representación de cadena del argumento.
        Parámetros
        c - a char 。
        Resultado
        Una cadena de longitud1la cadena,1contiene el argumentoccomo sus caracteres individuales.

      • valueOf

        public static String valueOf​(int i)
        DevuelveintLa representación de cadena del argumento.

        Esta representación es exactamente la de un argumentoInteger.toStringla representación devuelta por el método.

        Parámetros
        i - int 。
        Resultado
        intRepresentación de cadena del argumento.
        Véase también:
        Integer.toString(int, int)

      • valueOf

        public static String valueOf​(long l)
        DevuelvelongLa representación de cadena del argumento.

        Esta representación es exactamente la de un argumentoLong.toStringla representación devuelta por el método.

        Parámetros
        l - a long 。
        Resultado
        longRepresentación de cadena del argumento.
        Véase también:
        Long.toString(long)

      • valueOf

        public static String valueOf​(float f)
        DevuelvefloatLa representación de cadena del argumento.

        Esta representación es exactamente la de un argumentoFloat.toStringla representación devuelta por el método.

        Parámetros
        f - a float 。
        Resultado
        floatRepresentación de cadena del argumento.
        Véase también:
        Float.toString(float)

      • valueOf

        public static String valueOf​(double d)
        DevuelvedoubleLa representación de cadena del argumento.

        Esta representación es exactamente la de un argumentoDouble.toStringla representación devuelta por el método.

        Parámetros
        d - a double 。
        Resultado
        doubleRepresentación de cadena del argumento.
        Véase también:
        Double.toString(double)

      • intern

        public String intern()
        Devuelve la representación canónica del objeto String.

        El conjunto de cadenas, inicialmente vacío, es mantenido por la claseStringde forma privada.

        Al invocar el método intern, si el pool ya contiene una cadena igual aStringdeterminada por el métodoStringla cadena del objeto, entonces se devuelve la cadena del pool. De lo contrario, esteStringobjeto se añade al pool, y se devuelve una referencia a esteStringobjeto.

        Por lo tanto, para dos cadenas cualesquierasyt ， s.intern() == t.intern()Sítruesi y solo sis.equals(t)Paratrue 。

        Todas las cadenas literales y las expresiones constantes con valor de cadena están internadas. Las cadenas literales se definen ende The Java™ Language Specificationdefinidas en la sección 3.10.5.

        Resultado
        Una cadena que tiene el mismo contenido que esta cadena, pero que se garantiza que proviene de un grupo de cadenas únicas.
        See The Java™ Language Specification:
        3.10.5 Literales de cadena.

      • repeat

        public String repeat​(int count)
        Devuelve una cadena cuyo valor es la concatenación de esta cadena repetidacountveces.

        Si esta cadena está vacía o count es cero, entonces se devuelve una cadena vacía.

        Parámetros
        count- número de repeticiones
        Resultado
        La cadena formada por esta cadena repetida.countveces; si esta cadena está vacía o count es cero, entonces es una cadena vacía.
        Excepciones
        IllegalArgumentException- sicountes negativo.
        Desde la versión:
        11