Просмотр файла manual-ru/api.append.html

Конкурс дизайнеров на 15000 рублей
Скрипты | CMS | Боты
Размер файла: 4.96Kb 
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  4. <title>append()</title>
  5. <meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
  6. <link rel="home" href="index.html" title="Руководство по Smarty">
  7. <link rel="up" href="api.functions.html" title="Chapter 13. Методы класса Smarty">
  8. <link rel="prev" href="api.functions.html" title="Chapter 13. Методы класса Smarty">
  9. <link rel="next" href="api.append.by.ref.html" title="append_by_ref()">
  10. </head>
  11. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  12. <div class="navheader">
  13. <table width="100%" summary="Navigation header">
  14. <tr><th colspan="3" align="center">append()</th></tr>
  15. <tr>
  16. <td width="20%" align="left">
  17. <a accesskey="p" href="api.functions.html">Prev</a> </td>
  18. <th width="60%" align="center">Chapter 13. Методы класса Smarty</th>
  19. <td width="20%" align="right"> <a accesskey="n" href="api.append.by.ref.html">Next</a>
  20. </td>
  21. </tr>
  22. </table>
  23. <hr>
  24. </div>
  25. <div class="refentry" title="append()">
  26. <a name="api.append"></a><div class="titlepage"></div>
  27. <div class="refnamediv">
  28. <h2>Name</h2>
  29. <p>append() — добавляет элемент к назначенному массиву</p>
  30. </div>
  31. <div class="refsect1" title="Описание">
  32. <a name="id2715616"></a><h2>Описание</h2>
  33. <code class="methodsynopsis"><span class="type">void </span><span class="methodname">append</span>(<span class="methodparam"><span class="type">mixed </span><span class="parameter">var</span></span>);</code><br><code class="methodsynopsis"><span class="type">void </span><span class="methodname">append</span>(<span class="methodparam"><span class="type">string </span><span class="parameter">varname</span></span>,<br>            <span class="methodparam"><span class="type">mixed </span><span class="parameter">var</span></span>,<br>            <span class="methodparam"><span class="type">bool </span><span class="parameter">merge</span></span>);</code><p>
  34.    Если вы добавляете значение к строковому значению, последнее будет
  35.    предварительно преобразовано в массив. Вы можете явно передавать пары
  36.    ключей / значений, либо ассоциативный массив, содержащий пары
  37.    ключей / значений.
  38.    Если вы укажете необязательный третий аргумент, равный true, значение будет
  39.    совмещено с существующим массивом, вместо добавления.
  40.   </p>
  41. <div class="note" title="Техническое замечание" style="margin-left: 0.5in; margin-right: 0.5in;">
  42. <h3 class="title">Техническое замечание</h3>
  43. <p>
  44.   Пераметр <em class="parameter"><code>merge</code></em> учитывает ключи массива,
  45.   поэтому если вы объединяете массивы с числовыми индексами, то они могут
  46.   наложиться друг на друга или привести к непоследовательному порядку ключей.
  47.   Результат отличается от действия функции PHP
  48.   <a class="ulink" href="http://php.net/array_merge" target="_top"><code class="varname">array_merge()</code></a>,
  49.   которая заново нумерует элементы в массиве с числовоми ключами.
  50.  </p>
  51. </div>
  52. <div class="example">
  53. <a name="id2716296"></a><p class="title"><b>Example 13.1. append</b></p>
  54. <div class="example-contents"><pre class="programlisting">
  55.  
  56. &lt;?php
  57. // передаем пары ключ / значение
  58. $smarty-&gt;append("Name", "Fred");
  59. $smarty-&gt;append("Address", $address);
  60.  
  61. // передаем ассоциативный массив
  62. $smarty-&gt;append(array('city' =&gt; 'Lincoln', 'state' =&gt; 'Nebraska'));
  63. ?&gt;
  64.  
  65.    </pre></div>
  66. </div>
  67. <br class="example-break"><p>См. также
  68.   <a class="link" href="api.append.by.ref.html" title="append_by_ref()">append_by_ref()</a>,
  69.   <a class="link" href="api.assign.html" title="assign()">assign()</a>
  70.   и
  71.   <a class="link" href="api.get.template.vars.html" title="get_template_vars">get_template_vars()</a>
  72.   </p>
  73. </div>
  74. </div>
  75. <div class="navfooter">
  76. <hr>
  77. <table width="100%" summary="Navigation footer">
  78. <tr>
  79. <td width="40%" align="left">
  80. <a accesskey="p" href="api.functions.html">Prev</a> </td>
  81. <td width="20%" align="center"><a accesskey="u" href="api.functions.html">Up</a></td>
  82. <td width="40%" align="right"> <a accesskey="n" href="api.append.by.ref.html">Next</a>
  83. </td>
  84. </tr>
  85. <tr>
  86. <td width="40%" align="left" valign="top">Chapter 13. Методы класса Smarty </td>
  87. <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
  88. <td width="40%" align="right" valign="top"> append_by_ref()</td>
  89. </tr>
  90. </table>
  91. </div>
  92. </body>
  93. </html>