integer_8h-source.html

著名的密码库Crypto++的文档 C++语言的杰作。程序员必备。

<a name="l00136"></a>00136 <span class="comment"></span>                <span class="keywordtype">void</span> Encode(<a class="code" href="class_buffered_transformation.html" title="interface for buffered transformations">BufferedTransformation</a> &amp;bt, <span class="keywordtype">size_t</span> outputLen, Signedness=UNSIGNED) <span class="keyword">const</span>;
<a name="l00137"></a>00137 <span class="comment"></span>
<a name="l00138"></a>00138 <span class="comment">                //! encode using Distinguished Encoding Rules, put result into a BufferedTransformation object</span>
<a name="l00139"></a>00139 <span class="comment"></span>                <span class="keywordtype">void</span> <a class="code" href="class_a_s_n1_object.html#10e40187a6ba048dfc8a2c8ca5c6c2ec" title="encode this object into a BufferedTransformation, using DER (Distinguished Encoding...">DEREncode</a>(<a class="code" href="class_buffered_transformation.html" title="interface for buffered transformations">BufferedTransformation</a> &amp;bt) <span class="keyword">const</span>;
<a name="l00140"></a>00140 <span class="comment"></span>
<a name="l00141"></a>00141 <span class="comment">                //! encode absolute value as big-endian octet string</span>
<a name="l00142"></a>00142 <span class="comment"></span>                <span class="keywordtype">void</span> DEREncodeAsOctetString(<a class="code" href="class_buffered_transformation.html" title="interface for buffered transformations">BufferedTransformation</a> &amp;bt, <span class="keywordtype">size_t</span> length) <span class="keyword">const</span>;
<a name="l00143"></a>00143 <span class="comment"></span>
<a name="l00144"></a>00144 <span class="comment">                //! encode absolute value in OpenPGP format, return length of output</span>
<a name="l00145"></a>00145 <span class="comment"></span>                <span class="keywordtype">size_t</span> OpenPGPEncode(byte *output, <span class="keywordtype">size_t</span> bufferSize) <span class="keyword">const</span>;<span class="comment"></span>
<a name="l00146"></a>00146 <span class="comment">                //! encode absolute value in OpenPGP format, put result into a BufferedTransformation object</span>
<a name="l00147"></a>00147 <span class="comment"></span>                <span class="keywordtype">size_t</span> OpenPGPEncode(<a class="code" href="class_buffered_transformation.html" title="interface for buffered transformations">BufferedTransformation</a> &amp;bt) <span class="keyword">const</span>;
<a name="l00148"></a>00148 <span class="comment"></span>
<a name="l00149"></a>00149 <span class="comment">                //!</span>
<a name="l00150"></a>00150 <span class="comment"></span>                <span class="keywordtype">void</span> Decode(<span class="keyword">const</span> byte *input, <span class="keywordtype">size_t</span> inputLen, Signedness=UNSIGNED);<span class="comment"></span>
<a name="l00151"></a>00151 <span class="comment">                //! </span>
<a name="l00152"></a>00152 <span class="comment"></span>                <span class="comment">//* Precondition: bt.MaxRetrievable() &gt;= inputLen</span>
<a name="l00153"></a>00153                 <span class="keywordtype">void</span> Decode(<a class="code" href="class_buffered_transformation.html" title="interface for buffered transformations">BufferedTransformation</a> &amp;bt, <span class="keywordtype">size_t</span> inputLen, Signedness=UNSIGNED);
<a name="l00154"></a>00154 <span class="comment"></span>
<a name="l00155"></a>00155 <span class="comment">                //!</span>
<a name="l00156"></a>00156 <span class="comment"></span>                <span class="keywordtype">void</span> <a class="code" href="class_a_s_n1_object.html#430af8c994bc78d996067247fa5a0770" title="decode this object from a BufferedTransformation, using BER (Basic Encoding Rules)...">BERDecode</a>(<span class="keyword">const</span> byte *input, <span class="keywordtype">size_t</span> inputLen);<span class="comment"></span>
<a name="l00157"></a>00157 <span class="comment">                //!</span>
<a name="l00158"></a>00158 <span class="comment"></span>                <span class="keywordtype">void</span> <a class="code" href="class_a_s_n1_object.html#430af8c994bc78d996067247fa5a0770" title="decode this object from a BufferedTransformation, using BER (Basic Encoding Rules)...">BERDecode</a>(<a class="code" href="class_buffered_transformation.html" title="interface for buffered transformations">BufferedTransformation</a> &amp;bt);
<a name="l00159"></a>00159 <span class="comment"></span>
<a name="l00160"></a>00160 <span class="comment">                //! decode nonnegative value as big-endian octet string</span>
<a name="l00161"></a>00161 <span class="comment"></span>                <span class="keywordtype">void</span> BERDecodeAsOctetString(<a class="code" href="class_buffered_transformation.html" title="interface for buffered transformations">BufferedTransformation</a> &amp;bt, <span class="keywordtype">size_t</span> length);
<a name="l00162"></a>00162 
<a name="l00163"></a><a class="code" href="class_integer_1_1_open_p_g_p_decode_err.html">00163</a>                 <span class="keyword">class </span><a class="code" href="class_integer_1_1_open_p_g_p_decode_err.html">OpenPGPDecodeErr</a> : <span class="keyword">public</span> <a class="code" href="class_exception.html" title="base class for all exceptions thrown by Crypto++">Exception</a>
<a name="l00164"></a>00164                 {
<a name="l00165"></a>00165                 <span class="keyword">public</span>: 
<a name="l00166"></a><a class="code" href="class_integer_1_1_open_p_g_p_decode_err.html#9ac0a3d7ea0daa02a3eca0eb5b698bd0">00166</a>                         <a class="code" href="class_integer_1_1_open_p_g_p_decode_err.html">OpenPGPDecodeErr</a>() : <a class="code" href="class_exception.html" title="base class for all exceptions thrown by Crypto++">Exception</a>(INVALID_DATA_FORMAT, <span class="stringliteral">"OpenPGP decode error"</span>) {}
<a name="l00167"></a>00167                 };
<a name="l00168"></a>00168 <span class="comment"></span>
<a name="l00169"></a>00169 <span class="comment">                //!</span>
<a name="l00170"></a>00170 <span class="comment"></span>                <span class="keywordtype">void</span> OpenPGPDecode(<span class="keyword">const</span> byte *input, <span class="keywordtype">size_t</span> inputLen);<span class="comment"></span>
<a name="l00171"></a>00171 <span class="comment">                //!</span>
<a name="l00172"></a>00172 <span class="comment"></span>                <span class="keywordtype">void</span> OpenPGPDecode(<a class="code" href="class_buffered_transformation.html" title="interface for buffered transformations">BufferedTransformation</a> &amp;bt);<span class="comment"></span>
<a name="l00173"></a>00173 <span class="comment">        //@}</span>
<a name="l00174"></a>00174 <span class="comment"></span><span class="comment"></span>
<a name="l00175"></a>00175 <span class="comment">        //! \name ACCESSORS</span>
<a name="l00176"></a>00176 <span class="comment"></span><span class="comment">        //@{</span>
<a name="l00177"></a>00177 <span class="comment"></span><span class="comment">                //! return true if *this can be represented as a signed long</span>
<a name="l00178"></a>00178 <span class="comment"></span>                <span class="keywordtype">bool</span> IsConvertableToLong() <span class="keyword">const</span>;<span class="comment"></span>
<a name="l00179"></a>00179 <span class="comment">                //! return equivalent signed long if possible, otherwise undefined</span>
<a name="l00180"></a>00180 <span class="comment"></span>                <span class="keywordtype">signed</span> <span class="keywordtype">long</span> ConvertToLong() <span class="keyword">const</span>;
<a name="l00181"></a>00181 <span class="comment"></span>
<a name="l00182"></a>00182 <span class="comment">                //! number of significant bits = floor(log2(abs(*this))) + 1</span>
<a name="l00183"></a>00183 <span class="comment"></span>                <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> BitCount() <span class="keyword">const</span>;<span class="comment"></span>
<a name="l00184"></a>00184 <span class="comment">                //! number of significant bytes = ceiling(BitCount()/8)</span>
<a name="l00185"></a>00185 <span class="comment"></span>                <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> ByteCount() <span class="keyword">const</span>;<span class="comment"></span>
<a name="l00186"></a>00186 <span class="comment">                //! number of significant words = ceiling(ByteCount()/sizeof(word))</span>
<a name="l00187"></a>00187 <span class="comment"></span>                <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> WordCount() <span class="keyword">const</span>;
<a name="l00188"></a>00188 <span class="comment"></span>
<a name="l00189"></a>00189 <span class="comment">                //! return the i-th bit, i=0 being the least significant bit</span>
<a name="l00190"></a>00190 <span class="comment"></span>                <span class="keywordtype">bool</span> GetBit(<span class="keywordtype">size_t</span> i) <span class="keyword">const</span>;<span class="comment"></span>
<a name="l00191"></a>00191 <span class="comment">                //! return the i-th byte</span>
<a name="l00192"></a>00192 <span class="comment"></span>                byte GetByte(<span class="keywordtype">size_t</span> i) <span class="keyword">const</span>;<span class="comment"></span>
<a name="l00193"></a>00193 <span class="comment">                //! return n lowest bits of *this &gt;&gt; i</span>
<a name="l00194"></a>00194 <span class="comment"></span>                lword GetBits(<span class="keywordtype">size_t</span> i, <span class="keywordtype">size_t</span> n) <span class="keyword">const</span>;
<a name="l00195"></a>00195 <span class="comment"></span>
<a name="l00196"></a>00196 <span class="comment">                //!</span>
<a name="l00197"></a><a class="code" href="class_integer.html#cca1f2de6c0bfa91c49950daf681b678">00197</a> <span class="comment"></span>                <span class="keywordtype">bool</span> IsZero()<span class="keyword"> const </span>{<span class="keywordflow">return</span> !*<span class="keyword">this</span>;}<span class="comment"></span>
<a name="l00198"></a>00198 <span class="comment">                //!</span>
<a name="l00199"></a><a class="code" href="class_integer.html#5364029d13bf6d21e7b578127160dbed">00199</a> <span class="comment"></span>                <span class="keywordtype">bool</span> NotZero()<span class="keyword"> const </span>{<span class="keywordflow">return</span> !IsZero();}<span class="comment"></span>
<a name="l00200"></a>00200 <span class="comment">                //!</span>
<a name="l00201"></a><a class="code" href="class_integer.html#d767ae81c89be3804da8785e132d2d1f">00201</a> <span class="comment"></span>                <span class="keywordtype">bool</span> IsNegative()<span class="keyword"> const </span>{<span class="keywordflow">return</span> sign == NEGATIVE;}<span class="comment"></span>
<a name="l00202"></a>00202 <span class="comment">                //!</span>
<a name="l00203"></a><a class="code" href="class_integer.html#880ab53116f2b9f527489d86ee806896">00203</a> <span class="comment"></span>                <span class="keywordtype">bool</span> NotNegative()<span class="keyword"> const </span>{<span class="keywordflow">return</span> !IsNegative();}<span class="comment"></span>
<a name="l00204"></a>00204 <span class="comment">                //!</span>
<a name="l00205"></a><a class="code" href="class_integer.html#13ddbfd8e9729932c2a99b0dff530978">00205</a> <span class="comment"></span>                <span class="keywordtype">bool</span> IsPositive()<span class="keyword"> const </span>{<span class="keywordflow">return</span> NotNegative() &amp;&amp; NotZero();}<span class="comment"></span>
<a name="l00206"></a>00206 <span class="comment">                //!</span>
<a name="l00207"></a><a class="code" href="class_integer.html#82c26b308640b25c35213da4c315f3ce">00207</a> <span class="comment"></span>                <span class="keywordtype">bool</span> NotPositive()<span class="keyword"> const </span>{<span class="keywordflow">return</span> !IsPositive();}<span class="comment"></span>
<a name="l00208"></a>00208 <span class="comment">                //!</span>
<a name="l00209"></a><a class="code" href="class_integer.html#fedf9af097a3417d8bd3742ec53f9593">00209</a> <span class="comment"></span>                <span class="keywordtype">bool</span> IsEven()<span class="keyword"> const </span>{<span class="keywordflow">return</span> GetBit(0) == 0;}<span class="comment"></span>
<a name="l00210"></a>00210 <span class="comment">                //!</span>
<a name="l00211"></a><a class="code" href="class_integer.html#ed4bb7208a18b986ef3e1a7d92e06d1d">00211</a> <span class="comment"></span>                <span class="keywordtype">bool</span> IsOdd()<span class="keyword"> const      </span>{<span class="keywordflow">return</span> GetBit(0) == 1;}<span class="comment"></span>
<a name="l00212"></a>00212 <span class="comment">        //@}</span>
<a name="l00213"></a>00213 <span class="comment"></span><span class="comment"></span>