* Bug 10078 fixed: isinf(polynomials) was not reliable
[scilab.git] / scilab / modules / elementary_functions / help / fr_FR / floating_point / isinf.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) 2008 - INRIA
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2016 - 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:ns5="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="isinf" xml:lang="fr">
20     <refnamediv>
21         <refname>isinf</refname>
22         <refpurpose>teste la présence de valeurs infinies</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Syntaxe</title>
26         <synopsis>r = isinf(x)</synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Paramètres</title>
30         <variablelist>
31             <varlistentry>
32                 <term>x</term>
33                 <listitem>
34                     <para>
35                         matrice de nombres décimaux ou complexes, ou de polynômes à coefficients
36                         réels ou complexes.
37                     </para>
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>r</term>
42                 <listitem>
43                     <para>
44                         matrice de booléens, de même taille que <varname>x</varname>
45                     </para>
46                 </listitem>
47             </varlistentry>
48         </variablelist>
49     </refsection>
50     <refsection>
51         <title>Description</title>
52         <para>
53             Pour <literal>isinf(x)</literal> renvoie une matrice <literal>r</literal> dont chaque
54             élément <literal>r(i)</literal> vaut <literal>%T</literal> (vrai) si et seulement si
55             <literal>x(i)</literal> est infini.
56         </para>
57         <para>
58             Pour <literal>x</literal> complexe, <literal>x(i)</literal> est considéré infini
59             dés que sa partie réelle ou complexe ou les deux sont infinies.
60         </para>
61     </refsection>
62     <refsection>
63         <title>Exemples</title>
64         <programlisting role="example"><![CDATA[
65 [i, inf, nan] = (%i, %inf, %nan);
66 isinf([-1  0.01 -inf  inf  nan])
67 isinf([2+i, -10-inf, inf+i])
68 isinf([nan-i, nan+i*inf])
69 isinf(inf-nan*i)
70  ]]></programlisting>
71         <screen><![CDATA[
72 --> isinf([-1  0.01 -inf  inf  nan])
73  ans  =
74   F F T T F
75
76 --> isinf([2+i, -10-inf, inf+i])
77  ans  =
78   F T T
79
80 --> isinf([nan-i, nan+i*inf])
81  ans  =
82   F T
83
84 --> isinf(inf-nan*i)
85  ans  =
86   F
87 ]]></screen>
88         Note : <literal>%inf-%nan*%i</literal> est évalué comme
89         <literal>%inf - %nan*complex(0,1) == %inf - complex(%nan*0, %nan*1) == %inf - complex(%nan, %nan)
90             == complex(%inf-%nan, -%nan) == complex(%nan, %nan)
91         </literal>
92         ,où Inf est effacé par Nan et
93         n'apparait plus.
94         <para/>
95         <para>
96             Avec des polynômes :
97         </para>
98         <programlisting role="example"><![CDATA[
99 p = poly([%nan -2 0 3],"x","coeff")
100 q = poly([0 %inf %i],"x","coeff")
101 r = poly([%nan %inf*%i 1],"x","coeff")
102 isinf([p q r])
103  ]]></programlisting>
104         <screen><![CDATA[
105 --> p = poly([%nan -2 0 3],"x","coeff")
106  p  =
107
108   Nan -2x +3x³
109
110 --> q = poly([0 %inf %i],"x","coeff")
111  q  =
112
113   Infx +ix²
114
115 --> r = poly([%nan %inf*%i 1],"x","coeff")
116  r  =
117
118   Nan -(Nan-Infi)x +x²
119
120 --> isinf([p q r])
121  ans  =
122
123   F T F
124 ]]></screen>
125     </refsection>
126     <refsection role="see also">
127         <title>Voir aussi</title>
128         <simplelist type="inline">
129             <member>
130                 <link linkend="percentinf">percentinf</link>
131             </member>
132             <member>
133                 <link linkend="isnan">isnan</link>
134             </member>
135             <member>
136                 <link linkend="isreal">isreal</link>
137             </member>
138             <member>
139                 <link linkend="isnum">isnum</link>
140             </member>
141             <member>
142                 <link linkend="type">type</link>
143             </member>
144         </simplelist>
145         <refsection role="history">
146             <title>Historique</title>
147             <revhistory>
148                 <revision>
149                     <revnumber>6.1.0</revnumber>
150                     <revdescription>
151                         Extension aux polynômes.
152                     </revdescription>
153                 </revision>
154             </revhistory>
155         </refsection>
156     </refsection>
157 </refentry>