mirror of
https://github.com/boostorg/utility.git
synced 2025-05-08 18:34:02 +00:00
76 lines
4.3 KiB
HTML
76 lines
4.3 KiB
HTML
<html>
|
||
<head>
|
||
<title>Header </title>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||
<meta name="Template" content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot">
|
||
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
|
||
<boostcompressed_pair.hpp>
|
||
</head>
|
||
<body bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#800080">
|
||
<h2><img src="../../boost.png" width="276" height="86">Header <<a href="../../boost/detail/compressed_pair.hpp">boost/compressed_pair.hpp</a>></h2>
|
||
<p>All of the contents of <boost/compressed_pair.hpp> are defined inside
|
||
namespace boost.</p>
|
||
<p>The class compressed pair is very similar to std::pair, but if either of the
|
||
template arguments are empty classes, then the "empty base-class optimisation"
|
||
is applied to compress the size of the pair.</p>
|
||
<pre>template <class T1, class T2>
|
||
class compressed_pair
|
||
{
|
||
public:
|
||
typedef T1 first_type;
|
||
typedef T2 second_type;
|
||
typedef typename call_traits<first_type>::param_type first_param_type;
|
||
typedef typename call_traits<second_type>::param_type second_param_type;
|
||
typedef typename call_traits<first_type>::reference first_reference;
|
||
typedef typename call_traits<second_type>::reference second_reference;
|
||
typedef typename call_traits<first_type>::const_reference first_const_reference;
|
||
typedef typename call_traits<second_type>::const_reference second_const_reference;
|
||
|
||
compressed_pair() : base() {}
|
||
compressed_pair(first_param_type x, second_param_type y);
|
||
explicit compressed_pair(first_param_type x);
|
||
explicit compressed_pair(second_param_type y);
|
||
|
||
compressed_pair& operator=(const compressed_pair&);
|
||
|
||
first_reference first();
|
||
first_const_reference first() const;
|
||
|
||
second_reference second();
|
||
second_const_reference second() const;
|
||
|
||
void swap(compressed_pair& y);
|
||
};</pre>
|
||
<p>The two members of the pair can be accessed using the member functions first()
|
||
and second(). Note that not all member functions can be instantiated for all
|
||
template parameter types. In particular compressed_pair can be instantiated for
|
||
reference and array types, however in these cases the range of constructors
|
||
that can be used are limited. If types T1 and T2 are the same type, then there
|
||
is only one version of the single-argument constructor, and this constructor
|
||
initialises both values in the pair to the passed value.</p>
|
||
<P>Note that if either member is a POD type, then that member is not
|
||
zero-initialized by the compressed_pair default constructor: it's up to you to
|
||
supply an initial value for these types if you want them to have a default
|
||
value.</P>
|
||
<p>Note that compressed_pair can not be instantiated if either of the template
|
||
arguments is a union type, unless there is compiler support for
|
||
boost::is_union, or if boost::is_union is specialised for the union type.</p>
|
||
<p>Finally, a word of caution for Visual C++ 6 users: if either argument is an
|
||
empty type, then assigning to that member will produce memory corruption,
|
||
unless the empty type has a "do nothing" assignment operator defined. This is
|
||
due to a bug in the way VC6 generates implicit assignment operators.</p>
|
||
<h3>Acknowledgements</h3>
|
||
<p>Based on contributions by Steve Cleary, Beman Dawes, Howard Hinnant and John
|
||
Maddock.</p>
|
||
<p>Maintained by <a href="mailto:john@johnmaddock.co.uk">John Maddock</a>, the
|
||
latest version of this file can be found at <a href="http://www.boost.org">www.boost.org</a>,
|
||
and the boost discussion list at <a href="http://www.yahoogroups.com/list/boost">www.yahoogroups.com/list/boost</a>.</p>
|
||
<hr>
|
||
<p>Revised
|
||
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->07 November 2007<!--webbot bot="Timestamp" endspan i-checksum="40338" --></p>
|
||
<p><EFBFBD> Copyright Beman Dawes, 2000.</p>
|
||
<p>Distributed under the Boost Software License, Version 1.0. See
|
||
<a href="http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</a></p>
|
||
|
||
</body>
|
||
</html> |