* Bug 16148: xmlSetValues() <= setPreferencesValue()
[scilab.git] / scilab / modules / elementary_functions / help / ru_RU / floating_point / ieee.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) INRIA
5  * Copyright (C) 2017 - Samuel GOUGEON
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
19           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
20           xmlns:scilab="http://www.scilab.org" xml:id="ieee" xml:lang="ru">
21     <refnamediv>
22         <refname>ieee</refname>
23         <refpurpose>установка режима исключения с плавающей запятой</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>Синтаксис</title>
27         <synopsis>
28             mod = ieee()
29             ieee(mod)
30         </synopsis>
31     </refsynopsisdiv>
32     <refsection>
33         <title>Аргументы</title>
34         <variablelist>
35             <varlistentry>
36                 <term>mod</term>
37                 <listitem>
38                     <para>целочисленный скаляр, чьим возможным значением может быть 0, 1 или 2</para>
39                 </listitem>
40             </varlistentry>
41         </variablelist>
42     </refsection>
43     <refsection>
44         <title>Описание</title>
45         <para>
46             <literal>ieee()</literal> возвращает текущий режим исключения с плавающей запятой.
47         <variablelist>
48             <varlistentry>
49                 <term>0</term>
50                 <listitem>
51                     <para>исключение с плавающей запятой формирует ошибку</para>
52                     <para>
53                        специальные значения <constant>%inf</constant> и <constant>%nan</constant> 
54                        могут использоваться в этом режиме без ошибок. Например, <code>%inf/%inf</code>,
55                        <code>%inf-%inf</code> или <code>%inf/%nan</code> являются известными операциями.
56                     </para>
57                 </listitem>
58             </varlistentry>
59             <varlistentry>
60                 <term>1</term>
61                 <listitem>
62                     >исключение с плавающей запятой формирует предупреждение.
63                 </listitem>
64             </varlistentry>
65             <varlistentry>
66                 <term>2</term>
67                 <listitem>
68                     исключение с плавающей запятой формирует значение <constant>%inf</constant> или <constant>%nan</constant>.
69                 </listitem>
70             </varlistentry>
71         </variablelist>
72         </para>
73         <para>
74             <code>ieee(mod)</code> устанавливает текущий режим исключения с плавающей запятой в режим
75             <varname>mod</varname>.
76         </para>
77         <note>
78             По умолчанию исходный режим 2. Это значение по умолчанию можно установить любым из следующих способов:
79             <itemizedlist>
80                 <listitem>
81                   Через графический интерфейс настроек: <code>preferences</code>, в разделе
82                   <emphasis role="italic">Общие => Рабочая среда => ieee</emphasis>.
83                 </listitem>
84                 <listitem>
85                   Аналогично, используя <code>xmlSetValues</code> следующим образом
86                   (чтобы установить режим в 1) :
87                   <para>
88                   <literal>xmlSetValues("//general/body/environment", ["fpe";"1"])</literal>
89                   </para>
90                 </listitem>
91                 <listitem>
92                     Или используя <literal>ieee(mod)</literal> в вашем файле запуска.
93                 </listitem>
94             </itemizedlist>
95         </note>
96         <warning>
97             Исключение с плавающей запятой, возникающее внутри некоторых библиотечных алгоритмов,
98             пока ещё не обрабатывается режимами <literal>ieee</literal>.
99         </warning>
100     </refsection>
101     <refsection>
102         <title>Примеры</title>
103         <programlisting role="example"><![CDATA[
104 ieee(1); 1/0
105 ieee(2); 1/0, log(0)
106  ]]></programlisting>
107     </refsection>
108     <refsection role="see also">
109         <title>Смотрите также</title>
110         <simplelist type="inline">
111             <member>
112                 <link linkend="percentnan">%nan</link>
113             </member>
114             <member>
115                 <link linkend="percentinf">%inf</link>
116             </member>
117             <member>
118                 <link linkend="isinf">isinf</link>
119             </member>
120             <member>
121                 <link linkend="isnan">isnan</link>
122             </member>
123             <member>
124                 <link linkend="number_properties">number_properties</link>
125             </member>
126         </simplelist>
127     </refsection>
128     <refsection role="history">
129         <title>История</title>
130         <revhistory>
131             <revision>
132                 <revnumber>6.0.0</revnumber>
133                 <revremark>Исходное значение режима равно 2.</revremark>
134             </revision>
135         </revhistory>
136     </refsection>
137 </refentry>