/php/function.substr-compare.html
HTML | 167 lines | 124 code | 43 blank | 0 comment | 0 complexity | 0156194232f321b4d59b9de9125a021a MD5 | raw file
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
- <html>
- <head>
- <meta http-equiv="content-type" content="text/html; charset=UTF-8">
- <title>二进制安全比较字符串(从偏移位置比较指定长度)</title>
- </head>
- <body><div class="manualnavbar" style="text-align: center;">
- <div class="prev" style="text-align: left; float: left;"><a href="function.strtr.html">strtr</a></div>
- <div class="next" style="text-align: right; float: right;"><a href="function.substr-count.html">substr_count</a></div>
- <div class="up"><a href="ref.strings.html">字符串函数</a></div>
- <div class="home"><a href="index.html">PHP Manual</a></div>
- </div><hr /><div id="function.substr-compare" class="refentry">
- <div class="refnamediv">
- <h1 class="refname">substr_compare</h1>
- <p class="verinfo">(PHP 5)</p><p class="refpurpose"><span class="refname">substr_compare</span> — <span class="dc-title">二进制安全比较字符串(从偏移位置比较指定长度)</span></p>
- </div>
-
- <div class="refsect1 description" id="refsect1-function.substr-compare-description">
- <h3 class="title">说明</h3>
- <div class="methodsynopsis dc-description">
- <span class="type">int</span> <span class="methodname"><strong>substr_compare</strong></span>
- ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$main_str</code></span>
- , <span class="methodparam"><span class="type">string</span> <code class="parameter">$str</code></span>
- , <span class="methodparam"><span class="type">int</span> <code class="parameter">$offset</code></span>
- [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$length</code></span>
- [, <span class="methodparam"><span class="type">bool</span> <code class="parameter">$case_insensitivity</code><span class="initializer"> = false</span></span>
- ]] )</div>
- <p class="para rdfs-comment">
- <span class="function"><strong>substr_compare()</strong></span> 从偏移位置 <em><code class="parameter">offset</code></em> 开始比较 <em><code class="parameter">main_str</code></em> 与 <em><code class="parameter">str</code></em>,比较长度为 <em><code class="parameter">length</code></em> 个字符。
- </p>
- </div>
- <div class="refsect1 parameters" id="refsect1-function.substr-compare-parameters">
- <h3 class="title">参数</h3>
- <p class="para">
- <dl>
- <dt>
- <span class="term"><em><code class="parameter">main_str</code></em></span>
- <dd>
- <p class="para">
- 待比较的第一个字符串。
- </p>
- </dd>
- </dt>
- <dt>
- <span class="term"><em><code class="parameter">str</code></em></span>
- <dd>
- <p class="para">
- 待比较的第二个字符串。
- </p>
- </dd>
- </dt>
- <dt>
- <span class="term"><em><code class="parameter">offset</code></em></span>
- <dd>
- <p class="para">
- 比较开始的位置。如果为负数,则从字符串结尾处开始算起。
- </p>
- </dd>
- </dt>
- <dt>
- <span class="term"><em><code class="parameter">length</code></em></span>
- <dd>
- <p class="para">
- 比较的长度。默认值为 <em><code class="parameter">str</code></em> 的长度与 <em><code class="parameter">main_str</code></em> 的长度减去位置偏移量 <em><code class="parameter">offset</code></em> 后二者中的较大者。
- </p>
- </dd>
- </dt>
- <dt>
- <span class="term"><em><code class="parameter">case_insensitivity</code></em></span>
- <dd>
- <p class="para">
- 如果 <em><code class="parameter">case_insensitivity</code></em> 为 <strong><code>TRUE</code></strong>,比较将不区分大小写。
- </p>
- </dd>
- </dt>
- </dl>
- </p>
- </div>
- <div class="refsect1 returnvalues" id="refsect1-function.substr-compare-returnvalues">
- <h3 class="title">返回值</h3>
- <p class="para">
- 如果 <em><code class="parameter">main_str</code></em> 从偏移位置 <em><code class="parameter">offset</code></em> 起的子字符串小于 <em><code class="parameter">str</code></em>,则返回小于 0 的数;如果大于 <em><code class="parameter">str</code></em>,则返回大于 0 的数;如果二者相等,则返回 0。如果 <em><code class="parameter">offset</code></em> 大于等于 <em><code class="parameter">main_str</code></em> 的长度或 <em><code class="parameter">length</code></em> 被设置为小于 1 的值, <span class="function"><strong>substr_compare()</strong></span> 将打印出一条警告信息并且返回 <strong><code>FALSE</code></strong>。
- </p>
- </div>
- <div class="refsect1 changelog" id="refsect1-function.substr-compare-changelog">
- <h3 class="title">更新日志</h3>
- <p class="para">
- <table class="doctable informaltable">
-
- <thead>
- <tr>
- <th>版本</th>
- <th>说明</th>
- </tr>
- </thead>
- <tbody class="tbody">
- <tr>
- <td>5.1.0</td>
- <td>
- 允许使用负数的 <em><code class="parameter">offset</code></em> 参数。
- </td>
- </tr>
- </tbody>
-
- </table>
- </p>
- </div>
- <div class="refsect1 examples" id="refsect1-function.substr-compare-examples">
- <h3 class="title">范例</h3>
- <p class="para">
- <div class="example" id="example-4671">
- <p><strong>Example #1 <span class="function"><strong>substr_compare()</strong></span> 范例</strong></p>
- <div class="example-contents">
- <div class="phpcode"><code><span style="color: #000000">
- <span style="color: #0000BB"><?php<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">, </span><span style="color: #DD0000">"bc"</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">); </span><span style="color: #FF8000">// 0<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">, </span><span style="color: #DD0000">"de"</span><span style="color: #007700">, -</span><span style="color: #0000BB">2</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">); </span><span style="color: #FF8000">// 0<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">, </span><span style="color: #DD0000">"bcg"</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">); </span><span style="color: #FF8000">// 0<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">, </span><span style="color: #DD0000">"BC"</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">, </span><span style="color: #0000BB">true</span><span style="color: #007700">); </span><span style="color: #FF8000">// 0<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">, </span><span style="color: #DD0000">"bc"</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">3</span><span style="color: #007700">); </span><span style="color: #FF8000">// 1<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">, </span><span style="color: #DD0000">"cd"</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">); </span><span style="color: #FF8000">// -1<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">, </span><span style="color: #DD0000">"abc"</span><span style="color: #007700">, </span><span style="color: #0000BB">5</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">); </span><span style="color: #FF8000">// warning<br /></span><span style="color: #0000BB">?></span>
- </span>
- </code></div>
- </div>
- </div>
- </p>
- </div>
- </div><hr /><div class="manualnavbar" style="text-align: center;">
- <div class="prev" style="text-align: left; float: left;"><a href="function.strtr.html">strtr</a></div>
- <div class="next" style="text-align: right; float: right;"><a href="function.substr-count.html">substr_count</a></div>
- <div class="up"><a href="ref.strings.html">字符串函数</a></div>
- <div class="home"><a href="index.html">PHP Manual</a></div>
- </div></body></html>