Participer au site avec un Tip
Rechercher
 

Améliorations / Corrections

Vous avez des améliorations (ou des corrections) à proposer pour ce document : je vous remerçie par avance de m'en faire part, cela m'aide à améliorer le site.

Emplacement :

Description des améliorations :

Module : java.base - Package : java.lang
Version documentée : Java SE 17

Classe « String »

Informations générales

Héritage

java.lang.Object
    java.lang.String

Interfaces implémentées

java.io.Serializable
java.lang.CharSequence
java.lang.Comparable<java.lang.String>
java.lang.constant.Constable
java.lang.constant.ConstantDesc

Définition

public final class String extends java.lang.Object
implements java.io.Serializable,
java.lang.CharSequence,
java.lang.Comparable<java.lang.String>,
java.lang.constant.Constable,
java.lang.constant.ConstantDesc

Description

La classe java.lang.String permet la manipulation de chaînes de caractères. Un grand nombre de méthodes vous est proposé afin de permettre tous les traitements classique sur chaînes de caractères (gestion de la casse, découpage de chaînes de caractères, trimming, recherche de sous-chaînes, ...).

une chaîne de caractères Java est immutable : une fois instanciée il est impossible d'en changer son contenu. L'ensemble des méthodes de transformation de chaînes proposées par cette classe renvoient donc une nouvelle instance de chaîne.

En Java, un caractère occupe deux octets en mémoire et est stocké en représentation UFT-16. Il est possible d'insérer dans une chaîne de caractères n'importe quel caractère Unicode via son code numérique. Cela se fait en utilisant la syntaxe \u suivit des quatre chiffres, exprimés en hexadécimal, du caractère souhaité. Par exemple, la chaîne "\u03c0" représente le caractère PI en minuscule.

Exemple de code

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 
 28 
 29 
 30 
 31 
package fr.koor.sample;
    
public class Start {

    public static void main( String [] args ) {
    
        // Une chaine de caractère est immutable,
        // mais on peut produire une nouvelle instance altérée.
        String initial = "    Hello World    ";
        String result = initial.trim();    // On enlève les blancs devant et derrière
        result = result.toLowerCase();     // result reçoit une nouvelle instance.
        System.out.println( result );
        
        
        // Les chaînes de caractères Java supportent les caractères unicode.
        String message = "Voici le caractère PI en minuscules : \u03c0";
        System.out.println( message );
        message = message.replace( "minuscules", "majuscules" );
        message = message.toUpperCase();   // Oui, ça marche pour différents alphabets !
        System.out.println( message );
        
        
        // On peut découper et joindre des chaînes de caractères.
        String date = "01/01/2020";
        String [] parts = date.split( "/" );
        String newDate = String.join( "-", parts );
        System.out.println( newDate );     // Affiche 01-01-2020
    
    }
    
}
Exemple d'utilisation de la classe String

Disponible depuis

1.0

Voir aussi

Classe java.lang.StringBuffer
Classe java.lang.StringBuilder

Liste des attributs

Tous les attributs Attributs d'instance Attributs statiques Attributs dépréciés
QualificateursTypeNomDescription
public static Comparator CASE_INSENSITIVE_ORDER

Liste des constructeurs

Constructeurs Constructeurs dépréciés
ConstructeurDescription
String()
String( StringBuffer buffer )
String( StringBuilder builder )
String( byte[] bytes )
String( char[] value )
String( String original )
String( byte[] bytes, String charsetName )
String( byte[] bytes, Charset charset )
String( byte[] ascii, int hibyte )
String( byte[] bytes, int offset, int length )
String( char[] value, int offset, int count )
String( int[] codePoints, int offset, int count )
String( byte[] bytes, int offset, int length, Charset charset )
String( byte[] bytes, int offset, int length, String charsetName )
String( byte[] ascii, int hibyte, int offset, int count )

Liste des propriétés (getters/setters)

Propriétés Propriétés dépréciées
QualificateursTypeNomR/W
public boolean blank R/-
public byte[] bytes R/-
public boolean empty R/-

Propriétés héritées de la classe java.lang.Object

class

Liste des méthodes

