scanner.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 1,353 行 · 第 1/5 页

</DD>
<DD><DL>

<DT><B>返回：</B><DD>此扫描器的语言环境</DL>
</DD>
</DL>
<HR>

<A NAME="useLocale(java.util.Locale)"><!-- --></A><H3>
useLocale</H3>
<PRE>
public <A HREF="Scanner.html" title="java.util 中的类">Scanner</A> <B>useLocale</B>(<A HREF="Locale.html" title="java.util 中的类">Locale</A>&nbsp;locale)</PRE>
<DL>
<DD>将此扫描器的语言环境设置为指定的语言环境。

<p>扫描器的语言环境会影响其与正则表达式匹配的默认基元的许多元素；参见上面的<a href= "#localized-numbers">本地化数字</a>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>locale</CODE> - 指定要使用的语言环境的字符串
<DT><B>返回：</B><DD>此扫描器</DL>
</DD>
</DL>
<HR>

<A NAME="radix()"><!-- --></A><H3>
radix</H3>
<PRE>
public int <B>radix</B>()</PRE>
<DL>
<DD>返回此扫描器的默认基数。

<p>扫描器的基数会影响其与正则表达式匹配的默认数的元素；参见上面的<a href= "#localized-numbers">本地化数字</a>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此扫描器的默认基数</DL>
</DD>
</DL>
<HR>

<A NAME="useRadix(int)"><!-- --></A><H3>
useRadix</H3>
<PRE>
public <A HREF="Scanner.html" title="java.util 中的类">Scanner</A> <B>useRadix</B>(int&nbsp;radix)</PRE>
<DL>
<DD>将此扫描器的默认基数设置为指定基数。

<p>扫描器的基数会影响其与正则表达式匹配的默认数的元素；参见上面的<a href= "#localized-numbers">本地化数字</a>。

<p>如果该基数小于 <code>Character.MIN_RADIX</code> 或大于 <code>Character.MAX_RADIX</code>，则抛出 <code>IllegalArgumentException</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>radix</CODE> - 扫描数时要使用的基数
<DT><B>返回：</B><DD>此扫描器
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果基数超出范围</DL>
</DD>
</DL>
<HR>

<A NAME="match()"><!-- --></A><H3>
match</H3>
<PRE>
public <A HREF="regex/MatchResult.html" title="java.util.regex 中的接口">MatchResult</A> <B>match</B>()</PRE>
<DL>
<DD>返回此扫描器所执行的最后扫描操作的匹配结果。如果未执行匹配操作，或者最后的匹配操作失败，则此方法抛出 <code>IllegalStateException</code>。

<p>如果 <code>Scanner</code> 的不同 <code>next</code> 方法执行结束时未抛出异常，则它们会给出一个匹配结果。例如，调用了 <A HREF="Scanner.html#nextInt()"><CODE>nextInt()</CODE></A> 方法（它返回一个 int）后，此方法返回一个 <code>MatchResult</code>，作为搜索上述 <a href="#Integer-regex"><i>Integer</i></a> 正则表达式的结果。类似地，如果 <A HREF="Scanner.html#findInLine(java.lang.String)"><CODE>findInLine(java.lang.String)</CODE></A>、<A HREF="Scanner.html#findWithinHorizon(java.lang.String, int)"><CODE>findWithinHorizon(java.lang.String, int)</CODE></A> 和 <A HREF="Scanner.html#skip(java.util.regex.Pattern)"><CODE>skip(java.util.regex.Pattern)</CODE></A> 方法的调用成功，则它们会给出一个匹配结果。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>最后一次匹配操作的匹配结果
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果未给出匹配结果</DL>
</DD>
</DL>
<HR>

<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>toString</B>()</PRE>
<DL>
<DD><p>返回此 <code>Scanner</code> 的字符串表示形式。<code>Scanner</code> 的字符串表示形式包含了对调试可能有用的信息。没有指定确切格式。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../lang/Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="../lang/Object.html#toString()">toString</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此扫描器的字符串表示形式。</DL>
</DD>
</DL>
<HR>

<A NAME="hasNext()"><!-- --></A><H3>
hasNext</H3>
<PRE>
public boolean <B>hasNext</B>()</PRE>
<DL>
<DD>如果此扫描器的输入中有另一个标记，则返回 true。在等待要扫描的输入时，此方法可能阻塞。扫描器将不执行任何输入。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Iterator.html" title="java.util 中的接口">Iterator</A>&lt;<A HREF="../lang/String.html" title="java.lang 中的类">String</A>&gt;</CODE> 中的 <CODE><A HREF="Iterator.html#hasNext()">hasNext</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>当且仅当此扫描器有另一个标记时才返回 true
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果此扫描器已关闭<DT><B>另请参见：</B><DD><A HREF="Iterator.html" title="java.util 中的接口"><CODE>Iterator</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="next()"><!-- --></A><H3>
next</H3>
<PRE>
public <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>next</B>()</PRE>
<DL>
<DD>查找并返回来自此扫描器的下一个完整标记。完整标记的前后是与分隔模式匹配的输入信息。即使以前调用 <A HREF="Scanner.html#hasNext()"><CODE>hasNext()</CODE></A> 返回了 <code>true</code>，在等待要扫描的输入时此方法也可能阻塞。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Iterator.html" title="java.util 中的接口">Iterator</A>&lt;<A HREF="../lang/String.html" title="java.lang 中的类">String</A>&gt;</CODE> 中的 <CODE><A HREF="Iterator.html#next()">next</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>下一个标记
<DT><B>抛出：</B>
<DD><CODE><A HREF="NoSuchElementException.html" title="java.util 中的类">NoSuchElementException</A></CODE> - 如果没有更多标记可用
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果此扫描器已关闭<DT><B>另请参见：</B><DD><A HREF="Iterator.html" title="java.util 中的接口"><CODE>Iterator</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="remove()"><!-- --></A><H3>
remove</H3>
<PRE>
public void <B>remove</B>()</PRE>
<DL>
<DD><code>Iterator</code> 的这种实现不支持移除操作。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Iterator.html" title="java.util 中的接口">Iterator</A>&lt;<A HREF="../lang/String.html" title="java.lang 中的类">String</A>&gt;</CODE> 中的 <CODE><A HREF="Iterator.html#remove()">remove</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/UnsupportedOperationException.html" title="java.lang 中的类">UnsupportedOperationException</A></CODE> - 如果调用此方法。<DT><B>另请参见：</B><DD><A HREF="Iterator.html" title="java.util 中的接口"><CODE>Iterator</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="hasNext(java.lang.String)"><!-- --></A><H3>
hasNext</H3>
<PRE>
public boolean <B>hasNext</B>(<A HREF="../lang/String.html" title="java.lang 中的类">String</A>&nbsp;pattern)</PRE>
<DL>
<DD>如果下一个标记与从指定字符串构造的模式匹配，则返回 true。扫描器不执行任何输入。

<p> 此方法调用 <tt>hasNext(pattern)</tt> 的行为与调用 <tt>hasNext(Pattern.compile(pattern))</tt> 完全相同。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pattern</CODE> - 指定要扫描的模式的字符串
<DT><B>返回：</B><DD>当且仅当此扫描器有另一个标记与指定模式匹配时才返回 true
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果此扫描器已关闭</DL>
</DD>
</DL>
<HR>

<A NAME="next(java.lang.String)"><!-- --></A><H3>
next</H3>
<PRE>
public <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>next</B>(<A HREF="../lang/String.html" title="java.lang 中的类">String</A>&nbsp;pattern)</PRE>
<DL>
<DD>如果下一个标记与从指定字符串构造的模式匹配，则返回下一个标记。如果匹配操作成功，则扫描器执行与该模式匹配的输入。

<p> 此方法调用 <tt>next(pattern)</tt> 的行为与调用 <tt>next(Pattern.compile(pattern))</tt> 完全相同。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pattern</CODE> - 指定要扫描的模式的字符串
<DT><B>返回：</B><DD>下一标记
<DT><B>抛出：</B>
<DD><CODE><A HREF="NoSuchElementException.html" title="java.util 中的类">NoSuchElementException</A></CODE> - 如果没有这样的标记可用
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果此扫描器已关闭</DL>
</DD>
</DL>
<HR>

<A NAME="hasNext(java.util.regex.Pattern)"><!-- --></A><H3>
hasNext</H3>
<PRE>
public boolean <B>hasNext</B>(<A HREF="regex/Pattern.html" title="java.util.regex 中的类">Pattern</A>&nbsp;pattern)</PRE>
<DL>
<DD>如果下一个完整标记与指定模式匹配，则返回 true。完整标记以与分隔模式匹配的输入信息为前后缀。在等待输入信息时，此方法可能阻塞。扫描器不执行任何输入。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pattern</CODE> - 要扫描的模式
<DT><B>返回：</B><DD>当且仅当此扫描器有另一个标记与指定模式匹配时才返回 true
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果此扫描器已关闭</DL>
</DD>
</DL>
<HR>

<A NAME="next(java.util.regex.Pattern)"><!-- --></A><H3>
next</H3>
<PRE>
public <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>next</B>(<A HREF="regex/Pattern.html" title="java.util.regex 中的类">Pattern</A>&nbsp;pattern)</PRE>
<DL>
<DD>如果下一个标记与指定模式匹配，则返回下一个标记。即使以前调用 <A HREF="Scanner.html#hasNext(java.util.regex.Pattern)"><CODE>hasNext(Pattern)</CODE></A> 返回了 <code>true</code>，在等待要扫描的输入时此方法也可能阻塞。如果此匹配操作成功，则扫描器执行与该模式匹配的输入。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pattern</CODE> - 要扫描的模式
<DT><B>返回：</B><DD>下一个标记
<DT><B>抛出：</B>
<DD><CODE><A HREF="NoSuchElementException.html" title="java.util 中的类">NoSuchElementException</A></CODE> - 如果没有更多的标记可用
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果此扫描器已关闭</DL>
</DD>
</DL>
<HR>

<A NAME="hasNextLine()"><!-- --></A><H3>
hasNextLine</H3>
<PRE>
public boolean <B>hasNextLine</B>()</PRE>
<DL>
<DD>如果在此扫描器的输入中存在另一行，则返回 true。在等待输入信息时，此方法可能阻塞。扫描器不执行任何输入。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>当且仅当此扫描器有另一行输入时才返回 true
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果此扫描器已关闭</DL>
</DD>
</DL>
<HR>

<A NAME="nextLine()"><!-- --></A><H3>
nextLine</H3>
<PRE>
public <A HREF=