Files
smarty/docs/ru/programmers/api-functions/api-append-by-ref.xml
2008-05-25 15:06:11 +00:00

71 lines
2.6 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0 Maintainer: freespace Status: ready -->
<refentry id="api.append.by.ref">
<refnamediv>
<refname>append_by_ref()</refname>
<refpurpose>добавляет значение по ссылке</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
<methodsynopsis>
<type>void</type><methodname>append_by_ref</methodname>
<methodparam><type>string</type><parameter>varname</parameter></methodparam>
<methodparam><type>mixed</type><parameter>var</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>merge</parameter></methodparam>
</methodsynopsis>
<para>
Используется для <link linkend="api.append">добавления</link> значений
в шаблон по ссылке. Если вы добавляете значение переменной по ссылке и это
значение изменяется в шаблоне, эти изменения будут отражены в начальной
переменной. Для <link linkend="advanced.features.objects">объектов</link>,
append_by_ref() также позволяет избежать внутреннего копирования добавляемого
объекта.
См. руководство PHP для более подробного описания работы передачи переменных
по ссылкам.
Если вы укажете необязательный третий аргумент, равный true, значение будет
совмещено с существующим массивом, вместо добавления.
</para>
&note.parameter.merge;
<example>
<title>append_by_ref</title>
<programlisting role="php">
<![CDATA[
<?php
// добавление пар ключ / значение
$smarty->append_by_ref('Name', $myname);
$smarty->append_by_ref('Address', $address);
?>
]]>
</programlisting>
</example>
<para>
См. также
<link linkend="api.append">append()</link>
и
<link linkend="api.assign">assign()</link>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->