svn: /phpdoc/ru/trunk/reference/array/functions/ compact.xml

From: Date: Tue, 01 Feb 2011 12:09:36 +0000
Subject: svn: /phpdoc/ru/trunk/reference/array/functions/ compact.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1320@lists.php.net to get a copy of this message
shein Tue, 01 Feb 2011 12:09:36 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=307912 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/array/functions/compact.xml Modified: phpdoc/ru/trunk/reference/array/functions/compact.xml =================================================================== --- phpdoc/ru/trunk/reference/array/functions/compact.xml 2011-02-01 11:58:47 UTC (rev 307911) +++ phpdoc/ru/trunk/reference/array/functions/compact.xml 2011-02-01 12:09:36 UTC (rev 307912) @@ -1,43 +1,65 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: n/a Maintainer: sveta Status: ready --> +<!-- EN-Revision: 297028 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 --> - <refentry xml:id="function.compact" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>compact</refname> - <refpurpose> - Создать массив, содержащий названия переменных и их значения - </refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>array</type><methodname>compact</methodname> - <methodparam><type>mixed</type><parameter>varname</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <para> - <function>compact</function> принимает переменное число параметров. - Любой из параметров может быть либо строкой, содержащей название переменной - либо массивом названий переменных. Массив может содержать - вложенные массивы названий переменных; функция - <function>compact</function> обрабатывает их рекурсивно. - </para> - <para> - Для каждого из параметров, <function>compact</function> смотрит, существует - ли переменная с таким именем в текущей символьной таблице и добавляет в результирующий - массив элемент, ключ которого содержит название переменной, а значение, соответствующее - этому ключу, значение переменной. - Коротко говоря, действия этой функции противоположны действиям функции <function>extract</function>. - Она возвращает результирующий массив со всеми переменными, добавленными туда. - </para> - <para> - Если переменной, с именем, соответствующем переданной строке не существует, такая строка будет просто проигнорирована. - </para> - <para> - <example> - <title>Пример использования <function>compact</function></title> - <programlisting role="php"> +<refentry xml:id="function.compact" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>compact</refname> + <refpurpose>Создает массив, содержащий названия переменных и их значения</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>compact</methodname> + <methodparam><type>mixed</type><parameter>varname</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + Создает массив, содержащий переменные и их значения. + </para> + <para> + Для каждого из переданного параметров, <function>compact</function> ищет + переменную с указанным именем в текущей таблице символов и добавляет + их в выводимый массив так, что имя переменной становится ключом, + а содержимое переменной становится значением этого ключа. + Короче говоря, она обратна функции <function>extract</function>. + </para> + <para> + Любые неустановленные строки будут просто пропущены. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>varname</parameter></term> + <listitem> + <para> + <function>compact</function> принимает неограниченное + количество параметров. + Любой из параметров может быть либо строкой, содержащей название переменной, + либо массивом названий переменных. Массив может содержать + вложенные массивы названий переменных; функция + <function>compact</function> обрабатывает их рекурсивно. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Возвращает массив со всеми переменными, добавленными в него. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Пример использования <function>compact</function></title> + <programlisting role="php"> <![CDATA[ <?php $city = "San Francisco"; @@ -47,13 +69,12 @@ $location_vars = array("city", "state"); $result = compact("event", "nothing_here", $location_vars); +print_r($result); ?> ]]> - </programlisting> - <para> - После этого значение <varname>$result</varname> будет: - </para> - <screen role="php"> + </programlisting> + &example.outputs; + <screen role="php"> <![CDATA[ Array ( @@ -62,14 +83,32 @@ [state] => CA ) ]]> - </screen> - </example> - </para> - <para> - См. также <function>extract</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> + <title>Gotcha</title> + <para> + Так как <link linkend="language.variables.variable">переменные + переменных</link> не могут быть использованы с + <link linkend="language.variables.superglobals">суперглобальными + массивами</link> внутри функций, суперглобальные массивы не могут + быть переданы в <function>compact</function>. + </para> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>extract</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -82,7 +121,7 @@ sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../~/.phpdoc/manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil

« previous php.doc.ru (#1320) next »