Massive indent of all codes:
[scilab.git] / scilab / modules / elementary_functions / help / ja_JP / 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  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at    
11  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
12  * 
13  -->
14     <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="ja">
15         <refnamediv>
16             <refname>bitcmp</refname>
17             <refpurpose>ビット毎の補数</refpurpose>
18         </refnamediv>
19         <refsynopsisdiv>
20             <title>呼び出し手順</title>
21             <synopsis>
22                 y = bitcmp(x,n)
23             </synopsis>
24         </refsynopsisdiv>
25         <refsection>
26             <title>パラメータ</title>
27             <variablelist>
28                 <varlistentry>
29                     <term>x :</term>
30                     <listitem>
31                         <para>
32                             m行n列の行列(double)またはm1 x m2 x ... x mm ハイパー行列(double)
33                             または符合なし整数(uint8, uint16 または uint32)の
34                             m行n列行列.値は正の整数値である必要があります.
35                         </para>
36                     </listitem>
37                 </varlistentry>
38                 <varlistentry>
39                     <term>n :</term>
40                     <listitem>
41                         <para>
42                             m行n列の行列(double)またはm1 x m2 x ... x mm ハイパー行列(double)
43                             または符合なし整数(uint8, uint16 または uint32)の
44                             m行n列行列.
45                             入力<literal>n</literal>は 1,2,...,bitmax の範囲であることが
46                             必要です.
47                             ただし,bitmax は x の最大ビット数です.
48                             値は正の整数値である必要があります.
49                         </para>
50                     </listitem>
51                 </varlistentry>
52                 <varlistentry>
53                     <term>y :</term>
54                     <listitem>
55                         <para>
56                             m行n列の行列(double)またはm1 x m2 x ... x mm ハイパー行列(double)
57                             または符合なし整数のm行n列行列.
58                         </para>
59                     </listitem>
60                 </varlistentry>
61             </variablelist>
62         </refsection>
63         <refsection>
64             <title>説明</title>
65             <para>
66                 符合なし整数<literal>x</literal>を指定すると, この関数は
67                 <literal>x</literal>の2進数形式の補数を値とする
68                 符合なし整数を返します.
69             </para>
70             <para>
71                 整数 <literal>n</literal> は最大ビット数を指定します.
72             </para>
73             <para>
74                 <literal>x</literal>の2進数表現のビット数が bitmax の値 (8, 16 または 32)
75                 よりも小さい場合, bitmax ビット (8, 16 または 32)の補数とするために
76                 ビット '1' がこの補数に付加されます.
77             </para>
78         </refsection>
79         <refsection>
80             <title>例</title>
81             <programlisting role="example"><![CDATA[
82 // 13 is (1101)_2
83 // We insert zeros in the begining to get a 8-bit number:
84 // (00001101)_2
85 // The 8-bits complement is then (11110010)_2
86 // which is 242
87 bitcmp(13,8)
88 expected = 242
89
90 // The input argument can be an unsigned int
91 bitcmp(uint8(99),8)
92 expected = 156
93    ]]></programlisting>
94         </refsection>
95     </refentry>