<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.14"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>Crypto++: TrapdoorFunction Class Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td id="projectalign" style="padding-left: 0.5em;"> <div id="projectname">Crypto++  <span id="projectnumber">7.0</span> </div> <div id="projectbrief">Free C++ class library of cryptographic schemes</div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.14 --> <script type="text/javascript" src="menudata.js"></script> <script type="text/javascript" src="menu.js"></script> <script type="text/javascript"> /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ $(function() { initMenu('',false,false,'search.php','Search'); }); /* @license-end */</script> <div id="main-nav"></div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="#pub-methods">Public Member Functions</a> | <a href="class_trapdoor_function-members.html">List of all members</a> </div> <div class="headertitle"> <div class="title">TrapdoorFunction Class Reference<span class="mlabels"><span class="mlabel">abstract</span></span></div> </div> </div><!--header--> <div class="contents"> <p>Applies the trapdoor function. <a href="class_trapdoor_function.html#details">More...</a></p> <div id="dynsection-0" onclick="return toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;"> <img id="dynsection-0-trigger" src="closed.png" alt="+"/> Inheritance diagram for TrapdoorFunction:</div> <div id="dynsection-0-summary" class="dynsummary" style="display:block;"> </div> <div id="dynsection-0-content" class="dyncontent" style="display:none;"> <div class="center"> <img src="class_trapdoor_function.png" usemap="#TrapdoorFunction_map" alt=""/> <map id="TrapdoorFunction_map" name="TrapdoorFunction_map"> <area href="class_randomized_trapdoor_function.html" title="Applies the trapdoor function, using random data if required. " alt="RandomizedTrapdoorFunction" shape="rect" coords="382,56,563,80"/> <area href="class_trapdoor_function_bounds.html" title="Provides range for plaintext and ciphertext lengths. " alt="TrapdoorFunctionBounds" shape="rect" coords="382,0,563,24"/> <area href="class_e_s_i_g_n_function.html" title="ESIGN trapdoor function using the public key. " alt="ESIGNFunction" shape="rect" coords="0,168,181,192"/> <area href="class_l_u_c_function.html" title="The LUC function. " alt="LUCFunction" shape="rect" coords="191,168,372,192"/> <area href="class_rabin_function.html" title="Rabin trapdoor function using the public key. " alt="RabinFunction" shape="rect" coords="382,168,563,192"/> <area href="class_r_s_a_function.html" title="RSA trapdoor function using the public key. " alt="RSAFunction" shape="rect" coords="668,168,849,192"/> <area href="class_r_w_function.html" title="Rabin-Williams trapdoor function using the public key. " alt="RWFunction" shape="rect" coords="955,168,1136,192"/> <area href="class_invertible_e_s_i_g_n_function.html" title="ESIGN trapdoor function using the private key. " alt="InvertibleESIGNFunction" shape="rect" coords="0,224,181,248"/> <area href="class_invertible_l_u_c_function.html" title="The LUC inverse function. " alt="InvertibleLUCFunction" shape="rect" coords="191,224,372,248"/> <area href="class_invertible_rabin_function.html" title="Rabin trapdoor function using the private key. " alt="InvertibleRabinFunction" shape="rect" coords="382,224,563,248"/> <area href="class_invertible_r_s_a_function.html" title="RSA trapdoor function using the private key. " alt="InvertibleRSAFunction" shape="rect" coords="573,224,754,248"/> <area href="class_r_s_a_function___i_s_o.html" title="RSA trapdoor function using the public key. " alt="RSAFunction_ISO" shape="rect" coords="764,224,945,248"/> <area href="class_invertible_r_w_function.html" title="Rabin-Williams trapdoor function using the private key. " alt="InvertibleRWFunction" shape="rect" coords="955,224,1136,248"/> <area href="class_invertible_r_s_a_function___i_s_o.html" title="RSA trapdoor function using the private key. " alt="InvertibleRSAFunction_ISO" shape="rect" coords="573,280,754,304"/> </map> </div></div> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr class="memitem:a831474e986ac5c379ca55aa6675daf4b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_integer.html">Integer</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_trapdoor_function.html#a831474e986ac5c379ca55aa6675daf4b">ApplyRandomizedFunction</a> (<a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> &rng, const <a class="el" href="class_integer.html">Integer</a> &x) const</td></tr> <tr class="memdesc:a831474e986ac5c379ca55aa6675daf4b"><td class="mdescLeft"> </td><td class="mdescRight">Applies the trapdoor function. <a href="#a831474e986ac5c379ca55aa6675daf4b">More...</a><br /></td></tr> <tr class="separator:a831474e986ac5c379ca55aa6675daf4b"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a253eb5db8020326f869a4580e21bf5d8"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="class_trapdoor_function.html#a253eb5db8020326f869a4580e21bf5d8">IsRandomized</a> () const</td></tr> <tr class="memdesc:a253eb5db8020326f869a4580e21bf5d8"><td class="mdescLeft"> </td><td class="mdescRight">Determines if the encryption algorithm is randomized. <a href="#a253eb5db8020326f869a4580e21bf5d8">More...</a><br /></td></tr> <tr class="separator:a253eb5db8020326f869a4580e21bf5d8"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a06f1c5450f47d1de7143619b42f5167b"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="class_integer.html">Integer</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_trapdoor_function.html#a06f1c5450f47d1de7143619b42f5167b">ApplyFunction</a> (const <a class="el" href="class_integer.html">Integer</a> &x) const =0</td></tr> <tr class="memdesc:a06f1c5450f47d1de7143619b42f5167b"><td class="mdescLeft"> </td><td class="mdescRight">Applies the trapdoor. <a href="#a06f1c5450f47d1de7143619b42f5167b">More...</a><br /></td></tr> <tr class="separator:a06f1c5450f47d1de7143619b42f5167b"><td class="memSeparator" colspan="2"> </td></tr> <tr class="inherit_header pub_methods_class_trapdoor_function_bounds"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_class_trapdoor_function_bounds')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="class_trapdoor_function_bounds.html">TrapdoorFunctionBounds</a></td></tr> <tr class="memitem:a05e212439a3665a61872956061e5364c inherit pub_methods_class_trapdoor_function_bounds"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="class_integer.html">Integer</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_trapdoor_function_bounds.html#a05e212439a3665a61872956061e5364c">PreimageBound</a> () const =0</td></tr> <tr class="memdesc:a05e212439a3665a61872956061e5364c inherit pub_methods_class_trapdoor_function_bounds"><td class="mdescLeft"> </td><td class="mdescRight">Returns the maximum size of a message before the trapdoor function is applied. <a href="class_trapdoor_function_bounds.html#a05e212439a3665a61872956061e5364c">More...</a><br /></td></tr> <tr class="separator:a05e212439a3665a61872956061e5364c inherit pub_methods_class_trapdoor_function_bounds"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a092bfba4b87163e525da7e8e28b0011d inherit pub_methods_class_trapdoor_function_bounds"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="class_integer.html">Integer</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_trapdoor_function_bounds.html#a092bfba4b87163e525da7e8e28b0011d">ImageBound</a> () const =0</td></tr> <tr class="memdesc:a092bfba4b87163e525da7e8e28b0011d inherit pub_methods_class_trapdoor_function_bounds"><td class="mdescLeft"> </td><td class="mdescRight">Returns the maximum size of a message after the trapdoor function is applied. <a href="class_trapdoor_function_bounds.html#a092bfba4b87163e525da7e8e28b0011d">More...</a><br /></td></tr> <tr class="separator:a092bfba4b87163e525da7e8e28b0011d inherit pub_methods_class_trapdoor_function_bounds"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ab85b47c9c3df4cf1030eff786ab11d5b inherit pub_methods_class_trapdoor_function_bounds"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="class_integer.html">Integer</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_trapdoor_function_bounds.html#ab85b47c9c3df4cf1030eff786ab11d5b">MaxPreimage</a> () const</td></tr> <tr class="memdesc:ab85b47c9c3df4cf1030eff786ab11d5b inherit pub_methods_class_trapdoor_function_bounds"><td class="mdescLeft"> </td><td class="mdescRight">Returns the maximum size of a message before the trapdoor function is applied bound to a public key. <a href="class_trapdoor_function_bounds.html#ab85b47c9c3df4cf1030eff786ab11d5b">More...</a><br /></td></tr> <tr class="separator:ab85b47c9c3df4cf1030eff786ab11d5b inherit pub_methods_class_trapdoor_function_bounds"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a9b505cf1a3494645998e7e0872b76a72 inherit pub_methods_class_trapdoor_function_bounds"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="class_integer.html">Integer</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="class_trapdoor_function_bounds.html#a9b505cf1a3494645998e7e0872b76a72">MaxImage</a> () const</td></tr> <tr class="memdesc:a9b505cf1a3494645998e7e0872b76a72 inherit pub_methods_class_trapdoor_function_bounds"><td class="mdescLeft"> </td><td class="mdescRight">Returns the maximum size of a message after the trapdoor function is applied bound to a public key. <a href="class_trapdoor_function_bounds.html#a9b505cf1a3494645998e7e0872b76a72">More...</a><br /></td></tr> <tr class="separator:a9b505cf1a3494645998e7e0872b76a72 inherit pub_methods_class_trapdoor_function_bounds"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>Applies the trapdoor function. </p> <p><a class="el" href="class_trapdoor_function.html#a06f1c5450f47d1de7143619b42f5167b" title="Applies the trapdoor. ">ApplyFunction()</a> is the foundation for encrypting a message under a public key. Derived classes will override it at some point. </p><dl class="section see"><dt>See also</dt><dd><a class="el" href="class_trapdoor_function_bounds.html" title="Provides range for plaintext and ciphertext lengths. ">TrapdoorFunctionBounds()</a>, <a class="el" href="class_randomized_trapdoor_function.html" title="Applies the trapdoor function, using random data if required. ">RandomizedTrapdoorFunction()</a>, <a class="el" href="class_trapdoor_function.html" title="Applies the trapdoor function. ">TrapdoorFunction()</a>, <a class="el" href="class_randomized_trapdoor_function_inverse.html" title="Applies the inverse of the trapdoor function, using random data if required. ">RandomizedTrapdoorFunctionInverse()</a> and <a class="el" href="class_trapdoor_function_inverse.html" title="Applies the inverse of the trapdoor function. ">TrapdoorFunctionInverse()</a> </dd></dl> <p class="definition">Definition at line <a class="el" href="pubkey_8h_source.html#l00125">125</a> of file <a class="el" href="pubkey_8h_source.html">pubkey.h</a>.</p> </div><h2 class="groupheader">Member Function Documentation</h2> <a id="a831474e986ac5c379ca55aa6675daf4b"></a> <h2 class="memtitle"><span class="permalink"><a href="#a831474e986ac5c379ca55aa6675daf4b">◆ </a></span>ApplyRandomizedFunction()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname"><a class="el" href="class_integer.html">Integer</a> TrapdoorFunction::ApplyRandomizedFunction </td> <td>(</td> <td class="paramtype"><a class="el" href="class_random_number_generator.html">RandomNumberGenerator</a> & </td> <td class="paramname"><em>rng</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const <a class="el" href="class_integer.html">Integer</a> & </td> <td class="paramname"><em>x</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Applies the trapdoor function. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">rng</td><td>a <a class="el" href="class_random_number_generator.html" title="Interface for random number generators. ">RandomNumberGenerator</a> derived class </td></tr> <tr><td class="paramname">x</td><td>the message on which the encryption function is applied</td></tr> </table> </dd> </dl> <p>ApplyRandomizedFunction is a generalization of encryption under a public key cryptosystem. The <a class="el" href="class_random_number_generator.html" title="Interface for random number generators. ">RandomNumberGenerator</a> may (or may not) be required.</p> <p>Internally, <a class="el" href="class_trapdoor_function.html#a831474e986ac5c379ca55aa6675daf4b" title="Applies the trapdoor function. ">ApplyRandomizedFunction()</a> calls <a class="el" href="class_trapdoor_function.html#a06f1c5450f47d1de7143619b42f5167b" title="Applies the trapdoor. ">ApplyFunction()</a> <em>without</em> the <a class="el" href="class_random_number_generator.html" title="Interface for random number generators. ">RandomNumberGenerator</a>. </p> <p>Implements <a class="el" href="class_randomized_trapdoor_function.html#a0ef90207f59fb08deaafed6ce1ff2e6a">RandomizedTrapdoorFunction</a>.</p> <p class="definition">Definition at line <a class="el" href="pubkey_8h_source.html#l00137">137</a> of file <a class="el" href="pubkey_8h_source.html">pubkey.h</a>.</p> </div> </div> <a id="a253eb5db8020326f869a4580e21bf5d8"></a> <h2 class="memtitle"><span class="permalink"><a href="#a253eb5db8020326f869a4580e21bf5d8">◆ </a></span>IsRandomized()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">bool TrapdoorFunction::IsRandomized </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Determines if the encryption algorithm is randomized. </p> <dl class="section return"><dt>Returns</dt><dd>true if the encryption algorithm is randomized, false otherwise</dd></dl> <p>If <a class="el" href="class_trapdoor_function.html#a253eb5db8020326f869a4580e21bf5d8" title="Determines if the encryption algorithm is randomized. ">IsRandomized()</a> returns false, then <a class="el" href="cryptlib_8h.html#a1e53479a6d427158247ac1ece3161a6d" title="Random Number Generator that does not produce random numbers. ">NullRNG()</a> can be used. </p> <p>Reimplemented from <a class="el" href="class_randomized_trapdoor_function.html#af5fcf44d157a391ccf4ae61c9940e95a">RandomizedTrapdoorFunction</a>.</p> <p class="definition">Definition at line <a class="el" href="pubkey_8h_source.html#l00139">139</a> of file <a class="el" href="pubkey_8h_source.html">pubkey.h</a>.</p> </div> </div> <a id="a06f1c5450f47d1de7143619b42f5167b"></a> <h2 class="memtitle"><span class="permalink"><a href="#a06f1c5450f47d1de7143619b42f5167b">◆ </a></span>ApplyFunction()</h2> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">virtual <a class="el" href="class_integer.html">Integer</a> TrapdoorFunction::ApplyFunction </td> <td>(</td> <td class="paramtype">const <a class="el" href="class_integer.html">Integer</a> & </td> <td class="paramname"><em>x</em></td><td>)</td> <td> const</td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">pure virtual</span></span> </td> </tr> </table> </div><div class="memdoc"> <p>Applies the trapdoor. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">x</td><td>the message on which the encryption function is applied </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>the message x encrypted under the public key</dd></dl> <p>ApplyFunction is a generalization of encryption under a public key cryptosystem. Derived classes must implement it. </p> <p>Implemented in <a class="el" href="class_r_s_a_function___i_s_o.html#af6334da98da7b74b71deb819000e3365">RSAFunction_ISO</a>, <a class="el" href="class_l_u_c_function.html#ae23d0c06b0c29ff4f51e7b1f09724ab5">LUCFunction</a>, <a class="el" href="class_r_s_a_function.html#a64667f02da49f83cdfd7b98e9e0184e9">RSAFunction</a>, <a class="el" href="class_e_s_i_g_n_function.html#ad7d9112f0e94caa37e815fb8d50e391a">ESIGNFunction</a>, <a class="el" href="class_r_w_function.html#a37cf8dd12263547a61890f8409a3d4d5">RWFunction</a>, and <a class="el" href="class_rabin_function.html#af054d72c882160a1f09700559cb13b5d">RabinFunction</a>.</p> </div> </div> <hr/>The documentation for this class was generated from the following file:<ul> <li><a class="el" href="pubkey_8h_source.html">pubkey.h</a></li> </ul> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Sun Sep 16 2018 07:59:05 for Crypto++ by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.14 </small></address> </body> </html>