类 Scanner

public final class Scanner
extends 
implements <>

一个可以使用正则表达式来解析基本类型和字符串的简单文本扫描器。

Scanner 使用分隔符模式将其输入分解为标记，默认情况下该分隔符模式与空白匹配。然后可以使用不同的 next 方法将得到的标记转换为不同类型的值。

例如，以下代码使用户能够从 System.in 中读取一个数：

     Scanner sc = new Scanner(System.in);
     int i = sc.nextInt();
 

再看一个例子，以下代码使 long 类型可以通过 myNumbers 文件中的项分配：

      Scanner sc = new Scanner(new File("myNumbers"));
      while (sc.hasNextLong()) {
          long aLong = sc.nextLong();
      }

扫描器还可以使用不同于空白的分隔符。下面是从一个字符串读取若干项的例子：

     String input = "1 fish 2 fish red fish blue fish";
     Scanner s = new Scanner(input).useDelimiter("\\s*fish\\s*");
     System.out.println(s.nextInt());
     System.out.println(s.nextInt());
     System.out.println(s.next());
     System.out.println(s.next());
     s.close(); 

输出为：

     1
     2
     red
     blue 

以下代码使用正则表达式同时解析所有的 4 个标记，并可以产生与上例相同的输出结果：

     String input = "1 fish 2 fish red fish blue fish";
     Scanner s = new Scanner(input);
     s.findInLine("(\\d+) fish (\\d+) fish (\\w+) fish (\\w+)");
     MatchResult result = s.match();
     for (int i=1; i<=result.groupCount(); i++)
         System.out.println(result.group(i));
     s.close(); 

扫描器所使用的通过 . 来识别。不管以前是否更改， 方法将把扫描器分隔符的值重置为默认空白分隔符。

扫描操作可能被阻塞，而等待信息的输入。

和 方法及其基本类型 companion 方法（如 和 ）首先跳过与分隔符模式匹配的输入，然后尝试返回下一个标记。在等待更多输入时 hasNext 和 next 方法都可能阻塞。hasNext 方法是否阻塞与其相关的 next 方法是否阻塞无关。

、 和 方法的执行与分隔符模式无关。这些方法会尝试匹配与输入中的分隔符无关的指定模式，因此可用于分隔符无关的特殊环境中。在等待更多输入时这些方法可能阻塞。

当某一扫描器抛出 时，该扫描器不会传递导致该异常的标记，因此可以通过其他某种方法来获取或跳过它。

对于某些类型的分隔模式，可能返回空标记。例如，"\\s+" 模式不会返回空标记，因为它与该分隔符的多个实例匹配。而分隔模式 "\\s" 可能返回空标记，因为它一次只传递一个空格。

扫描器可以从实现 接口的任何对象读取文本。如果对底层 readable 的 方法的调用抛出 ，则扫描器认为已经到达了输入的结尾。底层 readable 最新抛出的 IOException 可以通过 方法获取。

如果 Scanner 关闭，且其输入源实现 接口，则该输入源也将关闭。

若没有外部同步，则 Scanner 的多线程使用是不安全的。

除非另行说明，否则将一个 null 参数传递到 Scanner 的任何一个方法中都将抛出 NullPointerException。

默认情况下扫描器会将数字解释为十进制形式，除非已经使用 方法设置了不同的基数。不管以前是否更改， 方法将把扫描器的基数重置为10 。 是 方法返回的值；它可以通过 方法更改。不管以前是否更改， 方法将把扫描器的语言环境重置为初始语言环境。

本地化格式是根据以下参数定义的，对于某一特定语言环境来说，这些参数取自该语言环境的 对象 df，及其 对象 dfs。

LocalGroupSeparator	用于分隔数千个组的字符，即 dfs.
LocalDecimalSeparator	用于小数点的字符，即 dfs.
LocalPositivePrefix	出现在正数前的字符串（可以为空），即 df.
LocalPositiveSuffix	出现在正数后的字符串（可以为空），即 df.
LocalNegativePrefix	出现在负数前的字符串（可以为空），即 df.
LocalNegativeSuffix	出现在负数后的字符串（可以为空），即 df.
LocalNaN	表示浮点值的非数字的字符串，即 dfs.
LocalInfinity	表示浮点值的无穷大的字符串，即 dfs.

(c) 返回 true   Non0Digit  :: = [1-Rmax] | NonASCIIDigit   Digit  :: = [0-Rmax] | NonASCIIDigit   GroupedNumeral  ::

= (	Non0Digit Digit? Digit?
	( LocalGroupSeparator Digit Digit Digit )+ )

  Numeral  :: = ( ( Digit+ ) | GroupedNumeral )   = ( [-+]? ( Numeral ) ) | LocalPositivePrefix Numeral LocalPositiveSuffix | LocalNegativePrefix Numeral LocalNegativeSuffix   DecimalNumeral  :: = Numeral | Numeral LocalDecimalSeparator Digit* | LocalDecimalSeparator Digit+   Exponent  :: = ( [eE] [+-]? Digit+ )   = ( [-+]? DecimalNumeral Exponent? ) | LocalPositivePrefix DecimalNumeral LocalPositiveSuffix Exponent? | LocalNegativePrefix DecimalNumeral LocalNegativeSuffix Exponent?   HexFloat  :: = [-+]? 0[xX][0-9a-fA-F]*\.[0-9a-fA-F]+ ([pP][-+]?[0-9]+)?   NonNumber  :: = NaN | LocalNan | Infinity | LocalInfinity   SignedNonNumber  :: = ( [-+]? NonNumber ) | LocalPositivePrefix NonNumber LocalPositiveSuffix | LocalNegativePrefix NonNumber LocalNegativeSuffix   = Decimal | HexFloat | SignedNonNumber

上面正则表达式中的空白没有意义。