PageRenderTime 30ms CodeModel.GetById 9ms RepoModel.GetById 0ms app.codeStats 0ms

/php/function.array-merge.html

https://bitbucket.org/thncr/manuals
HTML | 237 lines | 208 code | 29 blank | 0 comment | 0 complexity | 68f48b03228a971977a23accd9e233c6 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.array-merge-recursive.html">array_merge_recursive</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="function.array-multisort.html">array_multisort</a></div>
    11. 

  11.  <div class="up"><a href="ref.array.html">数组 函数</a></div>
    12. 

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

  13. </div><hr /><div id="function.array-merge" class="refentry">
    14. 

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

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

  16.     <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">array_merge</span> &mdash; <span class="dc-title">合并一个或多个数组</span></p>
    17. 

  17. 

  18.    </div>
    19. 

  19.  <div class="refsect1 description" id="refsect1-function.array-merge-description">
    20. 

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

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

  22.    <span class="type">array</span> <span class="methodname"><strong>array_merge</strong></span>
    23. 

  23.     ( <span class="methodparam"><span class="type">array</span> <code class="parameter">$array1</code></span>
    24. 

  24.    [, <span class="methodparam"><span class="type">array</span> <code class="parameter">$...</code></span>
    25. 

  25.   ] )</div>
    26. 

  26. 

  27.     <p class="para rdfs-comment">
    28. 

  28.       <span class="function"><strong>array_merge()</strong></span> 将一个或多个数组的单元合并起来，一个数组中的值附加在前一个数组的后面。返回作为结果的数组。
    29. 

  29.     </p>
    30. 

  30.     <p class="para">
    31. 

  31.      如果输入的数组中有相同的字符串键名，则该键名后面的值将覆盖前一个值。然而，如果数组包含数字键名，后面的值将<em class="emphasis">不会</em>覆盖原来的值，而是附加到后面。
    32. 

  32.     </p>
    33. 

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

  34.      如果只给了一个数组并且该数组是数字索引的，则键名会以连续方式重新索引。
    35. 

  35.     </p>
    36. 

  36.    </div>
    37. 

  37. 

  38.  <div class="refsect1 parameters" id="refsect1-function.array-merge-parameters">
    39. 

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

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

  41.    <dl>
    42. 

  42. 

  43.     <dt>
    44. 

  44. 

  45.      <span class="term"><em><code class="parameter">array1</code></em></span>
    46. 

  46.      <dd>
    47. 

  47. 

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

  49.        Initial array to merge.
    50. 

  50.       </p>
    51. 

  51.      </dd>
    52. 

  52. 

  53.     </dt>
    54. 

  54. 

  55.     <dt>
    56. 

  56. 

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

  58.      <dd>
    59. 

  59. 

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

  61.        Variable list of arrays to merge.
    62. 

  62.       </p>
    63. 

  63.      </dd>
    64. 

  64. 

  65.     </dt>
    66. 

  66. 

  67.    </dl>
    68. 

  68. 

  69.   </p>
    70. 

  70.  </div>
    71. 

  71. 

  72.  <div class="refsect1 returnvalues" id="refsect1-function.array-merge-returnvalues">
    73. 

  73.   <h3 class="title">返回值</h3>
    74. 

  74.   <p class="para">
    75. 

  75.    返回结果数组。
    76. 

  76.   </p>
    77. 

  77.  </div>
    78. 

  78. 

  79.  <div class="refsect1 changelog" id="refsect1-function.array-merge-changelog">
    80. 

  80.   <h3 class="title">更新日志</h3>
    81. 

  81.   <p class="para">
    82. 

  82.    <table class="doctable informaltable">
    83. 

  83.     
    84. 

  84.      <thead>
    85. 

  85.       <tr>
    86. 

  86.        <th>版本</th>
    87. 

  87.        <th>说明</th>
    88. 

  88.       </tr>
    89. 

  89. 

  90.      </thead>
    91. 

  91. 

  92.      <tbody class="tbody">
    93. 

  93.       <tr>
    94. 

  94.        <td>5.0.0</td>
    95. 

  95.        <td>
    96. 

  96.         <div class="warning"><strong class="warning">Warning</strong>
    97. 

  97.          <p class="para">
    98. 

  98.        <span class="function"><strong>array_merge()</strong></span> 的行为在 PHP 5 中被修改了。和 PHP 4
    99. 

  99.       不同， <span class="function"><strong>array_merge()</strong></span> 现在只接受
    100. 

  100.       <span class="type"><a href="language.types.array.html" class="type array">array</a></span> 类型的参数。不过可以用强制转换来合并其它类型。请看下面的例子。
    101. 

  101.          </p>
    102. 

  102.          <p class="para">
    103. 

  103.           <div class="example" id="example-4719">
    104. 

  104.            <p><strong>Example #1  <span class="function"><strong>array_merge()</strong></span> PHP 5 例子</strong></p>
    105. 

  105.            <div class="example-contents">
    106. 

  106. <div class="phpcode"><code><span style="color: #000000">
    107. 

  107. <span style="color: #0000BB">&lt;?php<br />$beginning&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'foo'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$end&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #0000BB">1&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'bar'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$result&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">array_merge</span><span style="color: #007700">((array)</span><span style="color: #0000BB">$beginning</span><span style="color: #007700">,&nbsp;(array)</span><span style="color: #0000BB">$end</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
    108. 

  108. </span>
    109. 

  109. </code></div>
    110. 

  110.            </div>
    111. 

  111. 

  112.            <div class="example-contents"><p>以上例程会输出：</p></div>
    113. 

  113.            <div class="example-contents screen">
    114. 

  114.     <div class="cdata"><pre>
    115. 

  115.     Array
    116. 

  116.     (
    117. 

  117.         [0] =&gt; foo
    118. 

  118.         [1] =&gt; bar
    119. 

  119.     )
    120. 

  120. </pre></div>
    121. 

  121.            </div>
    122. 

  122.           </div>
    123. 

  123.          </p>
    124. 

  124.         </div>
    125. 

  125.        </td>
    126. 

  126.       </tr>
    127. 

  127. 

  128.      </tbody>
    129. 

  129.     
    130. 

  130.    </table>
    131. 

  131. 

  132.   </p>
    133. 

  133.  </div>
    134. 

  134. 

  135.  <div class="refsect1 examples" id="refsect1-function.array-merge-examples">
    136. 

  136.   <h3 class="title">范例</h3>
    137. 

  137.   <p class="para">
    138. 

  138.    <div class="example" id="example-4720">
    139. 

  139.     <p><strong>Example #2  <span class="function"><strong>array_merge()</strong></span> 例子</strong></p>
    140. 

  140.     <div class="example-contents">
    141. 

  141. <div class="phpcode"><code><span style="color: #000000">
    142. 

  142. <span style="color: #0000BB">&lt;?php<br />$array1&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #DD0000">"color"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"red"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">4</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$array2&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #DD0000">"a"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"b"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"color"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"green"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"shape"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"trapezoid"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">4</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$result&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">array_merge</span><span style="color: #007700">(</span><span style="color: #0000BB">$array1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$array2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
    143. 

  143. </span>
    144. 

  144. </code></div>
    145. 

  145.     </div>
    146. 

  146. 

  147.     <div class="example-contents"><p>以上例程会输出：</p></div>
    148. 

  148.     <div class="example-contents screen">
    149. 

  149. <div class="cdata"><pre>
    150. 

  150. Array
    151. 

  151. (
    152. 

  152.     [color] =&gt; green
    153. 

  153.     [0] =&gt; 2
    154. 

  154.     [1] =&gt; 4
    155. 

  155.     [2] =&gt; a
    156. 

  156.     [3] =&gt; b
    157. 

  157.     [shape] =&gt; trapezoid
    158. 

  158.     [4] =&gt; 4
    159. 

  159. )
    160. 

  160. </pre></div>
    161. 

  161.     </div>
    162. 

  162.    </div>
    163. 

  163.   </p>
    164. 

  164.   <p class="para">
    165. 

  165.    <div class="example" id="example-4721">
    166. 

  166.     <p><strong>Example #3 Simple  <span class="function"><strong>array_merge()</strong></span> 例子</strong></p>
    167. 

  167.     <div class="example-contents">
    168. 

  168. <div class="phpcode"><code><span style="color: #000000">
    169. 

  169. <span style="color: #0000BB">&lt;?php<br />$array1&nbsp;</span><span style="color: #007700">=&nbsp;array();<br /></span><span style="color: #0000BB">$array2&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #0000BB">1&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"data"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$result&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">array_merge</span><span style="color: #007700">(</span><span style="color: #0000BB">$array1</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$array2</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
    170. 

  170. </span>
    171. 

  171. </code></div>
    172. 

  172.     </div>
    173. 

  173. 

  174.     <div class="example-contents"><p>
    175. 

  175.      别忘了数字键名将会被重新编号！
    176. 

  176.     </p></div>
    177. 

  177.     <div class="example-contents screen">
    178. 

  178. <div class="cdata"><pre>
    179. 

  179. Array
    180. 

  180. (
    181. 

  181.     [0] =&gt; data
    182. 

  182. )
    183. 

  183. </pre></div>
    184. 

  184.     </div>
    185. 

  185.     <div class="example-contents"><p>
    186. 

  186.      如果你想完全保留原有数组并只想新的数组附加到后面，用 <em>+</em> 运算符：
    187. 

  187.     </p></div>
    188. 

  188.     <div class="example-contents">
    189. 

  189. <div class="phpcode"><code><span style="color: #000000">
    190. 

  190. <span style="color: #0000BB">&lt;?php<br />$array1&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #0000BB">0&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'zero_a'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">2&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'two_a'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">3&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'three_a'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$array2&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #0000BB">1&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'one_b'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">3&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'three_b'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">4&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">'four_b'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$result&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">$array1&nbsp;</span><span style="color: #007700">+&nbsp;</span><span style="color: #0000BB">$array2</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
    191. 

  191. </span>
    192. 

  192. </code></div>
    193. 

  193.     </div>
    194. 

  194. 

  195.     <div class="example-contents"><p>
    196. 

  196.      The keys from the first array will be preserved. If an array key
    197. 

  197.      exists in both arrays, then the element from the first array will
    198. 

  198.      be used and the matching key&#039;s element from the second array will
    199. 

  199.      be ignored.
    200. 

  200.     </p></div>
    201. 

  201.     <div class="example-contents screen">
    202. 

  202. <div class="cdata"><pre>
    203. 

  203. array(5) {
    204. 

  204.   [0]=&gt;
    205. 

  205.   string(6) &quot;zero_a&quot;
    206. 

  206.   [2]=&gt;
    207. 

  207.   string(5) &quot;two_a&quot;
    208. 

  208.   [3]=&gt;
    209. 

  209.   string(7) &quot;three_a&quot;
    210. 

  210.   [1]=&gt;
    211. 

  211.   string(5) &quot;one_b&quot;
    212. 

  212.   [4]=&gt;
    213. 

  213.   string(6) &quot;four_b&quot;
    214. 

  214. }
    215. 

  215. </pre></div>
    216. 

  216.     </div>
    217. 

  217.    </div>
    218. 

  218.   </p>
    219. 

  219.  </div>
    220. 

  220. 

  221.  <div class="refsect1 seealso" id="refsect1-function.array-merge-seealso">
    222. 

  222.   <h3 class="title">参见</h3>
    223. 

  223.   <p class="para">
    224. 

  224.    <ul class="simplelist">
    225. 

  225.     <li class="member"> <span class="function"><a href="function.array-merge-recursive.html" class="function" rel="rdfs-seeAlso">array_merge_recursive()</a> - 递归地合并一个或多个数组</span></li>
    226. 

  226.     <li class="member"> <span class="function"><a href="function.array-combine.html" class="function" rel="rdfs-seeAlso">array_combine()</a> - 创建一个数组，用一个数组的值作为其键名，另一个数组的值作为其值</span></li>
    227. 

  227.     <li class="member"><a href="language.operators.array.html" class="link">array operators</a></li>
    228. 

  228.    </ul>
    229. 

  229.   </p>
    230. 

  230.  </div>
    231. 

  231. 

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

  233.  <div class="prev" style="text-align: left; float: left;"><a href="function.array-merge-recursive.html">array_merge_recursive</a></div>
    234. 

  234.  <div class="next" style="text-align: right; float: right;"><a href="function.array-multisort.html">array_multisort</a></div>
    235. 

  235.  <div class="up"><a href="ref.array.html">数组 函数</a></div>
    236. 

  236.  <div class="home"><a href="index.html">PHP Manual</a></div>
    237. 

  237. </div></body></html>
    238. 

  238.