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>