ceph/src/boost/libs/property_map/doc/const_assoc_property_map.html

   1 <HTML>
   2 <!--
   3      Copyright (c) Jeremy Siek, Lie-Quan Lee, and Andrew Lumsdaine 2000
   4
   5      Distributed under the Boost Software License, Version 1.0.
   6      (See accompanying file LICENSE_1_0.txt or copy at
   7      http://www.boost.org/LICENSE_1_0.txt)
   8   -->
   9 <Head>
  10 <Title>Constant Associative Property Map Adaptor</Title>
  11 <BODY BGCOLOR="#ffffff" LINK="#0000ee" TEXT="#000000" VLINK="#551a8b"
  12         ALINK="#ff0000">
  13 <IMG SRC="../../../boost.png"
  14      ALT="C++ Boost" width="277" height="86">
  15
  16 <BR Clear>
  17
  18
  19 <H2><A NAME="sec:const-associative-property-map"></A>
  20 </h2>
  21 <PRE>
  22 const_associative_property_map&lt;UniquePairAssociativeContainer&gt;
  23 </PRE>
  24
  25 <P>
  26 This property map is an adaptor that converts any type that is a model
  27 of both <a
  28 href="http://www.sgi.com/tech/stl/PairAssociativeContainer.html">Pair
  29 Associative Container</a> and <a
  30 href="http://www.sgi.com/tech/stl/UniqueAssociativeContainer.html">Unique
  31 Associative Container</a> such as <a
  32 href="http://www.sgi.com/tech/stl/Map.html"><tt>std::map</tt></a> into
  33 a constant <a href="./LvaluePropertyMap.html">Lvalue Property Map</a>.
  34 Note that the adaptor only retains a reference to the container, so
  35 the lifetime of the container must encompass the use of the adaptor.
  36 </P>
  37
  38 <h3>Example</h3>
  39
  40 <a href="../example/example1.cpp">example1.cpp</a>:
  41 <pre>
  42 <font color="#008040">#include &lt;iostream&gt;</font>
  43 <font color="#008040">#include &lt;map&gt;</font>
  44 <font color="#008040">#include &lt;string&gt;</font>
  45 <font color="#008040">#include &lt;boost/property_map/property_map.hpp&gt;</font>
  46
  47
  48 <B>template</B> &lt;<B>typename</B> ConstAddressMap&gt;
  49 <B>void</B> display(ConstAddressMap address)
  50 {
  51   <B>typedef</B> <B>typename</B> boost::property_traits&lt;ConstAddressMap&gt;::value_type
  52     value_type;
  53   <B>typedef</B> <B>typename</B> boost::property_traits&lt;ConstAddressMap&gt;::key_type key_type;
  54
  55   key_type fred = <font color="#0000FF">"Fred"</font>;
  56   key_type joe = <font color="#0000FF">"Joe"</font>;
  57
  58   value_type freds_address = get(address, fred);
  59   value_type joes_address = get(address, joe);
  60
  61   std::cout &lt;&lt; fred &lt;&lt; <font color="#0000FF">": "</font> &lt;&lt; freds_address &lt;&lt; <font color="#0000FF">"\n"</font>
  62             &lt;&lt; joe  &lt;&lt; <font color="#0000FF">": "</font> &lt;&lt; joes_address  &lt;&lt; <font color="#0000FF">"\n"</font>;
  63 }
  64
  65 <B>int</B>
  66 main()
  67 {
  68   std::map&lt;std::string, std::string&gt; name2address;
  69   boost::const_associative_property_map&lt; std::map&lt;std::string, std::string&gt; &gt;
  70     address_map(name2address);
  71
  72   name2address.insert(make_pair(std::string(<font color="#0000FF">"Fred"</font>),
  73                                 std::string(<font color="#0000FF">"710 West 13th Street"</font>)));
  74   name2address.insert(make_pair(std::string(<font color="#0000FF">"Joe"</font>),
  75                                 std::string(<font color="#0000FF">"710 West 13th Street"</font>)));
  76
  77   display(address_map);
  78
  79   <B>return</B> EXIT_SUCCESS;
  80 }
  81
  82
  83 </PRE>
  84
  85 <H3>Where Defined</H3>
  86
  87 <P>
  88 <a href="../../../boost/property_map/property_map.hpp"><TT>boost/property_map/property_map.hpp</TT></a>
  89
  90 <p>
  91 <H3>Model Of</H3>
  92
  93 <a href="./LvaluePropertyMap.html">Lvalue Property Map</a>
  94
  95 <P>
  96
  97 <H3>Template Parameters</H3>
  98
  99 <P>
 100
 101 <TABLE border>
 102 <TR>
 103 <th>Parameter</th><th>Description</th><th>Default</th>
 104 </tr>
 105
 106
 107 <TR>
 108 <TD><TT>UniquePairAssociativeContainer</TT></TD>
 109 <TD>Must be a model of both <a
 110 href="http://www.sgi.com/tech/stl/PairAssociativeContainer.html">Pair
 111 Associative Container</a> and <a
 112 href="http://www.sgi.com/tech/stl/UniqueAssociativeContainer.html">Unique
 113 Associative Container</a> .</TD>
 114 <TD>&nbsp;</td>
 115 </tr>
 116
 117 </TABLE>
 118 <P>
 119
 120 <H3>Members</H3>
 121
 122 <P>
 123 In addition to the methods and functions required by <a
 124 href="./LvaluePropertyMap.html">Lvalue Property Map</a>, this
 125 class has the following members.
 126
 127 <hr>
 128
 129 <pre>
 130 property_traits&lt;const_associative_property_map&gt;::value_type
 131 </pre>
 132 This is the same type as
 133 <TT>UniquePairAssociativeContainer::data_type</TT>.
 134
 135 <hr>
 136
 137 <pre>
 138 const_associative_property_map()
 139 </pre>
 140 Default Constructor.
 141
 142 <pre>
 143 const_associative_property_map(const UniquePairAssociativeContainer&amp; c)
 144 </pre>
 145 Constructor.
 146
 147 <hr>
 148
 149 <pre>
 150 const data_type&amp; operator[](const key_type&amp; k) const
 151 </pre>
 152 The operator bracket for property access.
 153 The <TT>key_type</TT> and
 154 <TT>data_type</TT> types are from the typedefs inside of
 155 <TT>UniquePairAssociativeContainer</TT>.
 156
 157 <hr>
 158
 159 <h3>Non-Member functions</h3>
 160
 161 <hr>
 162
 163 <pre>
 164   template &lt;typename UniquePairAssociativeContainer&gt;
 165   const_associative_property_map&lt;UniquePairAssociativeContainer&gt;
 166   make_assoc_property_map(const UniquePairAssociativeContainer&amp; c);
 167 </pre>
 168 A function for conveniently creating an associative property map.
 169
 170
 171
 172 <hr>
 173
 174
 175 <br>
 176 <HR>
 177 <TABLE>
 178 <TR valign=top>
 179 <TD nowrap>Copyright &copy 2002</TD><TD>
 180 <a HREF="http://www.boost.org/people/jeremy_siek.htm">Jeremy Siek</a>,
 181 Indiana University (<A
 182 HREF="mailto:jsiek@osl.iu.edu">jsiek@osl.iu.edu</A>)<br>
 183 <A HREF="http://www.boost.org/people/liequan_lee.htm">Lie-Quan Lee</A>, Indiana University (<A HREF="mailto:llee1@osl.iu.edu">llee1@osl.iu.edu</A>)<br>
 184 <A HREF="http://www.osl.iu.edu/~lums">Andrew Lumsdaine</A>,
 185 Indiana University (<A
 186 HREF="mailto:lums@osl.iu.edu">lums@osl.iu.edu</A>)
 187 </TD></TR></TABLE>
 188
 189 </BODY>
 190 </HTML>