String |
Chaine de caractères |
|---|---|
| Java | java.lang |
Description
Cette classe permet d'effectuer la gestion de base du type de données de chaine de caractères.
Liste des méthodes
| Méthode | Prototype | Description |
|---|---|---|
| STRING | public String(); | Ce constructeur permet d'affecter une valeur de chaine de caractères vide à l'objet. |
| STRING | public String(byte[] bytes); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tableau d'octets. |
| STRING | public String(byte[] ascii, int hibyte); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tableau d'octets et du type de format. |
| STRING | public String(byte[] bytes, int offset, int length); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tableau d'octets et en tenant compte d'une position et d'une longueur spécifié. |
| STRING | public String(byte[] ascii, int hibyte, int offset, int count); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tableau d'octets et en tenant compte d'une position, d'une longueur et d'un type de format spécifié. |
| STRING | public String(byte[] bytes, int offset, int length, String charsetName); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tableau d'octets et en tenant compte d'une position, d'une longueur et de spécificateur spécifié. |
| STRING | public String(byte[] bytes, String charsetName); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tableau d'octets et de spécificateur spécifié. |
| STRING | public String(char[] value); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tableau de caractères. |
| STRING | public String(char[] value, int offset, int count); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tableau de caractères et en tenant compte d'une position et d'une longueur spécifié. |
| STRING | public String(String original); | Ce constructeur permet d'affecter une valeur de chaine de caractères à l'objet. |
| STRING | public String(StringBuffer buffer); | Ce constructeur permet produire une chaine de caractères pour l'objet à partir d'un tampon de chaine de caractères. |
| CHARAT | char charAt(int index); | Cette méthode permet de retourner le caractère situé à la position spécifié dans la chaine de caractères. |
| COMPARETO | int compareTo(Object o); int compareTo(String anotherString); |
Cette méthode permet d'effectuer une comparaison avec un objet ou la chaine de caractères spécifié et la chaine de caractères de l'objet. |
| COMPARETOIGNORECASE | int compareToIgnoreCase(String str); | Cette méthode permet d'effectuer une comparaison de la chaine de caractères spécifié et la chaine de caractères de l'objet sans distinction entre les minuscules et majuscules. |
| CONCAT | String concat(String str); | Cette méthode permet d'ajouter une chaine de caractères à la fin de la chaine de caractères de l'objet |
| CONTENTEQUALS | boolean contentEquals(StringBuffer sb); | Cette méthode permet d'indiquer si une chaine de caractères spécifié est contenu dans la chaine de caractères de l'objet |
| COPYVALUEOF | static String copyValueOf(char[] data); | Cette méthode permet de retourner une chaine de caractères correspondant au tableau de caractères spécifié. |
| COPYVALUEOF | static String copyValueOf(char[] data, int offset, int count); | Cette méthode permet de retourner une chaine de caractères correspondant au tableau de caractères à la position et à la longueur spécifié. |
| ENDSWITH | boolean endsWith(String suffix); | Cette méthode permet d'indiquer si la chaine de caractères de l'objet correspond à la fin de la chaine de caractères spécifié. |
| EQUALS | boolean equals(Object anObject); | Cette méthode permet d'indiquer si l'objet est égale à celui spécifié. |
| EQUALSIGNORECASE | boolean equalsIgnoreCase(String anotherString); | Cette méthode permet d'indiquer si l'objet est égale à celui spécifié sans distinction de majuscule et de minuscule. |
| GETBYTES | byte[] getBytes(); | Cette méthode permet d'encoder un tableau d'octets à partir de la chaine de caractères de l'objet. |
| GETBYTES | void getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin); | Cette méthode permet d'encoder un tableau d'octets de la position début et de fin spécifié à partir de la chaine de caractères de l'objet à la position spécifié. |
| GETBYTES | byte[] getBytes(String charsetName); | Cette méthode permet d'encoder un tableau d'octets à partir de la chaine de caractères spécifié. |
| GETCHARS | void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin); | Cette méthode permet d'encoder un tableau de caractères de la position début et de fin spécifié à partir de la chaine de caractères de l'objet à la position spécifié. |
| HASHCODE | int hashCode(); | Cette méthode permet de demander le code haché de l'objet. |
| INDEXOF | int indexOf(int ch); | Cette méthode permet de demander la première position du caractère spécifié dans la chaine de caractères de l'objet. |
| INDEXOF | int indexOf(int ch, int fromIndex); | Cette méthode permet de demander la première position du caractère spécifié dans la chaine de caractères de l'objet en commençant la recherche à partir d'une certaine position. |
| INDEXOF | int indexOf(String str); | Cette méthode permet de demander la première position de la chaine de caractères spécifié dans la chaine de caractères de l'objet. |
| INDEXOF | int indexOf(String str, int fromIndex); | Cette méthode permet de demander la première position de la chaine de caractères spécifié dans la chaine de caractères de l'objet en commençant la recherche à partir d'une certaine position. |
| INTERN | String intern(); | Cette méthode permet de demander la représentation canonique de la chaine de caractères de l'objet. |
| LASTINDEXOF | int lastIndexOf(int ch); | Cette méthode permet de demander la dernière position du caractère spécifié dans la chaine de caractères de l'objet. |
| LASTINDEXOF | int lastIndexOf(int ch, int fromIndex); | Cette méthode permet de demander la dernière position du caractère spécifié dans la chaine de caractères de l'objet en commençant la recherche à partir d'une certaine position. |
| LASTINDEXOF | int lastIndexOf(String str); | Cette méthode permet de demander la dernière position de la chaine de caractères spécifié dans la chaine de caractères de l'objet. |
| LASTINDEXOF | int lastIndexOf(String str, int fromIndex); | Cette méthode permet de demander la dernière position de la chaine de caractères spécifié dans la chaine de caractères de l'objet en commençant la recherche à partir d'une certaine position. |
| LENGTH | int length(); | Cette méthode permet de demander la longueur de la chaine de caractères de l'objet. |
| MATCHES | boolean matches(String regex); | Cette méthode permet de demander s'il existe une correspondance avec les spécifications de la chaine de caractères spécifié et la chaine de caractères de l'objet. |
| REGIONMATCHES | boolean regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len); boolean regionMatches(int toffset, String other, int ooffset, int len); |
Cette méthode permet de demander s'il existe une correspondant avec les spécifications de la zone de la chaine de caractères spécifié et une zone de la chaine de caractères de l'objet. |
| REPLACE | String replace(char oldChar, char newChar); | Cette méthode permet de remplacer un ou plusieurs caractère(s) par un autre dans la chaine de caractères de l'objet. |
| REPLACEALL | String replaceAll(String regex, String replacement); | Cette méthode permet de remplacer une ou plusieurs sous-chaine de caractères avec certains spécifications par un autre dans la chaine de caractères de l'objet. |
| REPLACEFIRST | String replaceFirst(String regex, String replacement); | Cette méthode permet de remplacer seulement la première sous-chaine de caractères avec certains spécifications par un autre dans la chaine de caractères de l'objet. |
| SPLIT | String[] split(String regex); | Cette méthode permet de subdiviser, en tableau de chaine de caractères, la chaine de caractères de l'objet en prenant pour critère de séparation une spécification. |
| SPLIT | String[] split(String regex, int limit); | Cette méthode permet de subdiviser, en tableau de chaine de caractères d'un nombre élément maximal spécifié par la limite, la chaine de caractères de l'objet en prenant pour critère de séparation une spécification. |
| STARTSWITH | boolean startsWith(String prefix); | Cette méthode permet de vérifier si le début de la chaine de caractères de l'objet commence par le préfixe spécifié. |
| STARTSWITH | boolean startsWith(String prefix, int toffset); | Cette méthode permet de vérifier si le début de la chaine de caractères de l'objet commence par le préfixe spécifié ainsi que la position spécifié. |
| SUBSEQUENCE | CharSequence subSequence(int beginIndex, int endIndex); | Cette méthode permet de demander une partie de la chaine de caractères de l'objet et la retourne sous forme d'une séquence de caractères. |
| SUBSTRING | String substring(int beginIndex); | Cette méthode permet de demander une sous-chaine de caractères commençant à la position spécifié à partir de la chaine de caractères de l'objet. |
| SUBSTRING | String substring(int beginIndex, int endIndex); | Cette méthode permet de demander une partie de la chaine de caractères de l'objet. |
| TOCHARARRAY | char[] toCharArray(); | Cette méthode permet de demander un tableau de caractères correspondant à la valeur de la chaine de caractères de l'objet. |
| TOLOWERCASE | String toLowerCase(); | Cette méthode permet de retourner, en minuscule, la chaine de caractères de l'objet. |
| TOLOWERCASE | String toLowerCase(Locale locale); | Cette méthode permet de retourner, en minuscule, la chaine de caractères de l'objet en se basant sur le paramètre spécifié. |
| TOSTRING | String toString(); | Cette méthode permet de retourner une chaine de caractères correspondant à la valeur de l'objet. |
| TOUPPERCASE | String toUpperCase(); | Cette méthode permet de retourner, en majuscule, la chaine de caractères de l'objet. |
| TOUPPERCASE | String toUpperCase(Locale locale); | Cette méthode permet de retourner, en majuscule, la chaine de caractères de l'objet en se basant sur le paramètre spécifié. |
| TRIM | String trim(); | Cette méthode permet de retourner le résultat de la chaine de caractères, sans ses espaces au début et à la fin, de la chaine de caractères de l'objet. |
| VALUEOF | static String valueOf(boolean b); | Cette méthode permet de retourner une chaine de caractères correspondant à la valeur booléen spécifié. |
| VALUEOF | static String valueOf(char c); | Cette méthode permet de retourner une chaine de caractères correspondant au type de données d'un caractère. |
| VALUEOF | static String valueOf(char[] data); | Cette méthode permet de retourner une chaine de caractères correspondant au type de données d'un tableau de caractères. |
| VALUEOF | static String valueOf(char[] data, int offset, int count); | Cette méthode permet de retourner une chaine de caractères correspondant au type de données d'un tableau de caractères à partir de la position et de la longueur spécifié. |
| VALUEOF | static String valueOf(double d); | Cette méthode permet de retourner une chaine de caractères correspondant au type de données réel de double précision. |
| VALUEOF | static String valueOf(float f); | Cette méthode permet de retourner une chaine de caractères correspondant au type de données réel. |
| VALUEOF | static String valueOf(int i); | Cette méthode permet de retourner une chaine de caractères correspondant au type de données entier. |
| VALUEOF | static String valueOf(long l); | Cette méthode permet de retourner une chaine de caractères correspondant au type de données entier long. |
| VALUEOF | static String valueOf(Object obj); | Cette méthode permet de retourner une chaine de caractères correspondant au paramètre spécifié. |
Exemples
Voici un exemple typique des méthodes de cet objet :
- public class StringSamples {
- public static void main(String[] args) {
- String courriel = "support@gladir.com";
- String message;
- String Y = ',' + "DEUXIEME";
- String Z = "TROISIEME" + "," + "QUATRIEME";
- message = "ABC";
-
- System.out.println("gladir".concat(".com"));
- System.out.println("Sylvain Maltais".toUpperCase());
- System.out.println("SYLVain MALTais".toUpperCase());
- System.out.println("SYLVAIN MALTAIS".toUpperCase());
- System.out.println("Replace(\"89.7\",'.',',') = " + new String("89.7").replace('.',','));
- System.out.println("Replace(\"64.6\",'.',',') = " + "64.6".replace('.',','));
- System.out.println("Replace(\"M. Maltais\",\"M.\",\"Monsieur\") = " + "M. Maltais".replace("M.","Monsieur"));
- System.out.println("PREMIER" + Y + "," + Z);
- System.out.println("LONGUEUR('Bonjour')=" + "Bonjour".length());
- System.out.println("LONGUEUR(message)=" + message.length());
- System.out.print("Chaine de caractères : ");
- System.out.println(courriel);
- if(courriel.substring(courriel.length()-"gladir.com".length()).equals("gladir.com")) {
- System.out.print("Début de la chaine de caractères : ");
- System.out.println(courriel.substring(0,courriel.length()-"gladir.com".length()-1));
- }
- }
- }
on obtiendra le résultat suivant :
gladir.comSYLVAIN MALTAIS
SYLVAIN MALTAIS
SYLVAIN MALTAIS
Replace("89.7",'.',',') = 89,7
Replace("64.6",'.',',') = 64,6
Replace("M. Maltais","M.","Monsieur") = Monsieur Maltais
PREMIER,DEUXIEME,TROISIEME,QUATRIEME
LONGUEUR('Bonjour')=7
LONGUEUR(message)=3
Chaine de caractères : support@gladir.com
Début de la chaine de caractères : support
L'exemple suivant permet de montrer de vérifier une variable n'ayant jamais été initialisé en testant que la valeur est nulle afin d'éviter une erreur «java.lang.NullPointerException» :
- public class StringNullSamples {
-
- public static String variablenotinitial;
-
- public static void main(String[] args) {
- System.out.println("Starting...");
- if(variablenotinitial == null) {
- System.out.println("La valeur est NULL");
- } else if(variablenotinitial.isEmpty()) {
- System.out.println("La valeur est vide");
- } else {
- System.out.println("Autre valeur");
- }
- System.out.println("Finish!");
- }
-
- }
on obtiendra le résultat :
Starting...NULL
Finish!
Légende
Cette couleur permet d'indiquer qu'il s'agit d'un constructeur d'objet.
Voir également
Langage de programmation - Java - Type de données élémentaire - Les chaines de caractères
Langage de programmation - C# (C Sharp) - Référence des classes - String
Dernière mise à jour : Dimanche, le 21 juin 2015