Scanner 的 hasNext 方法如何“不超过任何输入”？

Question

在java.util.Scanner 的hasNext 和hasNextXxx 方法中显示：

如果此扫描器在其输入中有另一个令牌，则返回 true。此方法可能会在等待输入扫描时阻塞。 扫描仪不会超过任何输入。

扫描器如何在明确必须检查输入中是否存在下一个标记（如Readable 或InputStream）时不通过输入流？

Answer 1

这里有两个“通过输入推进”的概念。

第一个概念是从 InputStream 读取更多字节，当然 Scanner 必须这样做以测试它是否有下一个令牌。 Scanner 通过缓冲从 InputStream 读取的新字节来实现这一点，以便以后可以在必要时从 Scanner 读取这些字节。我们可以称之为“通过输入流前进”。

第二个概念是从缓冲区中推进要消耗的下一个字节的位置。当您调用像 next 这样使用令牌的方法来标记这些字节已被“使用”并且不应再次读取时，就会发生这种情况；调用next 会推进缓冲区中的位置。我们可以称之为“通过扫描器缓冲区中的输入前进”。

文档中的声明“扫描仪不会超过任何输入”是第二个概念；调用hasNext 不会通过扫描器的缓冲区，它只是从输入流中读取更多字节到缓冲区中。为了验证这一点，您可以尝试创建一个输入流，调用hasNext，然后使用nextInLine 读取下一个字符（而不是下一个标记）：

> InputStream is = new ByteArrayInputStream("hello world".getBytes());
> Scanner sc = new Scanner(is);
> sc.next()
"hello" (String)
> sc.hasNext()
true (boolean)
> sc.nextInLine(".")
" " (String)

所以调用hasNext 不仅不会消耗下一个标记，而且也不会消耗下一个标记之前的分隔符。从这个意义上说，扫描器没有“前进[d] 超过任何输入”。

Answer 2

它确实在输入流中前进。从Scanner 和Scanner 用户的角度来看，它只是不会超过下一个输入。所以可以说，这段文档措辞不当。

这可以很容易地通过将单个标记放入流中进行测试，然后为该标记调用hasNext。在这种情况下，您会发现调用hasNext 后流已耗尽。

换句话说，Scanner 在内部缓冲偷看的字符，包括任何分隔符。随后的调用将从缓冲的字符开始。 Scanner 不依赖底层流提供的任何缓冲。

此文本至少在 Java 12 之前存在。

示例代码：

Reader stringReader = new StringReader("Single line");

Scanner firstScanner = new Scanner(stringReader);
// prints out true because there is a first line
System.out.println(firstScanner.hasNextLine());

Scanner secondScanner = new Scanner(stringReader);
// prints out false because the scanner has advanced the reader
// ... through the character stream generated from the string
System.out.println(secondScanner.hasNextLine());

// prints out true because the first scanner is buffering the input
System.out.println(firstScanner.hasNextLine());

---

它还包含 hasNext 的其他文档问题，例如在 Scanner 类本身的文档中它写道：

next() 和 hasNext() 方法及其配套方法（例如 nextInt() 和 hasNextInt()）首先跳过任何与分隔符模式匹配的输入，然后尝试返回下一个标记强>。

显然最后一部分对于hasNext() 是不正确的。这看起来像 hasNext 已被硬塞到现有的句子中。