Sophie: php-manual-zh-5.2.4-1mdv2008.1 noarch

php-manual-zh-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>preg_match</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="Perl 兼容正则表达式函数"
HREF="ref.pcre.html"><LINK
REL="PREVIOUS"
TITLE="preg_match_all"
HREF="function.preg-match-all.html"><LINK
REL="NEXT"
TITLE="preg_quote"
HREF="function.preg-quote.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.preg-match-all.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.preg-quote.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.preg-match"
></A
>preg_match</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN171728"
></A
><P
>    (PHP 3 &#62;= 3.0.9, PHP 4, PHP 5)</P
>preg_match&nbsp;--&nbsp;进行正则表达式匹配</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN171731"
></A
><H2
>说明</H2
>int <B
CLASS="methodname"
>preg_match</B
> ( string pattern, string subject [, array matches [, int flags]] )<BR
></BR
><P
>&#13;     在 <CODE
CLASS="parameter"
>subject</CODE
> 字符串中搜索与
     <CODE
CLASS="parameter"
>pattern</CODE
> 给出的正则表达式相匹配的内容。
    </P
><P
>&#13;     如果提供了
     <CODE
CLASS="parameter"
>matches</CODE
>，则其会被搜索的结果所填充。<CODE
CLASS="varname"
>$matches[0]</CODE
>
     将包含与整个模式匹配的文本，<CODE
CLASS="varname"
>$matches[1]</CODE
>
     将包含与第一个捕获的括号中的子模式所匹配的文本，以此类推。
    </P
><P
>&#13;     <CODE
CLASS="parameter"
>flags</CODE
> 可以是下列标记：
     <P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>PREG_OFFSET_CAPTURE</DT
><DD
><P
>&#13;         如果设定本标记，对每个出现的匹配结果也同时返回其附属的字符串偏移量。注意这改变了返回的数组的值，使其中的每个单元也是一个数组，其中第一项为匹配字符串，第二项为其偏移量。本标记自
         <TT
CLASS="literal"
>PHP 4.3.0</TT
> 起可用。
        </P
></DD
></DL
></DIV
>
     <CODE
CLASS="parameter"
>flags</CODE
> 参数自
     <TT
CLASS="literal"
>PHP</TT
> 4.3.0 起可用。
    </P
><P
>&#13;     <B
CLASS="function"
>preg_match()</B
> 返回
     <CODE
CLASS="parameter"
>pattern</CODE
> 所匹配的次数。要么是
     0 次（没有匹配）或 1 次，因为 <B
CLASS="function"
>preg_match()</B
>
     在第一次匹配之后将停止搜索。<A
HREF="function.preg-match-all.html"
><B
CLASS="function"
>preg_match_all()</B
></A
>
     则相反，会一直搜索到 <CODE
CLASS="parameter"
>subject</CODE
>
     的结尾处。如果出错 <B
CLASS="function"
>preg_match()</B
> 返回 <TT
CLASS="constant"
><B
>FALSE</B
></TT
>。
    </P
><DIV
CLASS="tip"
><BLOCKQUOTE
CLASS="tip"
><P
><B
>提示: </B
>
      如果只想查看一个字符串是否包含在另一个字符串中，不要用
      <B
CLASS="function"
>preg_match()</B
>。可以用
      <A
HREF="function.strpos.html"
><B
CLASS="function"
>strpos()</B
></A
> 或 <A
HREF="function.strstr.html"
><B
CLASS="function"
>strstr()</B
></A
>
      替代，要快得多。
     </P
></BLOCKQUOTE
></DIV
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN171779"
></A
><P
><B
>例 1. 在文本中搜索“php”</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">// 模式定界符后面的 "i" 表示不区分大小写字母的搜索<br /></font><font color="#007700">if (</font><font color="#0000BB">preg_match </font><font color="#007700">(</font><font color="#DD0000">"/php/i"</font><font color="#007700">, </font><font color="#DD0000">"PHP is the web scripting language of choice."</font><font color="#007700">)) {<br />&nbsp;&nbsp;&nbsp;&nbsp;print </font><font color="#DD0000">"A match was found."</font><font color="#007700">;<br />} else {<br />&nbsp;&nbsp;&nbsp;&nbsp;print </font><font color="#DD0000">"A match was not found."</font><font color="#007700">;<br />}<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN171783"
></A
><P
><B
>例 2. 搜索单词“web”</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">/* 模式中的 \b 表示单词的边界，因此只有独立的 "web" 单词会被匹配，<br /> * 而不会匹配例如 "webbing" 或 "cobweb" 中的一部分 */<br /></font><font color="#007700">if (</font><font color="#0000BB">preg_match </font><font color="#007700">(</font><font color="#DD0000">"/\bweb\b/i"</font><font color="#007700">, </font><font color="#DD0000">"PHP is the web scripting language of choice."</font><font color="#007700">)) {<br />&nbsp;&nbsp;&nbsp;&nbsp;print </font><font color="#DD0000">"A match was found."</font><font color="#007700">;<br />} else {<br />&nbsp;&nbsp;&nbsp;&nbsp;print </font><font color="#DD0000">"A match was not found."</font><font color="#007700">;<br />}<br /><br />if (</font><font color="#0000BB">preg_match </font><font color="#007700">(</font><font color="#DD0000">"/\bweb\b/i"</font><font color="#007700">, </font><font color="#DD0000">"PHP is the website scripting language of choice."</font><font color="#007700">)) {<br />&nbsp;&nbsp;&nbsp;&nbsp;print </font><font color="#DD0000">"A match was found."</font><font color="#007700">;<br />} else {<br />&nbsp;&nbsp;&nbsp;&nbsp;print </font><font color="#DD0000">"A match was not found."</font><font color="#007700">;<br />}<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN171787"
></A
><P
><B
>例 3. 从 URL 中取出域名</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">// 从 URL 中取得主机名<br /></font><font color="#0000BB">preg_match</font><font color="#007700">(</font><font color="#DD0000">"/^(http:\/\/)?([^\/]+)/i"</font><font color="#007700">,<br />&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#DD0000">"http://www.php.net/index.html"</font><font color="#007700">, </font><font color="#0000BB">$matches</font><font color="#007700">);<br /></font><font color="#0000BB">$host </font><font color="#007700">= </font><font color="#0000BB">$matches</font><font color="#007700">[</font><font color="#0000BB">2</font><font color="#007700">];<br /><br /></font><font color="#FF8000">// 从主机名中取得后面两段<br /></font><font color="#0000BB">preg_match</font><font color="#007700">(</font><font color="#DD0000">"/</font><font color="#007700">[</font><font color="#DD0000">^\.\/</font><font color="#007700">]</font><font color="#DD0000">+\.</font><font color="#007700">[</font><font color="#DD0000">^\.\/</font><font color="#007700">]</font><font color="#DD0000">+</font><font color="#007700">$</font><font color="#DD0000">/"</font><font color="#007700">, </font><font color="#0000BB">$host</font><font color="#007700">, </font><font color="#0000BB">$matches</font><font color="#007700">);<br />echo </font><font color="#DD0000">"domain name is: </font><font color="#007700">{</font><font color="#DD0000">$matches</font><font color="#007700">[</font><font color="#DD0000">0</font><font color="#007700">]}\n</font><font color="#DD0000">"</font><font color="#007700">;<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
><P
>&#13;       本例将输出：
      </P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="screen"
>domain name is: php.net</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     参见 <A
HREF="function.preg-match-all.html"
><B
CLASS="function"
>preg_match_all()</B
></A
>，<A
HREF="function.preg-replace.html"
><B
CLASS="function"
>preg_replace()</B
></A
>
     和 <A
HREF="function.preg-split.html"
><B
CLASS="function"
>preg_split()</B
></A
>。
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.preg-match-all.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>起始页</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.preg-quote.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>preg_match_all</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.pcre.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>preg_quote</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>