<?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="warning">
    <refnamediv>
        <refname>warning</refname>
        <refpurpose>предупреждающие сообщения</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Синтаксис</title>
        <synopsis>
            warning('string')
            warning(string_matrix)
            warning('off')
            warning('on')
            warning('stop')
            mode = warning('query')
        </synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Описание</title>
        <para>
            <literal>warning('string')</literal> печатает символьную строку
            <literal>'string'</literal> в предупреждающем сообщении.
        </para>
        <para>
            <literal>warning(string_matrix)</literal> печатает каждый элемент матрицы
            <literal>string_matrix</literal> в предупреждающем сообщении.
        </para>
        <para>
            <literal>'on'</literal> - включение предупреждающих сообщений.
        </para>
        <para>
            <literal>'off'</literal> - отключение предупреждающих сообщений.
        </para>
        <para>
            <literal>'stop'</literal> включает предупреждающие сообщения и останавливает исполнение,
            когда возникает предупреждение.
        </para>
        <para>
            <literal>'query'</literal> - получение состояния: <literal>'on'</literal> или
            <literal>'off'</literal>.
        </para>
        <para>
            <literal>warning("on")</literal>, <literal>warning("off")</literal> и
            <literal>warning("stop")</literal> также влияют на предупреждения о проблемах в жёстко
             запрограммированных функциях.
        </para>
    </refsection>
    <refsection>
        <title>Примеры</title>
        <programlisting role="example"><![CDATA[
warning_prev = warning("query"); // запомним исходный сататус предупреждений

warning('on')
warning('это - предупреждение')
warning('off')
warning('это - предупреждение')
warning('query')
warning('on')
// Пример с локализованным сообщением
warning(msprintf(gettext("%s: Wrong number of input argument: %d expected.\n"),"myFunction",2));

// Установка остановки на предупреждении
warning("stop")

try
    warning("это предупреждение");
catch
    lasterror() // Предупреждающее сообщение считается ошибкой
end

warning(warning_prev); // восстановление исходного статуса предупреждений
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>Смотрите также</title>
        <simplelist type="inline">
            <member>
                <link linkend="error">error</link>
            </member>
            <member>
                <link linkend="gettext">gettext</link>
            </member>
            <member>
                <link linkend="msprintf">msprintf</link>
            </member>
            <member>
                <link linkend="messagebox">messagebox</link>
            </member>
        </simplelist>
    </refsection>
    <refsection>
        <title>История</title>
        <revhistory>
            <revision>
                <revnumber>6.0</revnumber>
                <revremark>
                    Добавлена опция <literal>"stop"</literal>.
                </revremark>
            </revision>
        </revhistory>
    </refsection>
</refentry>