Toutes les méthodes Méthodes d'instance Méthodes statiques Méthodes concrètes Méthodes abstraites Méthodes dépréciées
QualificateursType de retourPrototype de la méthodeDescription
public char charAt( int index ) Retourne le caractère à la position spécifiée.
public IntStream chars()
public int codePointAt( int index )
public int codePointBefore( int index )
public int codePointCount( int beginIndex, int endIndex )
public IntStream codePoints()
public int compareTo( String anotherString )
public int compareToIgnoreCase( String str )
public String concat( String str )
public boolean contains( CharSequence subString ) Cette méthode permet de vérifier si la séquence de caractères passées en paramètre est présente ou non dans la chaîne courante.
public boolean contentEquals( CharSequence cs )
public boolean contentEquals( StringBuffer sb )
public static String copyValueOf( char[] data, int offset, int count )
public static String copyValueOf( char[] data )
public Optional<java.lang.String> describeConstable()
public boolean endsWith( String suffix ) Cette méthode permet de déterminer si une chaîne de caractères se termine par le suffixe spécifié en paramètre.
public boolean equals( Object anObject )
public boolean equalsIgnoreCase( String anotherString )
public static String format( String format, Object[] args )
public static String format( Locale l, String format, Object[] args )
public String formatted( Object[] args )
public byte[] getBytes( Charset charset )
public byte[] getBytes( String charsetName )
public void getBytes( int srcBegin, int srcEnd, byte[] dst, int dstBegin )
public byte[] getBytes()
public void getChars( int srcBegin, int srcEnd, char[] dst, int dstBegin )
public int hashCode()
public String indent( int n )
public int indexOf( int ch )
public int indexOf( String str ) Recherche la présence d'une sous-chaîne dans la chaîne de caractères courante et renvoie sa position.
public int indexOf( String str, int fromIndex )
public int indexOf( int ch, int fromIndex )
public native String intern()
public boolean isBlank() Cette méthode permet de vérifier si la chaîne est vide ou si elle ne contient que des caractères d'espacements (white spaces).
public boolean isEmpty() Cette méthode permet de vérifier si la chaîne est vide.
public static String join( CharSequence arg0, CharSequence[] arg1 )
public static String join( CharSequence delimiter, Iterable<? extends java.lang.CharSequence> elements )
public int lastIndexOf( String str ) Recherche la dernière occurrence d'une sous-chaîne dans la chaîne de caractères courante et renvoie sa position.
public int lastIndexOf( String str, int fromIndex )
public int lastIndexOf( int ch, int fromIndex )
public int lastIndexOf( int ch )
public int length() Calcule le nombre de caractères Unicode présent dans la chaîne.
public Stream<java.lang.String> lines()
public boolean matches( String regex )
public int offsetByCodePoints( int index, int codePointOffset )
public boolean regionMatches( boolean ignoreCase, int toffset, String other, int ooffset, int len )
public boolean regionMatches( int toffset, String other, int ooffset, int len )
public String repeat( int count )
public String replace( char oldChar, char newChar )
public String replace( CharSequence target, CharSequence replacement )
public String replaceAll( String regex, String replacement )
public String replaceFirst( String regex, String replacement )
public String resolveConstantDesc( Lookup lookup )
public String[] split( String regex )
public String[] split( String regex, int limit )
public boolean startsWith( String prefix, int offset ) Cette méthode permet de déterminer si une chaîne de caractères commence, à partir d'une position donnée, par le préfixe spécifié.
public boolean startsWith( String prefix ) Cette méthode permet de déterminer si une chaîne de caractères commence par le préfixe spécifié en paramètre.
public String strip() Cette méthode permet de produire une nouvelle chaîne de caractères dans laquelle on a supprimé les caractères d'espacement placés en début et en fin de chaîne initiale.
public String stripIndent()
public String stripLeading() Cette méthode permet de produire une nouvelle chaîne de caractères dans laquelle on a supprimé les caractères d'espacement placés en début de chaîne initiale.
public String stripTrailing() Cette méthode permet de produire une nouvelle chaîne de caractères dans laquelle on a supprimé les caractères d'espacement placés en fin de chaîne initiale.
public CharSequence subSequence( int beginIndex, int endIndex )
public String substring( int beginIndex, int endIndex ) Cette méthode permet d'extraire une sous-chaîne de caractères à partir des positions spécifiées.
public String substring( int beginIndex ) Cette méthode permet d'extraire une sous-chaîne de caractères commençant à la position spécifiée et se terminant à la fin de la chaîne courante.
public char[] toCharArray()
public String toLowerCase() Cette méthode produit une nouvelle chaîne de caractères dont l'ensemble des caractères seront mis en minuscules.
public String toLowerCase( Locale locale ) Cette méthode produit une nouvelle chaîne de caractères dont l'ensemble des caractères seront mis en minuscules en tenant compte du Locale spécifié.
public String toString()
public String toUpperCase() Cette méthode produit une nouvelle chaîne de caractères dont l'ensemble des caractères seront mis en majuscules.
public String toUpperCase( Locale locale ) Cette méthode produit une nouvelle chaîne de caractères dont l'ensemble des caractères seront mis en majuscules en tenant compte du Locale spécifié.
public <R> R transform( Function<? super java.lang.String, ? extends R> f )
public String translateEscapes()
public String trim() Cette méthode permet de produire une nouvelle chaîne de caractères dans laquelle on a supprimé les caractères de contrôle et les espaces placés en début et en fin de chaîne initiale.
public static String valueOf( int i )
public static String valueOf( char[] data )
public static String valueOf( Object obj )
public static String valueOf( boolean b )
public static String valueOf( char[] data, int offset, int count )
public static String valueOf( char c )
public static String valueOf( double d )
public static String valueOf( float f )
public static String valueOf( long l )

Méthodes héritées de la classe java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait