* Bug 15934 fixed [doc]: ^rectangular yields an error
[scilab.git] / scilab / modules / core / help / pt_BR / 1_keywords / hat.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  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
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="hat" xml:lang="pt">
20     <refnamediv>
21         <refname>hat</refname>
22         <refpurpose>(^) exponentiation</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Seqüência de Chamamento</title>
26         <synopsis>A^b</synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Descrição</title>
30         <para>Exponenciação de matrizes ou vetores por um vetor constante.</para>
31         <para>
32             Se <literal>A</literal> é um vetor, a
33             exponenciação é feita elemento a elemento no sentido usual.
34         </para>
35         <para>Para matrizes quadradas, a exponenciação é feita no sentido
36             matricial.
37         </para>
38         <para>Para matrizes de booleanos, polinômios ou razões de polinômios, o
39             expoente deve ser um inteiro
40         </para>
41         <refsection>
42             <title>Observações</title>
43             <para>
44                 <literal>123.^b</literal> é interpretado como<literal>
45                     (123).^b
46                 </literal>
47                 .Em tais casos, o ponto é parte do operador, não do
48                 número.
49             </para>
50             <para>
51                 Para dois números reais ou complexos <literal>x1</literal> e
52                 <literal>x2</literal> , o valor de <literal>x1^x2</literal> é o "valor
53                 principal" determinado por <literal>x1^x2 =
54                     exp(x2*log(x1))
55                 </literal>
56                 .
57             </para>
58         </refsection>
59     </refsection>
60     <refsection>
61         <title>Exemplos</title>
62         <programlisting role="example"><![CDATA[
63 2^4
64 (-0.5)^(1/3)
65 [1 2;2 4]^(1+%i)
66 s=poly(0,"s");
67 [1 2 s]^4
68 [s 1;1  s]^(-1)
69  ]]></programlisting>
70     </refsection>
71     <refsection>
72         <title> Ver Também </title>
73         <simplelist type="inline">
74             <member>
75                 <link linkend="power">power</link>
76             </member>
77             <member>
78                 <link linkend="exp">exp</link>
79             </member>
80             <member>
81                 <link linkend="log">log</link>
82             </member>
83             <member>
84                 <link linkend="log2">log2</link>
85             </member>
86             <member>
87                 <link linkend="inv">inv</link>
88             </member>
89         </simplelist>
90     </refsection>
91 </refentry>