Scanner 类

定义

[Android.Runtime.Register("java/util/Scanner", DoNotGenerateAcw=true)]
public sealed class Scanner : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable, Java.Util.IIterator

[<Android.Runtime.Register("java/util/Scanner", DoNotGenerateAcw=true)>]
type Scanner = class
    inherit Object
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IIterator

继承

Object

Object

Scanner

属性

RegisterAttribute

实现

IJavaObject IJavaPeerable ICloseable IIterator IDisposable

注解

一个简单的文本扫描程序，可以使用正则表达式分析基元类型和字符串。

使用 Scanner 分隔符模式将输入分解为标记，该模式默认与空格匹配。 然后，可以使用各种 next 方法将生成的令牌转换为不同类型的值。

例如，此代码允许用户从 System.in： <blockquote 读取数字>

{@code
                Scanner sc = new Scanner(System.in);
                int i = sc.nextInt();
            }

</blockquote>

作为另一个示例，此代码允许 long 从文件中 myNumbers的条目分配类型： <blockquote>

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

</blockquote>

扫描程序还可以使用空格以外的分隔符。 此示例从字符串中读取多个项： <blockquote>

{@code
                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();
            }

</blockquote>

输出以下输出： <blockquote>

{@code
                1
                2
                red
                blue
            }

</blockquote>

可以使用此代码生成相同的输出，该代码使用正则表达式一次性分析所有四个标记： <blockquote>

{@code
                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();
            }

</blockquote>

扫描程序使用的“默认分隔符”>默认空格分隔符被识别。Character#isWhitespace(char) Character.isWhitespace() 无论以前是否已更改，该方法 #reset reset() 都将扫描程序的分隔符的值重置为默认空格分隔符。

扫描操作可能会阻止等待输入。

和#next#hasNext方法及其配套方法（如#nextInt和#hasNextInt）首先跳过与分隔符模式匹配的任何输入，然后尝试返回下一个标记。 next()这两hasNext()种方法都可能会阻止等待进一步输入。 方法块是否 hasNext() 没有与其关联的 next() 方法是否将阻止的连接。 该方法 #tokens 还可以阻止等待输入。

和#findInLine findInLine()#findWithinHorizon findWithinHorizon()#skip skip()#findAll findAll()方法独立于分隔符模式运行。 这些方法将尝试匹配指定的模式，而不考虑输入中的分隔符，因此可以在不相关的特殊情况下使用。 这些方法可能会阻止等待更多输入。

当扫描程序引发异常 InputMismatchException时，扫描程序不会传递导致异常的令牌，因此可以通过其他方法检索或跳过它。

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

扫描程序可以从实现 java.lang.Readable 接口的任何对象读取文本。 如果调用基础可 java.lang.Readable#read read() 读方法会引发扫描 java.io.IOException 程序，则扫描程序假定已到达输入的末尾。 可以通过该方法检索基础可读性引发的最新 IOException 一次 #ioException 。

关闭后 Scanner ，如果源实现 java.io.Closeable 接口，它将关闭其输入源。

对于没有外部同步的多线程使用，A Scanner 不安全。

除非另有说明，否则将 null 参数传递到任何方法 Scanner 将导致 NullPointerException 引发。

除非使用 #useRadix 该方法设置了不同的弧度，否则扫描程序将默认将数字解释为十进制数。 无论以前是否已更改，该方法 #reset 都将重置扫描程序的弧度 10 值。

<h2> “localized-numbers”>Localized numbers</h2>

此类的实例能够以标准格式以及扫描程序区域设置的格式扫描数字。 扫描程序的“initial-locale”>初始区域设置是该方法返回 java.util.Locale#getDefault(Locale.Category) Locale.getDefault(Locale.Category.FORMAT) 的值;它可以通过该方法进行更改 #useLocale useLocale() 。 无论以前是否已更改，该方法 #reset 都将扫描程序的区域设置的值重置为初始区域设置。

