Massive indent of all codes:
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / size.xml
1     <?xml version="1.0" encoding="ISO-8859-1"?>
2     <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13     <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="size" xml:lang="en">
14         <refnamediv>
15             <refname>size</refname>
16             <refpurpose>tamanho de objetos</refpurpose>
17         </refnamediv>
18         <refsynopsisdiv>
19             <title>Seqüência de Chamamento</title>
20             <synopsis>y=size(x [,sel])
21                 [nr,nc]=size(x)
22             </synopsis>
23         </refsynopsisdiv>
24         <refsection>
25             <title>Parâmetros</title>
26             <variablelist>
27                 <varlistentry>
28                     <term>x</term>
29                     <listitem>
30                         <para>matrix (incluindo matriz de transferência), lista, ou sistema
31                             linear (<literal>syslin</literal>)
32                         </para>
33                     </listitem>
34                 </varlistentry>
35                 <varlistentry>
36                     <term>y</term>
37                     <listitem>
38                         <para>
39                             <literal> 1x2</literal> vetor de inteiros ou número inteiro
40                         </para>
41                     </listitem>
42                 </varlistentry>
43                 <varlistentry>
44                     <term>sel</term>
45                     <listitem>
46                         <para>um escalar ou um string </para>
47                     </listitem>
48                 </varlistentry>
49                 <varlistentry>
50                     <term>nr,nc</term>
51                     <listitem>
52                         <para>dois inteiros </para>
53                     </listitem>
54                 </varlistentry>
55             </variablelist>
56         </refsection>
57         <refsection>
58             <title>Descrição</title>
59             <variablelist>
60                 <varlistentry>
61                     <term>Aplicado a :</term>
62                     <listitem>
63                         <para> uma matriz (de constantes, de polinômios, de "strings", de
64                             booleanos ou de razões de polinômios) <literal>x</literal>, com
65                             apenas um argumento LHS ("Left Hand Side" ou "do lado esquerdo")
66                             <literal>size</literal> retorna um vetor
67                             <literal>1</literal>x<literal>2</literal> [número de linhas, número
68                             de colunas]. Chamado com LHS= 2, retorna <literal>nr,nc</literal> =
69                             [número de linhas, número de colunas]. <literal>sel</literal> pode
70                             ser usado para especficar a dimensão a ser recebida: 
71                         </para>
72                     </listitem>
73                 </varlistentry>
74                 <varlistentry>
75                     <term>1 ou 'r'</term>
76                     <listitem>
77                         <para>para receber o número de linhas. </para>
78                     </listitem>
79                 </varlistentry>
80                 <varlistentry>
81                     <term>2 ou 'c'</term>
82                     <listitem>
83                         <para>para receber o número de colunas</para>
84                     </listitem>
85                 </varlistentry>
86                 <varlistentry>
87                     <term>'*'</term>
88                     <listitem>
89                         <para>para receber o produto de linhas e números de colunas </para>
90                     </listitem>
91                 </varlistentry>
92                 <varlistentry>
93                     <term>Aplicado a:</term>
94                     <listitem>
95                         <para>uma lista retorna o número de elementos. Neste caso, apenas a
96                             sintaxe <literal>y=size(x)</literal> pode ser usada.
97                         </para>
98                     </listitem>
99                 </varlistentry>
100                 <varlistentry>
101                     <term>Aplicado a:</term>
102                     <listitem>
103                         <para>
104                             um sistema linear, <literal>y=size(x)</literal> retorna em
105                             <literal>y</literal> o vetor (linha) [número de saídas, número de
106                             entradas] i.e. a dimensão da matriz de transferência correspondente.
107                             A sintaxe <literal>[nr,nc]=size(x)</literal> também é válida (com
108                             <literal>(nr,nc)=(y(1),y(2)</literal>). Se <literal>x</literal> é um
109                             sistema linear em forma de estado-espaço, então
110                             <literal>[nr,nc,nx]=size(x)</literal> retorna ainda a dimensão
111                             <literal>nx</literal> da matriz <literal>A</literal> de
112                             <literal>x</literal>.
113                         </para>
114                     </listitem>
115                 </varlistentry>
116                 <varlistentry>
117                     <term>Aplicado a</term>
118                     <listitem>
119                         <para>
120                             uma hipermatriz <literal> y=size(x) </literal> retorna o vetor
121                             de dimensões da hipermatriz. <literal> [n1,n2,...nn]=size(x)
122                             </literal>
123                             retorna as dimensões da hipermatriz. <literal>
124                                 ni=size(x,i) 
125                             </literal>
126                             retorna a i-ésima dimensão e
127                             <literal>size(x,'*') </literal> retorna o produto de
128                             dimensões.
129                         </para>
130                     </listitem>
131                 </varlistentry>
132             </variablelist>
133         </refsection>
134         <refsection>
135             <title>Exemplos</title>
136             <programlisting role="example"><![CDATA[ 
137 [n,m]=size(rand(3,2))
138 [n,m]=size(['a','b';'c','d'])
139 x=ssrand(3,2,4);[ny,nu]=size(x)
140 [ny,nu]=size(ss2tf(x))
141 [ny,nu,nx]=size(x)
142  ]]></programlisting>
143         </refsection>
144         <refsection role="see also">
145             <title>Ver Também</title>
146             <simplelist type="inline">
147                 <member>
148                     <link linkend="length">length</link>
149                 </member>
150                 <member>
151                     <link linkend="syslin">syslin</link>
152                 </member>
153             </simplelist>
154         </refsection>
155     </refentry>