WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Scanner.nextDouble() — einen double-Wert lesen

`Scanner.nextDouble()` liest das nächste Token als primitiven Wert vom Typ `double`. Welche Dezimal- und Gruppentrennzeichen erkannt werden, hängt von der Locale des Scanners ab.

Version: Java SE 21

Syntax

public double nextDouble()

// Call on an existing java.util.Scanner instance:
double value = scanner.nextDouble();

Scanner.nextDouble() ist eine Instanzmethode von java.util.Scanner ohne Argumente. Der Aufruf scanner.nextDouble() überspringt die Trennzeichen vor dem nächsten Token, wandelt das Token in einen primitiven double-Wert um und setzt die Leseposition bei Erfolg hinter das Token. Standardmäßig dienen Leerraumzeichen wie Leerzeichen und Zeilenumbrüche als Trennzeichen.

Ein Scanner übernimmt zunächst die Standard-Locale für die Formatierung (Locale.Category.FORMAT). Seine Locale beeinflusst, wie er Zahlen erkennt, insbesondere welche Dezimal- und Gruppentrennzeichen er akzeptiert. Verwende scanner.useLocale(Locale.US), wenn die Eingabe einen Dezimalpunkt wie in 12.5 verwendet.

Entspricht das nächste Token nicht dem erwarteten Format oder lässt es sich nicht in einen double-Wert umwandeln, löst die Methode InputMismatchException aus und verbraucht das Token nicht. Das Überschreiten des Bereichs endlicher double-Werte allein löst diese Ausnahme nicht aus: Mit Locale.US verbraucht die Methode das Token 1e309 und gibt Double.POSITIVE_INFINITY zurück. Ist die Eingabe zu Ende, löst sie NoSuchElementException aus; ist der Scanner geschlossen, IllegalStateException. hasNextDouble() prüft das nächste Token, ohne es zu verbrauchen. Gibt die Methode false zurück, unterscheidet hasNext() ein ungültiges Token vom Eingabeende. Ist ein Token vorhanden, lässt es sich mit next() überspringen. Bei interaktiver Eingabe können sowohl das Prüfen als auch das Lesen auf weitere Daten warten.

nextDouble() liest ein Token, keine ganze Zeile. Steht direkt hinter der Zahl ein Zeilenumbruch, liefert ein anschließendes nextLine() eine leere Zeichenkette. Beim Schließen des Scanners wird auch seine Quelle geschlossen, wenn diese Closeable implementiert. Ein Scanner für System.in schließt damit auch die Standardeingabe.

Beispiele

import java.util.Locale;
import java.util.Scanner;

public class Main {
    public static void main(String[] args) {
        try (Scanner scanner = new Scanner("12.5 -3.25")) {
            scanner.useLocale(Locale.US);
            double first = scanner.nextDouble();
            double second = scanner.nextDouble();
            System.out.println(first);
            System.out.println(second);
        }
    }
}

Ergebnis

12.5
-3.25

Das Programm liest aus einer fest vorgegebenen Zeichenkette; eine Eingabe ist nicht nötig. Mit `Locale.US` erkennt der Scanner den Dezimalpunkt unabhängig von der Standard-Locale für die Formatierung. Die beiden Aufrufe von `nextDouble()` lesen nacheinander `12.5` und `-3.25`. Der `try`-Block schließt den Scanner automatisch.

Zugehörige Lektionen

  • Java · Lektion 2 · Grundlagen · Version: 2

Quellen