scilab/modules/core/help/ru_RU/control_flow/select.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <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="select">
   3     <refnamediv>
   4         <refname>select</refname>
   5         <refpurpose>ключевое слово выбора</refpurpose>
   6     </refnamediv>
   7     <refsynopsisdiv>
   8         <title>Последовательность вызова</title>
   9         <synopsis>
  10             select variable
  11             case value1 then
  12             instructions 1
  13             case value2 then
  14             instructions 2
  15             ...
  16             case valuen then
  17             instructions n
  18             [else instructions]
  19             end
  20         </synopsis>
  21     </refsynopsisdiv>
  22     <refsection>
  23         <title>Аргументы</title>
  24         <variablelist>
  25             <varlistentry>
  26                 <term>variable</term>
  27                 <listitem>
  28                     <para>
  29                         переменная, значение которой анализируется.
  30                     </para>
  31                 </listitem>
  32             </varlistentry>
  33             <varlistentry>
  34                 <term>value1, ..., valuen</term>
  35                 <listitem>
  36                     <para>
  37                         значения переменной <literal>variable</literal> для которых предусмотрен соответствующий набор
  38                         инструкций  <literal>instructions 1, ..., instructions n</literal>.
  39                     </para>
  40                 </listitem>
  41             </varlistentry>
  42             <varlistentry>
  43                 <term>instructions</term>
  44                 <listitem>
  45                     <para>
  46                         набор корректных инструкций.
  47                     </para>
  48                 </listitem>
  49             </varlistentry>
  50         </variablelist>
  51     </refsection>
  52     <refsection>
  53         <title>Описание</title>
  54         <para>
  55             Управляющая инструкция выбора действий по значению переменной <literal>variable</literal>.
  56         </para>
  57         <para>
  58             Примечания:
  59         </para>
  60         <itemizedlist>
  61             <listitem>
  62                 <para>
  63                     Единственное ограничение в том, что каждое ключевое слово <literal>"then"</literal> должно быть на
  64                     той же строке, что и соответствующее ключевое слово <literal>"case"</literal> (либо используйте
  65                     обозначение продолжения, см <link linkend="dot">точка</link>).
  66                 </para>
  67             </listitem>
  68             <listitem>
  69                 <para>
  70                     Ключевое слово <literal>"then"</literal> можно заменить на перевод каретки или запятую.
  71                     Инструкции <literal>instructions1</literal> исполняются, если <literal>expr1=expr</literal>,
  72                     и т. д.
  73                 </para>
  74             </listitem>
  75         </itemizedlist>
  76         <para>
  77             В соответствии с договорённостями по написанию кода  в Scilab рекомендуется:
  78         </para>
  79         <itemizedlist>
  80             <listitem>
  81                 <para>
  82                     начинать новую инструкцию на новой строке;
  83                 </para>
  84             </listitem>
  85             <listitem>
  86                 <para>
  87                     писать не более одной простой инструкции на одной строке;
  88                 </para>
  89             </listitem>
  90             <listitem>
  91                 <para>
  92                     разбивать составные инструкции на множество строк.
  93                 </para>
  94             </listitem>
  95         </itemizedlist>
  96         <para>
  97             Например, используйте:
  98         </para>
  99         <programlisting role=""><![CDATA[
 100 A = 2
 101 select A
 102 case 1 then
 103     disp(1)
 104 case 2 then
 105     disp(2)
 106 else
 107     disp(3)
 108 end
 109 ]]></programlisting>
 110         <para>
 111             а не:
 112         </para>
 113         <programlisting role=""><![CDATA[
 114 A = 2;select A case 1 then disp(1); case 2 then disp(2); else  disp(3); end
 115 ]]></programlisting>
 116         <para>
 117             Предупреждение: число символов, используемых для определения тела любой инструкции условия
 118             (<literal>if while for</literal> или <literal>select/case</literal>) должно быть ограничено
 119             16К.
 120         </para>
 121     </refsection>
 122     <refsection>
 123         <title>Примеры</title>
 124         <programlisting role="example"><![CDATA[
 125 while %t do
 126   n=round(10*rand(1,1))
 127   select n
 128   case 0 then
 129     disp(0)
 130   case 1 then
 131     disp(1)
 132   else
 133     break
 134   end
 135 end
 136  ]]></programlisting>
 137     </refsection>
 138     <refsection role="see also">
 139         <title>Смотрите также</title>
 140         <simplelist type="inline">
 141             <member>
 142                 <link linkend="if">if</link>
 143             </member>
 144             <member>
 145                 <link linkend="while">while</link>
 146             </member>
 147             <member>
 148                 <link linkend="for">for</link>
 149             </member>
 150         </simplelist>
 151     </refsection>
 152 </refentry>