Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Scanner.nextLine() — Lire le reste de la ligne courante

`Scanner.nextLine()` renvoie le reste de la ligne courante sans son séparateur de ligne. Juste après `nextInt()`, le résultat peut être une chaîne vide.

Version : Java SE 21

Syntaxe

public String nextLine()

String line = scanner.nextLine();

Scanner.nextLine est une méthode d’instance de java.util.Scanner. Elle ne prend aucun argument et n’a pas de surcharge. Elle s’appelle sur un objet, par exemple avec scanner.nextLine(). Elle renvoie un String de la position courante jusqu’à la fin de la ligne : elle conserve les espaces, exclut le séparateur de ligne du résultat et avance au-delà de ce séparateur s’il est présent. Elle peut aussi lire une dernière ligne non vide sans séparateur final.

next() et nextInt() lisent des jetons, c’est-à-dire des morceaux de texte délimités par le motif de séparation des jetons. nextLine() n’utilise pas ce motif. nextInt() ne peut lire le nombre que s’il forme un jeton entier à lui seul selon le motif de séparation en vigueur. Avec le séparateur par défaut, 42Ada forme un seul jeton : nextInt() lève donc une InputMismatchException. Avec un motif personnalisé, un saut de ligne ne sépare pas forcément les jetons. Si la lecture réussit, nextInt() laisse la position juste après le jeton. Si un séparateur de ligne commence à cet endroit, nextLine() renvoie "", et non le texte de la ligne suivante. S’il reste du texte ou des espaces sur la même ligne, nextLine() les renvoie. Ignore le résultat uniquement si tu veux passer le reste de cette ligne.

hasNextLine() vérifie s’il reste une ligne à lire sans changer la position. Une ligne vide suivie d’un séparateur n’est pas la fin de l’entrée. En l’absence de ligne à lire, nextLine() lève une NoSuchElementException. Les deux méthodes lèvent une IllegalStateException si le scanner est fermé.

Les deux méthodes peuvent rester bloquées en attendant des données. Si le reste de l’entrée ne contient aucun séparateur de ligne, nextLine() peut le mettre entièrement en mémoire tampon. Fermer le scanner ferme aussi sa source si elle implémente Closeable. Ne ferme pas un scanner associé à System.in si le programme a encore besoin de l’entrée standard.

Exemples

import java.util.Scanner;

public class Main {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner("42\r\nAda Lovelace")) {
            int number = scanner.nextInt();
            String rest = scanner.nextLine();

            System.out.println(number);
            System.out.println("[" + rest + "]");
            while (scanner.hasNextLine()) {
                System.out.println("[" + scanner.nextLine() + "]");
            }
        }
    }
}

Résultat

42
[]
[Ada Lovelace]

L’entrée provient d’une chaîne, pas du clavier. Les crochets délimitent ce qui est renvoyé : `[]` représente le reste vide après `42`, et `[Ada Lovelace]` montre que la dernière ligne est lue avec son espace, même sans séparateur final.

Leçons associées

  • Java · Leçon 2 · Débutant · Version : 2

Sources