Méthode « String.substring »

Signature

public String substring( int beginIndex );

Description

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.

les chaînes de caractères Java sont immutables. La chaîne originale ne sera donc pas altérée et une copie de la sous-chaîne à extraire vous sera retournée.

les conventions de codage Java préconisent de recapitaliser les noms de méthodes à chaque nouveau mot et il faut respecter cette règle. Pour autant, en anglais une sous-chaîne se dit « substring » et il ne s'agit que d'un seul et unique mot. Amis francophones, ne mettez pas de majuscule sur le deuxième 's' ! Dans le cas contraire, le compilateur Java ne manquera pas de vous rappeler ce point de syntaxe anglaise.

Paramètre

Paramètre	Type	Description
beginIndex	int	La position (inclusive) du premier caractère à extraire.

Valeur de retour

La valeur de retour est de type String. Elle correspond à la sous-chaîne de caractères commençant à la position spécifiée et se terminant à la fin de la chaîne courante.

Exception

Type de l'exception	Description
IndexOutOfBoundsException	Ce type d'exception sera déclenché si le paramètre `beginIndex` est hors bornes (inférieur à `0` ou supérieur à `this.length()`).

Exemple de code

Exemple d'utilisation de la méthode String.substring
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	public class Sample { public static void main( String[] args ) { // Une chaîne de caractères contenant un identifiant et un mot de passe // séparés par un caractère / String data = "toto/P@$$w0rd"; // On recherche la position du caractère /. int slashPos = data.indexOf( "/" ); if ( slashPos != -1 ) { // On procède aux extractions des informations et on les affiche. String login = data.substring( 0, slashPos ); String password = data.substring( slashPos + 1 ); System.out.printf( "Authentification avec %s et %s.\n", login, password ); } else { // La chaîne de caractères initiale ne respecte pas le bon format. System.out.println( "Le format 'login/pwd' n'est pas respecté !" ); } } }

public class Sample {
    
    public static void main( String[] args ) {

        // Une chaîne de caractères contenant un identifiant et un mot de passe
        // séparés par un caractère /
        String data = "toto/P@$$w0rd";
        
        // On recherche la position du caractère /.
        int slashPos = data.indexOf( "/" );
        
        if ( slashPos != -1 ) {
            // On procède aux extractions des informations et on les affiche.
            String login = data.substring( 0, slashPos );
            String password = data.substring( slashPos + 1 );
            
            System.out.printf( "Authentification avec %s et %s.\n", login, password ); 
        } else {
            // La chaîne de caractères initiale ne respecte pas le bon format.
            System.out.println( "Le format 'login/pwd' n'est pas respecté !" );
        }
        
    }
    
}