scilab/modules/core/help/ru_RU/2_control_flow/pause.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!--
   3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
   4  * Copyright (C) 2006-2008 - INRIA
   5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
   6  * Copyright (C) 2020 - Samuel GOUGEON
   7  *
   8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
   9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
  10  * This file was originally licensed under the terms of the CeCILL v2.1,
  11  * and continues to be available under such terms.
  12  * For more information, see the COPYING file which you should have received
  13  * along with this program.
  14  *
  15  -->
  16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
  17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
  18           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
  19           xml:lang="ru" xml:id="pause">
  20     <refnamediv>
  21         <refname>pause</refname>
  22         <refpurpose>
  23             временно приостанавливает выполнение и разрешает инструкции в консоли.
  24         </refpurpose>
  25     </refnamediv>
  26     <refsynopsisdiv>
  27         <title>Синтаксис</title>
  28         <synopsis>
  29             pause
  30         </synopsis>
  31     </refsynopsisdiv>
  32     <refsection>
  33         <title>Описание</title>
  34         <para>
  35             Переключение в режим <function>pause</function>. Внесение функции <function>pause</function> в
  36             код функции прерывает исполнение функции: появляется символ командной строки, который
  37             указывает уровень  <function>pause</function> (например, <literal>-1-&gt;</literal>).
  38             Пользователь затем оказывается в новом рабочем окружении, в котором доступны все переменные
  39             более низкого уровня (и, особенно, все переменные функции) и могут быть изменены вручную
  40             при необходимости.
  41         </para>
  42         <para>
  43             Чтобы продолжить выполнение, введите <literal>resume</literal>.
  44         </para>
  45         <para>
  46             Это режим прекращается командой <code>abort</code>.
  47         </para>
  48         <note>
  49             Команда <function>pause</function> чрезвычайно полезна в процессе отладки.
  50         </note>
  51     </refsection>
  52     <refsection>
  53         <title>Примеры</title>
  54         <programlisting role="example"><![CDATA[
  55 function c = foo(b)
  56     a = 42 + b
  57     disp("Благодаря инструкции pause, вы можете исследовать - имеет ли ''a'' верное значение.");
  58     disp("Значение может быть, если нужно, изменено.");
  59     pause
  60     c = a + 2
  61 endfunction
  62
  63 a = 3;
  64 foo(2)
  65      ]]></programlisting>
  66         <screen><![CDATA[
  67 --> a = 3;
  68 --> foo(2)
  69   "Благодаря инструкции pause, вы можете исследовать - имеет ли 'a' верное значение."
  70   "Значение может быть, если нужно, изменено."
  71
  72   Введите «resume» или «abort» для возврата на стандартный уровень командной строки.
  73
  74 -1-> a
  75  a  =
  76    44.
  77
  78 -1-> a = 0;
  79
  80 -1-> resume
  81  ans  =
  82    2.
  83 ]]></screen>
  84     </refsection>
  85     <refsection role="see also">
  86         <title>Смотрите также</title>
  87         <simplelist type="inline">
  88             <member>
  89                 <link linkend="debug">debug</link>
  90             </member>
  91             <member>
  92                 <link linkend="halt">halt</link>
  93             </member>
  94             <member>
  95                 <link linkend="return">return</link>
  96             </member>
  97             <member>
  98                 <link linkend="abort">abort</link>
  99             </member>
 100             <member>
 101                 <link linkend="whereami">whereami</link>
 102             </member>
 103             <member>
 104                 <link linkend="sleep">sleep</link>
 105             </member>
 106             <member>
 107                 <link linkend="quit">quit</link>
 108             </member>
 109         </simplelist>
 110     </refsection>
 111     <refsection role="history">
 112         <title>История</title>
 113         <revhistory>
 114             <revision>
 115                 <revnumber>6.0.0</revnumber>
 116                 <revdescription>
 117                     Новые значения локальных переменных, изменённые в течение паузы, теперь
 118                     учитываются при возвращении с помощью <literal>resume</literal>.
 119                 </revdescription>
 120             </revision>
 121         </revhistory>
 122     </refsection>
 123 </refentry>