<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> <title>stl_extensions.h Source File</title> <link href="doxygen.css" rel="stylesheet" type="text/css"> <link href="tabs.css" rel="stylesheet" type="text/css"> </head><body> <div align="left"><a href="http://www.mrpt.org/">Main MRPT website</a> > <b>C++ reference</b> </div> <div align="right"> <a href="index.html"><img border="0" src="mrpt_logo.png" alt="MRPT logo"></a> </div> <!-- Generated by Doxygen 1.7.5 --> <script type="text/javascript"> var searchBox = new SearchBox("searchBox", "search",false,'Search'); </script> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li><a href="annotated.html"><span>Classes</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> <li> <div id="MSearchBox" class="MSearchBoxInactive"> <div class="left"> <form id="FSearchBox" action="search.php" method="get"> <img id="MSearchSelect" src="search/mag.png" alt=""/> <input type="text" id="MSearchField" name="query" value="Search" size="20" accesskey="S" onfocus="searchBox.OnSearchFieldFocus(true)" onblur="searchBox.OnSearchFieldFocus(false)"/> </form> </div><div class="right"></div> </div> </li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>File Members</span></a></li> </ul> </div> <div class="header"> <div class="headertitle"> <div class="title">stl_extensions.h</div> </div> </div> <div class="contents"> <a href="stl__extensions_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* +---------------------------------------------------------------------------+</span> <a name="l00002"></a>00002 <span class="comment"> | The Mobile Robot Programming Toolkit (MRPT) C++ library |</span> <a name="l00003"></a>00003 <span class="comment"> | |</span> <a name="l00004"></a>00004 <span class="comment"> | http://www.mrpt.org/ |</span> <a name="l00005"></a>00005 <span class="comment"> | |</span> <a name="l00006"></a>00006 <span class="comment"> | Copyright (C) 2005-2011 University of Malaga |</span> <a name="l00007"></a>00007 <span class="comment"> | |</span> <a name="l00008"></a>00008 <span class="comment"> | This software was written by the Machine Perception and Intelligent |</span> <a name="l00009"></a>00009 <span class="comment"> | Robotics Lab, University of Malaga (Spain). |</span> <a name="l00010"></a>00010 <span class="comment"> | Contact: Jose-Luis Blanco <jlblanco@ctima.uma.es> |</span> <a name="l00011"></a>00011 <span class="comment"> | |</span> <a name="l00012"></a>00012 <span class="comment"> | This file is part of the MRPT project. |</span> <a name="l00013"></a>00013 <span class="comment"> | |</span> <a name="l00014"></a>00014 <span class="comment"> | MRPT is free software: you can redistribute it and/or modify |</span> <a name="l00015"></a>00015 <span class="comment"> | it under the terms of the GNU General Public License as published by |</span> <a name="l00016"></a>00016 <span class="comment"> | the Free Software Foundation, either version 3 of the License, or |</span> <a name="l00017"></a>00017 <span class="comment"> | (at your option) any later version. |</span> <a name="l00018"></a>00018 <span class="comment"> | |</span> <a name="l00019"></a>00019 <span class="comment"> | MRPT is distributed in the hope that it will be useful, |</span> <a name="l00020"></a>00020 <span class="comment"> | but WITHOUT ANY WARRANTY; without even the implied warranty of |</span> <a name="l00021"></a>00021 <span class="comment"> | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |</span> <a name="l00022"></a>00022 <span class="comment"> | GNU General Public License for more details. |</span> <a name="l00023"></a>00023 <span class="comment"> | |</span> <a name="l00024"></a>00024 <span class="comment"> | You should have received a copy of the GNU General Public License |</span> <a name="l00025"></a>00025 <span class="comment"> | along with MRPT. If not, see <http://www.gnu.org/licenses/>. |</span> <a name="l00026"></a>00026 <span class="comment"> | |</span> <a name="l00027"></a>00027 <span class="comment"> +---------------------------------------------------------------------------+ */</span> <a name="l00028"></a>00028 <span class="preprocessor">#ifndef stl_extensions_H</span> <a name="l00029"></a>00029 <span class="preprocessor"></span><span class="preprocessor">#define stl_extensions_H</span> <a name="l00030"></a>00030 <span class="preprocessor"></span> <a name="l00031"></a>00031 <span class="preprocessor">#include <<a class="code" href="_c_serializable_8h.html">mrpt/utils/CSerializable.h</a>></span> <a name="l00032"></a>00032 <span class="preprocessor">#include <<a class="code" href="_c_stream_8h.html">mrpt/utils/CStream.h</a>></span> <a name="l00033"></a>00033 <span class="preprocessor">#include <<a class="code" href="metaprogramming_8h.html">mrpt/utils/metaprogramming.h</a>></span> <a name="l00034"></a>00034 <a name="l00035"></a>00035 <span class="preprocessor">#include <set></span> <a name="l00036"></a>00036 <span class="preprocessor">#include <map></span> <a name="l00037"></a>00037 <span class="preprocessor">#include <list></span> <a name="l00038"></a>00038 <span class="preprocessor">#include <cctype></span> <span class="comment">// tolower</span> <a name="l00039"></a>00039 <a name="l00040"></a>00040 <span class="comment">// These are "STL extensions" but have their own files for clarity</span> <a name="l00041"></a>00041 <span class="preprocessor">#include <<a class="code" href="circular__buffer_8h.html">mrpt/utils/circular_buffer.h</a>></span> <a name="l00042"></a>00042 <span class="preprocessor">#include <<a class="code" href="list__searchable_8h.html">mrpt/utils/list_searchable.h</a>></span> <a name="l00043"></a>00043 <span class="preprocessor">#include <<a class="code" href="bimap_8h.html">mrpt/utils/bimap.h</a>></span> <a name="l00044"></a>00044 <span class="preprocessor">#include <<a class="code" href="map__as__vector_8h.html">mrpt/utils/map_as_vector.h</a>></span> <a name="l00045"></a>00045 <span class="preprocessor">#include <<a class="code" href="traits__map_8h.html">mrpt/utils/traits_map.h</a>></span> <a name="l00046"></a>00046 <a name="l00047"></a>00047 <a name="l00048"></a>00048 <span class="keyword">namespace </span>mrpt <a name="l00049"></a>00049 { <a name="l00050"></a>00050 <span class="keyword">namespace </span>utils <a name="l00051"></a>00051 {<span class="comment"></span> <a name="l00052"></a>00052 <span class="comment"> /** \addtogroup stlext_grp STL extensions and metaprogramming</span> <a name="l00053"></a>00053 <span class="comment"> * \ingroup mrpt_base_grp</span> <a name="l00054"></a>00054 <span class="comment"> * @{ */</span> <a name="l00055"></a>00055 <a name="l00056"></a>00056 <span class="keyword">using namespace </span>mrpt::utils::metaprogramming; <a name="l00057"></a>00057 <span class="keyword">using</span> std::for_each; <a name="l00058"></a>00058 <span class="keyword">using</span> std::string; <a name="l00059"></a>00059 <a name="l00060"></a>00060 <a name="l00061"></a><a class="code" href="group__stlext__grp.html#ga6e9751bd4a03af62ab1adb1509a6182b">00061</a> <span class="preprocessor"> #define MRPTSTL_SERIALIZABLE_SEQ_CONTAINER( CONTAINER ) \</span> <a name="l00062"></a>00062 <span class="preprocessor"></span><span class="comment"> /** Template method to serialize a sequential STL container */</span> \ <a name="l00063"></a>00063 template <class T,class _Ax> \ <a name="l00064"></a>00064 CStream& operator << (CStream& out, const CONTAINER<T,_Ax> &obj) \ <a name="l00065"></a>00065 { \ <a name="l00066"></a>00066 out << string(#CONTAINER) << TTypeName<T>::get(); \ <a name="l00067"></a>00067 out << static_cast<uint32_t>(obj.size()); \ <a name="l00068"></a>00068 for_each( obj.begin(), obj.end(), ObjectWriteToStream(&out) ); \ <a name="l00069"></a>00069 return out; \ <a name="l00070"></a>00070 } \ <a name="l00071"></a>00071 <span class="comment"> /** Template method to deserialize a sequential STL container */</span> \ <a name="l00072"></a>00072 template <class T,class _Ax> \ <a name="l00073"></a>00073 CStream& operator >> (CStream& in, CONTAINER<T,_Ax> &obj) \ <a name="l00074"></a>00074 { \ <a name="l00075"></a>00075 obj.clear(); \ <a name="l00076"></a>00076 string pref,stored_T; \ <a name="l00077"></a>00077 in >> pref; \ <a name="l00078"></a>00078 if (pref!=#CONTAINER) THROW_EXCEPTION(format("Error: serialized container %s<%s>'s preambles is wrong: '%s'",#CONTAINER,TTypeName<T>::get().c_str(),pref.c_str() )) \ <a name="l00079"></a>00079 in >> stored_T; \ <a name="l00080"></a>00080 if (stored_T != TTypeName<T>::get() ) THROW_EXCEPTION(format("Error: serialized container %s< %s != %s >",#CONTAINER,stored_T.c_str(),TTypeName<T>::get().c_str() )) \ <a name="l00081"></a>00081 uint32_t n; \ <a name="l00082"></a>00082 in >> n; \ <a name="l00083"></a>00083 obj.resize(n); \ <a name="l00084"></a>00084 for_each( obj.begin(), obj.end(), ObjectReadFromStream(&in) ); \ <a name="l00085"></a>00085 return in; \ <a name="l00086"></a>00086 } <a name="l00087"></a>00087 <a name="l00088"></a>00088 <a name="l00089"></a><a class="code" href="group__stlext__grp.html#gacbe319059d7b0f530b4eb2e8e362e524">00089</a> <span class="preprocessor"> #define MRPTSTL_SERIALIZABLE_ASSOC_CONTAINER( CONTAINER ) \</span> <a name="l00090"></a>00090 <span class="preprocessor"></span><span class="comment"> /** Template method to serialize an associative STL container */</span> \ <a name="l00091"></a>00091 template <class K,class V, class _Pr, class _Alloc> \ <a name="l00092"></a>00092 CStream& operator << (CStream& out, const CONTAINER<K,V,_Pr,_Alloc> &obj) \ <a name="l00093"></a>00093 { \ <a name="l00094"></a>00094 out << string(#CONTAINER) << TTypeName<K>::get() << TTypeName<V>::get(); \ <a name="l00095"></a>00095 out << static_cast<uint32_t>(obj.size()); \ <a name="l00096"></a>00096 for (typename CONTAINER<K,V,_Pr,_Alloc>::const_iterator it=obj.begin();it!=obj.end();++it) \ <a name="l00097"></a>00097 out << it->first << it->second; \ <a name="l00098"></a>00098 return out; \ <a name="l00099"></a>00099 } \ <a name="l00100"></a>00100 <span class="comment"> /** Template method to deserialize an associative STL container */</span> \ <a name="l00101"></a>00101 template <class K,class V, class _Pr, class _Alloc> \ <a name="l00102"></a>00102 CStream& operator >> (CStream& in, CONTAINER<K,V,_Pr,_Alloc> &obj) \ <a name="l00103"></a>00103 { \ <a name="l00104"></a>00104 obj.clear(); \ <a name="l00105"></a>00105 string pref,stored_K,stored_V; \ <a name="l00106"></a>00106 in >> pref; \ <a name="l00107"></a>00107 if (pref!=#CONTAINER) THROW_EXCEPTION(format("Error: serialized container %s<%s,%s>'s preamble is wrong: '%s'",#CONTAINER, TTypeName<K>::get().c_str(), TTypeName<V>::get().c_str() ,pref.c_str())) \ <a name="l00108"></a>00108 in >> stored_K; \ <a name="l00109"></a>00109 if (stored_K != TTypeName<K>::get()) THROW_EXCEPTION(format("Error: serialized container %s key type %s != %s",#CONTAINER,stored_K.c_str(), TTypeName<K>::get().c_str())) \ <a name="l00110"></a>00110 in >> stored_V; \ <a name="l00111"></a>00111 if (stored_V != TTypeName<V>::get()) THROW_EXCEPTION(format("Error: serialized container %s value type %s != %s",#CONTAINER,stored_V.c_str(), TTypeName<V>::get().c_str())) \ <a name="l00112"></a>00112 uint32_t n; \ <a name="l00113"></a>00113 in >> n; \ <a name="l00114"></a>00114 for (uint32_t i=0;i<n;i++) \ <a name="l00115"></a>00115 { \ <a name="l00116"></a>00116 K key_obj; \ <a name="l00117"></a>00117 in >> key_obj; \ <a name="l00118"></a>00118 <span class="comment">/* Create an pair (Key, empty), then read directly into the ".second": */</span> \ <a name="l00119"></a>00119 typename CONTAINER<K,V,_Pr,_Alloc>::iterator it_new = obj.insert(obj.begin(), std::make_pair(key_obj, V()) ); \ <a name="l00120"></a>00120 in >> it_new->second; \ <a name="l00121"></a>00121 } \ <a name="l00122"></a>00122 return in; \ <a name="l00123"></a>00123 } <a name="l00124"></a>00124 <a name="l00125"></a><a class="code" href="group__stlext__grp.html#ga3fe5e4224b9e59419e84795f28977b86">00125</a> <a class="code" href="group__stlext__grp.html#ga3fe5e4224b9e59419e84795f28977b86" title="Template method to serialize a STL pair.">MRPTSTL_SERIALIZABLE_SEQ_CONTAINER</a>(<a class="code" href="classstd_1_1vector.html" title="STL class.">std::vector</a>) <span class="comment">// Serialization for std::vector</span> <a name="l00126"></a>00126 <a class="code" href="group__stlext__grp.html#ga3fe5e4224b9e59419e84795f28977b86" title="Template method to serialize a STL pair.">MRPTSTL_SERIALIZABLE_SEQ_CONTAINER</a>(std::<a class="code" href="classstd_1_1deque.html" title="STL class.">deque</a>) <span class="comment">// Serialization for std::deque</span> <a name="l00127"></a>00127 <a class="code" href="group__stlext__grp.html#ga3fe5e4224b9e59419e84795f28977b86" title="Template method to serialize a STL pair.">MRPTSTL_SERIALIZABLE_SEQ_CONTAINER</a>(std::<a class="code" href="classstd_1_1list.html" title="STL class.">list</a>) <span class="comment">// Serialization for std::list</span> <a name="l00128"></a>00128 <a name="l00129"></a>00129 <a class="code" href="group__stlext__grp.html#gacbe319059d7b0f530b4eb2e8e362e524">MRPTSTL_SERIALIZABLE_ASSOC_CONTAINER</a>(std::<a class="code" href="classstd_1_1map.html" title="STL class.">map</a>) <span class="comment">// Serialization for std::map</span> <a name="l00130"></a>00130 <a class="code" href="group__stlext__grp.html#gacbe319059d7b0f530b4eb2e8e362e524">MRPTSTL_SERIALIZABLE_ASSOC_CONTAINER</a>(std::<a class="code" href="classstd_1_1multimap.html" title="STL class.">multimap</a>) <span class="comment">// Serialization for std::multimap</span> <a name="l00131"></a>00131 <a name="l00132"></a>00132 <a name="l00133"></a>00133 <span class="preprocessor">#define MRPTSTL_SERIALIZABLE_SIMPLE_ASSOC_CONTAINER( CONTAINER ) \</span> <a name="l00134"></a>00134 <span class="preprocessor"></span><span class="comment"> /** Template method to serialize an associative STL container */</span> \ <a name="l00135"></a>00135 template <class K,class _Pr,class _Alloc> \ <a name="l00136"></a>00136 CStream& operator << (CStream& out, const CONTAINER<K,_Pr,_Alloc> &obj) \ <a name="l00137"></a>00137 { \ <a name="l00138"></a>00138 out << string(#CONTAINER) << TTypeName<K>::get(); \ <a name="l00139"></a>00139 out << static_cast<uint32_t>(obj.size()); \ <a name="l00140"></a>00140 for (typename CONTAINER<K,_Pr,_Alloc>::const_iterator it=obj.begin();it!=obj.end();++it) \ <a name="l00141"></a>00141 out << *it; \ <a name="l00142"></a>00142 return out; \ <a name="l00143"></a>00143 } \ <a name="l00144"></a>00144 <span class="comment"> /** Template method to deserialize an associative STL container */</span> \ <a name="l00145"></a>00145 template <class K,class _Pr,class _Alloc> \ <a name="l00146"></a>00146 CStream& operator >> (CStream& in, CONTAINER<K,_Pr,_Alloc> &obj) \ <a name="l00147"></a>00147 { \ <a name="l00148"></a>00148 obj.clear(); \ <a name="l00149"></a>00149 string pref,stored_K; \ <a name="l00150"></a>00150 in >> pref; \ <a name="l00151"></a>00151 if (pref!=#CONTAINER) THROW_EXCEPTION(format("Error: serialized container %s<%s>'s preamble is wrong: '%s'",#CONTAINER, TTypeName<K>::get().c_str(),pref.c_str())) \ <a name="l00152"></a>00152 in >> stored_K; \ <a name="l00153"></a>00153 if (stored_K != TTypeName<K>::get()) THROW_EXCEPTION(format("Error: serialized container %s key type %s != %s",#CONTAINER,stored_K.c_str(), TTypeName<K>::get().c_str())) \ <a name="l00154"></a>00154 uint32_t n; \ <a name="l00155"></a>00155 in >> n; \ <a name="l00156"></a>00156 for (uint32_t i=0;i<n;i++) \ <a name="l00157"></a>00157 { \ <a name="l00158"></a>00158 K key_obj; \ <a name="l00159"></a>00159 in >> key_obj; \ <a name="l00160"></a>00160 obj.insert(key_obj); \ <a name="l00161"></a>00161 } \ <a name="l00162"></a>00162 return in; \ <a name="l00163"></a>00163 } <a name="l00164"></a>00164 <a name="l00165"></a>00165 <a class="code" href="stl__extensions_8h.html#a81438265757e704ac4db6f4382426a62">MRPTSTL_SERIALIZABLE_SIMPLE_ASSOC_CONTAINER</a>(<a class="code" href="classstd_1_1set.html" title="STL class.">std::set</a>) <span class="comment">// Serialization for std::set</span> <a name="l00166"></a>00166 MRPTSTL_SERIALIZABLE_SIMPLE_ASSOC_CONTAINER(std::<a class="code" href="classstd_1_1multiset.html" title="STL class.">multiset</a>) <span class="comment">// Serialization for std::multiset</span> <a name="l00167"></a>00167 <a name="l00168"></a>00168 <span class="comment"></span> <a name="l00169"></a>00169 <span class="comment"> /** Template method to serialize a STL pair */</span> <a name="l00170"></a>00170 template <class T1,class T2> <a name="l00171"></a>00171 <a class="code" href="classmrpt_1_1utils_1_1_c_stream.html" title="This base class is used to provide a unified interface to files,memory buffers,..Please see the deriv...">CStream</a>& operator << (<a class="code" href="classmrpt_1_1utils_1_1_c_stream.html" title="This base class is used to provide a unified interface to files,memory buffers,..Please see the deriv...">CStream</a>& out, const std::pair<T1,T2> &obj) <a name="l00172"></a>00172 { <a name="l00173"></a>00173 out << <a class="code" href="classstd_1_1string.html" title="STL class.">string</a>(<span class="stringliteral">"std::pair"</span>) << <a class="code" href="structmrpt_1_1utils_1_1_t_type_name.html" title="A template to obtain the type of its argument as a string at compile time.">TTypeName<T1>::get</a>() << <a class="code" href="structmrpt_1_1utils_1_1_t_type_name.html" title="A template to obtain the type of its argument as a string at compile time.">TTypeName<T2>::get</a>(); <a name="l00174"></a>00174 out << obj.first << obj.second; <a name="l00175"></a>00175 <span class="keywordflow">return</span> out; <a name="l00176"></a>00176 }<span class="comment"></span> <a name="l00177"></a>00177 <span class="comment"> /** Template method to deserialize a STL pair */</span> <a name="l00178"></a>00178 <span class="keyword">template</span> <<span class="keyword">class</span> T1,<span class="keyword">class</span> T2> <a name="l00179"></a><a class="code" href="group__stlext__grp.html#ga13c0c64816a187c4198996ab8ce022b6">00179</a> <a class="code" href="classmrpt_1_1utils_1_1_c_stream.html" title="This base class is used to provide a unified interface to files,memory buffers,..Please see the deriv...">CStream</a>& <a class="code" href="namespacemrpt_1_1utils.html#a3494fa57d68d04e85f10edc3801debb3">operator >> </a>(<a class="code" href="classmrpt_1_1utils_1_1_c_stream.html" title="This base class is used to provide a unified interface to files,memory buffers,..Please see the deriv...">CStream</a>& in, std::pair<T1,T2> &obj) <a name="l00180"></a>00180 { <a name="l00181"></a>00181 <span class="keywordtype">string</span> pref,stored_K,stored_V; <a name="l00182"></a>00182 in >> pref; <a name="l00183"></a>00183 <span class="keywordflow">if</span> (pref!=<span class="stringliteral">"std::pair"</span>) <a class="code" href="mrpt__macros_8h.html#aaa3f404ea85a6575a7139f8d101370ba">THROW_EXCEPTION</a>(<a class="code" href="namespacemrpt.html#a3a27af794b658df5491e2b7678f8ccb8" title="A std::string version of C sprintf.">format</a>(<span class="stringliteral">"Error: serialized std::pair<%s,%s>'s preamble is wrong: '%s'"</span>, <a class="code" href="structmrpt_1_1utils_1_1_t_type_name.html" title="A template to obtain the type of its argument as a string at compile time.">TTypeName<T1>::get</a>().c_str(), <a class="code" href="structmrpt_1_1utils_1_1_t_type_name.html" title="A template to obtain the type of its argument as a string at compile time.">TTypeName<T2>::get</a>().c_str() ,pref.c_str())) <a name="l00184"></a>00184 in >> stored_K; <a name="l00185"></a>00185 <span class="keywordflow">if</span> (stored_K != <a class="code" href="structmrpt_1_1utils_1_1_t_type_name.html" title="A template to obtain the type of its argument as a string at compile time.">TTypeName<T1>::get</a>()) <a class="code" href="mrpt__macros_8h.html#aaa3f404ea85a6575a7139f8d101370ba">THROW_EXCEPTION</a>(<a class="code" href="namespacemrpt.html#a3a27af794b658df5491e2b7678f8ccb8" title="A std::string version of C sprintf.">format</a>(<span class="stringliteral">"Error: serialized std::pair first type %s != %s"</span>,stored_K.c_str(), <a class="code" href="structmrpt_1_1utils_1_1_t_type_name.html" title="A template to obtain the type of its argument as a string at compile time.">TTypeName<T1>::get</a>().c_str())) <a name="l00186"></a>00186 in >> stored_V; <a name="l00187"></a>00187 <span class="keywordflow">if</span> (stored_V != <a class="code" href="structmrpt_1_1utils_1_1_t_type_name.html" title="A template to obtain the type of its argument as a string at compile time.">TTypeName<T2>::get</a>()) <a class="code" href="mrpt__macros_8h.html#aaa3f404ea85a6575a7139f8d101370ba">THROW_EXCEPTION</a>(<a class="code" href="namespacemrpt.html#a3a27af794b658df5491e2b7678f8ccb8" title="A std::string version of C sprintf.">format</a>(<span class="stringliteral">"Error: serialized std::pair second type %s != %s"</span>,stored_V.c_str(), <a class="code" href="structmrpt_1_1utils_1_1_t_type_name.html" title="A template to obtain the type of its argument as a string at compile time.">TTypeName<T2>::get</a>().c_str())) <a name="l00188"></a>00188 in >> obj.first >> obj.second; <a name="l00189"></a>00189 <span class="keywordflow">return</span> in; <a name="l00190"></a>00190 } <a name="l00191"></a>00191 <a name="l00192"></a>00192 <span class="comment"></span> <a name="l00193"></a>00193 <span class="comment"> /** Returns the index of the value "T" in the container "vect" (std::vector,std::deque,etc), or string::npos if not found.</span> <a name="l00194"></a>00194 <span class="comment"> */</span> <a name="l00195"></a>00195 <span class="keyword">template</span> <<span class="keyword">class</span> T,<span class="keyword">class</span> CONTAINER> <a name="l00196"></a><a class="code" href="group__stlext__grp.html#ga0683c85522dd9009f2c2801c18e12eae">00196</a> <span class="keywordtype">size_t</span> <a class="code" href="group__stlext__grp.html#ga0683c85522dd9009f2c2801c18e12eae" title="Returns the index of the value "T" in the container "vect" (std::vector,std::deque,etc), or string::npos if not found.">find_in_vector</a>(<span class="keyword">const</span> T &value, <span class="keyword">const</span> CONTAINER &vect) <a name="l00197"></a>00197 { <a name="l00198"></a>00198 <span class="keyword">typename</span> CONTAINER<a class="code" href="eigen__plugins_8h.html#a8dbda719917732693c56cee228465ed9">::const_iterator</a> last = vect.end(); <a name="l00199"></a>00199 <span class="keywordflow">for</span> (<span class="keyword">typename</span> <a class="code" href="eigen__plugins_8h.html#a8dbda719917732693c56cee228465ed9">CONTAINER::const_iterator</a> i=vect.begin();i!=last;++i) <a name="l00200"></a>00200 <span class="keywordflow">if</span> (*i==value) <span class="keywordflow">return</span> <a class="code" href="group__geometry__grp.html#ga8c0a76e906f12560cfa49fcd269c8398" title="Gets the distance between two points in a 2D space.">std::distance</a>(vect.begin(),i); <a name="l00201"></a>00201 <span class="keywordflow">return</span> std::string::npos; <a name="l00202"></a>00202 } <a name="l00203"></a>00203 <span class="comment"></span> <a name="l00204"></a>00204 <span class="comment"> /** Calls the standard "erase" method of a STL container, but also returns an iterator to the next element in the container (or ::end if none) */</span> <a name="l00205"></a><a class="code" href="group__stlext__grp.html#gac2cbbb352f5b7daa375a029b9a65f9b5">00205</a> <span class="keyword">template</span> <<span class="keyword">class</span> T> <span class="keyword">inline</span> <span class="keyword">typename</span> std<a class="code" href="classstd_1_1list_1_1iterator.html" title="STL iterator class.">::list<T>::iterator</a> <a class="code" href="group__stlext__grp.html#gac2cbbb352f5b7daa375a029b9a65f9b5" title="Calls the standard "erase" method of a STL container, but also returns an iterator to the next elemen...">erase_return_next</a>(<a class="code" href="classstd_1_1list.html">std::list<T></a> &cont, <span class="keyword">typename</span> <a class="code" href="classstd_1_1list_1_1iterator.html" title="STL iterator class.">std::list<T>::iterator</a> &it) <a name="l00206"></a>00206 { <a name="l00207"></a>00207 <span class="keywordflow">return</span> cont.erase(it); <a name="l00208"></a>00208 }<span class="comment"></span> <a name="l00209"></a>00209 <span class="comment"> //! \overload</span> <a name="l00210"></a><a class="code" href="group__stlext__grp.html#ga2fe6bf9b8c0bcea04324d0f3e6beec84">00210</a> <span class="comment"></span> <span class="keyword">template</span> <<span class="keyword">class</span> K,<span class="keyword">class</span> V> <span class="keyword">inline</span> <span class="keyword">typename</span> std<a class="code" href="classstd_1_1map_1_1iterator.html" title="STL iterator class.">::map<K,V>::iterator</a> <a class="code" href="group__stlext__grp.html#gac2cbbb352f5b7daa375a029b9a65f9b5" title="Calls the standard "erase" method of a STL container, but also returns an iterator to the next elemen...">erase_return_next</a>(<a class="code" href="classstd_1_1map.html" title="STL class.">std::map<K,V></a> &cont, <span class="keyword">typename</span> <a class="code" href="classstd_1_1map_1_1iterator.html" title="STL iterator class.">std::map<K,V>::iterator</a> &it) <a name="l00211"></a>00211 { <a name="l00212"></a>00212 <span class="keyword">typename</span> std<a class="code" href="classstd_1_1map_1_1iterator.html" title="STL iterator class.">::map<K,V>::iterator</a> itRet = it; ++itRet; <a name="l00213"></a>00213 cont.erase(it); <a name="l00214"></a>00214 <span class="keywordflow">return</span> itRet; <a name="l00215"></a>00215 }<span class="comment"></span> <a name="l00216"></a>00216 <span class="comment"> //! \overload</span> <a name="l00217"></a><a class="code" href="group__stlext__grp.html#ga20dc9a22082b67aa35dda2087c182e89">00217</a> <span class="comment"></span> <span class="keyword">template</span> <<span class="keyword">class</span> K,<span class="keyword">class</span> V> <span class="keyword">inline</span> <span class="keyword">typename</span> std<a class="code" href="classstd_1_1multimap_1_1iterator.html" title="STL iterator class.">::multimap<K,V>::iterator</a> <a class="code" href="group__stlext__grp.html#gac2cbbb352f5b7daa375a029b9a65f9b5" title="Calls the standard "erase" method of a STL container, but also returns an iterator to the next elemen...">erase_return_next</a>(<a class="code" href="classstd_1_1multimap.html" title="STL class.">std::multimap<K,V></a> &cont, <span class="keyword">typename</span> <a class="code" href="classstd_1_1multimap_1_1iterator.html" title="STL iterator class.">std::multimap<K,V>::iterator</a> &it) <a name="l00218"></a>00218 { <a name="l00219"></a>00219 <span class="keyword">typename</span> std<a class="code" href="classstd_1_1multimap_1_1iterator.html" title="STL iterator class.">::multimap<K,V>::iterator</a> itRet = it; ++itRet; <a name="l00220"></a>00220 cont.erase(it); <a name="l00221"></a>00221 <span class="keywordflow">return</span> itRet; <a name="l00222"></a>00222 }<span class="comment"></span> <a name="l00223"></a>00223 <span class="comment"> //! \overload</span> <a name="l00224"></a><a class="code" href="group__stlext__grp.html#gac73187001985ae3ef41a8040a792db12">00224</a> <span class="comment"></span> <span class="keyword">template</span> <<span class="keyword">class</span> T> <span class="keyword">inline</span> <span class="keyword">typename</span> std<a class="code" href="classstd_1_1set_1_1iterator.html" title="STL iterator class.">::set<T>::iterator</a> <a class="code" href="group__stlext__grp.html#gac2cbbb352f5b7daa375a029b9a65f9b5" title="Calls the standard "erase" method of a STL container, but also returns an iterator to the next elemen...">erase_return_next</a>(<a class="code" href="classstd_1_1set.html">std::set<T></a> &cont, <span class="keyword">typename</span> <a class="code" href="classstd_1_1set_1_1iterator.html" title="STL iterator class.">std::set<T>::iterator</a> &it) <a name="l00225"></a>00225 { <a name="l00226"></a>00226 <span class="keyword">typename</span> std<a class="code" href="classstd_1_1set_1_1iterator.html" title="STL iterator class.">::set<T>::iterator</a> itRet = it; ++itRet; <a name="l00227"></a>00227 cont.erase(it); <a name="l00228"></a>00228 <span class="keywordflow">return</span> itRet; <a name="l00229"></a>00229 } <a name="l00230"></a>00230 <span class="comment"></span> <a name="l00231"></a>00231 <span class="comment"> /** Generates a string for a vector in the format [A,B,C,...] to std::cout, and the fmt string for <b>each</b> vector element. */</span> <a name="l00232"></a>00232 <span class="keyword">template</span> <<span class="keyword">typename</span> T> <a name="l00233"></a><a class="code" href="group__stlext__grp.html#ga39a976e64941bfbbcde6969124bdd6c5">00233</a> std<a class="code" href="classstd_1_1string.html" title="STL class.">::string</a> <a class="code" href="group__stlext__grp.html#ga39a976e64941bfbbcde6969124bdd6c5" title="Generates a string for a vector in the format [A,B,C,...] to std::cout, and the fmt string for each v...">sprintf_vector</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, <span class="keyword">const</span> <a class="code" href="classstd_1_1vector.html">std::vector<T></a> &V ) <a name="l00234"></a>00234 { <a name="l00235"></a>00235 std<a class="code" href="classstd_1_1string.html" title="STL class.">::string</a> ret = <span class="stringliteral">"["</span>; <a name="l00236"></a>00236 <span class="keyword">const</span> <span class="keywordtype">size_t</span> N = V.size(); <a name="l00237"></a>00237 <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0;i<N;i++) <a name="l00238"></a>00238 { <a name="l00239"></a>00239 ret+= <a class="code" href="namespacemrpt.html#a3a27af794b658df5491e2b7678f8ccb8" title="A std::string version of C sprintf.">format</a>(fmt,V[i]); <a name="l00240"></a>00240 <span class="keywordflow">if</span> (i!=(N-1)) ret+= <span class="stringliteral">","</span>; <a name="l00241"></a>00241 } <a name="l00242"></a>00242 ret+=<span class="stringliteral">"]"</span>; <a name="l00243"></a>00243 <span class="keywordflow">return</span> ret; <a name="l00244"></a>00244 }<span class="comment"></span> <a name="l00245"></a>00245 <span class="comment"> /// @overload</span> <a name="l00246"></a>00246 <span class="comment"></span> <span class="keyword">template</span> <<span class="keyword">typename</span> Derived> <a name="l00247"></a><a class="code" href="group__stlext__grp.html#gad16f1beaaa537e76df642cfec8e59399">00247</a> std<a class="code" href="classstd_1_1string.html" title="STL class.">::string</a> <a class="code" href="group__stlext__grp.html#ga39a976e64941bfbbcde6969124bdd6c5" title="Generates a string for a vector in the format [A,B,C,...] to std::cout, and the fmt string for each v...">sprintf_vector</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, <span class="keyword">const</span> <a class="code" href="class_eigen_1_1_matrix_base.html">Eigen::MatrixBase<Derived></a> &V ) <a name="l00248"></a>00248 { <a name="l00249"></a>00249 std<a class="code" href="classstd_1_1string.html" title="STL class.">::string</a> ret = <span class="stringliteral">"["</span>; <a name="l00250"></a>00250 <span class="keyword">const</span> <span class="keywordtype">size_t</span> N = V.size(); <a name="l00251"></a>00251 <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i=0;i<N;i++) <a name="l00252"></a>00252 { <a name="l00253"></a>00253 ret+= <a class="code" href="namespacemrpt.html#a3a27af794b658df5491e2b7678f8ccb8" title="A std::string version of C sprintf.">format</a>(fmt,V[i]); <a name="l00254"></a>00254 <span class="keywordflow">if</span> (i!=(N-1)) ret+= <span class="stringliteral">","</span>; <a name="l00255"></a>00255 } <a name="l00256"></a>00256 ret+=<span class="stringliteral">"]"</span>; <a name="l00257"></a>00257 <span class="keywordflow">return</span> ret; <a name="l00258"></a>00258 } <a name="l00259"></a>00259 <span class="comment"></span> <a name="l00260"></a>00260 <span class="comment"> /** Prints a vector in the format [A,B,C,...] to std::cout, and the fmt string for <b>each</b> vector element. */</span> <a name="l00261"></a>00261 <span class="keyword">template</span> <<span class="keyword">typename</span> T> <a name="l00262"></a><a class="code" href="group__stlext__grp.html#gac1fd539c110cc511a60fcc0675cad366">00262</a> <span class="keywordtype">void</span> <a class="code" href="group__stlext__grp.html#gac1fd539c110cc511a60fcc0675cad366" title="Prints a vector in the format [A,B,C,...] to std::cout, and the fmt string for each vector element...">printf_vector</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, <span class="keyword">const</span> <a class="code" href="classstd_1_1vector.html">std::vector<T></a> &V ) { <a name="l00263"></a>00263 std::cout << <a class="code" href="group__stlext__grp.html#ga39a976e64941bfbbcde6969124bdd6c5" title="Generates a string for a vector in the format [A,B,C,...] to std::cout, and the fmt string for each v...">sprintf_vector</a>(fmt, V); <a name="l00264"></a>00264 } <a name="l00265"></a>00265 <span class="comment"></span> <a name="l00266"></a>00266 <span class="comment"> /** A case-insensitive comparator struct for usage within STL containers, eg: map<string,string,ci_less></span> <a name="l00267"></a>00267 <span class="comment"> */</span> <a name="l00268"></a>00268 <span class="keyword">struct </span>ci_less : std::binary_function<std::string,std::string,bool> <a name="l00269"></a>00269 { <a name="l00270"></a>00270 <span class="comment">// case-independent (ci) compare_less binary function</span> <a name="l00271"></a>00271 <span class="keyword">struct </span>nocase_compare : <span class="keyword">public</span> std::binary_function<char,char,bool> { <a name="l00272"></a><a class="code" href="structmrpt_1_1utils_1_1ci__less_1_1nocase__compare.html#a722ba27441b6bcc740afb22dc52ceba6">00272</a> <span class="keywordtype">bool</span> <a class="code" href="structmrpt_1_1utils_1_1ci__less_1_1nocase__compare.html#a722ba27441b6bcc740afb22dc52ceba6">operator()</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> c1, <span class="keyword">const</span> <span class="keywordtype">char</span> c2)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> tolower(c1)<tolower(c2); } <a name="l00273"></a>00273 }; <a name="l00274"></a><a class="code" href="structmrpt_1_1utils_1_1ci__less.html#ae29029d129dad1d0f165f477aa25c99f">00274</a> <span class="keywordtype">bool</span> operator() (<span class="keyword">const</span> <a class="code" href="classstd_1_1string.html" title="STL class.">std::string</a> & s1, <span class="keyword">const</span> <a class="code" href="classstd_1_1string.html" title="STL class.">std::string</a> & s2)<span class="keyword"> const </span>{ <a name="l00275"></a>00275 <span class="keywordflow">return</span> std::lexicographical_compare(s1.begin(),s1.end(), s2.begin(),s2.end(), <a class="code" href="structmrpt_1_1utils_1_1ci__less_1_1nocase__compare.html">nocase_compare</a>()); <a name="l00276"></a>00276 } <a name="l00277"></a>00277 }; <span class="comment">// end of ci_less</span> <a name="l00278"></a>00278 <span class="comment"></span> <a name="l00279"></a>00279 <span class="comment"> /** @} */</span> <span class="comment">// end of grouping</span> <a name="l00280"></a>00280 <a name="l00281"></a>00281 } <span class="comment">// End of namespace</span> <a name="l00282"></a>00282 } <span class="comment">// End of namespace</span> <a name="l00283"></a>00283 <span class="preprocessor">#endif</span> </pre></div></div> </div> <br><hr><br> <table border="0" width="100%"> <tr> <td> Page generated by <a href="http://www.doxygen.org" target="_blank">Doxygen 1.7.5</a> for MRPT 0.9.5 SVN: at Sun Sep 25 17:20:18 UTC 2011</td><td></td> <td width="100"> </td> <td width="150"> </td></tr> </table> </body></html>