模块  java.base
Paquetage java.lang

Class String

  • Toutes les interfaces implémentées
    Serializable , CharSequence , Comparable<String>

    public final class String
    extends Object
    implements Serializable, Comparable<String>, CharSequence
    StringLa classe représente une chaîne de caractères. Toutes les chaînes littérales d'un programme Java (par exemple"abc") sont des instances de cette classe. Les chaînes sont immuables. Leur valeur ne change pas après la création. Les tampons de chaînes gèrent les chaînes modifiables. Les objets String sont immuables, donc on peut les partager. Par exemple :

         String str = "abc";
     

    équivaut à :

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

    Voici quelques exemples d'utilisation des chaînes :

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

    La classeStringCela comprend des méthodes pour examiner chaque caractère d'une séquence, comparer des chaînes, rechercher dans des chaînes et extraire des sous-chaînes. Cela comprend aussi des méthodes pour créer une copie d'une chaîne avec tous les caractères traduits en majuscules ou en minuscules. Le mappage de casse est basé surCharacter.

    Le langage Java fournit une prise en charge spéciale de l'opérateur de concaténation de chaînes (+) et de la conversion des autres objets en chaînes. Pour plus d'informations sur la concaténation et la conversion de chaînes, consultez la spécification du langage Java.

    Sauf indication contraire, le passage d'un argument null ànullun constructeur ou une méthode denullprovoquera le lancement d'uneNullPointerException.

    UnStringreprésente une chaîne au format UTF-16, où les caractères supplémentaires sont représentés par des paires de substitution (voir la section Unicode Character Representations dansCharacterpour plus d'informations sur cette classe). Les valeurs d'index font référence à descharunités de code, donc un caractère supplémentaire occupeStringdeux positions.

    StringLa classe fournit des méthodes pour traiter les points de code Unicode (c'est-à-dire les caractères), ainsi que des méthodes pour traiter les unités de code Unicode (c'est-à-dire lescharvaleurs).

    Sauf indication contraire, les méthodes de comparaison de chaînes ne tiennent pas compte des paramètres régionaux.CollatorLa classe fournit des méthodes de comparaison de String plus fines et sensibles aux paramètres régionaux.

    Implementation Note : tant que le compilateur est conforme à la spécification du langage Java, l'implémentation de l'opérateur de concaténation de chaînes est laissée à la discrétion du compilateur Java. Par exemple,
    javacle compilateur peut implémenter l'opérateur avecStringBuffer , StringBuilder ,或java.lang.invoke.StringConcatFactoryselon la version du JDK. La conversion de chaînes est généralement implémentée via la méthodetoString ,由Objectdéfinie par et héritée par toutes les classes en Java. Depuis la version : 1.0 Voir aussi :
    Object.toString(),StringBuffer,StringBuilder,Charset, Serialized Form Voir The Java™ Language Specification : 15.18.1 Opérateur de concaténation de chaînes +
    • 构造方法摘要

      Constructeur Description
      String()
      Initialise un objetStringnouvellement créé pour qu'il représente une séquence de caractères vide.
      String​(byte[] bytes)
      Construit un nouveauString 。
      String​(byte[] ascii, int hibyte)
      Obsolète. Cette méthode ne convertit pas correctement les octets en caractères.
      String​(byte[] bytes, int offset, int length)
      Construit un nouveauString 。
      String​(byte[] ascii, int hibyte, int offset, int count)
      Obsolète. Cette méthode ne convertit pas correctement les octets en caractères.
      String​(byte[] bytes, int offset, int length, String charsetName)
      Construit un nouveauStringen décodant le sous-tableau d'octets spécifié String 。
      String​(byte[] bytes, int offset, int length, Charset charset)
      Construit un nouveauStringen décodant le sous-tableau d'octets spécifié avec le charset indiqué.
      String​(byte[] bytes, String charsetName)
      Construit un nouveauStringen décodant le tableau d'octets spécifié avec le charset indiqué.
      String​(byte[] bytes, Charset charset)
      Construit un nouveauStringen décodant le tableau d'octets spécifié avec le charset indiqué.
      String​(char[] value)
      Alloue un nouveauString qui représente la séquence de caractères actuellement contenue dans le paramètre tableau de caractères.
      String​(char[] value, int offset, int count)
      Alloue un nouveauString qui contient les caractères du sous-tableau du paramètre tableau de caractères.
      String​(int[] codePoints, int offset, int count)
      Alloue un nouveauStringqui contient les caractères du sous-tableau du paramètre tableau de points de code Unicode.
      String​(String original)
      Initialise l'objetStringnouvellement créé pour représenter la même séquence de caractères que le paramètre. En d'autres termes, la chaîne nouvellement créée est une copie de la chaîne du paramètre.
      String​(StringBuffer buffer)
      Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans le paramètre StringBuffer.
      String​(StringBuilder builder)
      Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans le paramètre StringBuilder.
    • 方法摘要

      Toutes les méthodes Méthodes statiques Méthodes d'instance Méthodes concrètes Méthodes obsolètes Variable et type Méthode Description
      char charAt​(int index)
      Retourne la valeurcharà l'index spécifié.
      IntStream chars()
      Retourne un flux deintqui étend à zéro les valeurs charde cette séquence.
      int codePointAt​(int index)
      Retourne le caractère (point de code Unicode) à l'index spécifié.
      int codePointBefore​(int index)
      Retourne le caractère (point de code Unicode) précédant l'index spécifié.
      int codePointCount​(int beginIndex, int endIndex)
      Retourne le nombre de points de code Unicode dans la plage de texte spécifiée de ceString.
      IntStream codePoints()
      Retourne un flux des valeurs de points de code de cette séquence.
      int compareTo​(String anotherString)
      Compare deux chaînes par ordre lexicographique.
      int compareToIgnoreCase​(String str)
      Compare deux chaînes par ordre lexicographique en ignorant les différences de casse.
      String concat​(String str)
      Concatène la chaîne spécifiée à la fin de cette chaîne.
      boolean contains​(CharSequence s)
      Retourne true si et seulement si cette chaîne contient la séquence de valeurs char spécifiée.
      boolean contentEquals​(CharSequence cs)
      Compare cette chaîne avec leCharSequence 。
      boolean contentEquals​(StringBuffer sb)
      Compare cette chaîne avec leStringBuffer 。
      static String copyValueOf​(char[] data)
      Équivaut àvalueOf(char[]) 。
      static String copyValueOf​(char[] data, int offset, int count)
      Équivaut àvalueOf(char[], int, int) 。
      boolean endsWith​(String suffix)
      Teste si cette chaîne se termine par le suffixe spécifié.
      boolean equals​(Object anObject)
      Compare cette chaîne avec l'objet spécifié.
      boolean equalsIgnoreCase​(String anotherString)
      Compare cetteStringavec une autre Stringen ignorant la casse.
      static String format​(String format, Object... args)
      Retourne une chaîne formatée avec la chaîne de format et les arguments spécifiés.
      static String format​(Locale l, String format, Object... args)
      Retourne une chaîne formatée avec les paramètres régionaux, la chaîne de format et les arguments spécifiés.
      byte[] getBytes()
      Encode cetteStringen une séquence d'octets avec le jeu de caractères par défaut de la plateforme, puis stocke le résultat dans un nouveau tableau d'octets.
      void getBytes​(int srcBegin, int srcEnd, byte[] dst, int dstBegin)
      Obsolète. Cette méthode ne convertit pas correctement les caractères en octets.
      byte[] getBytes​(String charsetName)
      Encode cetteStringen une séquence d'octets avec le jeu de caractères nommé, puis stocke le résultat dans un nouveau tableau d'octets.
      byte[] getBytes​(Charset charset)
      Encode cetteStringen une séquence d'octets avec le charset donné, puis stocke le résultat dans un nouveau tableau d'octets.
      void getChars​(int srcBegin, int srcEnd, char[] dst, int dstBegin)
      Copie les caractères de cette chaîne dans le tableau de caractères cible.
      int hashCode()
      Retourne le code de hachage de cette chaîne.
      int indexOf​(int ch)
      Retourne l'index de la première occurrence du caractère spécifié dans la chaîne.
      int indexOf​(int ch, int fromIndex)
      Retourne l'index de la première occurrence du caractère spécifié dans cette chaîne, à partir de l'index de recherche spécifié.
      int indexOf​(String str)
      Retourne l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne.
      int indexOf​(String str, int fromIndex)
      À partir de l'index spécifié, retourne l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne.
      String intern()
      Retourne la représentation canonique de l'objet chaîne.
      boolean isBlank()
      Retournewhite spacesi la chaîne est vide ou ne contient que des points de codetrue , sinon false 。
      boolean isEmpty()
      Retournetruesi et seulement silength()est0 。
      static String join​(CharSequence delimiter, CharSequence... elements)
      Retourne une nouvelle String composée d'une copie deCharSequence elementsconcaténée avec une copie du delimiterspécifié.
      static String join​(CharSequence delimiter, Iterable<? extends CharSequence> elements)
      Retourne une nouvelleStringcomposée d'une copie de String , où CharSequence elementsspécifié delimiterune copie.
      int lastIndexOf​(int ch)
      Retourne l'index de la dernière occurrence du caractère spécifié dans la chaîne.
      int lastIndexOf​(int ch, int fromIndex)
      Retourne l'index de la dernière occurrence du caractère spécifié dans la chaîne. La recherche part de l'index donné en arrière.
      int lastIndexOf​(String str)
      Retourne l'index de la dernière occurrence de la sous-chaîne spécifiée dans la chaîne.
      int lastIndexOf​(String str, int fromIndex)
      Retourne l'index de la dernière occurrence de la sous-chaîne spécifiée dans la chaîne. La recherche part de l'index donné en arrière.
      int length()
      Retourne la longueur de cette chaîne.
      Stream<String> lines()
      Retourne un flux de lignes extraites de cette chaîne. Les lignes sont séparées par des terminateurs de ligne.
      boolean matches​(String regex)
      Vérifie si cette chaîne correspond à l'expression régulière donnée.
      int offsetByCodePoints​(int index, int codePointOffset)
      Retourne l'index dans cetteStringchaîne. Cet index part du indexdécalage codePointOffsetdonné en points de code.
      boolean regionMatches​(boolean ignoreCase, int toffset, String other, int ooffset, int len)
      Teste si deux régions de chaînes sont égales.
      boolean regionMatches​(int toffset, String other, int ooffset, int len)
      Teste si deux régions de chaînes sont égales.
      String repeat​(int count)
      Retourne une chaîne dont la valeur est la concaténation de cette chaîne répétéecountfois.
      String replace​(char oldChar, char newChar)
      Retourne une chaîne où toutes les occurrences deoldChardans cette chaîne newChar 。
      String replace​(CharSequence target, CharSequence replacement)
      Remplace chaque sous-chaîne correspondant à la séquence cible littérale par la séquence de remplacement littérale spécifiée.
      String replaceAll​(String regex, String replacement)
      Remplace chaque sous-chaîne de cette chaîne correspondant à l'expression régulière donnée par le remplacement donné.
      String replaceFirst​(String regex, String replacement)
      Remplace la première sous-chaîne de cette chaîne correspondant à l'expression régulière donnée par le remplacement donné.
      String[] split​(String regex)
      Divise cette chaîne autour des correspondances de l'expression régulière donnée.
      String[] split​(String regex, int limit)
      Divise cette chaîne autour des correspondances de l'expression régulière donnée.
      boolean startsWith​(String prefix)
      Teste si cette chaîne commence par le préfixe spécifié.
      boolean startsWith​(String prefix, int toffset)
      Teste si la sous-chaîne de cette chaîne à partir de l'index spécifié commence par le préfixe spécifié.
      String strip()
      Retourne une chaîne dont la valeur est cette chaîne. Tous les espaces de début et de fin sont suppriméswhite space 。
      String stripLeading()
      Retourne une chaîne dont la valeur est cette chaîne. Tous les espaces de début sont suppriméswhite space 。
      String stripTrailing()
      Retourne une chaîne dont la valeur est cette chaîne. Tous les espaces de fin sont suppriméswhite space 。
      CharSequence subSequence​(int beginIndex, int endIndex)
      Retourne la séquence de caractères qui est une sous-séquence de cette séquence.
      String substring​(int beginIndex)
      Retourne une chaîne qui est une sous-chaîne de cette chaîne.
      String substring​(int beginIndex, int endIndex)
      Retourne une chaîne qui est une sous-chaîne de cette chaîne.
      char[] toCharArray()
      Convertit cette chaîne en un nouveau tableau de caractères.
      String toLowerCase()
      Convertit tous les caractères de cetteStringchaîne en minuscules. Les règles des paramètres régionaux par défaut s'appliquent.
      String toLowerCase​(Locale locale)
      Convertit cetteLocale的规则将此 StringTous les caractères sont convertis en Locale 。
      String toString()
      Cet objet (qui est déjà une chaîne !)
      String toUpperCase()
      Cet objet convertit, selon les règles des paramètres régionaux par défaut,String所有字符转换为大写。
      String toUpperCase​(Locale locale)
      Cet objet convertit, selon les règles duLocale的规则将此 String所有字符转换为大写。
      String trim()
      Retourne une chaîne dont la valeur est cette chaîne, avec suppression de tous les espaces de début et de fin. Un espace est défini comme tout caractère dont le point de code est inférieur ou égal à'U+0020' (le caractère espace).
      static String valueOf​(boolean b)
      Retourne la représentation sous forme de chaîne de l'argumentboolean参数的字符串表示形式。
      static String valueOf​(char c)
      Retourne la représentation sous forme de chaîne de l'argumentchar参数的字符串表示形式。
      static String valueOf​(char[] data)
      Retourne la représentation sous forme de chaîne de l'argumentchar.
      static String valueOf​(char[] data, int offset, int count)
      Retourne la représentation sous forme de chaîne d'un sous-tableau spécifique de l'argumentchar.
      static String valueOf​(double d)
      Retourne la représentation sous forme de chaîne de l'argumentdouble参数的字符串表示形式。
      static String valueOf​(float f)
      Retourne la représentation sous forme de chaîne de l'argumentfloat参数的字符串表示形式。
      static String valueOf​(int i)
      Retourne la représentation sous forme de chaîne de l'argumentint参数的字符串表示形式。
      static String valueOf​(long l)
      Retourne la représentation sous forme de chaîne de l'argumentlong参数的字符串表示形式。
      static String valueOf​(Object obj)
      Retourne la représentation sous forme de chaîne de l'argumentObject参数的字符串表示形式。
    • 字段详细信息

      • CASE_INSENSITIVE_ORDER

        public static final Comparator<String> CASE_INSENSITIVE_ORDER
        Un comparateur qui ordonne lescompareToIgnoreCaseobjetsStringpar comparaison.compareToIgnoreCaseCe comparateur est sérialisable. Notez qu'il ne prend pas en compte les paramètres régionaux et donne donc un ordre insatisfaisant pour certains d'entre eux.

        CollatorLa classe fournit des comparaisons sensibles aux paramètres régionaux.

        Depuis la version : 1.2 Voir aussi :
        Collator
    • 构造方法详细信息

      • String

        public String()
        Initialise l'objet nouvellement créé.Stringobjet, pour qu'il représente une séquence de caractères vide. Notez que ce constructeur est inutile, car les chaînes sont immuables.
      • String

        public String​(String original)
        Initialise le nouvel objetStringcréé, pour qu'il représente la même séquence de caractères que l'argument. En d'autres termes, la nouvelle chaîne est une copie de la chaîne passée en argument. Sauf si vous avez besoinoriginald'une copie explicite de original, n'utilisez pas ce constructeur, car les chaînes sont immuables.
        Paramètres
        original - A String
      • String

        public String​(char[] value)
        Alloue un nouvel objetString, pour qu'il représente la séquence de caractères contenue dans le tableau de caractères passé en argument. Le contenu du tableau est copié. Une modification ultérieure du tableau n'affecte pas la nouvelle chaîne créée.
        Paramètres
        value- Valeur initiale de la chaîne
      • String

        public String​(char[] value,
                      int offset,
                      int count)
        Alloue un nouvel objetString, qui contient les caractères du sous-tableau du tableau de caractères passé en argument.offset参数是子count, et l'argument count参数指定子count. Le contenu du sous-tableau est copié. Une modification ultérieure du tableau n'affecte pas la nouvelle chaîne créée.
        Paramètres
        value- Tableau servant de source de caractères
        offset- Décalage initial
        count- Longueur Exceptions
        IndexOutOfBoundsException - 如果 offset为负数,则 count为负数,或 offset为大于 value.length - count
      • String

        public String​(int[] codePoints,
                      int offset,
                      int count)
        Alloue un nouvel objetString, qui contient les caractères du sous-tableau du tableau de points de code Unicode passé en argument.offset参数是子count, et l'argument count参数指定子count. Le contenu du sous-tableau est converti enchars. Une modification ultérieure du tableauintn'affecte pas la nouvelle chaîne créée.
        Paramètres
        codePoints- Tableau servant de source de points de code Unicode
        offset- Décalage initial
        count- Longueur Exception
        IllegalArgumentException - Si codePointscontient un point de code Unicode invalide
        IndexOutOfBoundsException - 如果 offset为负数,则 count为负数,或 offset为大于 codePoints.length - count
        Depuis la version : 1.5
      • String

        public String​(byte[] bytes,
                      int offset,
                      int length,
                      String charsetName)
               throws UnsupportedEncodingException
        Construit un nouveauString构造新的Stringen décodant le sous-tableau d'octets spécifié avec le jeu de caractères par défaut de la plateforme. La longueur du nouveau的Stringest fonction du charset, donc elle peut différer de la longueur du sous-tableau阵列的长度。

        当给定字节在给定字符集中无效时,此构造函数的行为未指定。 当需要更多地控制解码过程时,应使用CharsetDecoder.

        Paramètres
        bytes- les octets à décoder en caractères
        offset- l'index du premier octet à décoder
        length- le nombre d'octets à décoder
        charsetName- le nom du charset pris en charge Exceptions
        UnsupportedEncodingException- si le charset spécifié n'est pas pris en charge
        IndexOutOfBoundsException - 如果 offset为负数, length为负数,或 offset为大于 bytes.length - length
        Depuis la version : 1.1
      • String

        public String​(byte[] bytes,
                      int offset,
                      int length,
                      Charset charset)
        Construit un nouveauStringen décodant le sous-tableau d'octets spécifié avec le charset spécifié. La longueur du nouveauStringdépend du jeu de caractères et peut donc différer de la longueur du sous-tableauString. Cette méthode remplace toujours les entrées mal formées et les séquences de caractères non mappables par la chaîne de remplacement par défaut de ce charset. Pour mieux contrôler le processus de décodage, utilisez la classe

        CharsetDecoder.

        Paramètres
        bytes- les octets à décoder en caractères
        offset- l'index du premier octet à décoder
        length- le nombre d'octets à décoder
        charset- le charset utilisé pour décoderbytes
        Exceptions
        IndexOutOfBoundsException - 如果 offset为负数, length为负数,或 offset为大于 bytes.length - length
        Depuis la version : 1.6
      • String

        public String​(byte[] bytes,
                      String charsetName)
               throws UnsupportedEncodingException
        Construit un nouveauStringen décodant le tableau d'octets spécifié avec le charset indiqué. La longueur du nouveauStringdépend du jeu de caractères et peut donc différer de la longueur du tableau d'octets. Le comportement de ce constructeur n'est pas défini quand les octets donnés sont invalides dans le charset donné. Pour contrôler davantage le processus de décodage, utilisez la classe

        CharsetDecoder.

        Paramètres
        bytes- les octets à décoder en caractères
        charsetName- le nom du charset pris en charge Exceptions
        UnsupportedEncodingException- si le charset spécifié n'est pas pris en charge Depuis la version : 1.1
      • String

        public String​(byte[] bytes,
                      Charset charset)
        Construit un nouveauStringen décodant le tableau d'octets spécifié avec le charset indiqué. La longueur du nouveauStringdépend du jeu de caractères et peut donc différer de la longueur du tableau d'octets. Cette méthode remplace toujours les entrées mal formées et les séquences de caractères non mappables par la chaîne de remplacement par défaut du charset. Pour contrôler davantage le processus de décodage, utilisez la classe

        CharsetDecoder.

        Paramètres
        bytes- les octets à décoder en caractères
        charset- le charset utilisé pour décoderbytes
        Depuis la version : 1.6
      • String

        public String​(byte[] bytes,
                      int offset,
                      int length)
        Construit un nouveauString. Le nouveauString的长度是字符集的函数,因此可能不等于子String. Le comportement de ce constructeur n'est pas défini quand les octets donnés sont invalides dans le jeu de caractères par défaut. Pour contrôler davantage le processus de décodage, utilisez la classe

        CharsetDecoder.

        Paramètres
        bytes- les octets à décoder en caractères
        offset- l'index du premier octet à décoder
        length- le nombre d'octets à décoder Exceptions
        IndexOutOfBoundsException - 如果 offset为负数,则 length为负数,或 offset为大于 bytes.length - length
        Depuis la version : 1.1
      • String

        public String​(byte[] bytes)
        Décode le tableau d'octets spécifié avec le jeu de caractères par défaut de la plateforme et construit un nouveauString 。 新Stringa une longueur qui dépend du jeu de caractères, donc elle peut différer de la longueur du tableau d'octets. Le comportement de ce constructeur n'est pas défini quand un octet donné est invalide dans le jeu de caractères par défaut. Pour mieux contrôler le décodage, utilisez la classe

        CharsetDecoder.

        Paramètres
        bytes- les octets à décoder en caractères. Depuis la version : 1.1
      • String

        public String​(StringBuffer buffer)
        Alloue une nouvelle chaîne contenant la séquence de caractères actuellement présente dans le paramètre StringBuffer. Le contenu du StringBuffer est copié. Les modifications ultérieures du StringBuffer n'affectent pas la nouvelle chaîne.
        Paramètres
        buffer - A StringBuffer
      • String

        public String​(StringBuilder builder)
        Alloue une nouvelle chaîne contenant la séquence de caractères actuellement présente dans le paramètre StringBuilder. Le contenu du StringBuilder est copié. Les modifications ultérieures du StringBuilder n'affectent pas la nouvelle chaîne. Ce constructeur facilite la migration vers

        StringBuilder. La méthodetoStringpermet d'obtenir une chaîne depuis un StringBuilder plus rapidement et reste généralement préférée.

        Paramètres
        builder - A StringBuilder
        Depuis la version : 1.5
    • 方法详细信息

      • length

        public int length()
        Retourne la longueur de cette chaîne. La longueur correspond au nombre d'unités de code Unicode dans la chaîne.
        Spécifié par :
        length在界面 CharSequence
        Résultat : la longueur de la séquence de caractères représentée par cet objet.
      • isEmpty

        public boolean isEmpty()
        Retournetrue, si et seulement si,length()是 0 。
        Résultat
        trueSilength()est0 , sinon false
        Depuis la version : 1.6
      • charAt

        public char charAt​(int index)
        Retourne la valeurcharà l'index spécifié. Les index vont de0至length() - 1. La première valeurchar值位于索引0 , le suivant se trouve à l'index1, et ainsi de suite, comme les indices d'un tableau. Si la

        charvaleur désignée par l'index est un surrogate, la valeur de substitution est renvoyée.

        Spécifié par :
        charAtdans l'interface CharSequence
        Paramètres
        index - charl'index de la valeur. Résultat la
        charvaleur à l'index spécifié de cette chaîne. La premièrechar值位于索引0. Exceptions
        IndexOutOfBoundsException - 如果 indexargument est négatif ou n'est pas inférieur à la longueur de cette chaîne.
      • codePointAt

        public int codePointAt​(int index)
        Renvoie le caractère (point de code Unicode) à l'index spécifié. L'index fait référence auxcharvaleurs (unités de code Unicode), qui vont de0àlength() - 1. Si la

        charvaleur désignée à l'index donné se trouve dans la plage des surrogates hauts, que l'index suivant est inférieur à la longueur de cetteStringet que lacharvaleur à l'index suivant se trouve dans la plage des surrogates bas, alors le point de code supplémentaire correspondant à cette paire de surrogates est renvoyé. Sinon, lachar值。

        Paramètres
        index - charl'index de la valeur. Résultat
        indexla valeur du point de code du caractère à cet index. Exceptions
        IndexOutOfBoundsException - 如果 indexargument est négatif ou n'est pas inférieur à la longueur de cette chaîne. Depuis la version : 1.5
      • codePointBefore

        public int codePointBefore​(int index)
        Renvoie le caractère (point de code Unicode) précédant l'index spécifié. L'index fait référence auxcharvaleurs (unités de code Unicode), qui vont de1àlength. Si la

        char在值(index - 1)se trouve dans la plage des surrogates bas, que (index - 2)n'est pas négatif et que lachar在值(index - 2)se trouve dans la plage des surrogates hauts, alors la valeur du point de code supplémentaire de la paire de surrogates est renvoyée. Si lachar值为index - 1est un surrogate bas ou haut non apparié, la valeur du surrogate est renvoyée.

        Paramètres
        index- l'index après le point de code à retourner. Résultat la valeur du point de code Unicode avant l'index donné. Exceptions
        IndexOutOfBoundsException - 如果 indexl'argument est inférieur à 1 ou supérieur à la longueur de cette chaîne. Depuis la version : 1.5
      • codePointCount

        public int codePointCount​(int beginIndex,
                                  int endIndex)
        Retourne le nombre de points de code Unicode dans la plage de texte spécifiée de ceString. La plage de texte commence à l'indexbeginIndexspécifié et s'étend jusqu'àchar , index non comprisendIndex - 1. Ainsi, la longueur de la plage de texte (enchar s) estendIndex-beginIndex. Les substituts non appariés dans la plage de texte comptent pour un point de code chacun.
        Paramètres
        beginIndex - l'index du premier charde la plage de texte.
        endIndex - l'index après le dernier charde la plage de texte. Résultat le nombre de points de code Unicode dans la plage de texte spécifiée. Exceptions
        IndexOutOfBoundsException - 如果 beginIndex为负数,或者 endIndex大于此 String的长度,或者 beginIndex大于 endIndex. Depuis la version : 1.5
      • offsetByCodePoints

        public int offsetByCodePoints​(int index,
                                      int codePointOffset)
        Retourne l'index dans ceString, décalé deindex偏移codePointOffsetdonné. Les substituts non appariés dans la plage de texte délimitée parindex和codePointOffsetcomptent pour un point de code chacun.
        Paramètres
        index- l'index à décaler
        codePointOffset- le décalage en points de code. Résultat cet index dans le
        String
        Exceptions
        IndexOutOfBoundsException - 如果 indexest négatif ou supérieur à la longueur de ce String, ou si codePointOffsetest positif et que la sous-chaîne à partir de indexcontient moins de codePointOffsetpoints de code, ou si codePointOffsetest négatif et indexla sous-chaîne précédente contient moins de la valeur absolue codePointOffsetde points de code. Disponible depuis : 1.5
      • getChars

        public void getChars​(int srcBegin,
                             int srcEnd,
                             char[] dst,
                             int dstBegin)
        Copie les caractères de cette chaîne dans le tableau de caractères cible. Le premier caractère copié est à l'index

        srcBegin. Le dernier caractère copié est à l'indexsrcEnd-1 . Le nombre total de caractères copiés est doncsrcEnd-srcBegin. Les caractères sont copiés dans la sous-partie dedst的子dst从索引dstBeginsuivant :

             dstBegin + (srcEnd-srcBegin) - 1
         
        Paramètres
        srcBegin- L'index du premier caractère de la chaîne à copier.
        srcEnd- L'index situé après le dernier caractère à copier dans la chaîne.
        dst- Le tableau cible.
        dstBegin- L'offset de départ dans le tableau cible. Exceptions
        IndexOutOfBoundsException- Si l'une des conditions suivantes est remplie :
        • srcBeginest négatif.
        • srcBegin大于srcEnd
        • srcEndest supérieur à la longueur de cette chaîne
        • dstBegin是否定的
        • dstBegin+(srcEnd-srcBegin)大于dst.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.
        Copie les caractères de cette chaîne dans le tableau d'octets cible. Chaque octet reçoit les 8 bits de poids faible du caractère correspondant. Les 8 bits de poids fort de chaque caractère ne sont pas copiés et ne participent en rien au transfert. Le premier caractère copié est à l'index

        srcBegin. Le dernier caractère copié est à l'indexsrcEnd-1. Le nombre total de caractères copiés estsrcEnd-srcBegin. Les caractères convertis en octets sont copiés dans la sous-partie dedst的子dst从索引dstBeginsuivant :

             dstBegin + (srcEnd-srcBegin) - 1
         
        Paramètres
        srcBegin- L'index du premier caractère de la chaîne à copier
        srcEnd- L'index situé après le dernier caractère à copier dans la chaîne
        dst- Le tableau cible
        dstBegin- L'offset de départ dans le tableau cible Exceptions
        IndexOutOfBoundsException- Si l'une des conditions suivantes est remplie :
        • srcBegin是否定的
        • srcBegin大于srcEnd
        • srcEndSupérieure à la longueur de ce String
        • dstBegin是否定的
        • dstBegin+(srcEnd-srcBegin)大于dst.length
      • getBytes

        public byte[] getBytes​(String charsetName)
                        throws UnsupportedEncodingException
        Utilise le jeu de caractères spécifié pour convertir ceciStringEncode la chaîne en une séquence d'octets et stocke le résultat dans un nouveau tableau d'octets. Cette méthode ne spécifie pas son comportement quand la chaîne ne peut pas être encodée dans le jeu de caractères donné. Pour contrôler davantage le processus d'encodage, utilisez

        CharsetEncoderclasse.

        Paramètres
        charsetName- Nom du charset pris en charge Résultat Tableau d'octets du résultat Exception
        UnsupportedEncodingException- Si le charset spécifié n'est pas pris en charge
      • getBytes

        public byte[] getBytes​(Charset charset)
        Encode cette chaîne en une séquence d'octets avec le charset donné.StringLe résultat est stocké dans un nouveau tableau d'octets. Cette méthode remplace les entrées mal formées et les séquences de caractères non mappables par le tableau d'octets de remplacement par défaut de ce charset. Pour plus de contrôle sur le processus d'encodage, utilisez la classe

        CharsetEncoder.

        Paramètres
        charset- le Charset utilisé pour l'encodageString
        Résultat le tableau d'octets résultant. Depuis la version : 1.6
      • getBytes

        public byte[] getBytes()
        Encode cette chaîne en une séquence d'octets avec le charset par défaut de la plateforme.StringLe résultat est stocké dans un nouveau tableau d'octets. Le comportement de cette méthode n'est pas spécifié quand cette chaîne ne peut pas être encodée dans le charset par défaut. Pour plus de contrôle sur le processus d'encodage, utilisez

        CharsetEncoderclasse.

        Résultat : tableau d'octets du résultat. Disponible depuis : 1.1
      • equals

        public boolean equals​(Object anObject)
        Compare cette chaîne à l'objet spécifié. Le résultat est vrai si et seulement si l'argument n'est pasnullnul et représente unStringobjet contenant la même séquence de caractères que cet objet. Pour une comparaison plus fine des chaînes, consulteztrue.

        Collator.

        Redéfini :
        equals在类 Object
        Paramètres
        anObject - Comparaison comparaison Stringde l'objet Résultat
        trueSi l'objet donné représente Stringune chaîne équivalente à celle-ci, falsesinon Voir aussi :
        compareTo(String),equalsIgnoreCase(String)
      • contentEquals

        public boolean contentEquals​(StringBuffer sb)
        Compare cette chaîne avec laStringBufferspécifiée. Le résultat esttrue , si, si ceci neStringreprésente que les caractères dans la même séquence que celle spécifiéeStringBuffer. Cette méthode se synchronise surStringBuffer. Pour une comparaison de chaînes plus fine, consultez

        Collator.

        Paramètres
        sb - 用 StringBuffer来比较这 String
        Résultat
        true如果此 Stringreprésente la même séquence de caractères que le StringBufferspécifié, sinon false false
        Depuis la version : 1.4
      • contentEquals

        public boolean contentEquals​(CharSequence cs)
        Compare cette chaîne avec leCharSequencespécifié. Le résultat est true si et seulement si ceStringreprésente la même séquence de valeurs char que la séquence spécifiée. Notez que si letrueest unCharSequence是StringBuffer.

        CollatorParamètres

        Paramètres
        cs - la séquence à comparer avec ce StringRésultat
        true如果此 Stringreprésente la même séquence de valeurs char que la séquence spécifiée, sinon false false
        Depuis la version : 1.5
      • equalsIgnoreCase

        public boolean equalsIgnoreCase​(String anotherString)
        Compare cetteStringavec une autreStringen ignorant la casse. Deux chaînes sont considérées comme égales en ignorant la casse si elles ont la même longueur et si les caractères correspondants des deux chaînes sont égaux en ignorant la casse. Deux caractères

        c1和c2sont considérés comme identiques en ignorant la casse si au moins l'une des conditions suivantes est vraie :

        • Les deux caractères sont identiques (comparés par==l'opérateur)
        • L'appel deCharacter.toLowerCase(Character.toUpperCase(char))sur chaque caractère produit le même résultat

        Notez que cette méthode ne tient pas compte des paramètres régionaux et donne des résultats insatisfaisants pour certains paramètres régionaux spécifiques.CollatorLa classe

        Paramètres
        anotherString - 用 String来比较这 Stringrésultats de comparaison
        trueSi l'argument n'est pasnullet qu'il représente une chaîne équivalenteStringen ignorant la casse, sinonfalse
        Voir aussi :
        equals(Object)
      • compareTo

        public int compareTo​(String anotherString)
        Compare deux chaînes par ordre lexicographique. La comparaison se base sur la valeur Unicode de chaque caractère de la chaîne. CetteStringséquence de caractères représentée par l'objet est comparée lexicographiquement à la séquence de caractères représentée par la chaîne en argument. Si cetStringobjet précède lexicographiquement la chaîne en argument, le résultat est un entier négatif. Si cetStringobjet suit lexicographiquement la chaîne en argument, le résultat est un entier positif. Si les chaînes sont égales, le résultat est zéro,compareTodansequals(Object)la méthode retourne0retourne exactementtrue. C'est la définition de l'ordre lexicographique. Si deux chaînes sont différentes, elles ont un caractère différent à un certain index, qui est un index valide pour les deux chaînes, ou leurs longueurs diffèrent, ou les deux. Si elles ont des caractères différents à un ou plusieurs index, soit k le plus petit de ces index. Alors, en utilisant

        <l'opérateur, la chaîne dont le caractère à la position k a la valeur la plus petite précède lexicographiquement l'autre. Dans ce cas,compareToretourne la différence des valeurs des deux caractères à la positionkdans les deux chaînes,kc'est-à-dire la valeur :

         this.charAt(k)-anotherString.charAt(k)
         
        S'il n'existe aucun index où les caractères diffèrent, alors la chaîne la plus courte précède lexicographiquement la plus longue. Dans ce cas,compareToretourne la différence des longueurs des chaînes, c'est-à-dire la valeur :
         this.length()-anotherString.length()
         

        Pour des comparaisons de chaînes plus fines, consultezCollator.

        Spécifié par :
        compareToDans Comparable<String>
        Paramètres
        anotherString - 待比较的 Stringà comparer. Résultat Si la chaîne en argument est égale à cette chaîne, la valeur
        0; si cette chaîne est lexicographiquement inférieure à la chaîne en argument, une valeur inférieure à0; si cette chaîne est lexicographiquement supérieure à la chaîne en argument, une valeur supérieure à0.
      • compareToIgnoreCase

        public int compareToIgnoreCase​(String str)
        Compare deux chaînes par ordre lexicographique en ignorant les différences de casse. Cette méthode retourne un entier dont le signe est celui de l'appel àcompareTosur les versions normalisées des chaînes, où la normalisation élimine les différences de casse en appelantCharacter.toLowerCase(Character.toUpperCase(character))sur chaque caractère. Notez que cette méthode ne prend pas en compte les paramètres régionaux et produit un tri insatisfaisant pour certaines langues.

        CollatorLa classe fournit des comparaisons sensibles aux paramètres régionaux.

        Paramètres
        str - 待比较的 Stringà comparer. Résultat Un entier négatif, zéro ou positif, selon que la String spécifiée est supérieure, égale ou inférieure à cette String, en ignorant la casse. Depuis la version : 1.2 Voir aussi :
        Collator
      • regionMatches

        public boolean regionMatches​(int toffset,
                                     String other,
                                     int ooffset,
                                     int len)
        Tester si deux régions de chaînes sont égales. Compare une

        Stringsous-chaîne de cet objet avec une sous-chaîne de l'argument other. Si ces sous-chaînes représentent la même séquence de caractères, le résultat est vrai. La sous-chaîne de cetString对象的子字符串从索引toffset开始,长度为len. La sous-chaîne à comparer commence à l'indexooffset开始,长度为len. Le résultat est vrai si et seulement si au moins une des conditions suivantes est rempliefalse:

        • toffsetest négatif.
        • ooffsetest négatif.
        • toffset+len大于此Stringobjet.
        • ooffset+lenest supérieur à la longueur de l'autre argument.
        • Il existe des entiers k non négatifs inférieurs àlen tels que this.charAt(toffset + k ) != other.charAt(ooffset + k )

        Notez que cette méthode ne tient pas compte des paramètres régionaux.CollatorLa classe fournit des comparaisons sensibles aux paramètres régionaux.

        Paramètres
        toffset - 此字符串 toffset- l'argument de type String.
        other- le décalage de départ de la sous-région de l'argument de type String.
        ooffset - 字符串参数 ooffset- le décalage de départ de la sous-région de l'argument de type String.
        len- le nombre de caractères à comparer. Résultat
        truesi la sous-région spécifiée de cette chaîne correspond exactement à la sous-région spécifiée de l'argument de type String, sinonfalse.
      • regionMatches

        public boolean regionMatches​(boolean ignoreCase,
                                     int toffset,
                                     String other,
                                     int ooffset,
                                     int len)
        Tester si deux régions de chaînes sont égales. Compare une

        Stringsous-chaîne de cet objet avec une sous-chaîne de l'argumentotherenother. Si ces sous-chaînes représentent la même séquence de caractères, le résultat esttrue , si et seulement siignoreCaseest vrai, en ignorant la casse. La sous-chaîne de cetString对象的子字符串从索引toffset开始,长度为len. La sous-chaîne à comparerother从索引ooffset开始,长度为len. Le résultat estfalsevrai si et seulement si au moins une des conditions suivantes est remplie :

        • toffsetest négatif.
        • ooffsetest négatif.
        • toffset+len大于此Stringobjet.
        • ooffset+lenest supérieur à la longueur de l'autre paramètre.
        • ignoreCase是falseet il existe un entier non négatif k inférieur àlentel que :
           this.charAt(toffset+k) != other.charAt(ooffset+k)
           
        • ignoreCase是trueet il existe un entier non négatif k inférieur àlentel que :
           Character.toLowerCase(Character.toUpperCase(this.charAt(toffset+k))) !=
               Character.toLowerCase(Character.toUpperCase(other.charAt(ooffset+k)))
           

        Notez que cette méthode ne prend pas en compte les paramètres régionaux et donne des résultats inadaptés pour certaines langues quandignoreCase为true.CollatorLa classe fournit des comparaisons sensibles aux paramètres régionaux.

        Paramètres
        ignoreCase - si la valeur est true, ignorez la casse lors de la comparaison des caractères.
        toffset - 此字符串 toffsetdécalage de début de la zone.
        other- le paramètre de type chaîne.
        ooffset - 字符串参数 ooffsetdécalage de début de la zone.
        len- le nombre de caractères à comparer. Résultat
        truevrai si la sous-zone spécifiée de cette chaîne correspond à la sous-zone spécifiée du paramètre de type chaîne, sinonfalse. La correspondance est exacte ou insensible à la casse selon leignoreCaseparamètre.
      • startsWith

        public boolean startsWith​(String prefix,
                                  int toffset)
        Teste si la sous-chaîne de cette chaîne à partir de l'index spécifié commence par le préfixe spécifié.
        Paramètres
        prefix- le préfixe.
        toffset- l'endroit où commencer la recherche dans cette chaîne. Résultat
        truevrai si la séquence de caractères représentée par le paramètre est un préfixe de la sous-chaîne de cet objet à partir de l'indextoffset, sinonfalse. Sitoffsetest négatif ou supérieur à la longueur de cetStringobjet, le résultat estfalse; sinon le résultat est identique à celui de l'expression
          this.substring(toffset).startsWith(prefix) 
      • startsWith

        public boolean startsWith​(String prefix)
        Teste si cette chaîne commence par le préfixe spécifié.
        Paramètres
        prefix- le préfixe. Résultat
        trueRetourne true si la séquence de caractères représentée par l'argument est un préfixe de la séquence de caractères de cette chaîne ; sinon falsefalse. Notez également quetruesi l'argument est une chaîne vide ou est égal à cette chaîne, true sera retournéStringtel que déterminé par la méthodeequals(Object)de l'objet. Depuis la version : 1.0
      • endsWith

        public boolean endsWith​(String suffix)
        Teste si cette chaîne se termine par le suffixe spécifié.
        Paramètres
        suffix- le suffixe. Résultat
        trueRetourne true si la séquence de caractères représentée par l'argument est un suffixe de la séquence de caractères représentée par cet objet ; sinon falsefalse. Notez que le résultat sera truetruesi l'argument est une chaîne vide ou est égal à cetteStringchaîne, tel que déterminé par la méthodeequals(Object)de l'objet.
      • hashCode

        public int hashCode()
        Retourne le code de hachage de cette chaîne.StringLe code de hachage d'un objet String est calculé comme suit
         s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]
         
        使用intl'arithmétique, oùs[i]est le i-ème caractère de la chaîne,nest la longueur de la chaîne, ^désigne l'exponentiation. (La valeur de hachage de la chaîne vide est zéro.)
        Redéfini :
        hashCode在类 Object
        Résultat : la valeur du code de hachage de cet objet. Voir aussi :
        Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
      • indexOf

        public int indexOf​(int ch)
        Retourne l'index de la première occurrence du caractère spécifié dans cette chaîne. Si un caractère de valeurStringapparaît dans la séquence de caractères représentée par cetchobjet, l'index de la première occurrence est retourné (en unités de code Unicode). Pour les valeurs comprises entre 0 et 0xFFFF (inclus)ch, c'est la plus petite valeur k telle que :
         this.charAt(k) == ch
         
        est vraie. Pour leschautres valeurs, c'est la plus petite valeur k telle que :
         this.codePointAt(k) == ch
         
        est vraie. Dans les deux cas, si aucun tel caractère n'apparaît dans cette chaîne, la valeur-1 。
        Paramètres
        ch- caractère (point de code Unicode). Résultat L'index de la première occurrence du caractère dans la séquence de caractères représentée par cet objet, si le caractère n'apparaît pas,
        -1.
      • indexOf

        public int indexOf​(int ch,
                           int fromIndex)
        Retourne l'index de la première occurrence du caractère spécifié dans cette chaîne, la recherche commençant à l'index spécifié. Si un caractère de valeur

        fromIndex apparaît dans la séquence de caractères représentée par cetStringobjet à un index supérieur ou égal à l'index spécifié, alors l'index de la première occurrence est retourné. Pour les valeurschdans la plage de 0 à 0xFFFF (inclus), c'est la plus petite valeur k telle que :chest vraie. Pour les

         (this.charAt(k) == ch) && (k >= fromIndex)
         
        autres valeurs, c'est la plus petite valeur k telle que :chest vraie. Dans les deux cas, si aucun tel caractère n'apparaît dans la chaîne à la position
         (this.codePointAt(k) == ch) && (k >= fromIndex)
         
        spécifiée ou après, alorsfromIndexest retourné.-1 。

        fromIndexest retourné.-1 。

        valeurs (unités de code Unicode).charParamètres

        - caractère (point de code Unicode).
        ch - 字符(Unicode代码点)。
        fromIndex.
        fromIndex lastIndexOf -1Retourne l'index de la dernière occurrence du caractère spécifié dans cette chaîne. Pour les valeurs
      • lastIndexOf

        public int lastIndexOf​(int ch)
        est la plus grande valeur k telle que :chest vraie. Pour les chautres valeurs, c'est la plus grande valeur k telle que :
         this.charAt(k) == ch
         
        est vraie. Dans les deux cas, si aucun tel caractère n'apparaît dans cette chaîne, alorschest retourné. La recherche s'effectue à partir du dernier caractère vers l'arrière
         this.codePointAt(k) == ch
         
        .-1ParamètresString 。
        .
        chlastIndexOf
        -1Retourne l'index de la dernière occurrence du caractère spécifié dans cette chaîne, la recherche s'effectuant vers l'arrière à partir de l'index spécifié. Pour les valeurs
      • lastIndexOf

        public int lastIndexOf​(int ch,
                               int fromIndex)
        est vraie. Pour leschautres valeurs, c'est la plus grande valeur k telle que :
         (this.charAt(k) == ch) && (k <= fromIndex)
         
        是真的。 对于ch其他值,它是最大值k ,使得:
         (this.codePointAt(k) == ch) && (k <= fromIndex)
         
        C'est vrai. Dans les deux cas, si à la positionfromIndexSi aucun caractère de ce type n'apparaît à cette position ou avant, la fonction renvoie-1。 Tous les index commencent par

        charvaleur (unité de code Unicode).

        Paramètres
        ch- Un caractère (point de code Unicode).
        fromIndex- L'index à partir duquel lancer la recherche.fromIndexLa valeur n'a pas de limite. Si elle est supérieure ou égale à la longueur de la chaîne, l'effet est le même. Si elle est inférieure ou égale à la longueur de la chaîne, la recherche porte sur toute la chaîne. Si elle est négative, l'effet est identique à -1 : la méthode renvoie -1. Résultat : l'index de la dernière occurrence du caractère dans la séquence de caractères représentée par cet objet, avec un index inférieur ou égal à
        fromIndex , si ce caractère n'apparaît pas avant ce point, -1.
      • indexOf

        public int indexOf​(String str)
        Retourne l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne. L'index retourné est la plus petite valeur

        k ,其中:

           this.startsWith(str, k)  
        Si une telle valeur n'existek存在,那么-1返回。
        Paramètres
        str- La sous-chaîne à rechercher. Résultat L'index de la première occurrence de la sous-chaîne spécifiée, ou si ce n'est pas le cas,
        -1.
      • indexOf

        public int indexOf​(String str,
                           int fromIndex)
        À partir de l'index spécifié, renvoie l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne. L'index renvoyé est la valeur minimale

        k ,其中:

           k >= Math.min(fromIndex, this.length()) && this.startsWith(str, k)  
        Si aucune telle valeurk存在,那么-1返回。
        Paramètres
        str- La sous-chaîne à rechercher.
        fromIndex- L'index à partir duquel commencer la recherche. Résultat L'index de la première occurrence de la sous-chaîne spécifiée à partir de l'index donné, si ce cas n'existe pas
        -1.
      • lastIndexOf

        public int lastIndexOf​(String str)
        Renvoie l'index de la dernière occurrence de la sous-chaîne spécifiée dans la chaîne. La dernière occurrence d'une chaîne vide "" est considérée comme se produisant à la valeur d'indexthis.length(). L'index renvoyé est la valeur maximale

        k ,其中:

           this.startsWith(str, k)  
        Si aucune valeur de ce typek存在,那么-1返回。
        Paramètres
        str- La sous-chaîne à rechercher. Résultat L'index de la dernière occurrence de la sous-chaîne spécifiée, ou si ce n'est pas le cas,
        -1.
      • lastIndexOf

        public int lastIndexOf​(String str,
                               int fromIndex)
        Renvoie l'index de la dernière occurrence de la sous-chaîne spécifiée dans la chaîne, en effectuant la recherche vers l'arrière à partir de l'index spécifié. L'index renvoyé est la valeur maximale

        k ,其中:

           k <= Math.min(fromIndex, this.length()) && this.startsWith(str, k)  
        si aucune valeur de ce typek存在,那么-1返回。
        Paramètres
        str- la sous-chaîne à rechercher.
        fromIndex- l'index à partir duquel la recherche commence. Résultat l'index de la dernière occurrence de la sous-chaîne spécifiée, en effectuant la recherche vers l'arrière à partir de l'index spécifié, ou
        -1si ce cas n'existe pas.
      • substring

        public String substring​(int beginIndex)
        Renvoie une chaîne qui est une sous-chaîne de cette chaîne. La sous-chaîne commence au caractère de l'index spécifié et s'étend jusqu'à la fin de cette chaîne. Exemple :

         "unhappy".substring(2) returns "happy"
         "Harbison".substring(3) returns "bison"
         "emptiness".substring(9) returns "" (an empty string)
         
        Paramètres
        beginIndex- l'index de début, inclus. Résultat la sous-chaîne spécifiée. Exceptions
        IndexOutOfBoundsException - 如果 beginIndexest négatif ou supérieur à la longueur de cet objet String.
      • substring

        public String substring​(int beginIndex,
                                int endIndex)
        Renvoie une chaîne qui est une sous-chaîne de cette chaîne. La sous-chaîne commence à l'indexbeginIndexspécifié et s'étend jusqu'au caractère situé à l'indexendIndex - 1. La longueur de la sous-chaîne est doncendIndex-beginIndex. Exemple :

         "hamburger".substring(4, 8) returns "urge"
         "smiles".substring(1, 5) returns "mile"
         
        Paramètres
        beginIndex- l'index de début, inclus.
        endIndex- l'index de fin, exclu. Résultat la sous-chaîne spécifiée. Exceptions
        IndexOutOfBoundsException - 如果 beginIndex为负数,或者 endIndex大于此 String, ou si beginIndex大于 endIndex.
      • subSequence

        public CharSequence subSequence​(int beginIndex,
                                        int endIndex)
        Renvoie une séquence de caractères qui est une sous-séquence de cette séquence. Un appel de cette méthode sous la forme

         str.subSequence(begin, end)
        se comporte exactement comme un appel
         str.substring(begin, end)
        Spécifié par :
        subSequence在界面 CharSequence
        Note API : cette méthode est définie pour que la classe
        Stringpuisse implémenter l'interfaceCharSequence. Paramètres
        beginIndex- l'index de début, inclus.
        endIndex- l'index de fin, exclu. Résultat la sous-séquence spécifiée. Exceptions
        IndexOutOfBoundsException - 如果 beginIndexou endIndexest négatif, si endIndex大于 length() , ou si beginIndex大于 endIndex
        Disponible depuis : 1.4
      • concat

        public String concat​(String str)
        Concatène la chaîne spécifiée à la fin de cette chaîne. Si la longueur de la chaîne d'argument est

        0 , cetteStringest retournée. Sinon, uneStringest retournée. Elle représente une séquence de caractères formée de la concaténation de la séquence de caractères de cetteStringet de la séquence de caractères de la chaîne d'argument.

        Exemple :

         "cares".concat("s") returns "caress"
         "to".concat("get").concat("her") returns "together"
         
        Paramètre
        str - La Stringest concaténée à la fin de cette String. Résultat Une chaîne représentant la concaténation des caractères de cet objet suivie des caractères de la chaîne d'argument.
      • replace

        public String replace​(char oldChar,
                              char newChar)
        Retourne une chaîne résultant du remplacement de toutes les occurrences deoldChar在此字符串newChar. Si le caractère

        oldCharn'apparaît pas dans la séquence de caractères représentée par cetteString, cetteStringest retournée. Sinon, uneStringest retournée. Elle représente une séquence de caractères identique à celle de cetteString, sauf que chaque occurrence de oldCharest remplacée parnewChar 。

        Exemple :

         "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)
         
        Paramètre
        oldChar- Ancien caractère.
        newChar- Nouveau caractère. Résultat La chaîne obtenue en remplaçant
        oldCharchaque occurrence par oldChar , newCharà partir de la chaîne d'origine.
      • matches

        public boolean matches​(String regex)
        Indique si cette chaîne correspond à l'expression régulière donnée. L'appel de str

        .matches(regex)sous cette forme produit exactement le même résultat que l'expression

        Pattern.matches(regex, str)
        Paramètres
        regex- l'expression régulière à faire correspondre avec cette chaîne Résultat
        truetrue si et seulement si cette chaîne correspond à l'expression régulière donnée Exceptions
        PatternSyntaxException- si la syntaxe de l'expression régulière est invalide Depuis la version : 1.4 Voir aussi :
        Pattern
      • contains

        public boolean contains​(CharSequence s)
        Retourne true si et seulement si cette chaîne contient la séquence de valeurs char spécifiée.
        Paramètres
        s- la séquence à rechercher Résultat Retourne true si cette chaîne contient
        s la séquence, sinon sfalse. Depuis la version : 1.5
      • replaceFirst

        public String replaceFirst​(String regex,
                                   String replacement)
        Remplace le premier sous-ensemble de cette chaîne qui correspond à l'expression régulière donnée par le remplacement donné. L'appel de cette méthode sous la forme str

        .replaceFirst(regex, repl )produit exactement le même résultat que l'expression

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

        Notez que les barres obliques inverses (\ )和美元符号( $) dans la chaîne de remplacement peuvent donner un résultat différent de celui obtenu en la traitant comme une chaîne de remplacement littérale. VoirMatcher.replaceFirst(java.lang.String). Si nécessaire, utilisezMatcher.quoteReplacement(java.lang.String)pour supprimer la signification spéciale de ces caractères.

        Paramètres
        regex- l'expression régulière à faire correspondre avec cette chaîne
        replacement- la chaîne à substituer au premier résultat Résultat Le
        String
        Exceptions
        PatternSyntaxException- si la syntaxe de l'expression régulière est invalide Depuis la version : 1.4 Voir aussi :
        Pattern
      • replaceAll

        public String replaceAll​(String regex,
                                 String replacement)
        Remplace chaque sous-ensemble de cette chaîne qui correspond à l'expression régulière donnée par le remplacement donné. L'appel de cette méthode sous la forme str

        .replaceAll(regex, repl )produit exactement le même résultat que l'expression

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

        Notez que les barres obliques inverses (\ )和美元符号( $Cela peut donner un résultat différent de celui obtenu en le traitant comme une chaîne de remplacement littérale. VoirMatcher.replaceAllSi nécessaire, veuillez utiliserMatcher.quoteReplacement(java.lang.String)pour désactiver le sens spécial de ces caractères.

        Paramètres
        regex- L'expression régulière à faire correspondre avec cette chaîne
        replacement- Chaîne de remplacement pour chaque correspondance Résultat Résultat obtenu
        String
        Exception
        PatternSyntaxException- Si la syntaxe de l'expression régulière est invalide
        Pattern
      • replace

        public String replace​(CharSequence target,
                              CharSequence replacement)
        Remplace chaque sous-chaîne de cette chaîne correspondant à la séquence cible littérale par la séquence de remplacement littérale spécifiée. Le remplacement s'effectue du début à la fin de la chaîne. Par exemple, remplacer « aa » par « b » dans la chaîne « aaa » donne « ba » et non « ab ».
        Paramètres
        target- La séquence de valeurs char à remplacer
        replacement- Séquence de remplacement de la valeur char. Résultat : chaîne de résultat. Depuis : 1.5
      • split

        public String[] split​(String regex,
                              int limit)
        Divise cette chaîne en correspondances de l'expression régulière donnée. Le tableau retourné par cette méthode contient chaque sous-chaîne de cette chaîne terminée par une autre sous-chaîne correspondant à l'expression donnée, ou par la fin de la chaîne. Les sous-chaînes du tableau sont ordonnées selon leur ordre d'apparition dans cette chaîne. Si l'expression ne correspond à aucune partie de l'entrée, le tableau résultant ne contient qu'un seul élément, à savoir cette chaîne.

        Lorsqu'une correspondance de largeur positive existe au début de la chaîne, un sous-chaîne de tête vide est incluse au début du tableau de résultats. Cependant, une correspondance de largeur nulle au début ne produit jamais une telle sous-chaîne de tête vide.

        limitLe paramètre contrôle le nombre d'applications du mode et détermine donc la longueur du tableau de résultats.

        • Si la limite est positive, le motif sera appliqué au plus limite - 1 fois. La longueur du tableau ne dépassera pas limite. La dernière entrée du tableau contiendra toute l'entrée située au-delà du dernier séparateur trouvé.

        • Si la limite vaut zéro, le motif est appliqué autant de fois que possible, le tableau peut avoir n'importe quelle longueur et les chaînes vides finales sont ignorées.

        • Si la limite est négative, le motif est appliqué autant de fois que possible et le tableau peut avoir n'importe quelle longueur.

        Par exemple, la chaîne de caractères"boo:and:foo"Générez le résultat suivant avec les paramètres suivants :

        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" }

        Appelez cette méthode sous forme str.split(regex,n)Produit le même résultat que l'expression.

        Pattern.compile( regex ).split( str , n )
        Paramètres
        regex- Expression régulière de séparation
        limit- Seuil de résultat, comme décrit ci-dessus. Résultat : un tableau de chaînes calculé en scindant cette chaîne autour des correspondances de l'expression régulière donnée. Exceptions
        PatternSyntaxException- si la syntaxe de l'expression régulière est invalide Depuis la version : 1.4 Voir aussi :
        Pattern
      • split

        public String[] split​(String regex)
        Divise cette chaîne en correspondances de l'expression régulière donnée. Cette méthode agit comme si elle appelait la méthode à deux arguments avec l'expression donnée et le paramètre limit égal à zéro.

        splitPar conséquent, les chaînes vides finales ne sont pas incluses dans le tableau résultat.

        Par exemple, la chaîne"boo:and:foo"- regex l'expression régulière de délimitation Résultat le tableau de chaînes calculé en divisant cette chaîne autour des correspondances de l'expression régulière donnée Exceptions

        Exemples de split montrant l'expression régulière et le résultat Regex Résultat
        :{ "boo", "and", "foo" }
        o{ "b", "", ":and:f" }
        Paramètres
        regex - 分隔正则表达式
        结果
        通过在给定正则表达式的匹配项周围拆分此字符串计算的字符串数组
        Exceptions
        PatternSyntaxException- si la syntaxe de l'expression régulière est invalide Depuis la version : 1.4 Voir aussi :
        Pattern
      • join

        public static String join​(CharSequence delimiter,
                                  CharSequence... elements)
        Retourne une nouvelle String composée des copies deCharSequence elementsconcaténées avec les copies de l'élémentdelimiterspécifié. For example,
        
             String message = String.join("-", "Java", "is", "cool");
             // message returned is: "Java-is-cool"
         
        Notez que si un élément est null, la chaîne"null" 。
        Paramètres
        delimiter- le délimiteur utilisé pour séparer chaque élément
        elements- les éléments à joindre ensemble. Résultat une nouvelle
        String composée des elementsséparés par delimiter
        paramètres.
        NullPointerException - 如果 delimiterou elements是 null
        Depuis la version : 1.8 Voir aussi :
        StringJoiner
      • join

        public static String join​(CharSequence delimiter,
                                  Iterable<? extends CharSequence> elements)
        Retourne une nouvelleStringcomposée des copies deString ,其中CharSequence elements指定的delimiterspécifié. 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"
         
        Notez que si un élément individuel estnull , la chaîne"null" 。
        Paramètres
        delimiter - la séquence de caractères utilisée pour séparer chacun des elementsdans le résultat String
        elements - IterableLa relie elementsensemble. Le résultat est une nouvelle
        elementsexception composée des String
        异常
        NullPointerException - 如果 delimiterou elements是 null
        Depuis la version : 1.8 Voir aussi :
        join(CharSequence,CharSequence...),StringJoiner
      • toLowerCase

        public String toLowerCase​(Locale locale)
        Convertit tous les caractères de cetteLocale的规则将此String所有字符转换为Localedonnée. Le mappage de casse repose sur la version du standard Unicode spécifiée par la classeCharacter. Comme le mappage de casse n'est pas toujours un mappage de caractères 1:1, laString可能与原始Stringd'origine. Voici des exemples de mappage en minuscules :

        Exemples de mappage en minuscules. Ils montrent le code de langue de la locale, la majuscule, la minuscule et la description.
        Paramètres
        locale- utilise les règles de conversion de casse de cette locale. Résultat
        String, converti en minuscules. Depuis la version : 1.1 Voir aussi :
        toLowerCase(),toUpperCase(),toUpperCase(Locale)
      • toLowerCase

        public String toLowerCase()
        Convertit tous les caractères de cetteStringen minuscules en utilisant les règles de la locale par défaut. Cela équivaut à appelertoLowerCase(Locale.getDefault()). Attention : cette méthode est sensible à la locale. Elle peut donner des résultats inattendus pour les chaînes à interpréter indépendamment de la locale. Les exemples sont les identifiants de langage de programmation, les clés de protocole et les balises HTML. Par exemple,

        "TITLE".toLowerCase()在土耳其语言环境返回"t\u0131tle"dans la locale turque, où « \u0131 » est la lettre latine minuscule i sans point. Pour obtenir le résultat correct pour une chaîne insensible à la locale, utiliseztoLowerCase(Locale.ROOT) 。

        Résultat
        String, converti en minuscules. Voir aussi :
        toLowerCase(Locale)
      • toUpperCase

        public String toUpperCase​(Locale locale)
        Convertit tous les caractères de cetteLocale的规则将此Stringdonnée. Le mappage de casse repose sur la version du standard Unicode spécifiée par la classeCharacter. Comme le mappage de casse n'est pas toujours un mappage de char 1:1, laString可能与原始Stringd'origine. Voici des exemples de mappage de casse sensible à la locale et 1:M dans le tableau suivant.

        Exemples de conversions de casse sensibles aux paramètres régionaux et de type 1:M. Le tableau indique le code de langue, la minuscule, la majuscule et la description.
        Paramètres
        locale- Applique les règles de conversion de casse de ces paramètres régionaux. Résultat
        String, convertit en majuscules. Depuis la version : 1.1 Voir aussi :
        toUpperCase(),toLowerCase(),toLowerCase(Locale)
      • toUpperCase

        public String toUpperCase()
        Convertit tous les caractères de cetteStringchaîne en majuscules selon les règles des paramètres régionaux par défaut. Cette méthode équivaut àtoUpperCase(Locale.getDefault()). Remarque : cette méthode est sensible aux paramètres régionaux. Si elle est utilisée sur une chaîne à interpréter indépendamment des paramètres régionaux, elle peut produire des résultats inattendus. Exemples : identifiants de langage de programmation, clés de protocole et balises HTML. Par exemple,

        "title".toUpperCase()在土耳其语言环境返回"T\u0130TLE", où « \u0130 » est la lettre majuscule latine I avec point au-dessus. Pour obtenir le résultat correct pour une chaîne insensible aux paramètres régionaux, utiliseztoUpperCase(Locale.ROOT) 。

        Résultat
        String, convertit en majuscules. Voir aussi :
        toUpperCase(Locale)
      • trim

        public String trim()
        Retourne une chaîne dont la valeur est cette chaîne, avec suppression de tous les espaces de début et de fin. Un espace est défini comme tout caractère dont le point de code est inférieur ou égal à'U+0020'(caractère espace). Si cet objet

        Stringreprésente une séquence de caractères vide, ou si les premier et dernier caractères de la séquence représentée par cet objetStringont un code qui n'est pas un espace (comme défini ci-dessus), alors cette référenceStringest retournée.

        Sinon, si tous les caractères de cette chaîne sont des espaces (comme défini ci-dessus), un objetStringreprésentant la chaîne vide est retourné.

        Sinon, soit k l'index du premier caractère dont le code n'est pas un espace (tel que défini ci-dessus). Soit m l'index du dernier caractère dont le code n'est pas un espace (tel que défini ci-dessus). Retourner unStringreprésentant la sous-chaîne de cette chaîne qui commence au caractère d'index k et se termine au caractère d'index m, c'est-à-dire le résultat dethis.substring(k, m + 1).

        Cette méthode sert à supprimer les espaces (comme défini ci-dessus) au début et à la fin d'une chaîne.

        Résultat Une chaîne dont la valeur est cette chaîne, avec suppression de tous les espaces de début et de fin. Si aucun espace de début ou de fin n'existe, cette chaîne est retournée telle quelle.
      • strip

        public String strip()
        Retourne une chaîne dont la valeur est cette chaîne, avec suppression de tous leswhite spacede début et de fin. Si cet objet

        Stringreprésente une chaîne vide, ou si tous les points de code de cette chaîne sontwhite space, la chaîne vide est retournée.

        Sinon, retourne la sous-chaîne de cette chaîne qui commence au premier point de code qui n'est paswhite spaceet inclut le dernier point de code qui n'est paswhite space.

        Cette méthode sert à supprimer leswhite spaceau début et à la fin d'une chaîne.

        Résultat Une chaîne dont la valeur est cette chaîne, avec suppression de tous les espaces de début et de fin. Depuis la version : 11 Voir aussi :
        Character.isWhitespace(int)
      • stripLeading

        public String stripLeading()
        Retourne une chaîne dont la valeur est cette chaîne, avec suppression de tous les espaces de débutwhite space. Si cet

        Stringobjet représente une chaîne vide, ou si tous les points de code de cette chaîne sontwhite space, la méthode retourne une chaîne vide.

        Sinon, elle retourne une sous-chaîne de cette chaîne. Cette sous-chaîne commence au premier point de code qui n'est paswhite spaceet inclut le dernier point de code de la chaîne.

        Cette méthode permet de supprimer leswhite spaceau début d'une chaîne.

        Résultat Une chaîne dont la valeur est cette chaîne, avec suppression de tous les espaces de début. Depuis : 11 Voir aussi :
        Character.isWhitespace(int)
      • stripTrailing

        public String stripTrailing()
        Retourne une chaîne dont la valeur est cette chaîne, avec suppression de tous les espaces de finwhite space. Si cet

        Stringobjet représente une chaîne vide, ou si tous les caractères de cette chaîne sontwhite space, la méthode retourne une chaîne vide.

        Sinon, elle retourne une sous-chaîne de cette chaîne. Cette sous-chaîne commence au premier point de code et inclut le dernier point de code qui n'est paswhite space.

        Cette méthode permet de supprimer leswhite spaceà la fin d'une chaîne.

        Résultat Une chaîne dont la valeur est cette chaîne, avec suppression de tous les espaces de fin. Depuis : 11 Voir aussi :
        Character.isWhitespace(int)
      • lines

        public Stream<String> lines()
        Retourne un flux des lignes extraites de cette chaîne, séparées par des terminateurs de ligne. Un terminateur de ligne est l'un des suivants : le caractère de saut de ligne

        "\n" (U + 000A), le caractère de retour chariot"\r" (U + 000D), ou un retour chariot suivi immédiatement d'un saut de ligne"\r\n"(U + 000D U + 000A).

        Une ligne est une séquence de zéro ou plusieurs caractères suivie d'un terminateur de ligne. C'est aussi une séquence d'un ou plusieurs caractères suivie de la fin de la chaîne. Une ligne n'inclut pas le terminateur de ligne.

        Le flux retourné par cette méthode contient les lignes présentes dans cette chaîne.

        API Note : Cette définition d'une ligne implique qu'une chaîne vide a zéro ligne. Elle implique aussi qu'il n'y a pas de ligne vide après un terminateur de ligne en fin de chaîne. Implementation Note : Cette méthode fournit de meilleures performances que split("\R"). Elle fournit les éléments paresseusement et recherche plus rapidement les terminateurs de ligne. Résultat Un flux des lignes extraites de cette chaîne. Depuis : 11
      • toString

        public String toString()
        Cet objet (qui est déjà une chaîne !) est retourné tel quel.
        Specified by:
        toString在界面 CharSequence
        Réécriture :
        toString在类 Object
        La chaîne de résultats elle-même.
      • chars

        public IntStream chars()
        Retourneintun flux sur lescharvaleurs de cette séquence, avec extension à zéro. Tout caractère mappé à un surrogate code point est interprété comme non interprété.
        Spécifié par :
        chars在界面 CharSequence
        Résultat Un IntStream des valeurs char de cette séquence. Depuis la version : 9
      • codePoints

        public IntStream codePoints()
        Retourne un flux des valeurs de points de code de cette séquence. Toute paire de substitution rencontrée dans la séquence est combinée comme avec Character.toCodePoint, et le résultat est transmis au flux. Tout autre code unit (y compris les caractères BMP ordinaires, les substituts non appariés et les code units non définis) est étendu à zéro en uneintvaleur, puis transmis au flux.
        Spécifié par :
        codePoints在界面 CharSequence
        Résultat Un IntStream des points de code Unicode de cette séquence. Depuis la version : 9
      • toCharArray

        public char[] toCharArray()
        Convertit cette chaîne en un nouveau tableau de caractères.
        Résultat : un nouveau tableau de caractères alloué. Sa longueur est celle de cette chaîne. Son contenu est initialisé avec la séquence de caractères représentée par cette chaîne.
      • format

        public static String format​(String format,
                                    Object... args)
        Retourne une chaîne formatée en utilisant la chaîne de format et les arguments spécifiés. La locale toujours utilisée est celle retournée par

        Locale.getDefault(Locale.Category), avec laFORMATcatégorie spécifiée.

        Paramètres
        format- A format string
        args- Les arguments référencés par les spécificateurs de format dans la chaîne de format. S'il y a plus d'arguments que de spécificateurs de format, les arguments supplémentaires sont ignorés. Le nombre d'arguments est variable et peut être zéro. Le nombre maximal d'arguments est limité par la dimension maximale d'un tableau Java, telle que définie par The Java™ Virtual Machine Specification.nullLe comportement des arguments dépend de la conversion. Résultat La chaîne formatée. Exceptions
        IllegalFormatException- Si la chaîne de format contient une syntaxe illégale.
        Formatter
      • format

        public static String format​(Locale l,
                                    String format,
                                    Object... args)
        Retourne une chaîne formatée en utilisant la locale, la chaîne de format et les arguments spécifiés.
        Paramètres
        l- La locale appliquée lors du formatage. Sil是null, aucune localisation n'est appliquée.
        format- A format string
        args- Les arguments référencés par les spécificateurs de format dans la chaîne de format. S'il y a plus d'arguments que de spécificateurs de format, les arguments supplémentaires sont ignorés. Le nombre d'arguments est variable et peut être zéro. Le nombre maximal d'arguments est limité par la dimension maximale d'un tableau Java, telle que définie par The Java™ Virtual Machine Specification.nullLe comportement des arguments dépend de la conversion. Résultat La chaîne formatée. Exceptions
        IllegalFormatException- Si la chaîne de format contient une syntaxe illégale.
        Formatter
      • valueOf

        public static String valueOf​(Object obj)
        RetourneObject参数的字符串表示形式。
        Paramètre
        obj - Object. Résultat Si le paramètre est
        null , la chaîne est égale à"null"; sinon, la valeur de retour estobj.toString(). Voir aussi :
        Object.toString()
      • valueOf

        public static String valueOf​(char[] data)
        Retournecharla représentation sous forme de chaîne du paramètre tableau. Copie le contenu du tableau de caractères. Les modifications ultérieures du tableau n'affectent pas la chaîne retournée.
        Paramètre
        data- tableau de caractères. Résultat a
        String, contenant les caractères du tableau de caractères.
      • valueOf

        public static String valueOf​(char[] data,
                                     int offset,
                                     int count)
        Retournecharla représentation sous forme de chaîne d'un sous-tableau spécifique du paramètre tableau.

        offset参数是子offset.count参数指定子count. Copie le contenu du sous-tableau. Les modifications ultérieures du tableau n'affectent pas la chaîne retournée.

        Paramètres
        data- tableau de caractères.
        offset- décalage initial du sous-tableau.
        count- longueur du sous-tableau. Résultat a
        String, contenant les caractères du sous-tableau spécifié du tableau de caractères. Exception
        IndexOutOfBoundsException - 如果 offset为负数,或者 count为负数,或者 offset+count大于 data.length.
      • copyValueOf

        public static String copyValueOf​(char[] data,
                                         int offset,
                                         int count)
        Équivaut àvalueOf(char[], int, int) 。
        Paramètres
        data- tableau de caractères.
        offset- décalage initial du sous-tableau.
        count- longueur du sous-tableau. Résultat a
        String, contenant les caractères du sous-tableau spécifié du tableau de caractères. Exception
        IndexOutOfBoundsException - 如果 offset为负数,或者 count为负数,或者 offset+count大于 data.length.
      • copyValueOf

        public static String copyValueOf​(char[] data)
        est équivalent àvalueOf(char[]) 。
        Paramètres
        data- un tableau de caractères. Résultat un
        Stringcontenant les caractères du tableau.
      • valueOf

        public static String valueOf​(boolean b)
        Retourne la représentation sous forme de chaîne deboolean参数的字符串表示形式。
        Paramètres
        b - a boolean. Résultat si l'argument est
        true , retourne une chaîne égale à"true"; sinon, retourne une chaîne égale à"false".
      • valueOf

        public static String valueOf​(char c)
        Retourne la représentation sous forme de chaîne dechar参数的字符串表示形式。
        Paramètres
        c - a char. Résultat une chaîne de longueur
        1qui 1contient l'argument ccomme unique caractère.
      • valueOf

        public static String valueOf​(int i)
        Retourne la représentation sous forme de chaîne deintl'argument. Cette représentation est exactement celle retournée par la méthode

        Integer.toStringde l'argument.

        Paramètres
        i - int. Résultat
        intla représentation sous forme de chaîne de l'argument. Voir aussi :
        Integer.toString(int, int)
      • valueOf

        public static String valueOf​(long l)
        Retourne la représentation sous forme de chaîne delongl'argument. Cette représentation est exactement celle retournée par la méthode

        Long.toStringde l'argument.

        Paramètres
        l - a long。 Résultat
        longLa représentation sous forme de chaîne du paramètre. Voir aussi :
        Long.toString(long)
      • valueOf

        public static String valueOf​(float f)
        Retournefloatla représentation sous forme de chaîne du paramètre. Cette représentation est exactement celle que la méthode du paramètre

        Float.toStringretourne.

        Paramètre
        f - a float。 Résultat
        floatLa représentation sous forme de chaîne du paramètre. Voir aussi :
        Float.toString(float)
      • valueOf

        public static String valueOf​(double d)
        Retournedoublela représentation sous forme de chaîne du paramètre. Cette représentation est exactement celle que la méthode du paramètre

        Double.toStringretourne.

        Paramètre
        d - a double。 Résultat
        doubleLa représentation sous forme de chaîne du paramètre. Voir aussi :
        Double.toString(double)
      • intern

        public String intern()
        Retourne la représentation canonique de l'objet chaîne. Le pool de chaînes, initialement vide, est maintenu en privé par la classe

        String.

        Lors de l'appel de la méthode intern, si le pool contient déjà une chaîne égale à l'objet déterminé par la méthode StringString, la chaîne du pool est retournée. Sinon, cet objetStringest ajouté au pool et une référence à cet objetStringest retournée.

        Il en résulte que pour deux chaînes quelconquess和t , s.intern() == t.intern()是true当且仅当s.equals(t)为true 。

        Toutes les chaînes littérales et les expressions constantes de type chaîne sont internées. Les chaînes littérales sont définies dans la section 3.10.5 de The Java™ Language Specification.

        Résultat Une chaîne de même contenu que cette chaîne, mais garantie issue du pool de chaînes unique. See The Java™ Language Specification : 3.10.5 chaînes littérales
      • repeat

        public String repeat​(int count)
        Retourne une chaîne dont la valeur est la concaténation de cette chaîne répétéecountfois. Si cette chaîne est vide ou si count vaut zéro, une chaîne vide est retournée.

        Paramètre
        count- nombre de répétitions Résultat La chaîne composée de cette chaîne répétée
        countfois. Si cette chaîne est vide ou si count vaut zéro, la chaîne retournée est vide. Exceptions
        IllegalArgumentException - 如果 countest négatif. Depuis la version : 11