Translation of help pages for tree2code, varargin and varargout into Russian. 68/14068/1
Stanislav KROTER [Tue, 18 Mar 2014 15:29:16 +0000 (21:29 +0600)]
Change-Id: Ibf13180cdf73ae72df63638d987c86d3d449a5db

scilab/modules/functions/help/ru_RU/tree2code.xml [new file with mode: 0644]
scilab/modules/functions/help/ru_RU/varargin.xml [new file with mode: 0644]
scilab/modules/functions/help/ru_RU/varargout.xml [new file with mode: 0644]

diff --git a/scilab/modules/functions/help/ru_RU/tree2code.xml b/scilab/modules/functions/help/ru_RU/tree2code.xml
new file mode 100644 (file)
index 0000000..e90784e
--- /dev/null
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) INRIA -
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="tree2code">
+    <refnamediv>
+        <refname>tree2code</refname>
+        <refpurpose>
+            формирует ASCII-определение Scilab-функции
+        </refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Последовательность вызова</title>
+        <synopsis>txt = tree2code(tree, prettyprint)</synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>tree</term>
+                <listitem>
+                    <para>
+                        дерево функции (полученное с помощью <function>macr2tree</function>).
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>prettyprint</term>
+                <listitem>
+                    <para>необязательное логическое значение:</para>
+                    <variablelist>
+                        <varlistentry>
+                            <term>%T</term>
+                            <listitem>
+                                <para>
+                                    генерирует код, который имеет отступы и красивый вид;
+                                </para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>%F</term>
+                            <listitem>
+                                <para>
+                                    генерируемый код не приукрашен (по умолчанию).
+                                </para>
+                            </listitem>
+                        </varlistentry>
+                    </variablelist>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>txt</term>
+                <listitem>
+                    <para>
+                        вектор-столбец строк, текст, предоставляющий Scilab-инструкции.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            Задавая "дерево" загруженной в Scilab функции (полученное с
+            помощью функции <function>macr2tree</function>),
+            <function>tree2code</function> позволяет восстановить код.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+tree=macr2tree(cosh);
+txt=tree2code(tree,%T);
+write(%io(2),txt,'(a)');
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="macr2tree">macr2tree</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>
diff --git a/scilab/modules/functions/help/ru_RU/varargin.xml b/scilab/modules/functions/help/ru_RU/varargin.xml
new file mode 100644 (file)
index 0000000..e802b5e
--- /dev/null
@@ -0,0 +1,111 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) ????-2008 - INRIA
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="varargin" xml:lang="ru">
+    <refnamediv>
+        <refname>varargin</refname>
+        <refpurpose>
+            переменное число аргументов в списке входных аргументов
+        </refpurpose>
+    </refnamediv>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            Функция, чьим последним входным аргументом является
+            <literal>varargin</literal>, может быть вызвана с
+            бОльшим числом входных аргументов, чем указано в списке
+            входных аргументов. Аргументы вызова, переданные внутрь в форме ключевого слова <literal>varargin</literal> затем могут быть получены внутри функции в
+            списке с именем <literal>varargin</literal>.
+        </para>
+        <para>
+            Допустим, что ключевое слово <literal>varargin</literal>
+            является <literal>n</literal>-ным аргументом в списке
+            формальных входных аргументов, тогда, если функция
+            вызывается с меньшим числом, чем <literal>n-1</literal>,
+            входных аргументов, то список
+            <literal>varargin</literal> не будет определён. Если же
+            функция вызывается с <literal>n-1</literal> аргументами,
+            то список <literal>varargin</literal> будет пустым
+            списком.
+        </para>
+        <para>
+            <literal>function y = ex(varargin)</literal> может быть
+            вызвана с любым числом аргументов. Внутри функции
+            <literal>ex</literal> входные аргументы могут быть
+            получены в <literal>varargin(i)</literal>,
+            <literal>i=1:length(varargin)</literal>.
+        </para>
+        <para>
+            Если же это не последний аргумент функции, то
+            <literal>varargin</literal> будет обычным именем
+            входного аргумента без особого значения.
+        </para>
+        <para>
+            Общее число фактических входных аргументов даётся с
+            помощью <code>argn(2)</code>.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примечание</title>
+        <para>
+            Синтаксис именованных аргументов, такой как <literal>foo(...,key=value)</literal>, не совместим с использованием <literal>varargin</literal>. Причина в том, что имена (то есть ключи), связанные со значениями, не хранятся в списке <literal>varargin</literal>. Рассмотрим пример:
+        </para>
+        <programlisting role="no-scilab-exec"><![CDATA[
+function foo(varargin)
+    disp([varargin(1),varargin(2)])
+endfunction
+        ]]></programlisting>
+        <screen>
+            -->foo(a=1,b=2)
+            1.    2.
+            -->foo(b=1,a=2)
+            1.    2.
+        </screen>
+        <para>
+            Результат одинаковый, но аргументы были переставлены.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+function exampl(a,varargin)
+    [lhs,rhs]=argn(0)
+    if rhs>=1 then
+        disp(varargin)
+    end
+endfunction
+
+exampl(1)
+exampl()
+exampl(1,2,3)
+l=list('a',%s,%t);
+exampl(1,l(2:3))
+]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="argn">argn</link>
+            </member>
+            <member>
+                <link linkend="function">function</link>
+            </member>
+            <member>
+                <link linkend="list">list</link>
+            </member>
+            <member>
+                <link linkend="varargout">varargout</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>
diff --git a/scilab/modules/functions/help/ru_RU/varargout.xml b/scilab/modules/functions/help/ru_RU/varargout.xml
new file mode 100644 (file)
index 0000000..30132b0
--- /dev/null
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) ????-2008 - INRIA
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="varargout" xml:lang="ru">
+    <refnamediv>
+        <refname>varargout</refname>
+        <refpurpose>
+            переменное число аргументов в списке выходных аргументов
+        </refpurpose>
+    </refnamediv>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            Функция, чей список выходных аргументов содержит <literal>varargout</literal> должен вызываться с бОльшим числом аргументов, чем указано в списке выходных аргументов. Аргументы вызова, переданные внутрь в форме ключевого слова <literal>varargout</literal>, извлекаются из списка <literal>varargout</literal>, определённого внутри функции.
+        </para>
+        <para>
+            <literal>varargout = function ex()</literal> может вызываться с любым количеством выходных аргументов. Внутри функции <literal>ex</literal> выходные аргументы могут храниться в <literal>varargout(i)</literal>.
+        </para>
+        <para>
+            Может также использоваться <literal>[X1,...,Xn,varargout] = function ex()</literal>. В этом случае переменные <literal>Xi</literal> и <literal>varargout(i)</literal> должны быть определены в функции.
+        </para>
+        <para>
+            Фактическое общее количество выходных аргументов даётся с помощью <code>argn(1)</code>.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примечание</title>
+        <para>
+            Переменная <literal>varargout</literal> должна быть создана внутри функции и определена в виде <link linkend="list">списка</link>. Если <literal>varargout</literal> является единственной формальной выходной переменой, то список должен содержать хотя бы один элемент.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+function varargout=exampl()
+  varargout=list(1,2,3,4)
+endfunction
+
+x=exampl()
+[x,y]=exampl()
+[x,y,z]=exampl()
+
+function [a,b,varargout]=exampl1()
+  a='first'
+  b='second'
+  varargout=list(1,2,3,4)
+endfunction
+
+exampl1()
+[a,b]=exampl1()
+[a,b,c]=exampl1()
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="argn">argn</link>
+            </member>
+            <member>
+                <link linkend="function">function</link>
+            </member>
+            <member>
+                <link linkend="list">list</link>
+            </member>
+            <member>
+                <link linkend="varargin">varargin</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>