📄 pair.html
字号:
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="Author" CONTENT="Zafir Anjum">
<TITLE>MFC Programmer's SourceBook : STL Programmer's Guide</TITLE>
<META name="description"
content="A freely available implementation
of the C++ Standard Template Library, including
hypertext documentation.">
<META name="keywords"
content="generic programming, STL, standard template library">
</HEAD>
<SCRIPT LANGUAGE="JavaScript"><!--
var adcategory = "cpp";
// -->
</SCRIPT>
<body background="../../fancyhome/back.gif" bgcolor="#FFFFFF" >
<SCRIPT LANGUAGE="JavaScript"><!--
var nfrm = location.href.indexOf("_nfrm_");
var validframes = (top.frames.length > 0 && top.frames['ad'] && top.frames['logo'] );
var random = Math.random();
if( !validframes && nfrm == -1 )
{
var dclkPage = "www.codeguru.com/";
if( self.adcategory )
dclkPage += adcategory;
else
dclkPage += "mfc";
document.write('<nolayer><center>');
document.write('<iframe src="http://ad.doubleclick.net/adi/' + dclkPage + ';ord='
+ random + '" width=470 height=62 marginwidth=0 marginheight=0 hspace=0 vspace=0 '
+ 'frameborder=0 scrolling=no bordercolor="#000000">');
document.write('<a href="http://ad.doubleclick.net/jump/' + dclkPage + ';ord='
+ random + '">');
document.write('<img src="http://ad.doubleclick.net/ad/' + dclkPage + ';ord='
+ random + '" height=60 width=468>' + '</a>');
document.write('</iframe>');
document.write('</center></nolayer>');
document.write('<layer src="http://ad.doubleclick.net/adl/' + dclkPage +
';ord=' + random + '"></layer>');
document.write('<ilayer visibility=hide width=468 height=83></ilayer>');
}
// top.location = "/show.cgi?" + adcategory + "=" + location.pathname;
// -->
</SCRIPT>
<noscript>
<p align="center">
<a href="http://ad.doubleclick.net/jump/www.codeguru.com/cpp;ord=Nupb8tFCY34AAHr-XPw">
<img src="http://ad.doubleclick.net/ad/www.codeguru.com/cpp;ord=Nupb8tFCY34AAHr-XPw"></a>
</p>
</noscript>
<BR Clear>
<H1>pair<T1, T2></H1>
<Table CellPadding=0 CellSpacing=0 width=100%>
<TR>
<TD Align=left><Img src = "utilities.gif" Alt="" WIDTH = "194" HEIGHT = "38" ></TD>
<TD Align=right><Img src = "type.gif" Alt="" WIDTH = "194" HEIGHT = "39" ></TD>
</TR>
<TR>
<TD Align=left VAlign=top><b>Category</b>: utilities</TD>
<TD Align=right VAlign=top><b>Component type</b>: type</TD>
</TR>
</Table>
<h3>Description</h3>
<tt>Pair<T1,T2></tt> is a heterogeneous pair: it holds one object of type
<tt>T1</tt> and one of type <tt>T2</tt>. A pair is much like a <A href="Container.html">Container</A>,
in that it "owns" its elements. It is not actually a model of
<A href="Container.html">Container</A>, though, because it does not support the standard
methods (such as <A href="Iterators.html">iterators</A>) for accessing the elements of a
<A href="Container.html">Container</A>.
<P>
Functions that need to return two values often return a <tt>pair</tt>.
<h3>Example</h3>
<pre>
pair<bool, double> result = do_a_calculation();
if (result.first)
do_something_more(result.second);
else
report_error();
</pre>
<h3>Definition</h3>
Defined in <A href="pair.h">pair.h</A>
<h3>Template parameters</h3>
<Table border>
<TR>
<TH>
Parameter
</TH>
<TH>
Description
</TH>
<TH>
Default
</TH>
</TR>
<TR>
<TD VAlign=top>
<tt>T1</tt>
</TD>
<TD VAlign=top>
The type of the first element stored in the <tt>pair</tt>
</TD>
<TD VAlign=top>
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>T2</tt>
</TD>
<TD VAlign=top>
The type of the second element stored in the <tt>pair</tt>
</TD>
<TD VAlign=top>
</TD>
</tr>
</table>
<h3>Model of</h3>
<A href="Assignable.html">Assignable</A>
<h3>Type requirements</h3>
<tt>T1</tt> and <tt>T2</tt> must both be models of <A href="Assignable.html">Assignable</A>. Additional operations
have additional requirements. <tt>Pair</tt>'s default constructor may only
be used if both <tt>T1</tt> and <tt>T2</tt> are <A href="DefaultConstructible.html">DefaultConstructible</A>,
<tt>operator==</tt> may only be used if both <tt>T1</tt> and <tt>T2</tt> are
<A href="EqualityComparable.html">EqualityComparable</A>, and <tt>operator<</tt> may only be used if both
<tt>T1</tt> and <tt>T2</tt> are <A href="LessThanComparable.html">LessThanComparable</A>.
<h3>Public base classes</h3>
None.
<h3>Members</h3>
<Table border>
<TR>
<TH>
Member
</TH>
<TH>
Where defined
</TH>
<TH>
Description
</TH>
</TR>
<TR>
<TD VAlign=top>
<tt>first_type</tt>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>second_type</tt>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>pair()</tt>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
The default constructor. See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>pair(const first_type&, const second_type&)</tt>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
The pair constructor. See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>pair(const pair&)</tt>
</TD>
<TD VAlign=top>
<A href="Assignable.html">Assignable</A>
</TD>
<TD VAlign=top>
The copy constructor
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>pair& operator=(const pair&)</tt>
</TD>
<TD VAlign=top>
<A href="Assignable.html">Assignable</A>
</TD>
<TD VAlign=top>
The assignment operator
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>first</tt>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>second</tt>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>bool operator==(const pair&, const pair&)</tt>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>bool operator<(const pair&, const pair&)</tt>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
template <class T1, class T2>
pair<T1, T2> make_pair(const T1&, const T2&)
</pre>
</TD>
<TD VAlign=top>
<tt>pair</tt>
</TD>
<TD VAlign=top>
See below.
</TD>
</tr>
</table>
<h3>New members</h3>
These members are not defined
in the <A href="Assignable.html">Assignable</A> requirements,
but are specific to <tt>pair</tt>.
<Table border>
<TR>
<TH>
Member
</TH>
<TH>
Description
</TH>
</TR>
<TR>
<TD VAlign=top>
<tt>first_type</tt>
</TD>
<TD VAlign=top>
The type of the pair's first component. This is a <tt>typedef</tt> for
the template parameter <tt>T1</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>second_type</tt>
</TD>
<TD VAlign=top>
The type of the pair's second component. This is a <tt>typedef</tt> for
the template parameter <tt>T2</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>pair()</tt>
</TD>
<TD VAlign=top>
The default constructor. It uses constructs objects of types
<tt>T1</tt> and <tt>T2</tt> using their default constructors. This constructor
may only be used if both <tt>T1</tt> and <tt>T2</tt> are <A href="DefaultConstructible.html">DefaultConstructible</A>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>pair(const first_type& x, const second_type& y)</tt>
</TD>
<TD VAlign=top>
The pair constructor. Constructs a pair such that <tt>first</tt> is constructed
from <tt>x</tt> and <tt>second</tt> is constructed from <tt>y</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>first</tt>
</TD>
<TD VAlign=top>
Public member variable of type <tt>first_type</tt>: the first object stored in the <tt>pair</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>second</tt>
</TD>
<TD VAlign=top>
Public member variable of type <tt>second_type</tt>: The second object stored in the <tt>pair</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
template <class T1, class T2>
bool operator==(const pair<T1,T2>& x,
const pair<T1,T2>& y);
</pre>
</TD>
<TD VAlign=top>
The equality operator. The return value is <tt>true</tt> if and only
the first elements of <tt>x</tt> and <tt>y</tt> are equal, and the second
elements of <tt>x</tt> and <tt>y</tt> are equal. This operator may only
be used if both <tt>T1</tt> and <tt>T2</tt> are <A href="EqualityComparable.html">EqualityComparable</A>.
This is a global function, not a member function.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
template <class T1, class T2>
bool operator<(const pair<T1,T2>& x,
const pair<T1,T2>& y);
</pre>
</TD>
<TD VAlign=top>
The comparison operator. It uses lexicographic comparison:
the return value is <tt>true</tt> if the
first element of <tt>x</tt> is less than the first element of <tt>y</tt>,
and <tt>false</tt> if the first element of <tt>y</tt> is less than the first
element of <tt>x</tt>. If neither of these is the case, then
<tt>operator<</tt> returns the result of comparing the second elements
of <tt>x</tt> and <tt>y</tt>. This operator may only
be used if both <tt>T1</tt> and <tt>T2</tt> are <A href="LessThanComparable.html">LessThanComparable</A>.
This is a global function, not a member function.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
template <class T1, class T2>
pair<T1, T2> make_pair(const T1& x, const T2& x)
</pre>
</TD>
<TD VAlign=top>
Equivalent to <tt>pair<T1, T2>(x, y)</tt>.
This is a global function, not a member function.
It exists only for the sake of convenience.
</TD>
</tr>
</table>
<h3>Notes</h3>
<h3>See also</h3>
<A href="Assignable.html">Assignable</A>, <A href="DefaultConstructible.html" tppabs="http://www.sgi.com/Technology/STL/DefaultConstructible.shtml">Default Constructible</A>, <A href="LessThanComparable.html" tppabs="http://www.sgi.com/Technology/STL/LessThanComparable.shtml">LessThan Comparable</A>
<HR SIZE="6"> <FONT SIZE="-2"> Copyright © 1996 Silicon Graphics, Inc.
<HR>
<TABLE BORDER=0 WIDTH="100%" >
<TR>
<TD WIDTH="33%"><FONT SIZE=-1><A HREF="index.html" >
STL</A></FONT></TD>
<TD WIDTH="33%">
<CENTER><FONT SIZE=-2>© Copyright 1997-1998 CodeGuru</FONT> </CENTER>
</TD>
<TD WIDTH="34%">
<DIV ALIGN=right><FONT SIZE=-1>Contact : <A HREF="mailto:webmaster@codeguru.com">webmaster@codeguru.com</A> </FONT></DIV>
</TD>
</TR>
</TABLE>
<SCRIPT LANGUAGE="JavaScript" ><!--
var adurl = "/cgi-bin/doubleclick.cgi?";
if( self.adcategory )
adurl += adcategory;
else
adurl += "mfc";
if( self.parent.norefreshad )
parent.norefreshad = false;
else if( validframes )
parent.frames['ad'].location = adurl;
if( !validframes && nfrm == -1)
{
var dclkPage = "www.codeguru.com/";
if( self.adcategory )
dclkPage += adcategory;
else
dclkPage += "mfc";
// var random = Math.random();
document.write('<nolayer><center>');
document.write('<iframe src="http://ad.doubleclick.net/adi/' + dclkPage + ';ord='
+ random + '" width=470 height=62 marginwidth=0 marginheight=0 hspace=0 vspace=0 '
+ 'frameborder=0 scrolling=no bordercolor="#000000">');
document.write('<a href="http://ad.doubleclick.net/jump/' + dclkPage + ';ord='
+ random + '">');
document.write('<img src="http://ad.doubleclick.net/ad/' + dclkPage + ';ord='
+ random + '" height=60 width=468>' + '</a>');
document.write('</iframe>');
document.write('</center></nolayer>');
document.write('<layer src="http://ad.doubleclick.net/adl/' + dclkPage +
';ord=' + random + '"></layer>');
document.write('<ilayer visibility=hide width=468 height=83></ilayer>');
}
// -->
</SCRIPT>
<!-- SCRIPT LANGUAGE="JavaScript" SRC="/global/fscript.js">
//
</SCRIPT -->
<noscript>
<p align="center">
<a href="http://ad.doubleclick.net/jump/www.codeguru.com/cpp;ord=Nupb8tFCY34AAHr-XPw">
<img src="http://ad.doubleclick.net/ad/www.codeguru.com/cpp;ord=Nupb8tFCY34AAHr-XPw"></a>
</p>
</noscript>
</BODY>
</HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -