archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 14:54:52 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8297288: Example code in Scanner class

Browse source 
Reviewed-by: lancea, bpb, alanb
This commit is contained in:
Naoto Sato 2022-12-12 17:59:25 +00:00
parent cf93933e21
commit 0267aa528b
1 changed files with 16 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

28
src/java.base/share/classes/java/util/Scanner.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2021, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2022, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -51,24 +51,28 @@ import sun.util.locale.provider.ResourceBundleBasedAdapter;
* various {@code next} methods. * various {@code next} methods.
* *
* <p>For example, this code allows a user to read a number from * <p>For example, this code allows a user to read a number from
* {@code System.in}: * the console.
* <blockquote><pre>{@code * {@snippet :
* Scanner sc = new Scanner(System.in); * var con = System.console();
* int i = sc.nextInt(); * if (con != null) {
* }</pre></blockquote> * // @link substring="reader()" target="java.io.Console#reader()" :
* Scanner sc = new Scanner(con.reader());
* int i = sc.nextInt();
* }
* }
* *
* <p>As another example, this code allows {@code long} types to be * <p>As another example, this code allows {@code long} types to be
* assigned from entries in a file {@code myNumbers}: * assigned from entries in a file {@code myNumbers}:
* <blockquote><pre>{@code * {@snippet :
* Scanner sc = new Scanner(new File("myNumbers")); * Scanner sc = new Scanner(new File("myNumbers"));
* while (sc.hasNextLong()) { * while (sc.hasNextLong()) {
* long aLong = sc.nextLong(); * long aLong = sc.nextLong();
* } * }
* }</pre></blockquote> * }
* *
* <p>The scanner can also use delimiters other than whitespace. This * <p>The scanner can also use delimiters other than whitespace. This
* example reads several items in from a string: * example reads several items in from a string:
* <blockquote><pre>{@code * {@snippet :
* String input = "1 fish 2 fish red fish blue fish"; * String input = "1 fish 2 fish red fish blue fish";
* Scanner s = new Scanner(input).useDelimiter("\\s*fish\\s*"); * Scanner s = new Scanner(input).useDelimiter("\\s*fish\\s*");
* System.out.println(s.nextInt()); * System.out.println(s.nextInt());
@ -76,7 +80,7 @@ import sun.util.locale.provider.ResourceBundleBasedAdapter;
* System.out.println(s.next()); * System.out.println(s.next());
* System.out.println(s.next()); * System.out.println(s.next());
* s.close(); * s.close();
* }</pre></blockquote> * }
* <p> * <p>
* prints the following output: * prints the following output:
* <blockquote><pre>{@code * <blockquote><pre>{@code
@ -88,7 +92,7 @@ import sun.util.locale.provider.ResourceBundleBasedAdapter;
* *
* <p>The same output can be generated with this code, which uses a regular * <p>The same output can be generated with this code, which uses a regular
* expression to parse all four tokens at once: * expression to parse all four tokens at once:
* <blockquote><pre>{@code * {@snippet :
* String input = "1 fish 2 fish red fish blue fish"; * String input = "1 fish 2 fish red fish blue fish";
* Scanner s = new Scanner(input); * Scanner s = new Scanner(input);
* s.findInLine("(\\d+) fish (\\d+) fish (\\w+) fish (\\w+)"); * s.findInLine("(\\d+) fish (\\d+) fish (\\w+) fish (\\w+)");
@ -96,7 +100,7 @@ import sun.util.locale.provider.ResourceBundleBasedAdapter;
* for (int i=1; i<=result.groupCount(); i++) * for (int i=1; i<=result.groupCount(); i++)
* System.out.println(result.group(i)); * System.out.println(result.group(i));
* s.close(); * s.close();
* }</pre></blockquote> * }
* *
* <p>The <a id="default-delimiter">default whitespace delimiter</a> used * <p>The <a id="default-delimiter">default whitespace delimiter</a> used
* by a scanner is as recognized by {@link Character#isWhitespace(char) * by a scanner is as recognized by {@link Character#isWhitespace(char)