Subject: [Boost-commit] svn:boost r48640 - trunk/libs/utility
From: rivorus_at_[hidden]
Date: 2008-09-06 17:49:50
Author: matt_calabrese
Date: 2008-09-06 17:49:49 EDT (Sat, 06 Sep 2008)
New Revision: 48640
URL: http://svn.boost.org/trac/boost/changeset/48640
Log:
Changed wording for BOOST_BINARY docs.
Text files modified:
trunk/libs/utility/utility.htm | 25 ++++++++++++++++---------
1 files changed, 16 insertions(+), 9 deletions(-)
Modified: trunk/libs/utility/utility.htm
==============================================================================
--- trunk/libs/utility/utility.htm (original)
+++ trunk/libs/utility/utility.htm 2008-09-06 17:49:49 EDT (Sat, 06 Sep 2008)
@@ -187,10 +187,10 @@
<p>See separate documentation.</p>
<h2><a name="BOOST_BINARY">Macro BOOST_BINARY</a></h2>
- <p>The macro <code>BOOST_BINARY</code> allows for the
+ <p>The macro <code>BOOST_BINARY</code> is used for the
representation of binary literals. It takes as an argument
a binary number arranged as an arbitrary amount of 1s and 0s in
- groupings of length 1 to 8 inclusive, with groups separated
+ groupings of length 1 to 8, with groups separated
by spaces. The type of the literal yielded is determined by
the same rules as those of hex and octal
literals (<i>2.13.1p1</i>). By implementation, this macro
@@ -201,17 +201,19 @@
<p>In order to directly support binary literals with suffixes,
additional macros of the form BOOST_BINARY_XXX are also
provided, where XXX is a standard integer suffix in all capital
- letters. LL and ULL are also provided for representing long long
- and unsigned long long types in compilers which provide them as
- an extension.</p>
+ letters. In addition, LL and ULL suffixes may be for representing
+ long long and unsigned long long types in compilers which provide
+ them as an extension.</p>
- <p>The BOOST_BINARY family of macros reside in the header
+ <p>The BOOST_BINARY family of macros resides in the header
<a
href="../../boost/utility/binary.hpp"><boost/utility/binary.hpp></a>
which is automatically included by
<a
- href="../../boost/utility.hpp"><boost/utility.hpp></a>.
+ href="../../boost/utility.hpp"><boost/utility.hpp></a> and
+ <a
+ href="../../boost/binary.hpp"><boost/binary.hpp></a>..
<p>Contributed by Matt Calabrese.</p><p>
</p><h3>Example</h3>
@@ -227,11 +229,16 @@
unsigned long value2 = BOOST_BINARY_UL( 100 001 ); // unsigned long
+ long long value3 = BOOST_BINARY_LL( 11 000 ); // long long if supported
+
+ assert( BOOST_BINARY( 10010 )
+ & BOOST_BINARY( 11000 )
+ == BOOST_BINARY( 10000 )
+ );
+
foo( BOOST_BINARY( 1010 ) ); // calls the first foo
foo( BOOST_BINARY_LU( 1010 ) ); // calls the second foo
-
- long long value4 = BOOST_BINARY_LL( 11 000 ); // long long if supported
}
</pre></blockquote>
<hr>