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.contains »

Signature

public boolean contains( CharSequence subString );

Description

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.

la classe String implémente l'interface CharSequence. Dans la majorité des cas, le paramètre de la méthode sera bien une chaîne de caractères, mais vous pouvez aussi utiliser un StringBuilder ou autre.

Paramètre

ParamètreTypeDescription
subString
CharSequence
La séquence de caractère pour laquelle recherche la présence.

Valeur de retour

La valeur de retour est de type boolean. Cette méthode renvoie true si la séquence de caractères est présente dans la chaîne courante, false dans le cas contraire.

Exception

Type de l'exceptionDescription
NullPointerException
Une exception de ce type est déclenchée si le paramètre passé 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 
 32 
 33 
import java.util.Scanner;

public class Sample {    
    
    public static void main( String[] args ) {
        
        String [] agenda = {
                "Luke Skywalker", "Walker texas ranger", "Ripley Ellen", "Paul Walker"
        };
        
        // 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 texte à rechercher
            System.out.print( "Veuillez préciser votre recherche : " );
            String seachedString = scanner.nextLine();

            // On met la recherche en minuscules pour ne pas tenir compte de la casse.
            seachedString = seachedString.toLowerCase();
            
            // On sélectionne toutes les chaînes qui possède la chaîne recherchée.
            for( String person : agenda ) {
                if ( person.toLowerCase().contains( seachedString ) ) {
                    System.out.println( person );
                }
            }

        }

    }

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

Et voici les résultats produits par cet exemple.

Veuillez préciser votre recherche : walker
Luke Skywalker
Walker texas ranger
Paul Walker

Disponible depuis

1.5

Voir aussi

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