81a7165a77f40028d4c8387e861b32616cd17393
[scilab.git] / scilab / modules / elementary_functions / help / ru_RU / bitwise / bitcmp.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  *
4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
5  * Copyright (C) 2011 - DIGITEO - Michael Baudin
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <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="bitcmp" xml:lang="ru">
18     <refnamediv>
19         <refname>bitcmp</refname>
20         <refpurpose>побитовое дополнение</refpurpose>
21     </refnamediv>
22     <refsynopsisdiv>
23         <title>Синтаксис</title>
24         <synopsis>
25             y = bitcmp(x, bitnum)
26         </synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Параметры</title>
30         <variablelist>
31             <varlistentry>
32                 <term>x :</term>
33                 <listitem>
34                     <para>
35                         матрица чисел двойной точности (<literal>double</literal>) размером <literal>m</literal> на <literal>n</literal>
36                         или гиперматрица чисел двойной точности размером <literal>m1</literal> на <literal>m2</literal> на ... на <literal>mm</literal>
37                         или матрица беззнаковых целых чисел (<literal>uint8</literal>, <literal>uint16</literal> или <literal>uint32</literal>) размером <literal>m</literal> на <literal>n</literal>. Должна содержать положительные целые значения.
38                     </para>
39                 </listitem>
40             </varlistentry>
41             <varlistentry>
42                 <term>bitnum :</term>
43                 <listitem>
44                     <para>
45                         матрица чисел двойной точности (<literal>double</literal>) размером <literal>m</literal> на <literal>n</literal>
46                         или гиперматрица чисел двойной точности размером <literal>m1</literal> на <literal>m2</literal> на ... на <literal>mm</literal>
47                         или матрица беззнаковых целых чисел (<literal>uint8</literal>, <literal>uint16</literal> или <literal>uint32</literal>) размером <literal>m</literal> на <literal>n</literal>. Должна содержать положительные целые значения.
48                         Входная <varname>bitnum</varname> должна быть в диапазоне 1, 2, ..., <literal>bitmax</literal>
49                         где <literal>bitmax</literal> - максимальное количество битов в <varname>x</varname>.
50                         <varname>bitnum</varname> должна содержать положительные целые значения.
51                     </para>
52                 </listitem>
53             </varlistentry>
54             <varlistentry>
55                 <term>y :</term>
56                 <listitem>
57                     <para>
58                         матрица чисел двойной точности размером <literal>m</literal> на <literal>n</literal>
59                         или гиперматрица чисел двойной точности размером <literal>m1</literal> на <literal>m2</literal> на ... на <literal>mm</literal>
60                         или матрица беззнаковых целых чисел (<literal>uint8</literal>, <literal>uint16</literal> или <literal>uint32</literal>) размером <literal>m</literal> на <literal>n</literal>.
61                     </para>
62                 </listitem>
63             </varlistentry>
64         </variablelist>
65     </refsection>
66     <refsection>
67         <title>Описание</title>
68         <para>
69             Для заданного беззнакового целого числа <varname>x</varname>, эта функция возвращает беззнаковое целое число <varname>y</varname>, которое является целым числом, соответствующим дополнительному коду двоичного представления <varname>x</varname>.
70         </para>
71         <para>
72             Целое число <varname>bitnum</varname> устанавливает максимальное количество битов.
73         </para>
74         <para>
75             Если количество битов в двоичном представлении <varname>x</varname> меньше количества
76             <literal>bitmax</literal> (8, 16 или 32), то добавляются биты <literal>'1'</literal> к дополнительному коду для того чтобы у дополнительного кода количество битов было <literal>bitmax</literal> (8, 16 или 32).
77         </para>
78     </refsection>
79     <refsection>
80         <title>Примеры</title>
81         <programlisting role="example"><![CDATA[
82 // 13 соответствует (1101)_2
83 // Мы вводим нули в начало, чтобы получить 8-битовое число:
84 // (00001101)_2
85 // 8-битовый дополнительный код тогда (11110010)_2,
86 // что соответствует 242
87 bitcmp(13,8)
88 expected = 242
89
90 // Входной аргумент может быть беззнаковым целым числом
91 bitcmp(uint8(99),8)
92 expected = 156
93    ]]></programlisting>
94     </refsection>
95 </refentry>