<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>
end [C++ Reference]
</title>
<meta name="generator" content="DokuWiki Release 2009-12-25c "Lemming"" />
<meta name="robots" content="index,follow" />
<meta name="date" content="2008-10-14T15:42:07-0700" />
<meta name="keywords" content="stl,set,end" />
<link rel="search" type="application/opensearchdescription+xml" href="/wiki/lib/exe/opensearch.php" title="C++ Reference" />
<link rel="start" href="/wiki/" />
<link rel="contents" href="/wiki/stl/set/end?do=index" title="Index" />
<link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/wiki/feed.php" />
<link rel="alternate" type="application/rss+xml" title="Current Namespace" href="/wiki/feed.php?mode=list&ns=stl:set" />
<link rel="edit" title="Edit this page" href="/wiki/stl/set/end?do=edit" />
<link rel="alternate" type="text/html" title="Plain HTML" href="/wiki/_export/xhtml/stl/set/end" />
<link rel="alternate" type="text/plain" title="Wiki Markup" href="/wiki/_export/raw/stl/set/end" />
<link rel="canonical" href="http://www.cppreference.com/wiki/stl/set/end" />
<link rel="stylesheet" media="all" type="text/css" href="/wiki/lib/exe/css.php?s=all&t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="screen" type="text/css" href="/wiki/lib/exe/css.php?t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="print" type="text/css" href="/wiki/lib/exe/css.php?s=print&t=custom1&tseed=1272971091" />
<script type="text/javascript" charset="utf-8" ><!--//--><![CDATA[//><!--
var NS='stl:set';var JSINFO = {"id":"stl:set:end","namespace":"stl:set"};
//--><!]]></script>
<script type="text/javascript" charset="utf-8" src="/wiki/lib/exe/js.php?tseed=1272971091" ></script>
<link rel="shortcut icon" href="/wiki/lib/tpl/custom1/images/favicon.png" />
</head>
<body>
<div class="dokuwiki">
<div class="stylehead">
<div class="breadcrumbs">
<span class="bchead">You are here: </span><a href="../../start.html" title="start">C++ Reference</a> » <a href="../../stl/start.html" title="stl:start">C++ Standard Template Library</a> » <a href="../../stl/set/start.html" title="stl:set:start">C++ Sets</a> » <a href="../../stl/set/end.html" title="stl:set:end">end</a> </div>
</div>
<div class="page">
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-2828341-1";
urchinTracker();
</script>
<!-- wikipage start -->
<h2><a name="end" id="end">end</a></h2>
<div class="level2">
<p>
Syntax:
</p>
<pre class="c code c++" style="font-family:monospace;"> <span class="co2">#include <set></span>
iterator end<span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>
const_iterator end<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span><span class="sy0">;</span></pre>
<p>
The end() function returns an iterator just past the end of the set.
Note that before you can access the last element of the set using an iterator
that you get from a call to end(), you'll have to decrement the iterator first.
</p>
<p>
For example, the following code uses end() to display the set in reverse order:
</p>
<pre class="c code c++" style="font-family:monospace;"> <span class="co1">// Create a set of characters</span>
set<span class="sy0"><</span>char<span class="sy0">></span> charSet<span class="sy0">;</span>
<span class="kw4">const</span> <span class="kw4">char</span><span class="sy0">*</span> s <span class="sy0">=</span> <span class="st0">"Hello There"</span><span class="sy0">;</span>
<span class="kw1">for</span><span class="br0">(</span> <span class="kw4">int</span> i<span class="sy0">=</span><span class="nu0">0</span><span class="sy0">;</span> i <span class="sy0"><</span> strlen<span class="br0">(</span>s<span class="br0">)</span><span class="sy0">;</span> i<span class="sy0">++</span> <span class="br0">)</span> <span class="br0">{</span>
charSet.<span class="me1">insert</span><span class="br0">(</span> s<span class="br0">[</span>i<span class="br0">]</span> <span class="br0">)</span><span class="sy0">;</span>
<span class="br0">}</span>
<span class="co1">// Display the last element of the set</span>
set<span class="sy0"><</span>char<span class="sy0">>::</span><span class="me2">iterator</span> theIterator <span class="sy0">=</span> charSet.<span class="me1">end</span><span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span>
<span class="kw1">for</span><span class="br0">(</span> theIterator <span class="sy0">=</span> charSet.<span class="me1">end</span><span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span> theIterator <span class="sy0">!=</span> charSet.<span class="me1">begin</span><span class="br0">(</span><span class="br0">)</span><span class="sy0">;</span> <span class="br0">)</span> <span class="br0">{</span>
theIterator<span class="sy0">--;</span>
<a href="http://www.opengroup.org/onlinepubs/009695399/functions/cout.html"><span class="kw3">cout</span></a> <span class="sy0"><<</span> <span class="sy0">*</span>theIterator<span class="sy0">;</span>
<span class="br0">}</span>
<span class="co1">// output is "rolheTH "</span></pre>
<p>
Related Topics: <a href="../../stl/set/begin.html" class="wikilink1" title="stl:set:begin">begin</a>, <a href="../../stl/set/rbegin.html" class="wikilink1" title="stl:set:rbegin">rbegin</a>, <a href="../../stl/set/rend.html" class="wikilink1" title="stl:set:rend">rend</a>
</p>
</div>
<!-- wikipage stop -->
</div>
<div class="clearer"> </div>
<div class="stylefoot">
<div class="meta">
<div class="user">
</div>
<!--
<div class="doc">
stl/set/end.txt · Last modified: 10/14/2008 15:42 (external edit) </div>
-->
</div>
</div></div></body>
</html>