misc_8h-source.html

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

<a name="l00266"></a>00266 }
<a name="l00267"></a>00267 
<a name="l00268"></a>00268 <span class="keyword">inline</span> <span class="keywordtype">size_t</span> BytesToWords(<span class="keywordtype">size_t</span> byteCount)
<a name="l00269"></a>00269 {
<a name="l00270"></a>00270         <span class="keywordflow">return</span> ((byteCount+WORD_SIZE-1)/WORD_SIZE);
<a name="l00271"></a>00271 }
<a name="l00272"></a>00272 
<a name="l00273"></a>00273 <span class="keyword">inline</span> <span class="keywordtype">size_t</span> BitsToWords(<span class="keywordtype">size_t</span> bitCount)
<a name="l00274"></a>00274 {
<a name="l00275"></a>00275         <span class="keywordflow">return</span> ((bitCount+WORD_BITS-1)/(WORD_BITS));
<a name="l00276"></a>00276 }
<a name="l00277"></a>00277 
<a name="l00278"></a>00278 <span class="keyword">inline</span> <span class="keywordtype">size_t</span> BitsToDwords(<span class="keywordtype">size_t</span> bitCount)
<a name="l00279"></a>00279 {
<a name="l00280"></a>00280         <span class="keywordflow">return</span> ((bitCount+2*WORD_BITS-1)/(2*WORD_BITS));
<a name="l00281"></a>00281 }
<a name="l00282"></a>00282 
<a name="l00283"></a>00283 CRYPTOPP_DLL <span class="keywordtype">void</span> CRYPTOPP_API xorbuf(byte *buf, <span class="keyword">const</span> byte *mask, <span class="keywordtype">size_t</span> count);
<a name="l00284"></a>00284 CRYPTOPP_DLL <span class="keywordtype">void</span> CRYPTOPP_API xorbuf(byte *output, <span class="keyword">const</span> byte *input, <span class="keyword">const</span> byte *mask, <span class="keywordtype">size_t</span> count);
<a name="l00285"></a>00285 
<a name="l00286"></a>00286 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T&gt;
<a name="l00287"></a>00287 <span class="keyword">inline</span> <span class="keywordtype">bool</span> IsPowerOf2(<span class="keyword">const</span> T &amp;n)
<a name="l00288"></a>00288 {
<a name="l00289"></a>00289         <span class="keywordflow">return</span> n &gt; 0 &amp;&amp; (n &amp; (n-1)) == 0;
<a name="l00290"></a>00290 }
<a name="l00291"></a>00291 
<a name="l00292"></a>00292 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T1, <span class="keyword">class</span> T2&gt;
<a name="l00293"></a>00293 <span class="keyword">inline</span> T2 ModPowerOf2(<span class="keyword">const</span> T1 &amp;a, <span class="keyword">const</span> T2 &amp;b)
<a name="l00294"></a>00294 {
<a name="l00295"></a>00295         assert(IsPowerOf2(b));
<a name="l00296"></a>00296         <span class="keywordflow">return</span> T2(a) &amp; (b-1);
<a name="l00297"></a>00297 }
<a name="l00298"></a>00298 
<a name="l00299"></a>00299 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T1, <span class="keyword">class</span> T2&gt;
<a name="l00300"></a>00300 <span class="keyword">inline</span> T1 RoundDownToMultipleOf(<span class="keyword">const</span> T1 &amp;n, <span class="keyword">const</span> T2 &amp;m)
<a name="l00301"></a>00301 {
<a name="l00302"></a>00302         <span class="keywordflow">if</span> (IsPowerOf2(m))
<a name="l00303"></a>00303                 <span class="keywordflow">return</span> n - ModPowerOf2(n, m);
<a name="l00304"></a>00304         <span class="keywordflow">else</span>
<a name="l00305"></a>00305                 <span class="keywordflow">return</span> n - n%m;
<a name="l00306"></a>00306 }
<a name="l00307"></a>00307 
<a name="l00308"></a>00308 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T1, <span class="keyword">class</span> T2&gt;
<a name="l00309"></a>00309 <span class="keyword">inline</span> T1 RoundUpToMultipleOf(<span class="keyword">const</span> T1 &amp;n, <span class="keyword">const</span> T2 &amp;m)
<a name="l00310"></a>00310 {
<a name="l00311"></a>00311         <span class="keywordflow">if</span> (n+m-1 &lt; n)
<a name="l00312"></a>00312                 <span class="keywordflow">throw</span> <a class="code" href="class_invalid_argument.html" title="exception thrown when an invalid argument is detected">InvalidArgument</a>(<span class="stringliteral">"RoundUpToMultipleOf: integer overflow"</span>);
<a name="l00313"></a>00313         <span class="keywordflow">return</span> RoundDownToMultipleOf(n+m-1, m);
<a name="l00314"></a>00314 }
<a name="l00315"></a>00315 
<a name="l00316"></a>00316 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T&gt;
<a name="l00317"></a>00317 <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> GetAlignmentOf(T *dummy=NULL)       <span class="comment">// VC60 workaround</span>
<a name="l00318"></a>00318 {
<a name="l00319"></a>00319 <span class="preprocessor">#if CRYPTOPP_BOOL_X64 || CRYPTOPP_BOOL_X86</span>
<a name="l00320"></a>00320 <span class="preprocessor"></span>        <span class="keywordflow">if</span> (<span class="keyword">sizeof</span>(T) &lt; 16)
<a name="l00321"></a>00321                 <span class="keywordflow">return</span> 1;                       <span class="comment">// alignment not needed on x86 and x64</span>
<a name="l00322"></a>00322 <span class="preprocessor">#endif</span>
<a name="l00323"></a>00323 <span class="preprocessor"></span>
<a name="l00324"></a>00324 <span class="preprocessor">#if (_MSC_VER &gt;= 1300)</span>
<a name="l00325"></a>00325 <span class="preprocessor"></span>        <span class="keywordflow">return</span> __alignof(T);
<a name="l00326"></a>00326 <span class="preprocessor">#elif defined(__GNUC__)</span>
<a name="l00327"></a>00327 <span class="preprocessor"></span>        <span class="keywordflow">return</span> __alignof__(T);
<a name="l00328"></a>00328 <span class="preprocessor">#elif defined(CRYPTOPP_SLOW_WORD64)</span>
<a name="l00329"></a>00329 <span class="preprocessor"></span>        <span class="keywordflow">return</span> UnsignedMin(4U, <span class="keyword">sizeof</span>(T));
<a name="l00330"></a>00330 <span class="preprocessor">#else</span>
<a name="l00331"></a>00331 <span class="preprocessor"></span>        <span class="keywordflow">return</span> <span class="keyword">sizeof</span>(T);
<a name="l00332"></a>00332 <span class="preprocessor">#endif</span>
<a name="l00333"></a>00333 <span class="preprocessor"></span>}
<a name="l00334"></a>00334 
<a name="l00335"></a>00335 <span class="keyword">inline</span> <span class="keywordtype">bool</span> IsAlignedOn(<span class="keyword">const</span> <span class="keywordtype">void</span> *p, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> alignment)
<a name="l00336"></a>00336 {
<a name="l00337"></a>00337         <span class="keywordflow">return</span> alignment==1 || (IsPowerOf2(alignment) ? ModPowerOf2((<span class="keywordtype">size_t</span>)p, alignment) == 0 : (size_t)p % alignment == 0);
<a name="l00338"></a>00338 }
<a name="l00339"></a>00339 
<a name="l00340"></a>00340 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T&gt;
<a name="l00341"></a>00341 <span class="keyword">inline</span> <span class="keywordtype">bool</span> IsAligned(<span class="keyword">const</span> <span class="keywordtype">void</span> *p, T *dummy=NULL)     <span class="comment">// VC60 workaround</span>
<a name="l00342"></a>00342 {
<a name="l00343"></a>00343         <span class="keywordflow">return</span> IsAlignedOn(p, GetAlignmentOf&lt;T&gt;());
<a name="l00344"></a>00344 }
<a name="l00345"></a>00345 
<a name="l00346"></a>00346 <span class="preprocessor">#ifdef IS_LITTLE_ENDIAN</span>
<a name="l00347"></a>00347 <span class="preprocessor"></span>        <span class="keyword">typedef</span> <a class="code" href="struct_enum_to_type.html">LittleEndian</a> <a class="code" href="struct_enum_to_type.html">NativeByteOrder</a>;
<a name="l00348"></a>00348 <span class="preprocessor">#else</span>
<a name="l00349"></a>00349 <span class="preprocessor"></span>        <span class="keyword">typedef</span> <a class="code" href="struct_enum_to_type.html">BigEndian</a> NativeByteOrder;
<a name="l00350"></a>00350 <span class="preprocessor">#endif</span>
<a name="l00351"></a>00351 <span class="preprocessor"></span>
<a name="l00352"></a>00352 <span class="keyword">inline</span> <a class="code" href="cryptlib_8h.html#aeb92d42f5a6e27b8ba19f18d69d142b">ByteOrder</a> GetNativeByteOrder()
<a name="l00353"></a>00353 {
<a name="l00354"></a>00354         <span class="keywordflow">return</span> <a class="code" href="struct_enum_to_type.html#fe0316d264db930e7cd0c4b829599213">NativeByteOrder::ToEnum</a>();
<a name="l00355"></a>00355 }
<a name="l00356"></a>00356 
<a name="l00357"></a>00357 <span class="keyword">inline</span> <span class="keywordtype">bool</span> NativeByteOrderIs(<a class="code" href="cryptlib_8h.html#aeb92d42f5a6e27b8ba19f18d69d142b">ByteOrder</a> order)
<a name="l00358"></a>00358 {
<a name="l00359"></a>00359         <span class="keywordflow">return</span> order == GetNativeByteOrder();
<a name="l00360"></a>00360 }
<a name="l00361"></a>00361 
<a name="l00362"></a>00362 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T&gt;
<a name="l00363"></a>00363 std::string IntToString(T a, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> base = 10)
<a name="l00364"></a>00364 {
<a name="l00365"></a>00365         <span class="keywordflow">if</span> (a == 0)
<a name="l00366"></a>00366                 <span class="keywordflow">return</span> <span class="stringliteral">"0"</span>;
<a name="l00367"></a>00367         <span class="keywordtype">bool</span> negate = <span class="keyword">false</span>;
<a name="l00368"></a>00368         <span class="keywordflow">if</span> (a &lt; 0)
<a name="l00369"></a>00369         {
<a name="l00370"></a>00370                 negate = <span class="keyword">true</span>;
<a name="l00371"></a>00371                 a = 0-a;        <span class="comment">// VC .NET does not like -a</span>
<a name="l00372"></a>00372         }
<a name="l00373"></a>00373         std::string result;
<a name="l00374"></a>00374         <span class="keywordflow">while</span> (a &gt; 0)
<a name="l00375"></a>00375         {
<a name="l00376"></a>00376                 T digit = a % base;
<a name="l00377"></a>00377                 result = char((digit &lt; 10 ? <span class="charliteral">'0'</span> : (<span class="charliteral">'a'</span> - 10)) + digit) + result;
<a name="l00378"></a>00378                 a /= base;
<a name="l00379"></a>00379         }
<a name="l00380"></a>00380         <span class="keywordflow">if</span> (negate)
<a name="l00381"></a>00381                 result = <span class="stringliteral">"-"</span> + result;
<a name="l00382"></a>00382         <span class="keywordflow">return</span> result;
<a name="l00383"></a>00383 }
<a name="l00384"></a>00384 
<a name="l00385"></a>00385 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T1, <span class="keyword">class</span> T2&gt;
<a name="l00386"></a>00386 <span class="keyword">inline</span> T1 SaturatingSubtract(<span class="keyword">const</span> T1 &amp;a, <span class="keyword">const</span> T2 &amp;b)
<a name="l00387"></a>00387 {
<a name="l00388"></a>00388         <span class="keywordflow">return</span> T1((a &gt; b) ? (a - b) : 0);
<a name="l00389"></a>00389 }
<a name="l00390"></a>00390 
<a name="l00391"></a>00391 <span class="keyword">template</span> &lt;<span class="keyword">class</span> T&gt;
<a name="l00392"></a>00392 <span class="keyword">inline</span> <a class="code" href="cryptlib_8h.html#353ccabf5ddc119a6a33e92f7b9961c7" title="used to specify a direction for a cipher to operate in (encrypt or decrypt)">CipherDir</a> GetCipherDir(<span class="keyword">const</span> T &amp;obj)
<a name="l00393"></a>00393 {
<a name="l00394"></a>00394         <span class="keywordflow">return</span> obj.IsForwardTransformation() ? <a class="code" href="cryptlib_8h.html#353ccabf5ddc119a6a33e92f7b9961c7244e5e74f856cdd5aafc1005877a2f61">ENCRYPTION</a> : <a class="code" href="cryptlib_8h.html#353ccabf5ddc119a6a33e92f7b9961c7b5f88847da182e7a1a8af64f4e18f048">DECRYPTION</a>;
<a name="l00395"></a>00395 }
<a name="l00396"></a>00396 
<a name="l00397"></a>00397 CRYPTOPP_DLL <span class="keywordtype">void</span> CallNewHandler();
<a name="l00398"></a>00398 
<a name="l00399"></a>00399 <span class="keyword">inline</span> <span class="keywordtype">void</span> IncrementCounterByOne(byte *inout, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> s)
<a name="l00400"></a>00400 {
<a name="l00401"></a>00401         <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=s-1, carry=1; i&gt;=0 &amp;&amp; carry; i--)
<a name="l00402"></a>00402                 carry = !++inout[i];
<a name="l00403"></a>00403 }
<a name="l00404"></a>00404 
<a name="l00405"></a>00405 <span class="keyword">inline</span> <span class="keywordtype">void</span> IncrementCounterByOne(byte *output, <span class="keyword">const</span> byte *input, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> s)
<a name="l00406"></a>00406 {
<a name="l00407"></a>00407         <span class="keywordtype">int</span> i, carry;
<a name="l00408"></a>00408         <span class="keywordflow">for</span> (i=s-1, carry=1; i&gt;=0 &amp;&amp; carry; i--)