<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) 2008 - INRIA
 *
 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 *
 * This file is hereby licensed under the terms of the GNU GPL v2.0,
 * pursuant to article 5.3.4 of the CeCILL v.2.1.
 * This file was originally licensed under the terms of the CeCILL v2.1,
 * and continues to be available under such terms.
 * For more information, see the COPYING file which you should have received
 * along with this program.
 *
 -->
<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="pt">
    <refnamediv>
        <refname>size</refname>
        <refpurpose>tamanho de objetos</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Seqüência de Chamamento</title>
        <synopsis>y=size(x [,sel])
            [nr,nc]=size(x)
        </synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Parâmetros</title>
        <variablelist>
            <varlistentry>
                <term>x</term>
                <listitem>
                    <para>matrix (incluindo matriz de transferência), lista, ou sistema
                        linear (<literal>syslin</literal>)
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>y</term>
                <listitem>
                    <para>
                        <literal> 1x2</literal> vetor de inteiros ou número inteiro
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>sel</term>
                <listitem>
                    <para>um escalar ou um string </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>nr,nc</term>
                <listitem>
                    <para>dois inteiros </para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Descrição</title>
        <variablelist>
            <varlistentry>
                <term>Aplicado a :</term>
                <listitem>
                    <para> uma matriz (de constantes, de polinômios, de "strings", de
                        booleanos ou de razões de polinômios) <literal>x</literal>, com
                        apenas um argumento LHS ("Left Hand Side" ou "do lado esquerdo")
                        <literal>size</literal> retorna um vetor
                        <literal>1</literal>x<literal>2</literal> [número de linhas, número
                        de colunas]. Chamado com LHS= 2, retorna <literal>nr,nc</literal> =
                        [número de linhas, número de colunas]. <literal>sel</literal> pode
                        ser usado para especficar a dimensão a ser recebida:
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>1 ou 'r'</term>
                <listitem>
                    <para>para receber o número de linhas. </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>2 ou 'c'</term>
                <listitem>
                    <para>para receber o número de colunas</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>'*'</term>
                <listitem>
                    <para>para receber o produto de linhas e números de colunas </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>Aplicado a:</term>
                <listitem>
                    <para>uma lista retorna o número de elementos. Neste caso, apenas a
                        sintaxe <literal>y=size(x)</literal> pode ser usada.
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>Aplicado a:</term>
                <listitem>
                    <para>
                        um sistema linear, <literal>y=size(x)</literal> retorna em
                        <literal>y</literal> o vetor (linha) [número de saídas, número de
                        entradas] i.e. a dimensão da matriz de transferência correspondente.
                        A sintaxe <literal>[nr,nc]=size(x)</literal> também é válida (com
                        <literal>(nr,nc)=(y(1),y(2)</literal>). Se <literal>x</literal> é um
                        sistema linear em forma de estado-espaço, então
                        <literal>[nr,nc,nx]=size(x)</literal> retorna ainda a dimensão
                        <literal>nx</literal> da matriz <literal>A</literal> de
                        <literal>x</literal>.
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>Aplicado a</term>
                <listitem>
                    <para>
                        uma hipermatriz <literal> y=size(x) </literal> retorna o vetor
                        de dimensões da hipermatriz. <literal> [n1,n2,...nn]=size(x)
                        </literal>
                        retorna as dimensões da hipermatriz. <literal>
                            ni=size(x,i)
                        </literal>
                        retorna a i-ésima dimensão e
                        <literal>size(x,'*') </literal> retorna o produto de
                        dimensões.
                    </para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Exemplos</title>
        <programlisting role="example"><![CDATA[
[n,m]=size(rand(3,2))
[n,m]=size(['a','b';'c','d'])
x=ssrand(3,2,4);[ny,nu]=size(x)
[ny,nu]=size(ss2tf(x))
[ny,nu,nx]=size(x)
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>Ver Também</title>
        <simplelist type="inline">
            <member>
                <link linkend="length">length</link>
            </member>
            <member>
                <link linkend="syslin">syslin</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
