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 - Classe : String
Version documentée : Java SE 17

Méthode « String.startsWith »

Signature

public boolean startsWith( String prefix,  int offset );

Description

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é. Son comportement est équivalent à this.substring( offset ).startsWith( prefix ).

Paramètres

ParamètreTypeDescription
prefix
String
La chaîne de caractères à tester comme préfixe.
offset
int
La position à partir de laquelle vérifier la correpondance des premiers caractères.

Valeur de retour

La valeur de retour est de type boolean. La méthode retourne true si la chaîne commence bien, à partir de la position spécifiée, par le préfixe spécifié. Dans le cas contraire, elle retourne false.

si le préfixe est une chaîne vide (""), la méthode renvoie true.

Exception

Type de l'exceptionDescription
NullPointerException
Une exception de ce type est déclenchée si le préfixe spécifié en paramètre est nul.

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 
import java.util.Scanner;

public class Sample {    
    
    public static void main( String[] args ) {
        
        String [] words = {
                "testBase", "testBateau", "testDemo", "testDernier"
        };
        
        // Le try (de type tr-with-resources) permet de libérer automatiquement
        // le scanner en fin de bloc (l'appel à la méthode scanner.close()).
        try ( Scanner scanner = new Scanner( System.in ) ) {
            
            // Saisie d'un préfixe
            System.out.print( "Veuillez saisir un préfixe : " );
            String prefix = scanner.nextLine();

            // On sélectionne toutes les chaînes qui possède le préfixe, 
            // à partir du quatrième caractères.
            for( String word : words ) {
                if ( word.startsWith( prefix, 4 ) ) {
                    System.out.println( word );
                }
            }
            
        }
        
    }

}
Exemple d'utilisation de la méthode String.startsWith

Et voici les résultats produits par cet exemple de code.

Veuillez saisir un préfixe : Ba
testBase
testBateau

Disponible depuis

1.0

Voir aussi

La méthode String.indexOf( String )
La méthode String.lastIndexOf( String )
La méthode String.startsWith( String )