svn: /phpdoc/ru/trunk/reference/array/functions/ compact.xml
| From: | Shein Alexey | 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