PageRenderTime 25ms CodeModel.GetById 14ms RepoModel.GetById 0ms app.codeStats 0ms

/php/function.substr-compare.html

https://bitbucket.org/thncr/manuals
HTML | 167 lines | 124 code | 43 blank | 0 comment | 0 complexity | 0156194232f321b4d59b9de9125a021a MD5 | raw file
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3.  <head>
    4. 

  4.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    5. 

  5.   <title>二进制安全比较字符串（从偏移位置比较指定长度）</title>
    6. 

  6. 

  7.  </head>
    8. 

  8.  <body><div class="manualnavbar" style="text-align: center;">
    9. 

  9.  <div class="prev" style="text-align: left; float: left;"><a href="function.strtr.html">strtr</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="function.substr-count.html">substr_count</a></div>
    11. 

  11.  <div class="up"><a href="ref.strings.html">字符串函数</a></div>
    12. 

  12.  <div class="home"><a href="index.html">PHP Manual</a></div>
    13. 

  13. </div><hr /><div id="function.substr-compare" class="refentry">
    14. 

  14.  <div class="refnamediv">
    15. 

  15.   <h1 class="refname">substr_compare</h1>
    16. 

  16.   <p class="verinfo">(PHP 5)</p><p class="refpurpose"><span class="refname">substr_compare</span> &mdash; <span class="dc-title">二进制安全比较字符串（从偏移位置比较指定长度）</span></p>
    17. 

  17. 

  18.  </div>
    19. 

  19.  
    20. 

  20.  <div class="refsect1 description" id="refsect1-function.substr-compare-description">
    21. 

  21.   <h3 class="title">说明</h3>
    22. 

  22.   <div class="methodsynopsis dc-description">
    23. 

  23.    <span class="type">int</span> <span class="methodname"><strong>substr_compare</strong></span>
    24. 

  24.     ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$main_str</code></span>
    25. 

  25.    , <span class="methodparam"><span class="type">string</span> <code class="parameter">$str</code></span>
    26. 

  26.    , <span class="methodparam"><span class="type">int</span> <code class="parameter">$offset</code></span>
    27. 

  27.    [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$length</code></span>
    28. 

  28.    [, <span class="methodparam"><span class="type">bool</span> <code class="parameter">$case_insensitivity</code><span class="initializer"> = false</span></span>
    29. 

  29.   ]] )</div>
    30. 

  30. 

  31.   <p class="para rdfs-comment">
    32. 

  32.     <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> 个字符。
    33. 

  33.   </p>
    34. 

  34.  </div>
    35. 

  35. 

  36. 

  37.  <div class="refsect1 parameters" id="refsect1-function.substr-compare-parameters">
    38. 

  38.   <h3 class="title">参数</h3>
    39. 

  39.   <p class="para">
    40. 

  40.    <dl>
    41. 

  41. 

  42.     <dt>
    43. 

  43. 

  44.      <span class="term"><em><code class="parameter">main_str</code></em></span>
    45. 

  45.      <dd>
    46. 

  46. 

  47.       <p class="para">
    48. 

  48.        待比较的第一个字符串。
    49. 

  49.       </p>
    50. 

  50.      </dd>
    51. 

  51. 

  52.     </dt>
    53. 

  53. 

  54.     <dt>
    55. 

  55. 

  56.      <span class="term"><em><code class="parameter">str</code></em></span>
    57. 

  57.      <dd>
    58. 

  58. 

  59.       <p class="para">
    60. 

  60.        待比较的第二个字符串。
    61. 

  61.       </p>
    62. 

  62.      </dd>
    63. 

  63. 

  64.     </dt>
    65. 

  65. 

  66.     <dt>
    67. 

  67. 

  68.      <span class="term"><em><code class="parameter">offset</code></em></span>
    69. 

  69.      <dd>
    70. 

  70. 

  71.       <p class="para">
    72. 

  72.        比较开始的位置。如果为负数，则从字符串结尾处开始算起。
    73. 

  73.       </p>
    74. 

  74.      </dd>
    75. 

  75. 

  76.     </dt>
    77. 

  77. 

  78.     <dt>
    79. 

  79. 

  80.      <span class="term"><em><code class="parameter">length</code></em></span>
    81. 

  81.      <dd>
    82. 

  82. 

  83.       <p class="para">
    84. 

  84.        比较的长度。默认值为 <em><code class="parameter">str</code></em> 的长度与 <em><code class="parameter">main_str</code></em> 的长度减去位置偏移量 <em><code class="parameter">offset</code></em> 后二者中的较大者。
    85. 

  85.       </p>
    86. 

  86.      </dd>
    87. 

  87. 

  88.     </dt>
    89. 

  89. 

  90.     <dt>
    91. 

  91. 

  92.      <span class="term"><em><code class="parameter">case_insensitivity</code></em></span>
    93. 

  93.      <dd>
    94. 

  94. 

  95.       <p class="para">
    96. 

  96.        如果 <em><code class="parameter">case_insensitivity</code></em> 为 <strong><code>TRUE</code></strong>，比较将不区分大小写。
    97. 

  97.       </p>
    98. 

  98.      </dd>
    99. 

  99. 

  100.     </dt>
    101. 

  101. 

  102.    </dl>
    103. 

  103. 

  104.   </p>
    105. 

  105.  </div>
    106. 

  106. 

  107. 

  108.  <div class="refsect1 returnvalues" id="refsect1-function.substr-compare-returnvalues">
    109. 

  109.   <h3 class="title">返回值</h3>
    110. 

  110.   <p class="para">
    111. 

  111.    如果 <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>。
    112. 

  112.   </p>
    113. 

  113.  </div>
    114. 

  114. 

  115. 

  116.  <div class="refsect1 changelog" id="refsect1-function.substr-compare-changelog">
    117. 

  117.   <h3 class="title">更新日志</h3>
    118. 

  118.   <p class="para">
    119. 

  119.    <table class="doctable informaltable">
    120. 

  120.     
    121. 

  121.      <thead>
    122. 

  122.       <tr>
    123. 

  123.        <th>版本</th>
    124. 

  124.        <th>说明</th>
    125. 

  125.       </tr>
    126. 

  126. 

  127.      </thead>
    128. 

  128. 

  129.      <tbody class="tbody">
    130. 

  130.       <tr>
    131. 

  131.        <td>5.1.0</td>
    132. 

  132.        <td>
    133. 

  133.         允许使用负数的 <em><code class="parameter">offset</code></em> 参数。
    134. 

  134.        </td>
    135. 

  135.       </tr>
    136. 

  136. 

  137.      </tbody>
    138. 

  138.     
    139. 

  139.    </table>
    140. 

  140. 

  141.   </p>
    142. 

  142.  </div>
    143. 

  143. 

  144. 

  145.  <div class="refsect1 examples" id="refsect1-function.substr-compare-examples">
    146. 

  146.   <h3 class="title">范例</h3>
    147. 

  147.   <p class="para">
    148. 

  148.    <div class="example" id="example-4671">
    149. 

  149.     <p><strong>Example #1  <span class="function"><strong>substr_compare()</strong></span> 范例</strong></p>
    150. 

  150.     <div class="example-contents">
    151. 

  151. <div class="phpcode"><code><span style="color: #000000">
    152. 

  152. <span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"bc"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;0<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"de"</span><span style="color: #007700">,&nbsp;-</span><span style="color: #0000BB">2</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;0<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"bcg"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;0<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"BC"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">true</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;0<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"bc"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">3</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;1<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"cd"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;-1<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">substr_compare</span><span style="color: #007700">(</span><span style="color: #DD0000">"abcde"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"abc"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">5</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;warning<br /></span><span style="color: #0000BB">?&gt;</span>
    153. 

  153. </span>
    154. 

  154. </code></div>
    155. 

  155.     </div>
    156. 

  156. 

  157.    </div>
    158. 

  158.   </p>
    159. 

  159.  </div>
    160. 

  160. 

  161. 

  162. </div><hr /><div class="manualnavbar" style="text-align: center;">
    163. 

  163.  <div class="prev" style="text-align: left; float: left;"><a href="function.strtr.html">strtr</a></div>
    164. 

  164.  <div class="next" style="text-align: right; float: right;"><a href="function.substr-count.html">substr_count</a></div>
    165. 

  165.  <div class="up"><a href="ref.strings.html">字符串函数</a></div>
    166. 

  166.  <div class="home"><a href="index.html">PHP Manual</a></div>
    167. 

  167. </div></body></html>
    168. 

  168.