1 <html><head><meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8"><title>Pairs
</title><meta name=
"generator" content=
"DocBook XSL-NS Stylesheets V1.76.1"><meta name=
"keywords" content=
"
5 "><meta name=
"keywords" content=
"
11 "><link rel=
"home" href=
"../index.html" title=
"The GNU C++ Library"><link rel=
"up" href=
"utilities.html" title=
"Chapter 6. Utilities"><link rel=
"prev" href=
"utilities.html" title=
"Chapter 6. Utilities"><link rel=
"next" href=
"memory.html" title=
"Memory"></head><body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF"><div class=
"navheader"><table width=
"100%" summary=
"Navigation header"><tr><th colspan=
"3" align=
"center">Pairs
</th></tr><tr><td width=
"20%" align=
"left"><a accesskey=
"p" href=
"utilities.html">Prev
</a> </td><th width=
"60%" align=
"center">Chapter
6.
14 </th><td width=
"20%" align=
"right"> <a accesskey=
"n" href=
"memory.html">Next
</a></td></tr></table><hr></div><div class=
"section" title=
"Pairs"><div class=
"titlepage"><div><div><h2 class=
"title" style=
"clear: both"><a name=
"std.util.pairs"></a>Pairs
</h2></div></div></div><p>The
<code class=
"code">pair
<T1,T2
></code> is a simple and handy way to
15 carry around a pair of objects. One is of type T1, and another of
16 type T2; they may be the same type, but you don't get anything
17 extra if they are. The two members can be accessed directly, as
18 <code class=
"code">.first
</code> and
<code class=
"code">.second
</code>.
19 </p><p>Construction is simple. The default ctor initializes each member
20 with its respective default ctor. The other simple ctor,
21 </p><pre class=
"programlisting">
22 pair (const T1
& x, const T2
& y);
23 </pre><p>does what you think it does,
<code class=
"code">first
</code> getting
<code class=
"code">x
</code>
24 and
<code class=
"code">second
</code> getting
<code class=
"code">y
</code>.
25 </p><p>There is a constructor template for copying pairs of other types:
26 </p><pre class=
"programlisting">
27 template
<class U, class V
> pair (const pair
<U,V
>& p);
28 </pre><p>The compiler will convert as necessary from U to T1 and from
29 V to T2 in order to perform the respective initializations.
30 </p><p>The comparison operators are done for you. Equality
31 of two
<code class=
"code">pair
<T1,T2
></code>s is defined as both
<code class=
"code">first
</code>
32 members comparing equal and both
<code class=
"code">second
</code> members comparing
33 equal; this simply delegates responsibility to the respective
34 <code class=
"code">operator==
</code> functions (for types like MyClass) or builtin
35 comparisons (for types like int, char, etc).
37 The less-than operator is a bit odd the first time you see it. It
38 is defined as evaluating to:
39 </p><pre class=
"programlisting">
40 x.first
< y.first ||
41 ( !(y.first
< x.first)
&& x.second
< y.second )
42 </pre><p>The other operators are not defined using the
<code class=
"code">rel_ops
</code>
43 functions above, but their semantics are the same.
44 </p><p>Finally, there is a template function called
<code class=
"function">make_pair
</code>
45 that takes two references-to-const objects and returns an
46 instance of a pair instantiated on their respective types:
47 </p><pre class=
"programlisting">
48 pair
<int,MyClass
> p = make_pair(
4,myobject);
49 </pre></div><div class=
"navfooter"><hr><table width=
"100%" summary=
"Navigation footer"><tr><td width=
"40%" align=
"left"><a accesskey=
"p" href=
"utilities.html">Prev
</a> </td><td width=
"20%" align=
"center"><a accesskey=
"u" href=
"utilities.html">Up
</a></td><td width=
"40%" align=
"right"> <a accesskey=
"n" href=
"memory.html">Next
</a></td></tr><tr><td width=
"40%" align=
"left" valign=
"top">Chapter
6.
52 </td><td width=
"20%" align=
"center"><a accesskey=
"h" href=
"../index.html">Home
</a></td><td width=
"40%" align=
"right" valign=
"top"> Memory
</td></tr></table></div></body></html>