La classe String représente une séquence de caractères. Tous les littéraux de type String dans un programme Java sont implémentées comme des instances de cette classe.
String chaine = "Une chaîne de caractères quelconque !";
es chaînes de caractères sont des constantes, leur valeur ne peut être modifiée après leur création. La classe StringBuffer supporte des modifications directement dans l'objet contenant une chaîne de caractères. Lorsqu'une chaîne de caractères de type String subit une modification de valeur, en réalité, un second objet est créé contenant la chaîne d'origine modifiée.
String part1 = "Quand aurons-nous "; part1 = part1 + "une réelle démocratie ?";
Cet exemple montre qu'un premier objet String est créé, auquel on rajoute une seconde chaîne de caractères. En mémoire, est créé un premier objet référencé par la variable part1. Un second objet composé du premier concaténé à une autre chaîne de caractères est également créé en mémoire, provoquant la suppression de la référence (contenue dans la variable part1) vers le premier objet en la changeant par une référence vers le second objet.
Les champs |
---|
static Comparator CASE_INSENSITIVE_ORDER |
Ce champ représente un comparateur qui ordonne les objets String selon compareToIgnoreCase. |
Les constructeurs |
---|
String() |
initialise un nouvel objet avec une chaîne de caractères vide. |
String(byte[] bytes) |
construit un nouvel objet String en décodant le tableau d'octets à partir d'un jeu de caractères par défaut de la plateforme. |
String(byte[] ascii, int hibyte) |
Dépréciée. |
String(byte[] bytes, int offset, int length) |
construit un nouvel objet String en décodant le tableau d'octets à partir d'un intervalle spécifié par une position et une longueur. |
String(byte[] ascii, int hibyte, int offset, int count) |
Dépréciée. |
String(byte[] bytes, int offset, int length, String charsetName) |
construit un nouvel objet String en décodant le tableau d'octets à partir d'un certaine intervalle et d'un jeu de caractères spécifié. |
String(byte[] bytes, String charsetName) |
construit un nouvel objet String en décodant le tableau d'octets à partir d'un jeu de caractères spécifié. |
String(char[] value) |
alloue un nouvel objet String contenant les caractères provenant du tableau. |
String(char[] value, int offset, int count) |
alloue un nouvel objet String contenant les caractères provenant du tableau et à partir d'une position spécifiée et jusqu'à une certaine longueur. |
String(String original) |
initialise un nouvel objet String avec une chaîne de caractères passée en argument. |
String(StringBuffer buffer) |
alloue un nouvel objet String contenant la séquence de caractères de l'objet StringBuffer passé en argument. |
Les méthodes |
---|
char charAt(int index) |
retourne la caractère positionné à l'index spécifié. |
int compareTo(Object o) |
compare l'objet String à un autre objet. |
int compareTo(String anotherString) |
compare deux chaînes lexicographiquement. |
int compareToIgnoreCase(String str) |
compare deux chaînes lexicographiquement en ignorant la casse de caractères. |
String concat(String str) |
concatène l'objet String à une autre chaîne de caractères. |
boolean contentEquals(StringBuffer sb) |
retourne true si et seulement si l'objet String représente la même séquence de caractères comme l'objet StringBuffer spécifié. |
static String copyValueOf(char[] data) |
retourne un objet String qui représente la séquence de caractères dans le tableau spécifié. |
static String copyValueOf(char[] data, int offset, int count) |
retourne un nouvel objet String qui représente la séquence de caractères dans le tableau spécifié. |
boolean endsWith(String suffix) |
teste si la fin de l'objet String correspond au suffixe spécifié. |
boolean equals(Object anObject) |
compare deux chaînes de caractères entre elles. |
boolean equalsIgnoreCase(String anotherString) |
compare l'objet String à un autre objet de même type en ignorant la casse de caractères. |
byte[] getBytes() |
encode un objet String à l'intérieur d'un tableau d'octets en utilisant le jeu de caractères par défaut de la plateforme. |
void getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin) |
Déprécié. Voir getBytes(). |
byte[] getBytes(String charsetName) |
encode l'objet String à l'intérieur d'une séquence d'octets utilisant le jeu de caractères nommé et stocke le résultat à l'intérieur d'un tableau d'octets. |
void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin) |
copie des caractères à partir de l'objet String à l'intérieur d'un tableau de caractères de destination en suivant des positions de commencement et de fin sur la source et un index de départ au niveau du tableau. |
int hashCode() |
retourne un hash code pour l'objet String. |
int indexOf(int ch) |
retourne l'index à l'intérieur l'objet String de la première occurrence du caractère spécifié. |
int indexOf(int ch, int fromIndex) |
retourne l'index à l'intérieur l'objet String de la première occurrence du caractère spécifié à partir d'une certaine position. |
int indexOf(String str) |
retourne l'index à l'intérieur l'objet String de la première occurrence de la sous-chaîne spécifiée. |
int indexOf(String str, int fromIndex) |
retourne l'index à l'intérieur l'objet String de la première occurrence de la sous-chaîne spécifiée à partir d'une certaine position. |
String intern() |
retourne une représentation canonique pour l'objet String. |
int lastIndexOf(int ch) |
retourne l'index à l'intérieur l'objet String de la dernière occurrence du caractère spécifié. |
int lastIndexOf(int ch, int fromIndex) |
retourne l'index à l'intérieur l'objet String de la dernière occurrence du caractère spécifié à partir d'une certaine position. |
int lastIndexOf(String str) |
retourne l'index à l'intérieur l'objet String de la dernière occurrence de la sous-chaîne spécifiée. |
int lastIndexOf(String str, int fromIndex) |
retourne l'index à l'intérieur l'objet String de la dernière occurrence de la sous-chaîne spécifiée à partir d'une certaine position. |
int length() |
retourne la longueur de l'objet String. |
boolean matches(String regex) |
indique si l'objet String correspond à l'expression régulière donnée. |
boolean regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len) |
teste si deux parties de chaînes de caractères, délimitées chacun par une position de démarrage et une certaine longueur, sont égales en ignorant la casse de caractères. |
boolean regionMatches(int toffset, String other, int ooffset, int len) |
teste si deux parties de chaînes de caractères, délimitées chacun par une position de démarrage et une certaine longueur, sont égales. |
String replace(char oldChar, char newChar) |
retourne un nouvel objet String résultant du remplacement de toutes les occurrences d'un caractère donnée par un autre caractère. |
String replaceAll(String regex, String replacement) |
remplace dans une chaîne de caractères, chaque sous-chaîne qui correspondent à l'expression régulière fournie, par une chaîne de caractères de remplacement. |
String replaceFirst(String regex, String replacement) |
remplace dans un objet String, la première sous-chaîne qui correspond à l'expression régulière fournie, par la chaîne de remplacement. |
String[] split(String regex) |
découpe une chaîne de caractères autour des correspondances données par l'expression régulière. |
String[] split(String regex, int limit) |
découpe, selon une certaine limite, une chaîne de caractères autour des correspondances trouvées par l'expression régulière. |
boolean startsWith(String prefix) |
teste si l'objet String démarre au préfixe spécifié. |
boolean startsWith(String prefix, int toffset) |
teste si l'objet String démarre au préfixe spécifié jusqu'à une position donnée. |
CharSequence subSequence(int beginIndex, int endIndex) |
retourne un objet CharSequence qui est une sous-séquence de l'objet String par l'intermédiaire d'un intervalle spécifié. |
String substring(int beginIndex) |
retourne une nouvelle chaîne de caractères qui est une sous-chaîne de l'objet String par l'intermédiaire d'un intervalle commençant à l'index spécifié jusqu'à la fin. |
String substring(int beginIndex, int endIndex) |
retourne une nouvelle chaîne de caractères qui est une sous-chaîne de l'objet String par l'intermédiaire d'un intervalle spécifié. |
char[] toCharArray() |
convertit l'objet String vers un nouveau tableau de caractères. |
String toLowerCase() |
convertit tous les caractères dans l'objet String en casse minuscule en utilisant les règles de l'objet Locale par défaut. |
String toLowerCase(Locale locale) |
convertit tous les caractères dans l'objet String en casse minuscule en utilisant les règles de l'objet Locale fourni. |
String toString() |
retourne une chaîne de caractères issue de l'objet String. |
String toUpperCase() |
convertit tous les caractères dans l'objet String en casse majuscule en utilisant les règles de l'objet Locale par défaut. |
String toUpperCase(Locale locale) |
convertit tous les caractères dans l'objet String en casse majuscule en utilisant les règles de l'objet Locale fourni. |
String trim() |
retourne une copie de l'objet String en supprimant les espaces blancs avant et après la chaîne de caractères. |
static String valueOf(boolean b) |
retourne un représentation sous forme d'un objet String de la valeur de type booléen passée en argument. |
static String valueOf(char c) |
retourne un représentation sous forme d'un objet String de la valeur de type char passée en argument. |
static String valueOf(char[] data) |
retourne un représentation sous forme d'un objet String d'un tableau de caractères passé en argument. |
static String valueOf(char[] data, int offset, int count) |
retourne un représentation sous forme d'un objet String d'un tableau de caractères avec une position et un nombre de cellules, passés en argument. |
static String valueOf(double d) |
retourne un représentation sous forme d'un objet String de la valeur de type double passée en argument. |
static String valueOf(float f) |
retourne un représentation sous forme d'un objet String de la valeur de type float passée en argument. |
static String valueOf(int i) |
retourne un représentation sous forme d'un objet String de la valeur de type int passée en argument. |
static String valueOf(long l) |
retourne un représentation sous forme d'un objet String de la valeur de type long passée en argument. |
static String valueOf(Object obj) |
retourne un représentation sous forme d'un objet String de l'objet passé en argument. |
Les méthodes héritées de la classe racine java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |