/.vim/manuals/php/mbstring.overload.html

https://bitbucket.org/fally/configs · HTML · 155 lines · 135 code · 20 blank · 0 comment · 0 complexity · 41c1c23453c6f5ff046aa3d4022947ef 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.   <title>Function Overloading Feature</title>
    5. 

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

  6.  </head>
    7. 

  7.  <body><div style="text-align: center;">
    8. 

  8.  <div class="prev" style="text-align: left; float: left;"><a href="mbstring.supported-encodings.html">Supported Character Encodings</a></div>
    9. 

  9.  <div class="next" style="text-align: right; float: right;"><a href="mbstring.php4.req.html">PHP Character Encoding Requirements</a></div>
    10. 

  10.  <div class="up"><a href="book.mbstring.html">Multibyte String</a></div>
    11. 

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

  12. </div><hr /><div>
    13. 

  13.  <h1>
    14. 

  14.   Function Overloading Feature
    15. 

  15.  </h1>
    16. 

  16. 

  17.  <p class="para">
    18. 

  18.   You might often find it difficult to get an existing PHP application
    19. 

  19.   to work in a given multibyte environment. This happens because most 
    20. 

  20.   PHP applications out there are written with the standard string 
    21. 

  21.   functions such as <a href="function.substr.html" class="function">substr()</a>, which are known to 
    22. 

  22.   not properly handle multibyte-encoded strings.
    23. 

  23.  </p>
    24. 

  24.  <p class="para">
    25. 

  25.   mbstring supports a &#039;function overloading&#039; feature which enables
    26. 

  26.   you to add multibyte awareness to such an application without
    27. 

  27.   code modification by overloading multibyte counterparts on
    28. 

  28.   the standard string functions. For example,
    29. 

  29.   <a href="function.mb-substr.html" class="function">mb_substr()</a> is called instead of
    30. 

  30.   <a href="function.substr.html" class="function">substr()</a> if function overloading is enabled.
    31. 

  31.   This feature makes it easy to port applications that only support
    32. 

  32.   single-byte encodings to a multibyte environment in many cases.
    33. 

  33.  </p>
    34. 

  34.  <p class="para">
    35. 

  35.   To use function overloading, set
    36. 

  36.   <i>mbstring.func_overload</i> in <var class="filename">php.ini</var> to a
    37. 

  37.   positive value that represents a combination of bitmasks specifying
    38. 

  38.   the categories of functions to be overloaded. It should be set
    39. 

  39.   to 1 to overload the <a href="function.mail.html" class="function">mail()</a> function. 2 for string
    40. 

  40.   functions, 4 for regular expression functions. For example,
    41. 

  41.   if it is set to 7, mail, strings and regular expression functions will
    42. 

  42.   be overloaded. The list of overloaded functions are shown below.
    43. 

  43.   <table border="5">
    44. 

  44.    <caption><b>Functions to be overloaded</b></caption>
    45. 

  45.    <colgroup>
    46. 

  46. 

  47.     <thead valign="middle">
    48. 

  48.      <tr valign="middle">
    49. 

  49.       <th colspan="1">value of mbstring.func_overload</th>
    50. 

  50.       <th colspan="1">original function</th>
    51. 

  51.       <th colspan="1">overloaded function</th>
    52. 

  52.      </tr>
    53. 

  53. 

  54.    </thead>
    55. 

  55. 

  56.    <tbody valign="middle" class="tbody">
    57. 

  57.      <tr valign="middle">
    58. 

  58.       <td colspan="1" rowspan="1" align="left">1</td>
    59. 

  59.       <td colspan="1" rowspan="1" align="left"><a href="function.mail.html" class="function">mail()</a></td>
    60. 

  60.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-send-mail.html" class="function">mb_send_mail()</a></td>
    61. 

  61.      </tr>
    62. 

  62. 

  63.      <tr valign="middle">
    64. 

  64.       <td colspan="1" rowspan="1" align="left">2</td>
    65. 

  65.       <td colspan="1" rowspan="1" align="left"><a href="function.strlen.html" class="function">strlen()</a></td>
    66. 

  66.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-strlen.html" class="function">mb_strlen()</a></td>
    67. 

  67.      </tr>
    68. 

  68. 

  69.      <tr valign="middle">
    70. 

  70.       <td colspan="1" rowspan="1" align="left">2</td>
    71. 

  71.       <td colspan="1" rowspan="1" align="left"><a href="function.strpos.html" class="function">strpos()</a></td>
    72. 

  72.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-strpos.html" class="function">mb_strpos()</a></td>
    73. 

  73.      </tr>
    74. 

  74. 

  75.      <tr valign="middle">
    76. 

  76.       <td colspan="1" rowspan="1" align="left">2</td>
    77. 

  77.       <td colspan="1" rowspan="1" align="left"><a href="function.strrpos.html" class="function">strrpos()</a></td>
    78. 

  78.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-strrpos.html" class="function">mb_strrpos()</a></td>
    79. 

  79.      </tr>
    80. 

  80. 

  81.      <tr valign="middle">
    82. 

  82.       <td colspan="1" rowspan="1" align="left">2</td>
    83. 

  83.       <td colspan="1" rowspan="1" align="left"><a href="function.substr.html" class="function">substr()</a></td>
    84. 

  84.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-substr.html" class="function">mb_substr()</a></td>
    85. 

  85.      </tr>
    86. 

  86. 

  87.      <tr valign="middle">
    88. 

  88.       <td colspan="1" rowspan="1" align="left">2</td>
    89. 

  89.       <td colspan="1" rowspan="1" align="left"><a href="function.strtolower.html" class="function">strtolower()</a></td>
    90. 

  90.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-strtolower.html" class="function">mb_strtolower()</a></td>
    91. 

  91.      </tr>
    92. 

  92. 

  93.      <tr valign="middle">
    94. 

  94.       <td colspan="1" rowspan="1" align="left">2</td>
    95. 

  95.       <td colspan="1" rowspan="1" align="left"><a href="function.strtoupper.html" class="function">strtoupper()</a></td>
    96. 

  96.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-strtoupper.html" class="function">mb_strtoupper()</a></td>
    97. 

  97.      </tr>
    98. 

  98. 

  99.      <tr valign="middle">
    100. 

  100.       <td colspan="1" rowspan="1" align="left">2</td>
    101. 

  101.       <td colspan="1" rowspan="1" align="left"><a href="function.substr-count.html" class="function">substr_count()</a></td>
    102. 

  102.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-substr-count.html" class="function">mb_substr_count()</a></td>
    103. 

  103.      </tr>
    104. 

  104. 

  105.      <tr valign="middle">
    106. 

  106.       <td colspan="1" rowspan="1" align="left">4</td>
    107. 

  107.       <td colspan="1" rowspan="1" align="left"><a href="function.ereg.html" class="function">ereg()</a></td>
    108. 

  108.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-ereg.html" class="function">mb_ereg()</a></td>
    109. 

  109.      </tr>
    110. 

  110. 

  111.      <tr valign="middle">
    112. 

  112.       <td colspan="1" rowspan="1" align="left">4</td>
    113. 

  113.       <td colspan="1" rowspan="1" align="left"><a href="function.eregi.html" class="function">eregi()</a></td>
    114. 

  114.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-eregi.html" class="function">mb_eregi()</a></td>
    115. 

  115.      </tr>
    116. 

  116. 

  117.      <tr valign="middle">
    118. 

  118.       <td colspan="1" rowspan="1" align="left">4</td>
    119. 

  119.       <td colspan="1" rowspan="1" align="left"><a href="function.ereg-replace.html" class="function">ereg_replace()</a></td>
    120. 

  120.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-ereg-replace.html" class="function">mb_ereg_replace()</a></td>
    121. 

  121.      </tr>
    122. 

  122. 

  123.      <tr valign="middle">
    124. 

  124.       <td colspan="1" rowspan="1" align="left">4</td>
    125. 

  125.       <td colspan="1" rowspan="1" align="left"><a href="function.eregi-replace.html" class="function">eregi_replace()</a></td>
    126. 

  126.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-eregi-replace.html" class="function">mb_eregi_replace()</a></td>
    127. 

  127.      </tr>
    128. 

  128. 

  129.      <tr valign="middle">
    130. 

  130.       <td colspan="1" rowspan="1" align="left">4</td>
    131. 

  131.       <td colspan="1" rowspan="1" align="left"><a href="function.split.html" class="function">split()</a></td>
    132. 

  132.       <td colspan="1" rowspan="1" align="left"><a href="function.mb-split.html" class="function">mb_split()</a></td>
    133. 

  133.      </tr>
    134. 

  134. 

  135.     </tbody>
    136. 

  136.    </colgroup>
    137. 

  137. 

  138.   </table>
    139. 

  139. 

  140.  </p>
    141. 

  141.  <blockquote><p><b class="note">Note</b>: 
    142. 

  142.   
    143. 

  143.    It is not recommended to use the function overloading option in
    144. 

  144.    the per-directory context, because it&#039;s not confirmed yet to be
    145. 

  145.    stable enough in a production environment and may lead to undefined
    146. 

  146.    behaviour.
    147. 

  147.   <br />
    148. 

  148.  </p></blockquote>
    149. 

  149. </div>
    150. 

  150. <hr /><div style="text-align: center;">
    151. 

  151.  <div class="prev" style="text-align: left; float: left;"><a href="mbstring.supported-encodings.html">Supported Character Encodings</a></div>
    152. 

  152.  <div class="next" style="text-align: right; float: right;"><a href="mbstring.php4.req.html">PHP Character Encoding Requirements</a></div>
    153. 

  153.  <div class="up"><a href="book.mbstring.html">Multibyte String</a></div>
    154. 

  154.  <div class="home"><a href="index.html">PHP Manual</a></div>
    155. 

  155. </div></body></html>
    156.