<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.mbstring.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'mbstring.overload.php',
    1 => '函数重载功能',
    2 => '函数重载功能',
  ),
  'up' => 
  array (
    0 => 'book.mbstring.php',
    1 => '多字节字符串',
  ),
  'prev' => 
  array (
    0 => 'mbstring.supported-encodings.php',
    1 => '支持的字符编码',
  ),
  'next' => 
  array (
    0 => 'mbstring.php4.req.php',
    1 => 'PHP字符编码的要求',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/mbstring/overloading.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="mbstring.overload" class="chapter">
 <h1 class="title">
  函数重载功能
 </h1>


 <div class="warning"><strong class="warning">警告</strong><p class="simpara"> 本特性自 PHP 7.2.0 
起<em>废弃</em>，并且自 PHP 8.0.0 起被<em>移除</em>。
强烈建议不要使用本特性。</p></div>

 <p class="para">
  你也许常常会发现现存的 PHP 应用很难运行在多字节环境下。
  发生这种情况的原因是大多数那种 PHP 应用使用了标准的字符串函数，类似 <span class="function"><a href="function.substr.php" class="function">substr()</a></span>，已知无法处理多字节编码的字符串。
 </p>
 <p class="para">
  mbstring 支持一个“函数重载”功能，将对应的多字节版本重载到标准字符处理函数上，例如你能够让这类应用在不修改代码的前提下添加多字节的处理能力。
  比如，启用函数重载后，<span class="function"><a href="function.mb-substr.php" class="function">mb_substr()</a></span> 将会代替 <span class="function"><a href="function.substr.php" class="function">substr()</a></span> 被调用。
  在很多情况下这个功能允许让仅支持单字节编码的应用简单地和多字节环境对接。
 </p>
 <p class="para">
  要使用函数重载功能，设置 <var class="filename">php.ini</var> 里的 <code class="literal">mbstring.func_overload</code> 为正值，就是表示为重载函数分类的位掩码组合。
  要重载 <span class="function"><a href="function.mail.php" class="function">mail()</a></span> 函数需要设置它为 1。字符串函数设置为 2，正则表达式函数为 4。 
  例如，当它设置为 7， mail、strings 和 正则表达式函数将都会被重载。
  以下列表显示了重载的函数。
  <table class="doctable table">
   <caption><strong>被重载的函数</strong></caption>
   
    <thead>
     <tr>
      <th>mbstring.func_overload 的值</th>
      <th>原始函数</th>
      <th>重载后的函数</th>
     </tr>

   </thead>

   <tbody class="tbody">
     <tr>
      <td>1</td>
      <td><span class="function"><a href="function.mail.php" class="function">mail()</a></span></td>
      <td><span class="function"><a href="function.mb-send-mail.php" class="function">mb_send_mail()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.strlen.php" class="function">strlen()</a></span></td>
      <td><span class="function"><a href="function.mb-strlen.php" class="function">mb_strlen()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.strpos.php" class="function">strpos()</a></span></td>
      <td><span class="function"><a href="function.mb-strpos.php" class="function">mb_strpos()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.strrpos.php" class="function">strrpos()</a></span></td>
      <td><span class="function"><a href="function.mb-strrpos.php" class="function">mb_strrpos()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.substr.php" class="function">substr()</a></span></td>
      <td><span class="function"><a href="function.mb-substr.php" class="function">mb_substr()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.strtolower.php" class="function">strtolower()</a></span></td>
      <td><span class="function"><a href="function.mb-strtolower.php" class="function">mb_strtolower()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.strtoupper.php" class="function">strtoupper()</a></span></td>
      <td><span class="function"><a href="function.mb-strtoupper.php" class="function">mb_strtoupper()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.stripos.php" class="function">stripos()</a></span></td>
      <td><span class="function"><a href="function.mb-stripos.php" class="function">mb_stripos()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.strripos.php" class="function">strripos()</a></span></td>
      <td><span class="function"><a href="function.mb-strripos.php" class="function">mb_strripos()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.strstr.php" class="function">strstr()</a></span></td>
      <td><span class="function"><a href="function.mb-strstr.php" class="function">mb_strstr()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.stristr.php" class="function">stristr()</a></span></td>
      <td><span class="function"><a href="function.mb-stristr.php" class="function">mb_stristr()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.strrchr.php" class="function">strrchr()</a></span></td>
      <td><span class="function"><a href="function.mb-strrchr.php" class="function">mb_strrchr()</a></span></td>
     </tr>

     <tr>
      <td>2</td>
      <td><span class="function"><a href="function.substr-count.php" class="function">substr_count()</a></span></td>
      <td><span class="function"><a href="function.mb-substr-count.php" class="function">mb_substr_count()</a></span></td>
     </tr>

    </tbody>
   
  </table>

 </p>
 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <p class="para">
   不推荐每个目录的范围（context）内使用函数重载选项，因为还无法确定在生产环境中是否稳定，也许会导致不确定的行为。
  </p>
 </p></blockquote>
</div>
<?php manual_footer($setup); ?>