本地化格式根据以下参数进行定义，这些参数用于特定区域设置，取自该区域设置java.text.DecimalFormat DecimalFormat的对象及其df对象java.text.DecimalFormatSymbols DecimalFormatSymbols。 dfs

<blockquote><dl><dt>LocalGroupSeparator  <dd>用于分隔数千个组的字符， 即 nbsp;dfs.java.text.DecimalFormatSymbols#getGroupingSeparator getGroupingSeparator()<dt>LocalDecimalSeparator  <dd>用于小数点的字符， 即 nbsp;dfs.java.text.DecimalFormatSymbols#getDecimalSeparator getDecimalSeparator()<dt>LocalPositivePrefix  <dd>出现在正数（可能为空）之前的字符串， 即 nbsp;df.java.text.DecimalFormat#getPositivePrefix getPositivePrefix()<dt>LocalPositiveSuffix  <dd>正数后显示的字符串（可能为空）， 即 nbsp;df.java.text.DecimalFormat#getPositiveSuffix getPositiveSuffix()<dt>LocalNegativePrefix  <dd>负数之前显示的字符串（可能为空）， 即 nbsp;df.java.text.DecimalFormat#getNegativePrefix getNegativePrefix()<dt>LocalNegativeSuffix  <dd>负数后显示的字符串（可能为空）， 即 nbsp;df.java.text.DecimalFormat#getNegativeSuffix getNegativeSuffix()<dt>LocalNaN  <dd>表示浮点值的非数字的字符串， 例如，nbsp;dfs.java.text.DecimalFormatSymbols#getNaN getNaN()<dt>LocalInfinity  <dd>表示浮点值的无穷大字符串， 例如，nbsp;dfs.java.text.DecimalFormatSymbols#getInfinity getInfinity()</dl></blockquote>

<h3> “number-syntax”>Number syntax</h3>

此类实例可以分析为数字的字符串按以下正则表达式语法指定，其中 Rmax 是正在使用的弧度中最高的数字（例如，Rmax 为 9（以基 10 为单位）。

<dl><dt>NonAsciiDigit： <dd>A non-ASCII character c， for which java.lang.Character#isDigit Character.isDigit(c) returns true

<dt>Non0Digit： <dd[1->RmaxNonASCIIDigit<dt>Digit： <dd>[0-Rmax] |] |NonASCIIDigitdt>GroupedNumeral： <dd>( Non0Digit<Digit??<dd>    ( LocalGroupSeparator数字数字)+ )<数字 dt>数字：<dd>( (Digit+ ) |GroupedNumeral)<dt>“Integer-regex”><i>Integer</i>：<dd( [-+]? (>Digit) )<dd|>LocalPositivePrefixDigitLocalPositiveSuffix<dd>|LocalNegativePrefix数字LocalNegativeSuffix<dt>DecimalNumeral： <dd>数字 dd>|数字<LocalDecimalSeparatorDigit*<dd|>LocalDecimalSeparatorDigit+<dt>Exponent： <dd>( [eE] [+-]?Digit+ )<dt>“Decimal-regex”><i>Decimal</i>：<dd>( [-+]?DecimalNumeralExponent? )<dd>|LocalPositivePrefixDecimalNumeralLocalPositiveSuffixExponent?<dd>|LocalNegativePrefixDecimalNumeralLocalNegativeSuffixExponent?<dt>HexFloat： dd dt>NonNumber： <<dd<>NaN |>[-+]? 0[xX][0-9a-fA-F]*\.[0-9a-fA-F]+ ([pP][-+]?[0-9]+)?LocalNan| Infinity |LocalInfinity<dt>SignedNonNumber： <dd>( [-+]?NonNumber)<dd>|LocalPositivePrefixNonNumberLocalPositiveSuffix<dd>|LocalNegativePrefixNonNumberLocalNegativeSuffix<dt>“Float-regex”><i>Float</i>： <dd>Decimal|HexFloat|SignedNonNumber</dl>

上述正则表达式中的空格并不重要。

在 1.5 中添加。

Java文档java.util.Scanner。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。