bitstring() complement
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / integer_representation / dec2bin.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) 2008 - 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:ns4="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="dec2bin" xml:lang="pt">
20     <refnamediv>
21         <refname>dec2bin</refname>
22         <refpurpose>representação binária</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Seqüência de Chamamento</title>
26         <synopsis>
27             str = dec2bin(x)
28             str = dec2bin(x, n)
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection>
32         <title>Parâmetros</title>
33         <variablelist>
34             <varlistentry>
35                 <term>x</term>
36                 <listitem>
37                     <para>escalar/vetor/matriz/hypermatriz de inteiros positivos</para>
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>n</term>
42                 <listitem>
43                     <para>um inteiro positivo</para>
44                 </listitem>
45             </varlistentry>
46             <varlistentry>
47                 <term>str</term>
48                 <listitem>
49                     <para>um string ou vetor de strings</para>
50                 </listitem>
51             </varlistentry>
52         </variablelist>
53     </refsection>
54     <refsection>
55         <title>Descrição</title>
56         <para>
57             Dado <literal>x</literal>, um inteiro (ou um vetor/matriz de
58             inteiros) positivo, esta função retorna um string (ou um vetor coluna de
59             strings) que é a representação binária de <literal>x. </literal>Se a
60             dimensão de <literal>x</literal> é superior a 1, então cada componente do
61             vetor coluna <literal>str</literal> é a representação binária dos
62             componentes de <literal>x</literal> (i.e <literal>str(i)</literal> é a
63             representação binária de <literal>x(i)</literal>). Se o comprimento dos
64             componentes de <literal>str</literal> é menor que <literal>n</literal> (
65             i.e length str(i) &lt; n ), então, adicione aos componentes de
66             <literal>str</literal> os caracteres '0' à esquerda, para se obter o
67             comprimento dos componentes igual a <literal>n</literal>
68         </para>
69     </refsection>
70     <refsection>
71         <title>Exemplos</title>
72         <programlisting role="example"><![CDATA[
73 // exemplo 1 :
74 x=86;
75 str=dec2bin(x)
76
77 // exemplo 2 :
78 // a representação binária de 86 é: '1010110'
79 // seu comprimento é 7(menor que n), então, temos adicionamos a str,
80 //8 vezes o caracteres '0'  (à esquerda)
81 x=86;n=15;
82 str=dec2bin(x,n)
83
84 // exemplo 3 :
85 x=[12;45;135]
86 z=dec2bin(x)
87  ]]></programlisting>
88     </refsection>
89     <refsection role="see also">
90         <title>Ver Também</title>
91         <simplelist type="inline">
92             <member>
93                 <link linkend="bitstring">bitstring</link>
94             </member>
95             <member>
96                 <link linkend="dec2base">dec2base</link>
97             </member>
98             <member>
99                 <link linkend="dec2oct">dec2oct</link>
100             </member>
101             <member>
102                 <link linkend="dec2hex">dec2hex</link>
103             </member>
104             <member>
105                 <link linkend="bin2dec">bin2dec</link>
106             </member>
107         </simplelist>
108     </refsection>
109 </refentry>