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

Signature

public String trim();

Description

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. Les caractères de contrôles considérés sont au nombre de 32 et sont placés juste devant le caractère espace ('\u0020') : on y trouve notamment le caractère tabulation ('\t' de code 9), le caractère CR (Carriage Return/Retour chariot - \r de code 13) et le caractère LF (Line Feed/Saut de ligne - \n de code 10). Dit autrement la méthode trim supprime donc tous les caractères de code numérique inférieur ou égal à 32, placés en tête ou en fin de la chaîne considérée. Les espaces et les caractères de contrôle placés entre deux caractères classiques seront conservés.

les chaînes de caractères Java sont immutables. La chaîne originale ne sera donc pas altérée et une copie nettoyée de la chaîne vous sera retournée.
depuis le Java SE 11, des nouvelles méthodes complètent les possibilités de nettoyage de chaîne de caractères. On peut notamment parler de la méthode String.strip(). Elles ne considèrent plus tous les caractères de contrôle, mais uniquement ceux apparentés à des caractères d'espacement.

Paramètres

Cette méthode n'accepte aucun paramètre.

Valeur de retour

La valeur de retour est de type String. Renvoie une copie nettoyée de la chaîne initiale.

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 
 34 
 35 
 36 
 37 
public class Sample {    
    
    public static void main( String[] args ) {
        
        // On vérifie la suppression des espaces au début et à la fin de la chaîne. 
        String initialString = "   De La Vega Zorro    ";
        String trimedString = initialString.trim();
        
        System.out.println( initialString + "!" );
        System.out.println( trimedString + "!");
        
        
        // On vérifie la suppression des caractères de contrôle au début et à la fin de la chaîne.
        initialString = " \n\tCa néttoie bien la chaîne \t ";
        trimedString = initialString.trim();
        
        System.out.println( initialString + "!" );
        System.out.println( trimedString + "!");
        
        
        // Test sur un caractère de contrôle non apparenté à un espacement :
        // On utilise le caractère BELL (Bip sonore). 
        // Il faut être dans une vraie console pour l'entendre (pensez à mettre le son).
        initialString = "\u0007BELL";
        System.out.println( initialString + " - " + initialString.length() );
        
        // trim supprime le caractère BELL
        trimedString = initialString.trim();
        System.out.println( trimedString + " - " + trimedString.length() );
        
        // alors que strip le conserve !!!
        String strippedString = initialString.strip();
        System.out.println( strippedString + " - " + strippedString.length() );
                
    }

}
Exemple d'utilisation de la méthode String.trim()

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

   De La Vega Zorro    !
De La Vega Zorro!
 
    Ca néttoie bien la chaîne    !
Ca néttoie bien la chaîne!
BELL - 5
BELL - 4
BELL - 5

Disponible depuis

1.0

Voir aussi

La méthode String.strip()

Comment enlever les caractères blancs et espaces devant et dérrière la chaîne ?