projects / ceph.git / blame
| Commit | Line | Data |
|---|---|---|
| 7c673cae FG |
1 | ++++++++++++++++++++++++++++++++++ |
| 2 | |Boost| Pointer Container Library | |
| 3 | ++++++++++++++++++++++++++++++++++ | |
| 4 | ||
| 5 | .. |Boost| image:: boost.png | |
| 6 | ||
| 7 | Insert Iterators | |
| 8 | ---------------- | |
| 9 | ||
| 10 | When you work with normal value-based containers and algorithms, you often | |
| 11 | use insert iterators :: | |
| 12 | ||
| 13 | std::list<int> coll1; | |
| 14 | // ... | |
| 15 | std::vector<int> coll2; | |
| 16 | std::copy( coll1.begin(), coll1.end(), | |
| 17 | back_inserter(coll2) ); | |
| 18 | ||
| 19 | With the special insert iterators for pointer containers, | |
| 20 | you can do exactly the same :: | |
| 21 | ||
| 22 | boost::ptr_list<Base> coll1; | |
| 23 | // ... | |
| 24 | boost::ptr_vector<Base> coll2; | |
| 25 | std::copy( coll1.begin(), coll1.end(), | |
| 26 | boost::ptr_container::ptr_back_inserter(coll2) ); | |
| 27 | ||
| 28 | Each element is cloned and inserted into the container. Furthermore, | |
| 29 | if the source range iterates over pointers | |
| 30 | instead of references, ``NULL`` pointers | |
| 31 | can be transfered as well. | |
| 32 | ||
| 33 | **Navigate** | |
| 34 | ||
| 35 | - `home <ptr_container.html>`_ | |
| 36 | - `reference <reference.html>`_ | |
| 37 | ||
| 38 | **Synopsis:** | |
| 39 | ||
| 40 | :: | |
| 41 | ||
| 42 | namespace boost | |
| 43 | { | |
| 44 | namespace ptr_container | |
| 45 | { | |
| 46 | ||
| 47 | template< class PtrContainer > | |
| 48 | class ptr_back_insert_iterator; | |
| 49 | ||
| 50 | template< class PtrContainer > | |
| 51 | class ptr_front_insert_iterator; | |
| 52 | ||
| 53 | template< class PtrContainer > | |
| 54 | class ptr_insert_iterator; | |
| 55 | ||
| 56 | template< class PtrContainer > | |
| 57 | ptr_back_insert_iterator<PtrContainer> | |
| 58 | ptr_back_inserter( PtrContainer& cont ); | |
| 59 | ||
| 60 | template< class PtrContainer > | |
| 61 | ptr_front_insert_iterator<PtrContainer> | |
| 62 | ptr_front_inserter( PtrContainer& cont ); | |
| 63 | ||
| 64 | template< class PtrContainer > | |
| 65 | ptr_insert_iterator<PtrContainer> | |
| 66 | ptr_inserter( PtrContainer& cont, typename PtrContainer::iterator before ); | |
| 67 | ||
| 68 | } // namespace 'ptr_container' | |
| 69 | } // namespace 'boost' | |
| 70 | ||
| 71 | .. raw:: html | |
| 72 | ||
| 73 | <hr> | |
| 74 | ||
| 75 | :Copyright: Thorsten Ottosen 2008. Use, modification and distribution is subject to the Boost Software License, Version 1.0 (see LICENSE_1_0.txt__). | |
| 76 | ||
| 77 | __ http://www.boost.org/LICENSE_1_0.txt | |
| 78 | ||
| 79 |