f1f74c76018e3ace1bc2c8dfff449ff5715cbb3f
[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" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="hat" xml:lang="pt">
17     <refnamediv>
18         <refname>hat</refname>
19         <refpurpose>(^) exponentiation</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Seqüência de Chamamento</title>
23         <synopsis>A^b</synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>Descrição</title>
27         <para>Exponenciação de matrizes ou vetores por um vetor constante.</para>
28         <para>
29             Se <literal>A</literal> é um vetor ou uma matriz retangular, a
30             exponenciação é feita elemento a elemento no sentido usual.
31         </para>
32         <para>Para matrizes quadradas, a exponenciação é feita no sentido
33             matricial.
34         </para>
35         <para>Para matrizes de booleanos, polinômios ou razões de polinômios, o
36             expoente deve ser um inteiro
37         </para>
38         <refsection>
39             <title>Observações</title>
40             <para>
41                 <literal>123.^b</literal> é interpretado como<literal>
42                     (123).^b
43                 </literal>
44                 .Em tais casos, o ponto é parte do operador, não do
45                 número.
46             </para>
47             <para>
48                 Para dois números reais ou complexos <literal>x1</literal> e
49                 <literal>x2</literal> , o valor de <literal>x1^x2</literal> é o "valor
50                 principal" determinado por <literal>x1^x2 =
51                     exp(x2*log(x1))
52                 </literal>
53                 .
54             </para>
55         </refsection>
56     </refsection>
57     <refsection>
58         <title>Exemplos</title>
59         <programlisting role="example"><![CDATA[
60 2^4
61 (-0.5)^(1/3)
62 [1 2;2 4]^(1+%i)
63 s=poly(0,"s");
64 [1 2 s]^4
65 [s 1;1  s]^(-1)
66  ]]></programlisting>
67     </refsection>
68     <refsection>
69         <title> Ver Também </title>
70         <simplelist type="inline">
71             <member>
72                 <link linkend="exp">exp</link>
73             </member>
74             <member>
75                 <link linkend="inv">inv</link>
76             </member>
77         </simplelist>
78     </refsection>
79 </refentry>