* Bug 15891 fixed: [doc] matrix-wise trigo pages => subsection
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / ind2sub.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 - Serge STEER
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:ns4="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="ind2sub" xml:lang="pt">
17     <refnamediv>
18         <refname>ind2sub</refname>
19         <refpurpose>conversão de índice linear para matriz de valores
20             subescritos
21         </refpurpose>
22     </refnamediv>
23     <refsynopsisdiv>
24         <title>Seqüência de Chamamento</title>
25         <synopsis>[i1,i2,..] =ind2sub(dims,I)
26             Mi = ind2sub(dims,I)
27         </synopsis>
28     </refsynopsisdiv>
29     <refsection>
30         <title>Parâmetros</title>
31         <variablelist>
32             <varlistentry>
33                 <term>dims</term>
34                 <listitem>
35                     <para>vetor com as dimensões da matriz </para>
36                 </listitem>
37             </varlistentry>
38             <varlistentry>
39                 <term>I</term>
40                 <listitem>
41                     <para>vetor com os dados índices lineares </para>
42                 </listitem>
43             </varlistentry>
44             <varlistentry>
45                 <term>i1,i2,..</term>
46                 <listitem>
47                     <para>valores subescritos (de mesma forma que
48                         <literal>I</literal>)
49                     </para>
50                 </listitem>
51             </varlistentry>
52             <varlistentry>
53                 <term>Mi</term>
54                 <listitem>
55                     <para>matriz cujas colunas contém os valores subescritos.</para>
56                 </listitem>
57             </varlistentry>
58         </variablelist>
59     </refsection>
60     <refsection>
61         <title>Descrição</title>
62         <para>
63             <literal>ind2sub</literal> é usado para determinar os valores
64             subescritos equivalentes que correspondem a um índice único num "array".
65             <literal>[i1,i2,..] = ind2sub(dims,I)</literal> retorna os "arrays"
66             <literal>i1</literal>, <literal>i2</literal>, ... contendo os subescritos
67             das linha, coluna, ... equivalentes correspondente à matriz de índices
68             <literal>I</literal> para uma matriz de tamanho <literal>dims</literal>.
69             <literal>Mi=ind2sub(dims,I)</literal> retorna uma matriz
70             <literal>Mi</literal> cujas colunas são os "arrays"
71             <literal>i1(:)</literal>, <literal>i2(:)</literal>, ...
72         </para>
73     </refsection>
74     <refsection>
75         <title>Exemplos</title>
76         <programlisting role="example"><![CDATA[
77 ind2sub([2,3,2],1:12)
78 [i,j,k]=ind2sub([2,3,2],1:12)
79  ]]></programlisting>
80     </refsection>
81     <refsection role="see also">
82         <title>Ver Também</title>
83         <simplelist type="inline">
84             <member>
85                 <link linkend="sub2ind">sub2ind</link>
86             </member>
87             <member>
88                 <link linkend="extraction">extraction</link>
89             </member>
90             <member>
91                 <link linkend="insertion">insertion</link>
92             </member>
93         </simplelist>
94     </refsection>
95 </refentry>