Section courante

A propos

Section administrative du site

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 :

  1. public class StringSamples {
  2.     public static void main(String[] args) {
  3.         String courriel = "support@gladir.com";
  4.         String message;
  5.         String Y = ',' + "DEUXIEME";
  6.         String Z = "TROISIEME" + "," + "QUATRIEME";
  7.         message = "ABC";
  8.  
  9.         System.out.println("gladir".concat(".com"));
  10.         System.out.println("Sylvain Maltais".toUpperCase());
  11.         System.out.println("SYLVain MALTais".toUpperCase());
  12.         System.out.println("SYLVAIN MALTAIS".toUpperCase());
  13.         System.out.println("Replace(\"89.7\",'.',',') = " + new String("89.7").replace('.',','));
  14.         System.out.println("Replace(\"64.6\",'.',',') = " + "64.6".replace('.',','));
  15.         System.out.println("Replace(\"M. Maltais\",\"M.\",\"Monsieur\") = " + "M. Maltais".replace("M.","Monsieur"));
  16.         System.out.println("PREMIER" + Y + "," + Z);
  17.         System.out.println("LONGUEUR('Bonjour')=" + "Bonjour".length());
  18.         System.out.println("LONGUEUR(message)=" + message.length());
  19.         System.out.print("Chaine de caractères : ");
  20.         System.out.println(courriel);
  21.         if(courriel.substring(courriel.length()-"gladir.com".length()).equals("gladir.com")) {
  22.             System.out.print("Début de la chaine de caractères : ");
  23.             System.out.println(courriel.substring(0,courriel.length()-"gladir.com".length()-1));
  24.         }
  25.     }
  26. }

on obtiendra le résultat suivant :

gladir.com
SYLVAIN 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» :

  1. public class StringNullSamples {
  2.  
  3.     public static String variablenotinitial;
  4.     
  5.     public static void main(String[] args) {
  6.         System.out.println("Starting...");
  7.         if(variablenotinitial == null) {
  8.             System.out.println("La valeur est NULL");
  9.         } else if(variablenotinitial.isEmpty()) {
  10.             System.out.println("La valeur est vide");
  11.         } else {
  12.             System.out.println("Autre valeur");
  13.         }
  14.         System.out.println("Finish!");
  15.     }
  16.     
  17. }

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