matchresult.html

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

<PRE>
int <B>start</B>()</PRE>
<DL>
<DD>返回匹配的初始索引。
<P>
<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="start(int)"><!-- --></A><H3>
start</H3>
<PRE>
int <B>start</B>(int&nbsp;group)</PRE>
<DL>
<DD>返回在匹配期间由给定组捕获的子序列的初始索引。

<p> <a href="Pattern.html#cg">捕获组</a>是从左到右的索引，从 1 开始。组零表示整个模式，因此表达式 <i>m.</i><tt>start(0)</tt> 等效于 <i>m.</i><tt>start()</tt>。  </p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>group</CODE> - 此匹配器模式中捕获组的索引
<DT><B>返回：</B><DD>组捕获的第一个字符的索引；如果匹配成功但组本身没有匹配项，则返回 <tt>-1</tt>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果没有尝试任何匹配或者以前的匹配操作失败
<DD><CODE><A HREF="../../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果在给定索引的模式中不存在捕获组</DL>
</DD>
</DL>
<HR>

<A NAME="end()"><!-- --></A><H3>
end</H3>
<PRE>
int <B>end</B>()</PRE>
<DL>
<DD>返回最后匹配字符之后的偏移量。</p>
<P>
<DD><DL>

<DT><B>返回：</B><DD>@return  最后匹配字符之后的偏移量
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果没有尝试任何匹配或者以前的匹配操作失败</DL>
</DD>
</DL>
<HR>

<A NAME="end(int)"><!-- --></A><H3>
end</H3>
<PRE>
int <B>end</B>(int&nbsp;group)</PRE>
<DL>
<DD>返回在匹配期间由给定组所捕获子序列的最后字符之后的偏移量。

<p> <a href="Pattern.html#cg">捕获组</a>是从左到右的索引，从 1 开始。组零表示整个模式，因此表达式 <i>m.</i><tt>end(0)</tt> 等效于 <i>m.</i><tt>end()</tt>。</p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>group</CODE> - 此匹配器模式中捕获组的索引
<DT><B>返回：</B><DD>组捕获的最后字符之后的偏移量；如果匹配成功但组本身没有匹配项，则返回 <tt>-1</tt>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果没有尝试任何匹配或者以前的匹配操作失败
<DD><CODE><A HREF="../../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果在给定索引的模式中不存在捕获组</DL>
</DD>
</DL>
<HR>

<A NAME="group()"><!-- --></A><H3>
group</H3>
<PRE>
<A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>group</B>()</PRE>
<DL>
<DD>返回由以前匹配所匹配的输入子序列。

<p> 对于具有输入序列 <i>s</i> 的匹配器 <i>m</i>，表达式 <i>m.</i><tt>group()</tt> 和 <i>s.</i><tt>substring(</tt><i>m.</i><tt>start(),</tt>&nbsp;<i>m.</i><tt>end())</tt> 是等效的。</p>

<p> 注意，某些模式（例如，<tt>a*</tt>）匹配空字符串。当模式成功匹配输入中的空字符串时，此方法将返回空字符串。</p>
<P>
<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="group(int)"><!-- --></A><H3>
group</H3>
<PRE>
<A HREF="../../lang/String.html" title="java.lang 中的类">String</A> <B>group</B>(int&nbsp;group)</PRE>
<DL>
<DD>返回在以前匹配操作期间由给定组捕获的输入子序列。

<p> 对于匹配器 <i>m</i>、输入序列 <i>s</i> 和组索引 <i>g</i>，表达式 <i>m.</i><tt>group(</tt><i>g</i><tt>)</tt> 和 <i>s.</i><tt>substring(</tt><i>m.</i><tt>start(</tt><i>g</i><tt>),</tt>&nbsp;<i>m.</i><tt>end(</tt><i>g</i><tt>))</tt> 是等效的。  </p>
 
<p> <a href="Pattern.html#cg">捕获组</a>是从左到右的索引，从 1 开始。组零表示整个模式，因此表达式 <tt>m.group(0)</tt> 等效于 <tt>m.group()</tt>。
 </p>

<p> 如果该匹配成功了，但指定组未能匹配输入序列的任何部分，则返回 <tt>null</tt>。注意，某些组（例如，<tt>(a*)</tt>）匹配空字符串。当这些的组成功匹配输入中的空字符串时，此方法将返回空字符串。  </p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>group</CODE> - 此匹配器模式中捕获组的索引
<DT><B>返回：</B><DD>在以前的匹配期间组所捕获的子序列（可能为空）；如果组未能匹配输入的部分，则返回 <tt>null</tt>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../lang/IllegalStateException.html" title="java.lang 中的类">IllegalStateException</A></CODE> - 如果没有尝试任何匹配或者以前的匹配操作失败
<DD><CODE><A HREF="../../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果在给定索引的模式中不存在捕获组</DL>
</DD>
</DL>
<HR>

<A NAME="groupCount()"><!-- --></A><H3>
groupCount</H3>
<PRE>
int <B>groupCount</B>()</PRE>
<DL>
<DD>返回此匹配结果的模式中的捕获组数。

<p> 根据惯例，零组表示整个模式。它不包括在此计数中。

<p> 任何小于或等于由此方法返回的值的非负整数保证是此匹配器的有效组索引。</p>
<P>
<DD><DL>

<DT><B>返回：</B><DD>此匹配器模式中的捕获组数</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="跳过导航链接"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>类</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/MatchResult.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Standard&nbsp;Ed. 5.0</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="Matcher.html" title="java.util.regex 中的类"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="Pattern.html" title="java.util.regex 中的类"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html@java_2Futil_2Fregex_2FMatchResult.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="MatchResult.html" target="_top"><B>无框架</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  摘要：&nbsp;嵌套&nbsp;|&nbsp;字段&nbsp;|&nbsp;构造方法&nbsp;|&nbsp;<A HREF="#method_summary">方法</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
详细信息：&nbsp;字段&nbsp;|&nbsp;构造方法&nbsp;|&nbsp;<A HREF="#method_detail">方法</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1"><a href="../../../../../../../../../java.sun.com/cgi-bin/bugreport.cgi">提交错误或意见</a><br>有关更多的 API 参考资料和开发人员文档，请参阅 <a href="../../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/devdocs-vs-specs.html">Java 2 SDK SE 开发人员文档</a>。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。 <p>版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守<a href="../../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/license.html">许可证条款</a>。另请参阅<a href="../../../../../../../../../java.sun.com/docs/redist.html">文档重新分发政策</a>。</font>
</BODY>
</HTML>