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

Конкурс дизайнеров на 15000 рублей
Милый пушистый сайт !!!!
Размер файла: 4.91Kb 
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  4. <title>append_by_ref()</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.append.html" title="append()">
  9. <link rel="next" href="api.assign.html" title="assign()">
  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_by_ref()</th></tr>
  15. <tr>
  16. <td width="20%" align="left">
  17. <a accesskey="p" href="api.append.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.assign.html">Next</a>
  20. </td>
  21. </tr>
  22. </table>
  23. <hr>
  24. </div>
  25. <div class="refentry" title="append_by_ref()">
  26. <a name="api.append.by.ref"></a><div class="titlepage"></div>
  27. <div class="refnamediv">
  28. <h2>Name</h2>
  29. <p>append_by_ref() — добавляет значение по ссылке</p>
  30. </div>
  31. <div class="refsect1" title="Описание">
  32. <a name="id2715748"></a><h2>Описание</h2>
  33. <code class="methodsynopsis"><span class="type">void </span><span class="methodname">append_by_ref</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.    Используется для <a class="link" href="api.append.html" title="append()">добавления</a> значений
  35.    в шаблон по ссылке. Если вы добавляете значение переменной по ссылке и это
  36.    значение изменяется в шаблоне, эти изменения будут отражены в начальной
  37.    переменной. Для <a class="link" href="advanced.features.html#advanced.features.objects" title="Объекты">объектов</a>,
  38.    append_by_ref() также позволяет избежать внутреннего копирования добавляемого
  39.    объекта.
  40.    См. руководство PHP для более подробного описания работы передачи переменных
  41.    по ссылкам.
  42.    Если вы укажете необязательный третий аргумент, равный true, значение будет
  43.    совмещено с существующим массивом, вместо добавления.
  44.   </p>
  45. <div class="note" title="Техническое замечание" style="margin-left: 0.5in; margin-right: 0.5in;">
  46. <h3 class="title">Техническое замечание</h3>
  47. <p>
  48.   Пераметр <em class="parameter"><code>merge</code></em> учитывает ключи массива,
  49.   поэтому если вы объединяете массивы с числовыми индексами, то они могут
  50.   наложиться друг на друга или привести к непоследовательному порядку ключей.
  51.   Результат отличается от действия функции PHP
  52.   <a class="ulink" href="http://php.net/array_merge" target="_top"><code class="varname">array_merge()</code></a>,
  53.   которая заново нумерует элементы в массиве с числовоми ключами.
  54.  </p>
  55. </div>
  56. <div class="example">
  57. <a name="id2716753"></a><p class="title"><b>Example 13.2. append_by_ref</b></p>
  58. <div class="example-contents"><pre class="programlisting">
  59.  
  60. &lt;?php
  61. // добавление пар ключ / значение
  62. $smarty-&gt;append_by_ref('Name', $myname);
  63. $smarty-&gt;append_by_ref('Address', $address);
  64. ?&gt;
  65.  
  66.    </pre></div>
  67. </div>
  68. <br class="example-break"><p>
  69.    См. также
  70.    <a class="link" href="api.append.html" title="append()">append()</a>
  71.    и
  72.    <a class="link" href="api.assign.html" title="assign()">assign()</a>.
  73.   </p>
  74. </div>
  75. </div>
  76. <div class="navfooter">
  77. <hr>
  78. <table width="100%" summary="Navigation footer">
  79. <tr>
  80. <td width="40%" align="left">
  81. <a accesskey="p" href="api.append.html">Prev</a> </td>
  82. <td width="20%" align="center"><a accesskey="u" href="api.functions.html">Up</a></td>
  83. <td width="40%" align="right"> <a accesskey="n" href="api.assign.html">Next</a>
  84. </td>
  85. </tr>
  86. <tr>
  87. <td width="40%" align="left" valign="top">append() </td>
  88. <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
  89. <td width="40%" align="right" valign="top"> assign()</td>
  90. </tr>
  91. </table>
  92. </div>
  93. </body>
  94. </html>