]> git.proxmox.com Git - ceph.git/blame - ceph/src/boost/libs/preprocessor/doc/ref/sub.html
bump version to 12.2.2-pve1
[ceph.git] / ceph / src / boost / libs / preprocessor / doc / ref / sub.html
CommitLineData
7c673cae
FG
1<html>
2<head>
3 <title>BOOST_PP_SUB</title>
4 <link rel="stylesheet" type="text/css" href="../styles.css">
5</head>
6<body>
7 <div style="margin-left: 0px;">
8 The <b>BOOST_PP_SUB</b> macro expands to the difference between its arguments.
9 </div>
10 <h4>Usage</h4>
11 <div class="code">
12 <b>BOOST_PP_SUB</b>(<i>x</i>, <i>y</i>)
13 </div>
14 <h4>Arguments</h4>
15 <dl>
16 <dt>x</dt>
17 <dd>
18 The minuend of the operation.&nbsp;
19 Valid values range from <i>0</i> to <b>BOOST_PP_LIMIT_MAG</b>.
20 </dd>
21 <dt>y</dt>
22 <dd>
23 The subtrahend of the operation.&nbsp;
24 Valid values range from <i>0</i> to <b>BOOST_PP_LIMIT_MAG</b>.
25 </dd>
26 </dl>
27 <h4>Remarks</h4>
28 <div>
29 If the difference between <i>x</i> and <i>y</i> is less than <i>0</i>, the result is saturated to <i>0</i>.
30 </div>
31 <div>
32 Previously, this macro could not be used inside <b>BOOST_PP_WHILE</b>.&nbsp;
33 There is no longer any such restriction.&nbsp;
34 It is more efficient, however, to use <b>BOOST_PP_SUB_D</b> in such a situation.
35 </div>
36 <h4>See Also</h4>
37 <ul>
38 <li><a href="limit_mag.html">BOOST_PP_LIMIT_MAG</a></li>
39 <li><a href="sub_d.html">BOOST_PP_SUB_D</a></li>
40 </ul>
41 <h4>Requirements</h4>
42 <div>
43 <b>Header:</b> &nbsp;<a href="../headers/arithmetic/sub.html">&lt;boost/preprocessor/arithmetic/sub.hpp&gt;</a>
44 </div>
45 <h4>Sample Code</h4>
46<div><pre>
47#include &lt;<a href="../headers/arithmetic/sub.html">boost/preprocessor/arithmetic/sub.hpp</a>&gt;
48
49<a href="sub.html">BOOST_PP_SUB</a>(4, 3) // expands to 1
50</pre></div>
51 <hr size="1">
52 <div style="margin-left: 0px;">
53