* Bug 16021 fixed: tand(90) cotd(90) 1/cosd(90) were wrong
[scilab.git] / scilab / modules / elementary_functions / help / fr_FR / trigonometry / cotd.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) 2019 - 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="cotd" xml:lang="fr">
20     <refnamediv>
21         <refname>cotd</refname>
22         <refpurpose>cotangent des éléments de l'argument donné en
23             degrés.
24         </refpurpose>
25     </refnamediv>
26     <refsynopsisdiv>
27         <title>Séquence d'appel</title>
28         <synopsis>y = cotg(x)</synopsis>
29     </refsynopsisdiv>
30     <refsection>
31         <title>Paramètres</title>
32         <variablelist>
33             <varlistentry>
34                 <term>x</term>
35                 <listitem>
36                     <para>Tableau réel.</para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>y</term>
41                 <listitem>
42                     <para>Tableau réel de mêmes dimensions que
43                         <literal>x</literal>.
44                     </para>
45                 </listitem>
46             </varlistentry>
47         </variablelist>
48     </refsection>
49     <refsection>
50         <title>Description</title>
51         <para>
52             Les éléments de <literal>y</literal> sont les cotangentes
53             (<literal>y=cos(x)./sin(x)</literal>) des éléments correspondants de
54             <literal>x</literal> supposés donnés en degrés. Pour les éléments égaux à
55             <literal>n*180</literal> avec <literal>n</literal> entier le résultat et
56             infini (ou une erreur selon le mode ieee choisi) tandis que
57             <literal>cotg(n*%pi)</literal> est très grand mais fini car
58             <literal>%pi</literal> ne peut être représenté exactement. Pour les
59             éléments égaux à <literal>n*90</literal> avec <literal>n</literal> entier
60             et impair le résultat est exactement 0.
61         </para>
62     </refsection>
63     <refsection>
64         <title>Exemples</title>
65         <programlisting role="example"><![CDATA[
66 cotd([30 45 60 90])
67 cotd([-180 -90 0 90 180])
68  ]]></programlisting>
69     <screen><![CDATA[
70 --> cotd([30 45 60 90])
71  ans  =
72    1.7320508   1.   0.5773503   0.
73
74 --> cotd([-180 -90 0 90 180])
75  ans  =
76    Inf   0.   Inf   0.   Inf
77 ]]></screen>
78     </refsection>
79     <refsection role="see also">
80         <title>Voir aussi</title>
81         <simplelist type="inline">
82             <member>
83                 <link linkend="cotg">cotg</link>
84             </member>
85             <member>
86                 <link linkend="coth">coth</link>
87             </member>
88             <member>
89                 <link linkend="tan">tan</link>
90             </member>
91             <member>
92                 <link linkend="tand">tand</link>
93             </member>
94         </simplelist>
95     </refsection>
96 </refentry>