1<!-- HTML header for doxygen 1.8.10--> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4<head> 5<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> 6<meta http-equiv="X-UA-Compatible" content="IE=9"/> 7<meta name="generator" content="Doxygen 1.8.14"/> 8<title>Intel® Enhanced Privacy ID SDK: epid/member/tiny/math/fq.h File Reference</title> 9<link href="tabs.css" rel="stylesheet" type="text/css"/> 10<script type="text/javascript" src="jquery.js"></script> 11<script type="text/javascript" src="dynsections.js"></script> 12<link href="navtree.css" rel="stylesheet" type="text/css"/> 13<script type="text/javascript" src="resize.js"></script> 14<script type="text/javascript" src="navtreedata.js"></script> 15<script type="text/javascript" src="navtree.js"></script> 16<script type="text/javascript"> 17/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ 18 $(document).ready(initResizable); 19/* @license-end */</script> 20<link href="doxygen.css" rel="stylesheet" type="text/css" /> 21<link href="epidstyle.css" rel="stylesheet" type="text/css"/> 22</head> 23<body> 24<div id="top"><!-- do not remove this div, it is closed by doxygen! --> 25<div id="titlearea"> 26<table cellspacing="0" cellpadding="0"> 27 <tbody> 28 <tr style="height: 56px;"> 29 <td id="projectalign" style="padding-left: 0.5em;"> 30 <div id="projectname"><a 31 onclick="storeLink('index.html')" 32 id="projectlink" 33 class="index.html" 34 href="index.html">Intel® Enhanced Privacy ID SDK</a> 35 <span id="projectnumber">6.0.1</span> 36</div> 37 </td> 38 </tr> 39 </tbody> 40</table> 41</div> 42<!-- end header part --> 43<!-- Generated by Doxygen 1.8.14 --> 44</div><!-- top --> 45<div id="side-nav" class="ui-resizable side-nav-resizable"> 46 <div id="nav-tree"> 47 <div id="nav-tree-contents"> 48 <div id="nav-sync" class="sync"></div> 49 </div> 50 </div> 51 <div id="splitbar" style="-moz-user-select:none;" 52 class="ui-resizable-handle"> 53 </div> 54</div> 55<script type="text/javascript"> 56/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ 57$(document).ready(function(){initNavTree('fq_8h.html','');}); 58/* @license-end */ 59</script> 60<div id="doc-content"> 61<div class="header"> 62 <div class="summary"> 63<a href="#func-members">Functions</a> </div> 64 <div class="headertitle"> 65<div class="title">fq.h File Reference</div> </div> 66</div><!--header--> 67<div class="contents"> 68 69<p>Definition of Fq math. 70<a href="#details">More...</a></p> 71<div class="textblock"><code>#include <stddef.h></code><br /> 72<code>#include <stdint.h></code><br /> 73<code>#include "<a class="el" href="bitsupplier_8h.html">epid/common/bitsupplier.h</a>"</code><br /> 74</div><table class="memberdecls"> 75<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> 76Functions</h2></td></tr> 77<tr class="memitem:aceb37a8f5538fe9ca682058ff0e36091"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#aceb37a8f5538fe9ca682058ff0e36091">FqInField</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> const *in)</td></tr> 78<tr class="memdesc:aceb37a8f5538fe9ca682058ff0e36091"><td class="mdescLeft"> </td><td class="mdescRight">Test if an element is in Fq. <a href="#aceb37a8f5538fe9ca682058ff0e36091">More...</a><br /></td></tr> 79<tr class="separator:aceb37a8f5538fe9ca682058ff0e36091"><td class="memSeparator" colspan="2"> </td></tr> 80<tr class="memitem:ab52f69c761454d976c3fc56a26549419"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#ab52f69c761454d976c3fc56a26549419">FqAdd</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *left, <a class="el" href="struct_fq_elem.html">FqElem</a> const *right)</td></tr> 81<tr class="memdesc:ab52f69c761454d976c3fc56a26549419"><td class="mdescLeft"> </td><td class="mdescRight">Add two elements of Fq. <a href="#ab52f69c761454d976c3fc56a26549419">More...</a><br /></td></tr> 82<tr class="separator:ab52f69c761454d976c3fc56a26549419"><td class="memSeparator" colspan="2"> </td></tr> 83<tr class="memitem:a5148f610202ae759aafb197cb52137f1"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#a5148f610202ae759aafb197cb52137f1">FqSub</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *left, <a class="el" href="struct_fq_elem.html">FqElem</a> const *right)</td></tr> 84<tr class="memdesc:a5148f610202ae759aafb197cb52137f1"><td class="mdescLeft"> </td><td class="mdescRight">Subtract two elements of Fq. <a href="#a5148f610202ae759aafb197cb52137f1">More...</a><br /></td></tr> 85<tr class="separator:a5148f610202ae759aafb197cb52137f1"><td class="memSeparator" colspan="2"> </td></tr> 86<tr class="memitem:ab0bf77a97fb3a12292886bef3abcf9bd"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#ab0bf77a97fb3a12292886bef3abcf9bd">FqMul</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *left, <a class="el" href="struct_fq_elem.html">FqElem</a> const *right)</td></tr> 87<tr class="memdesc:ab0bf77a97fb3a12292886bef3abcf9bd"><td class="mdescLeft"> </td><td class="mdescRight">Multiply two elements of Fq. <a href="#ab0bf77a97fb3a12292886bef3abcf9bd">More...</a><br /></td></tr> 88<tr class="separator:ab0bf77a97fb3a12292886bef3abcf9bd"><td class="memSeparator" colspan="2"> </td></tr> 89<tr class="memitem:a276d3747aefdac5503982f2aa5eccbf8"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#a276d3747aefdac5503982f2aa5eccbf8">FqExp</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *base, <a class="el" href="struct_very_large_int.html">VeryLargeInt</a> const *exp)</td></tr> 90<tr class="memdesc:a276d3747aefdac5503982f2aa5eccbf8"><td class="mdescLeft"> </td><td class="mdescRight">Exponentiate an element of Fq by a large integer. <a href="#a276d3747aefdac5503982f2aa5eccbf8">More...</a><br /></td></tr> 91<tr class="separator:a276d3747aefdac5503982f2aa5eccbf8"><td class="memSeparator" colspan="2"> </td></tr> 92<tr class="memitem:a17133e5b777baa8c745b7dfcf1c8ad8d"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#a17133e5b777baa8c745b7dfcf1c8ad8d">FqCp</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *in)</td></tr> 93<tr class="memdesc:a17133e5b777baa8c745b7dfcf1c8ad8d"><td class="mdescLeft"> </td><td class="mdescRight">Copy an element's value. <a href="#a17133e5b777baa8c745b7dfcf1c8ad8d">More...</a><br /></td></tr> 94<tr class="separator:a17133e5b777baa8c745b7dfcf1c8ad8d"><td class="memSeparator" colspan="2"> </td></tr> 95<tr class="memitem:ac08ca8c781cd18cbadabbeeb85722e49"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#ac08ca8c781cd18cbadabbeeb85722e49">FqIsZero</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> const *value)</td></tr> 96<tr class="memdesc:ac08ca8c781cd18cbadabbeeb85722e49"><td class="mdescLeft"> </td><td class="mdescRight">Test if an element is zero. <a href="#ac08ca8c781cd18cbadabbeeb85722e49">More...</a><br /></td></tr> 97<tr class="separator:ac08ca8c781cd18cbadabbeeb85722e49"><td class="memSeparator" colspan="2"> </td></tr> 98<tr class="memitem:a7b60a8996973d474d2fb7a31838c6d8c"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#a7b60a8996973d474d2fb7a31838c6d8c">FqInv</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *in)</td></tr> 99<tr class="memdesc:a7b60a8996973d474d2fb7a31838c6d8c"><td class="mdescLeft"> </td><td class="mdescRight">Invert an element of Fq. <a href="#a7b60a8996973d474d2fb7a31838c6d8c">More...</a><br /></td></tr> 100<tr class="separator:a7b60a8996973d474d2fb7a31838c6d8c"><td class="memSeparator" colspan="2"> </td></tr> 101<tr class="memitem:ae8379530cca959e7e36446b2979d8af4"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#ae8379530cca959e7e36446b2979d8af4">FqNeg</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *in)</td></tr> 102<tr class="memdesc:ae8379530cca959e7e36446b2979d8af4"><td class="mdescLeft"> </td><td class="mdescRight">Negate an element of Fq. <a href="#ae8379530cca959e7e36446b2979d8af4">More...</a><br /></td></tr> 103<tr class="separator:ae8379530cca959e7e36446b2979d8af4"><td class="memSeparator" colspan="2"> </td></tr> 104<tr class="memitem:ab62c8f43f78a0c4f830c9ed65048b8f9"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#ab62c8f43f78a0c4f830c9ed65048b8f9">FqSquare</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *in)</td></tr> 105<tr class="memdesc:ab62c8f43f78a0c4f830c9ed65048b8f9"><td class="mdescLeft"> </td><td class="mdescRight">Square an element of Fq. <a href="#ab62c8f43f78a0c4f830c9ed65048b8f9">More...</a><br /></td></tr> 106<tr class="separator:ab62c8f43f78a0c4f830c9ed65048b8f9"><td class="memSeparator" colspan="2"> </td></tr> 107<tr class="memitem:ac85eb642d3b3973477749769e04d45af"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#ac85eb642d3b3973477749769e04d45af">FqClear</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result)</td></tr> 108<tr class="memdesc:ac85eb642d3b3973477749769e04d45af"><td class="mdescLeft"> </td><td class="mdescRight">Clear an element's value. <a href="#ac85eb642d3b3973477749769e04d45af">More...</a><br /></td></tr> 109<tr class="separator:ac85eb642d3b3973477749769e04d45af"><td class="memSeparator" colspan="2"> </td></tr> 110<tr class="memitem:ab28f9df688a669a64dc04fa33f4cbb64"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#ab28f9df688a669a64dc04fa33f4cbb64">FqSet</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, uint32_t in)</td></tr> 111<tr class="memdesc:ab28f9df688a669a64dc04fa33f4cbb64"><td class="mdescLeft"> </td><td class="mdescRight">Set an element's value. <a href="#ab28f9df688a669a64dc04fa33f4cbb64">More...</a><br /></td></tr> 112<tr class="separator:ab28f9df688a669a64dc04fa33f4cbb64"><td class="memSeparator" colspan="2"> </td></tr> 113<tr class="memitem:abd40d255e0094f7156092db44a3b90fa"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#abd40d255e0094f7156092db44a3b90fa">FqEq</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> const *left, <a class="el" href="struct_fq_elem.html">FqElem</a> const *right)</td></tr> 114<tr class="memdesc:abd40d255e0094f7156092db44a3b90fa"><td class="mdescLeft"> </td><td class="mdescRight">Test if two elements in Fq are equal. <a href="#abd40d255e0094f7156092db44a3b90fa">More...</a><br /></td></tr> 115<tr class="separator:abd40d255e0094f7156092db44a3b90fa"><td class="memSeparator" colspan="2"> </td></tr> 116<tr class="memitem:afbb0976ef343b14c66305db0a48647ca"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#afbb0976ef343b14c66305db0a48647ca">FqCondSet</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *true_val, <a class="el" href="struct_fq_elem.html">FqElem</a> const *false_val, int truth_val)</td></tr> 117<tr class="memdesc:afbb0976ef343b14c66305db0a48647ca"><td class="mdescLeft"> </td><td class="mdescRight">Conditionally Set an element's value to one of two values. <a href="#afbb0976ef343b14c66305db0a48647ca">More...</a><br /></td></tr> 118<tr class="separator:afbb0976ef343b14c66305db0a48647ca"><td class="memSeparator" colspan="2"> </td></tr> 119<tr class="memitem:a0cbded46e28a1e6f641c5c0ae37fd744"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#a0cbded46e28a1e6f641c5c0ae37fd744">FqSqrt</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="struct_fq_elem.html">FqElem</a> const *in)</td></tr> 120<tr class="memdesc:a0cbded46e28a1e6f641c5c0ae37fd744"><td class="mdescLeft"> </td><td class="mdescRight">Compute the Square root of an element of Fq. <a href="#a0cbded46e28a1e6f641c5c0ae37fd744">More...</a><br /></td></tr> 121<tr class="separator:a0cbded46e28a1e6f641c5c0ae37fd744"><td class="memSeparator" colspan="2"> </td></tr> 122<tr class="memitem:a5cc7d7d7640cd0bbcb635e95be3ed8a3"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#a5cc7d7d7640cd0bbcb635e95be3ed8a3">FqRand</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, <a class="el" href="group___epid_common.html#ga6119a2c0323a3fca9e502b24bc378c2c">BitSupplier</a> rnd_func, void *rnd_param)</td></tr> 123<tr class="memdesc:a5cc7d7d7640cd0bbcb635e95be3ed8a3"><td class="mdescLeft"> </td><td class="mdescRight">Generate a random element of Fq. <a href="#a5cc7d7d7640cd0bbcb635e95be3ed8a3">More...</a><br /></td></tr> 124<tr class="separator:a5cc7d7d7640cd0bbcb635e95be3ed8a3"><td class="memSeparator" colspan="2"> </td></tr> 125<tr class="memitem:a7794f72bcc506f8d8a60dbfae1a70ed0"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="fq_8h.html#a7794f72bcc506f8d8a60dbfae1a70ed0">FqFromHash</a> (<a class="el" href="struct_fq_elem.html">FqElem</a> *result, unsigned char const *hash, size_t len)</td></tr> 126<tr class="memdesc:a7794f72bcc506f8d8a60dbfae1a70ed0"><td class="mdescLeft"> </td><td class="mdescRight">Reinterpret a buffer as an element of Fq. <a href="#a7794f72bcc506f8d8a60dbfae1a70ed0">More...</a><br /></td></tr> 127<tr class="separator:a7794f72bcc506f8d8a60dbfae1a70ed0"><td class="memSeparator" colspan="2"> </td></tr> 128</table> 129<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> 130<div class="textblock"><p>Definition of Fq math. </p> 131</div><h2 class="groupheader">Function Documentation</h2> 132<a id="ab52f69c761454d976c3fc56a26549419"></a> 133<h2 class="memtitle"><span class="permalink"><a href="#ab52f69c761454d976c3fc56a26549419">◆ </a></span>FqAdd()</h2> 134 135<div class="memitem"> 136<div class="memproto"> 137 <table class="memname"> 138 <tr> 139 <td class="memname">void FqAdd </td> 140 <td>(</td> 141 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 142 <td class="paramname"><em>result</em>, </td> 143 </tr> 144 <tr> 145 <td class="paramkey"></td> 146 <td></td> 147 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 148 <td class="paramname"><em>left</em>, </td> 149 </tr> 150 <tr> 151 <td class="paramkey"></td> 152 <td></td> 153 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 154 <td class="paramname"><em>right</em> </td> 155 </tr> 156 <tr> 157 <td></td> 158 <td>)</td> 159 <td></td><td></td> 160 </tr> 161 </table> 162</div><div class="memdoc"> 163 164<p>Add two elements of Fq. </p> 165<dl class="params"><dt>Parameters</dt><dd> 166 <table class="params"> 167 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>of adding left and right. </td></tr> 168 <tr><td class="paramdir">[in]</td><td class="paramname">left</td><td>The first operand to be added. </td></tr> 169 <tr><td class="paramdir">[in]</td><td class="paramname">right</td><td>The second operand to be added. </td></tr> 170 </table> 171 </dd> 172</dl> 173 174</div> 175</div> 176<a id="ac85eb642d3b3973477749769e04d45af"></a> 177<h2 class="memtitle"><span class="permalink"><a href="#ac85eb642d3b3973477749769e04d45af">◆ </a></span>FqClear()</h2> 178 179<div class="memitem"> 180<div class="memproto"> 181 <table class="memname"> 182 <tr> 183 <td class="memname">void FqClear </td> 184 <td>(</td> 185 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 186 <td class="paramname"><em>result</em></td><td>)</td> 187 <td></td> 188 </tr> 189 </table> 190</div><div class="memdoc"> 191 192<p>Clear an element's value. </p> 193<dl class="params"><dt>Parameters</dt><dd> 194 <table class="params"> 195 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>element to clear. </td></tr> 196 </table> 197 </dd> 198</dl> 199 200</div> 201</div> 202<a id="afbb0976ef343b14c66305db0a48647ca"></a> 203<h2 class="memtitle"><span class="permalink"><a href="#afbb0976ef343b14c66305db0a48647ca">◆ </a></span>FqCondSet()</h2> 204 205<div class="memitem"> 206<div class="memproto"> 207 <table class="memname"> 208 <tr> 209 <td class="memname">void FqCondSet </td> 210 <td>(</td> 211 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 212 <td class="paramname"><em>result</em>, </td> 213 </tr> 214 <tr> 215 <td class="paramkey"></td> 216 <td></td> 217 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 218 <td class="paramname"><em>true_val</em>, </td> 219 </tr> 220 <tr> 221 <td class="paramkey"></td> 222 <td></td> 223 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 224 <td class="paramname"><em>false_val</em>, </td> 225 </tr> 226 <tr> 227 <td class="paramkey"></td> 228 <td></td> 229 <td class="paramtype">int </td> 230 <td class="paramname"><em>truth_val</em> </td> 231 </tr> 232 <tr> 233 <td></td> 234 <td>)</td> 235 <td></td><td></td> 236 </tr> 237 </table> 238</div><div class="memdoc"> 239 240<p>Conditionally Set an element's value to one of two values. </p> 241<dl class="params"><dt>Parameters</dt><dd> 242 <table class="params"> 243 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>target. </td></tr> 244 <tr><td class="paramdir">[in]</td><td class="paramname">true_val</td><td>value to set if condition is true. </td></tr> 245 <tr><td class="paramdir">[in]</td><td class="paramname">false_val</td><td>value to set if condition is false. </td></tr> 246 <tr><td class="paramdir">[in]</td><td class="paramname">truth_val</td><td>value of condition. </td></tr> 247 </table> 248 </dd> 249</dl> 250 251</div> 252</div> 253<a id="a17133e5b777baa8c745b7dfcf1c8ad8d"></a> 254<h2 class="memtitle"><span class="permalink"><a href="#a17133e5b777baa8c745b7dfcf1c8ad8d">◆ </a></span>FqCp()</h2> 255 256<div class="memitem"> 257<div class="memproto"> 258 <table class="memname"> 259 <tr> 260 <td class="memname">void FqCp </td> 261 <td>(</td> 262 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 263 <td class="paramname"><em>result</em>, </td> 264 </tr> 265 <tr> 266 <td class="paramkey"></td> 267 <td></td> 268 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 269 <td class="paramname"><em>in</em> </td> 270 </tr> 271 <tr> 272 <td></td> 273 <td>)</td> 274 <td></td><td></td> 275 </tr> 276 </table> 277</div><div class="memdoc"> 278 279<p>Copy an element's value. </p> 280<dl class="params"><dt>Parameters</dt><dd> 281 <table class="params"> 282 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>copy target. </td></tr> 283 <tr><td class="paramdir">[in]</td><td class="paramname">in</td><td>copy source. </td></tr> 284 </table> 285 </dd> 286</dl> 287 288</div> 289</div> 290<a id="abd40d255e0094f7156092db44a3b90fa"></a> 291<h2 class="memtitle"><span class="permalink"><a href="#abd40d255e0094f7156092db44a3b90fa">◆ </a></span>FqEq()</h2> 292 293<div class="memitem"> 294<div class="memproto"> 295 <table class="memname"> 296 <tr> 297 <td class="memname">int FqEq </td> 298 <td>(</td> 299 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 300 <td class="paramname"><em>left</em>, </td> 301 </tr> 302 <tr> 303 <td class="paramkey"></td> 304 <td></td> 305 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 306 <td class="paramname"><em>right</em> </td> 307 </tr> 308 <tr> 309 <td></td> 310 <td>)</td> 311 <td></td><td></td> 312 </tr> 313 </table> 314</div><div class="memdoc"> 315 316<p>Test if two elements in Fq are equal. </p> 317<dl class="params"><dt>Parameters</dt><dd> 318 <table class="params"> 319 <tr><td class="paramdir">[in]</td><td class="paramname">left</td><td>The first operand to be tested. </td></tr> 320 <tr><td class="paramdir">[in]</td><td class="paramname">right</td><td>The second operand to be tested. </td></tr> 321 </table> 322 </dd> 323</dl> 324<dl class="section return"><dt>Returns</dt><dd>A value different from zero (i.e., true) if indeed the values are equal. Zero (i.e., false) otherwise. </dd></dl> 325 326</div> 327</div> 328<a id="a276d3747aefdac5503982f2aa5eccbf8"></a> 329<h2 class="memtitle"><span class="permalink"><a href="#a276d3747aefdac5503982f2aa5eccbf8">◆ </a></span>FqExp()</h2> 330 331<div class="memitem"> 332<div class="memproto"> 333 <table class="memname"> 334 <tr> 335 <td class="memname">void FqExp </td> 336 <td>(</td> 337 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 338 <td class="paramname"><em>result</em>, </td> 339 </tr> 340 <tr> 341 <td class="paramkey"></td> 342 <td></td> 343 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 344 <td class="paramname"><em>base</em>, </td> 345 </tr> 346 <tr> 347 <td class="paramkey"></td> 348 <td></td> 349 <td class="paramtype"><a class="el" href="struct_very_large_int.html">VeryLargeInt</a> const * </td> 350 <td class="paramname"><em>exp</em> </td> 351 </tr> 352 <tr> 353 <td></td> 354 <td>)</td> 355 <td></td><td></td> 356 </tr> 357 </table> 358</div><div class="memdoc"> 359 360<p>Exponentiate an element of Fq by a large integer. </p> 361<dl class="params"><dt>Parameters</dt><dd> 362 <table class="params"> 363 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>target. </td></tr> 364 <tr><td class="paramdir">[in]</td><td class="paramname">base</td><td>the base. </td></tr> 365 <tr><td class="paramdir">[in]</td><td class="paramname">exp</td><td>the exponent. </td></tr> 366 </table> 367 </dd> 368</dl> 369 370</div> 371</div> 372<a id="a7794f72bcc506f8d8a60dbfae1a70ed0"></a> 373<h2 class="memtitle"><span class="permalink"><a href="#a7794f72bcc506f8d8a60dbfae1a70ed0">◆ </a></span>FqFromHash()</h2> 374 375<div class="memitem"> 376<div class="memproto"> 377 <table class="memname"> 378 <tr> 379 <td class="memname">void FqFromHash </td> 380 <td>(</td> 381 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 382 <td class="paramname"><em>result</em>, </td> 383 </tr> 384 <tr> 385 <td class="paramkey"></td> 386 <td></td> 387 <td class="paramtype">unsigned char const * </td> 388 <td class="paramname"><em>hash</em>, </td> 389 </tr> 390 <tr> 391 <td class="paramkey"></td> 392 <td></td> 393 <td class="paramtype">size_t </td> 394 <td class="paramname"><em>len</em> </td> 395 </tr> 396 <tr> 397 <td></td> 398 <td>)</td> 399 <td></td><td></td> 400 </tr> 401 </table> 402</div><div class="memdoc"> 403 404<p>Reinterpret a buffer as an element of Fq. </p> 405<dl class="params"><dt>Parameters</dt><dd> 406 <table class="params"> 407 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>target. </td></tr> 408 <tr><td class="paramdir">[in]</td><td class="paramname">hash</td><td>buffer to reinterpret. </td></tr> 409 <tr><td class="paramdir">[in]</td><td class="paramname">len</td><td>length of hash in bytes. </td></tr> 410 </table> 411 </dd> 412</dl> 413 414</div> 415</div> 416<a id="aceb37a8f5538fe9ca682058ff0e36091"></a> 417<h2 class="memtitle"><span class="permalink"><a href="#aceb37a8f5538fe9ca682058ff0e36091">◆ </a></span>FqInField()</h2> 418 419<div class="memitem"> 420<div class="memproto"> 421 <table class="memname"> 422 <tr> 423 <td class="memname">int FqInField </td> 424 <td>(</td> 425 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 426 <td class="paramname"><em>in</em></td><td>)</td> 427 <td></td> 428 </tr> 429 </table> 430</div><div class="memdoc"> 431 432<p>Test if an element is in Fq. </p> 433<dl class="params"><dt>Parameters</dt><dd> 434 <table class="params"> 435 <tr><td class="paramdir">[in]</td><td class="paramname">in</td><td>the element to test. </td></tr> 436 </table> 437 </dd> 438</dl> 439<dl class="section return"><dt>Returns</dt><dd>A value different from zero (i.e., true) indeed the value is in the field. Zero (i.e., false) otherwise. </dd></dl> 440 441</div> 442</div> 443<a id="a7b60a8996973d474d2fb7a31838c6d8c"></a> 444<h2 class="memtitle"><span class="permalink"><a href="#a7b60a8996973d474d2fb7a31838c6d8c">◆ </a></span>FqInv()</h2> 445 446<div class="memitem"> 447<div class="memproto"> 448 <table class="memname"> 449 <tr> 450 <td class="memname">void FqInv </td> 451 <td>(</td> 452 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 453 <td class="paramname"><em>result</em>, </td> 454 </tr> 455 <tr> 456 <td class="paramkey"></td> 457 <td></td> 458 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 459 <td class="paramname"><em>in</em> </td> 460 </tr> 461 <tr> 462 <td></td> 463 <td>)</td> 464 <td></td><td></td> 465 </tr> 466 </table> 467</div><div class="memdoc"> 468 469<p>Invert an element of Fq. </p> 470<dl class="params"><dt>Parameters</dt><dd> 471 <table class="params"> 472 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>the inverse of the element. </td></tr> 473 <tr><td class="paramdir">[in]</td><td class="paramname">in</td><td>the element to invert. </td></tr> 474 </table> 475 </dd> 476</dl> 477 478</div> 479</div> 480<a id="ac08ca8c781cd18cbadabbeeb85722e49"></a> 481<h2 class="memtitle"><span class="permalink"><a href="#ac08ca8c781cd18cbadabbeeb85722e49">◆ </a></span>FqIsZero()</h2> 482 483<div class="memitem"> 484<div class="memproto"> 485 <table class="memname"> 486 <tr> 487 <td class="memname">int FqIsZero </td> 488 <td>(</td> 489 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 490 <td class="paramname"><em>value</em></td><td>)</td> 491 <td></td> 492 </tr> 493 </table> 494</div><div class="memdoc"> 495 496<p>Test if an element is zero. </p> 497<dl class="params"><dt>Parameters</dt><dd> 498 <table class="params"> 499 <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>the element to test. </td></tr> 500 </table> 501 </dd> 502</dl> 503<dl class="section return"><dt>Returns</dt><dd>A value different from zero (i.e., true) if indeed the value is zero. Zero (i.e., false) otherwise. </dd></dl> 504 505</div> 506</div> 507<a id="ab0bf77a97fb3a12292886bef3abcf9bd"></a> 508<h2 class="memtitle"><span class="permalink"><a href="#ab0bf77a97fb3a12292886bef3abcf9bd">◆ </a></span>FqMul()</h2> 509 510<div class="memitem"> 511<div class="memproto"> 512 <table class="memname"> 513 <tr> 514 <td class="memname">void FqMul </td> 515 <td>(</td> 516 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 517 <td class="paramname"><em>result</em>, </td> 518 </tr> 519 <tr> 520 <td class="paramkey"></td> 521 <td></td> 522 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 523 <td class="paramname"><em>left</em>, </td> 524 </tr> 525 <tr> 526 <td class="paramkey"></td> 527 <td></td> 528 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 529 <td class="paramname"><em>right</em> </td> 530 </tr> 531 <tr> 532 <td></td> 533 <td>)</td> 534 <td></td><td></td> 535 </tr> 536 </table> 537</div><div class="memdoc"> 538 539<p>Multiply two elements of Fq. </p> 540<dl class="params"><dt>Parameters</dt><dd> 541 <table class="params"> 542 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>of multiplying left and right. </td></tr> 543 <tr><td class="paramdir">[in]</td><td class="paramname">left</td><td>The first operand to be multiplied. </td></tr> 544 <tr><td class="paramdir">[in]</td><td class="paramname">right</td><td>The second operand to be multiplied. </td></tr> 545 </table> 546 </dd> 547</dl> 548 549</div> 550</div> 551<a id="ae8379530cca959e7e36446b2979d8af4"></a> 552<h2 class="memtitle"><span class="permalink"><a href="#ae8379530cca959e7e36446b2979d8af4">◆ </a></span>FqNeg()</h2> 553 554<div class="memitem"> 555<div class="memproto"> 556 <table class="memname"> 557 <tr> 558 <td class="memname">void FqNeg </td> 559 <td>(</td> 560 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 561 <td class="paramname"><em>result</em>, </td> 562 </tr> 563 <tr> 564 <td class="paramkey"></td> 565 <td></td> 566 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 567 <td class="paramname"><em>in</em> </td> 568 </tr> 569 <tr> 570 <td></td> 571 <td>)</td> 572 <td></td><td></td> 573 </tr> 574 </table> 575</div><div class="memdoc"> 576 577<p>Negate an element of Fq. </p> 578<p>This function was formerly called as FqConst.</p> 579<dl class="params"><dt>Parameters</dt><dd> 580 <table class="params"> 581 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>the negative of the element. </td></tr> 582 <tr><td class="paramdir">[in]</td><td class="paramname">in</td><td>the element to negate. </td></tr> 583 </table> 584 </dd> 585</dl> 586 587</div> 588</div> 589<a id="a5cc7d7d7640cd0bbcb635e95be3ed8a3"></a> 590<h2 class="memtitle"><span class="permalink"><a href="#a5cc7d7d7640cd0bbcb635e95be3ed8a3">◆ </a></span>FqRand()</h2> 591 592<div class="memitem"> 593<div class="memproto"> 594 <table class="memname"> 595 <tr> 596 <td class="memname">int FqRand </td> 597 <td>(</td> 598 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 599 <td class="paramname"><em>result</em>, </td> 600 </tr> 601 <tr> 602 <td class="paramkey"></td> 603 <td></td> 604 <td class="paramtype"><a class="el" href="group___epid_common.html#ga6119a2c0323a3fca9e502b24bc378c2c">BitSupplier</a> </td> 605 <td class="paramname"><em>rnd_func</em>, </td> 606 </tr> 607 <tr> 608 <td class="paramkey"></td> 609 <td></td> 610 <td class="paramtype">void * </td> 611 <td class="paramname"><em>rnd_param</em> </td> 612 </tr> 613 <tr> 614 <td></td> 615 <td>)</td> 616 <td></td><td></td> 617 </tr> 618 </table> 619</div><div class="memdoc"> 620 621<p>Generate a random element of Fq. </p> 622<dl class="params"><dt>Parameters</dt><dd> 623 <table class="params"> 624 <tr><td class="paramdir">[in]</td><td class="paramname">result</td><td>the random value. </td></tr> 625 <tr><td class="paramdir">[in]</td><td class="paramname">rnd_func</td><td>Random number generator. </td></tr> 626 <tr><td class="paramdir">[in]</td><td class="paramname">rnd_param</td><td>Pass through context data for rnd_func. </td></tr> 627 </table> 628 </dd> 629</dl> 630<dl class="section return"><dt>Returns</dt><dd>A value different from zero (i.e., true) if on success. Zero (i.e., false) otherwise. </dd></dl> 631 632</div> 633</div> 634<a id="ab28f9df688a669a64dc04fa33f4cbb64"></a> 635<h2 class="memtitle"><span class="permalink"><a href="#ab28f9df688a669a64dc04fa33f4cbb64">◆ </a></span>FqSet()</h2> 636 637<div class="memitem"> 638<div class="memproto"> 639 <table class="memname"> 640 <tr> 641 <td class="memname">void FqSet </td> 642 <td>(</td> 643 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 644 <td class="paramname"><em>result</em>, </td> 645 </tr> 646 <tr> 647 <td class="paramkey"></td> 648 <td></td> 649 <td class="paramtype">uint32_t </td> 650 <td class="paramname"><em>in</em> </td> 651 </tr> 652 <tr> 653 <td></td> 654 <td>)</td> 655 <td></td><td></td> 656 </tr> 657 </table> 658</div><div class="memdoc"> 659 660<p>Set an element's value. </p> 661<dl class="params"><dt>Parameters</dt><dd> 662 <table class="params"> 663 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>target. </td></tr> 664 <tr><td class="paramdir">[in]</td><td class="paramname">in</td><td>value to set. </td></tr> 665 </table> 666 </dd> 667</dl> 668 669</div> 670</div> 671<a id="a0cbded46e28a1e6f641c5c0ae37fd744"></a> 672<h2 class="memtitle"><span class="permalink"><a href="#a0cbded46e28a1e6f641c5c0ae37fd744">◆ </a></span>FqSqrt()</h2> 673 674<div class="memitem"> 675<div class="memproto"> 676 <table class="memname"> 677 <tr> 678 <td class="memname">int FqSqrt </td> 679 <td>(</td> 680 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 681 <td class="paramname"><em>result</em>, </td> 682 </tr> 683 <tr> 684 <td class="paramkey"></td> 685 <td></td> 686 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 687 <td class="paramname"><em>in</em> </td> 688 </tr> 689 <tr> 690 <td></td> 691 <td>)</td> 692 <td></td><td></td> 693 </tr> 694 </table> 695</div><div class="memdoc"> 696 697<p>Compute the Square root of an element of Fq. </p> 698<dl class="params"><dt>Parameters</dt><dd> 699 <table class="params"> 700 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>the square root of the element. </td></tr> 701 <tr><td class="paramdir">[in]</td><td class="paramname">in</td><td>the element to find the square root of. </td></tr> 702 </table> 703 </dd> 704</dl> 705<dl class="section return"><dt>Returns</dt><dd>A value different from zero (i.e., true) if the square root exists. Zero (i.e., false) otherwise. </dd></dl> 706 707</div> 708</div> 709<a id="ab62c8f43f78a0c4f830c9ed65048b8f9"></a> 710<h2 class="memtitle"><span class="permalink"><a href="#ab62c8f43f78a0c4f830c9ed65048b8f9">◆ </a></span>FqSquare()</h2> 711 712<div class="memitem"> 713<div class="memproto"> 714 <table class="memname"> 715 <tr> 716 <td class="memname">void FqSquare </td> 717 <td>(</td> 718 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 719 <td class="paramname"><em>result</em>, </td> 720 </tr> 721 <tr> 722 <td class="paramkey"></td> 723 <td></td> 724 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 725 <td class="paramname"><em>in</em> </td> 726 </tr> 727 <tr> 728 <td></td> 729 <td>)</td> 730 <td></td><td></td> 731 </tr> 732 </table> 733</div><div class="memdoc"> 734 735<p>Square an element of Fq. </p> 736<dl class="params"><dt>Parameters</dt><dd> 737 <table class="params"> 738 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>the square of the element. </td></tr> 739 <tr><td class="paramdir">[in]</td><td class="paramname">in</td><td>the element to square. </td></tr> 740 </table> 741 </dd> 742</dl> 743 744</div> 745</div> 746<a id="a5148f610202ae759aafb197cb52137f1"></a> 747<h2 class="memtitle"><span class="permalink"><a href="#a5148f610202ae759aafb197cb52137f1">◆ </a></span>FqSub()</h2> 748 749<div class="memitem"> 750<div class="memproto"> 751 <table class="memname"> 752 <tr> 753 <td class="memname">void FqSub </td> 754 <td>(</td> 755 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> * </td> 756 <td class="paramname"><em>result</em>, </td> 757 </tr> 758 <tr> 759 <td class="paramkey"></td> 760 <td></td> 761 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 762 <td class="paramname"><em>left</em>, </td> 763 </tr> 764 <tr> 765 <td class="paramkey"></td> 766 <td></td> 767 <td class="paramtype"><a class="el" href="struct_fq_elem.html">FqElem</a> const * </td> 768 <td class="paramname"><em>right</em> </td> 769 </tr> 770 <tr> 771 <td></td> 772 <td>)</td> 773 <td></td><td></td> 774 </tr> 775 </table> 776</div><div class="memdoc"> 777 778<p>Subtract two elements of Fq. </p> 779<dl class="params"><dt>Parameters</dt><dd> 780 <table class="params"> 781 <tr><td class="paramdir">[out]</td><td class="paramname">result</td><td>of subtracting left from right. </td></tr> 782 <tr><td class="paramdir">[in]</td><td class="paramname">left</td><td>The operand to be subtracted from. </td></tr> 783 <tr><td class="paramdir">[in]</td><td class="paramname">right</td><td>The operand to subtract. </td></tr> 784 </table> 785 </dd> 786</dl> 787 788</div> 789</div> 790</div><!-- contents --> 791</div><!-- doc-content --> 792<!-- HTML footer for doxygen 1.8.10--> 793<!-- start footer part --> 794<div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> 795 <ul> 796 <li class="navelem"><a class="el" href="dir_12b90d9c027aaf878a834df729679a56.html">epid</a></li><li class="navelem"><a class="el" href="dir_512d3e62841a8535b716ec4cf8b9e950.html">member</a></li><li class="navelem"><a class="el" href="dir_ea12d375fc1eb79df248c0adf953af4f.html">tiny</a></li><li class="navelem"><a class="el" href="dir_5f2fc2cf41db41de2b55e03ffa7a1d16.html">math</a></li><li class="navelem"><a class="el" href="fq_8h.html">fq.h</a></li> 797 <li class="footer"> 798 © 2016-2017 Intel Corporation 799 </li> 800 </ul> 801</div> 802</body> 803</html> 804