boost/more
1
0
Fork 0
mirror of https://github.com/boostorg/more.git synced 2025-03-27 13:50:14 +08:00
Code Issues Packages Projects Releases Wiki Activity

remove std_min and std_max, update minmax coding guidelines

Browse Source 
[SVN r23162]
This commit is contained in:
Eric Niebler 2004-06-23 04:49:48 +00:00
parent 440fbf0e16
commit a9422b863d
1 changed files with 14 additions and 7 deletions

21
lib_guide.htm
View File

@ -305,12 +305,19 @@
If you want to call <code>std::min()</code> or <code>std::max()</code>:<br>&nbsp;
<ul>
<li>
Use <code>(std::min)(a,b)</code> if you do not require argument-dependent
look-up.</li>&nbsp;
If you do not require argument-dependent look-up, use <code>(std::min)(a,b)</code>.
</li>&nbsp;
<li>
Use <code>boost::std_min(a,b)</code> if you do require argument-dependent look-up.
<code>boost::std_min()</code> delegates to <code>std::min()</code>.</li>&nbsp;
</ul>
If you do require argument-dependent look-up, you should:<br>&nbsp;
<ul>
<li><code>#include &lt;boost/minmax.hpp&gt;</code></li>&nbsp;
<li>Use <code>BOOST_USING_STD_MIN();</code> to bring <code>std::min()</code> into
the current scope.</li>&nbsp;
<li>Use <code>min BOOST_PREVENT_MACRO_SUBSTITUTION (a,b);</code> to make an
argument-dependent call to <code>min(a,b)</code>.</li>&nbsp;
</ul>
</li>
</ul>&nbsp;
</li>
<li>
If you want to call <code>std::numeric_limits&lt;int&gt;::max()</code>, use
@ -324,7 +331,7 @@
If you want to declare or define a function or a member function named <code>min</code>
or <code>max</code>, then you must use the <code>BOOST_PREVENT_MACRO_SUBSTITUTION</code>
macro. Instead of writing <code>int min() { return 0; }</code> you should write
<code>int min BOOST_PREVENT_MACRO_SUBSTITUTION () { return 0; }</code>This is true
<code>int min BOOST_PREVENT_MACRO_SUBSTITUTION () { return 0; }</code> This is true
regardless if the function is a free (namespace scope) function, a member function or a
static member function, and it applies for the function declaration as well as the
function definition.<br>&nbsp;
@ -369,7 +376,7 @@
<td>If any build files.</td>
</tr>
<tr>
<td>doc</td>
<td><code>doc</code></td>
<td>Documentation (HTML) files.</td>
<td>If several doc files.</td>
</tr>