<?xml version="1.0" encoding="UTF-8"?>
<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="pause">
    <refnamediv>
        <refname>pause</refname>
        <refpurpose>режим паузы, вызов клавиатуры</refpurpose>
    </refnamediv>
    <refsection>
        <title>Описание</title>
        <para>
            Переключение в режим <code>pause</code>. Внесение функции <code>pause</code> в
            код функции прерывает исполнение функции: появляется символ командной строки, который
            указывает уровень  <code>pause</code> (например, <literal>-1-&gt;</literal>).
            Пользователь затем оказывается в новом рабочем окружении, в котором доступны все переменные
            более низкого уровня (и, особенно, все переменные функции). Чтобы вернуться в вызывающее
            рабочее окружение, введите команду <code>return</code>.
        </para>
        <para>
            В этом режиме<literal>[...]=return(...)</literal> возвращает переменные аргумента
            <literal>(...)</literal> в вызывающее рабочее окружение с именами на выходе <literal>
                [...]
            </literal>
            .
            Таким образом, переменные более низкого уровня защищены и не могут быть
            изменены.
        </para>
        <para>
            Команда <code>pause</code> чрезвычайно полезна в процессе отладки.
        </para>
        <para>
            Это режим прекращается командой <code>abort</code>.
        </para>
    </refsection>
    <refsection>
        <title>Examples</title>
        <programlisting role="example"><![CDATA[
    function c=foo(b)
    a=42+b
    disp("Благодаря инструкции pause, вы можете исследовать - имеет ли ''a'' верное значение");
    disp("Значение может быть, если нужно, изменено.");
    pause
    c=a+2
    endfunction

    foo(2)
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>Смотрите также</title>
        <simplelist type="inline">
            <member>
                <link linkend="halt">halt</link>
            </member>
            <member>
                <link linkend="return">return</link>
            </member>
            <member>
                <link linkend="abort">abort</link>
            </member>
            <member>
                <link linkend="quit">quit</link>
            </member>
            <member>
                <link linkend="whereami">whereami</link>
            </member>
            <member>
                <link linkend="where">where</link>
            </member>
            <member>
                <link linkend="sleep">sleep</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
