Merge remote-tracking branch 'refs/remotes/origin/master' into YaSp
[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" version="5.0-subset Scilab" 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>