19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// This file is part of the ustl library, an STL implementation. 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// Copyright (C) 2005 by Mike Sharov <msharov@users.sourceforge.net> 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// This file is free software, distributed under the MIT License. 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// umultimap.h 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#ifndef UMULTIMAP_H_45743F516E02A87A3FCEA5024052A6F5 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#define UMULTIMAP_H_45743F516E02A87A3FCEA5024052A6F5 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include "uassert.h" 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include "ufunction.h" 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include "uvector.h" 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectnamespace ustl { 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \class multimap umultimap.h ustl.h 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \ingroup AssociativeContainers 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \brief A sorted associative container that may container multiple entries for each key. 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename K, typename V> 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectclass multimap : public vector<pair<K,V> > { 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef K key_type; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef V data_type; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef const K& const_key_ref; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef const V& const_data_ref; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef const multimap<K,V>& rcself_t; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef vector<pair<K,V> > base_class; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::value_type value_type; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::size_type size_type; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::pointer pointer; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::const_pointer const_pointer; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::reference reference; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::const_reference const_reference; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::const_iterator const_iterator; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::iterator iterator; 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::reverse_iterator reverse_iterator; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename base_class::const_reverse_iterator const_reverse_iterator; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef pair<const_iterator,const_iterator> const_range_t; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef pair<iterator,iterator> range_t; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline multimap (void) : vector<pair<K,V> > () {} 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project explicit inline multimap (size_type n) : vector<pair<K,V> > (n) {} 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline multimap (rcself_t v) : vector<pair<K,V> > (v) {} 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline multimap (const_iterator i1, const_iterator i2) : vector<pair<K,V> > () { insert (i1, i2); } 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline rcself_t operator= (rcself_t v) { base_class::operator= (v); return (*this); } 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline size_type size (void) const { return (base_class::size()); } 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline iterator begin (void) { return (base_class::begin()); } 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline const_iterator begin (void) const { return (base_class::begin()); } 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline iterator end (void) { return (base_class::end()); } 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline const_iterator end (void) const { return (base_class::end()); } 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline void assign (const_iterator i1, const_iterator i2) { clear(); insert (i1, i2); } 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline size_type count (const_key_ref k) const { return (upper_bound(k) - lower_bound(k)); } 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline void push_back (const_reference v) { insert (v); } 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline const_range_t equal_range (const_key_ref k) const { return (make_pair (lower_bound(k), upper_bound(k))); } 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline range_t equal_range (const_key_ref k) { return (make_pair (const_cast<iterator>(lower_bound(k)), const_cast<iterator>(upper_bound(k)))); } 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const_iterator lower_bound (const_key_ref k) const; 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const_iterator upper_bound (const_key_ref k) const; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline iterator insert (const_reference v); 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void insert (const_iterator i1, const_iterator i2); 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline void erase (const_key_ref k) { erase (const_cast<iterator>(lower_bound(k)), const_cast<iterator>(upper_bound(k))); } 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline iterator erase (iterator ep) { return (base_class::erase (ep)); } 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline iterator erase (iterator ep1, iterator ep2) { return (base_class::erase (ep1, ep2)); } 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline void clear (void) { base_class::clear(); } 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Returns an iterator to the first element with key value \p k. 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename K, typename V> 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttypename multimap<K,V>::const_iterator multimap<K,V>::lower_bound (const_key_ref k) const 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const_iterator first (begin()), last (end()); 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (first != last) { 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const_iterator mid = advance (first, distance (first,last) / 2); 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mid->first < k) 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project first = advance (mid, 1); 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project last = mid; 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (first); 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Returns an iterator to the first element with key value \p k. 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename K, typename V> 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttypename multimap<K,V>::const_iterator multimap<K,V>::upper_bound (const_key_ref k) const 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const_iterator first (begin()), last (end()); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (first != last) { 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const_iterator mid = advance (first, distance (first,last) / 2); 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (k < mid->first) 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project last = mid; 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project first = advance (mid, 1); 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (last); 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Inserts the pair into the container. 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename K, typename V> 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectinline typename multimap<K,V>::iterator multimap<K,V>::insert (const_reference v) 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project iterator ip = const_cast<iterator> (upper_bound (v.first)); 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (base_class::insert (ip, v)); 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Inserts elements from range [i1,i2) into the container. 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename K, typename V> 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectvoid multimap<K,V>::insert (const_iterator i1, const_iterator i2) 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project assert (i1 <= i2); 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project reserve (size() + distance (i1, i2)); 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i1 != i2; ++i1) 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project insert (*i1); 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} // namespace ustl 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#endif 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 122