Pointer Container Library
+
Pointer Container Library
Class associative_ptr_container
This section describes all the common operations for all associative @@ -83,7 +83,7 @@ namespace boost
Semantics
-Semantics: algorithms
iterator find( const Key& x );
@@ -242,7 +242,7 @@ given ptr_set<T> -+
diff --git a/doc/associative_ptr_container.rst b/doc/associative_ptr_container.rst index f937a5d..cd2cfe4 100755 --- a/doc/associative_ptr_container.rst +++ b/doc/associative_ptr_container.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``associative_ptr_container`` ------------------------------------- diff --git a/doc/boost.png b/doc/boost.png new file mode 100755 index 0000000..199b21c Binary files /dev/null and b/doc/boost.png differ diff --git a/doc/cboost.gif b/doc/cboost.gif deleted file mode 100644 index 58be431..0000000 Binary files a/doc/cboost.gif and /dev/null differ diff --git a/doc/comp_all.sh b/doc/comp_all.sh index 45d27c8..b723f09 100644 --- a/doc/comp_all.sh +++ b/doc/comp_all.sh @@ -6,9 +6,9 @@ sh comp_guidelines.sh sh comp_headers.sh sh comp_examples.sh sh comp_conventions.sh -sh comp_reversible_ptr_container.sh +sh comp_rever_ptr_container.sh sh comp_ptr_sequence_adapter.sh -sh comp_associative_ptr_container.sh +sh comp_assoc_ptr_container.sh sh comp_ptr_set_adapter.sh sh comp_ptr_multiset_adapter.sh sh comp_ptr_map_adapter.sh diff --git a/doc/conventions.html b/doc/conventions.html index b4beb62..11a4dcc 100644 --- a/doc/conventions.html +++ b/doc/conventions.html @@ -9,7 +9,7 @@ -
+ Pointer Container Library Pointer Container LibraryConventions
There are a few design decisions that will affect how the classes are used. Besides these the classes are much like normal standard containers diff --git a/doc/conventions.rst b/doc/conventions.rst index 3816b41..ffa9357 100755 --- a/doc/conventions.rst +++ b/doc/conventions.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Conventions +++++++++++ diff --git a/doc/examples.html b/doc/examples.html index 79cd215..9847fd0 100644 --- a/doc/examples.html +++ b/doc/examples.html @@ -3,13 +3,13 @@
- +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryExamples
Some examples are given here and in the accompanying test files:
@@ -22,19 +22,17 @@-- 6. Transferring ownership of a single element
- 7. Transferring ownership of pointers between different pointer containers
- 8. Selected test files
-- 9. A large example
-- 10. Changing the Clone Allocator
+-1. Null pointers cannot be stored in the containers
my_container.push_back( 0 ); // throws bad_ptr my_container.replace( an_iterator, 0 ); // throws bad_ptr my_container.insert( an_iterator, 0 ); // throws bad_ptr
-++-2. Iterators and other operations return indirected values
ptr_vector<X> pvec; @@ -46,8 +44,8 @@ pvec.begin()->foo(); // no indirection needed *vec.front() = X(); // overwrite first element pvec.front() = X(); // no indirection needed
-++-3. Copy-semantics of pointer containers
ptr_vector<T> vec1; @@ -58,15 +56,15 @@ vec2.release(); // give up ownership; the objects will be de vec1 = vec2; // compile time error: 'operator=()' not defined ptr_vector<T> vec3( vec1 ); // compile time error: copy-constructor not defined
-++-4. Making a non-copyable type Clonable
// a class that has no normal copy semantics class X : boost::noncopyable { public: X* clone() const; ... }; // this will be found by the library by argument dependent lookup -X* allocate_clone( const X& x ) +X* new_clone( const X& x ) { return x.clone(); } // we can now use the interface that requires clonability @@ -75,20 +73,20 @@ ptr_vector<X> vec1, vec2; vec2 = vec1.clone(); // 'clone()' requires cloning <g> vec2.insert( vec2.end(), vec1.begin(), vec1.end() ); // inserting always means inserting clones-++-5. Objects are cloned before insertion, inserted pointers are owned by the container
class X { ... }; // assume 'X' is Clonable X x; // and 'X' can be stack-allocated ptr_list<X> list; list.push_back( x ); // clone 'x' and then insert the resulting pointer -list.push_back( allocate_clone( x ); // do it manually +list.push_back( new_clone( x ); // do it manually list.push_back( new X ); // always give the pointer directly to the container to avoid leaks list.push_back( &x ); // don't do this!!!-++-6. Transferring ownership of a single element
ptr_deque<T> deq; @@ -100,8 +98,8 @@ auto_type ptr = deq.release_back(); // remove back element from con auto_type ptr2 = deq.release( deq.begin() + 2 ); // use an iterator to determine the element to release ptr = deq.release_front(); // supported for 'ptr_list' and 'ptr_deque'
-++-7. Transferring ownership of pointers between different pointer containers
ptr_list<X> list; ptr_vector<X> vec; @@ -112,8 +110,8 @@ ptr_list<X> list; ptr_vector<X> vec; list.transfer( list.begin(), vec.begin(), vec ); // make the first element of 'vec' the first element of 'list' vec.transfer( vec.end(), list.begin(), list.end(), list ); // put all the lists element into the vector
-++-8. Selected test files
-@@ -135,546 +133,24 @@ container of pointer pointers -9. A large example
-This examples shows many of the most common -features at work.
- - - - - - -- - - - -// -// This example is intended to get you started. -// Notice how the smart container -// -// 1. takes ownership of objects -// 2. transfers ownership -// 3. applies indirection to iterators -// 4. clones objects from other smart containers -// +Navigate:
- home diff --git a/doc/examples.rst b/doc/examples.rst index 06fa67a..5d49d59 100755 --- a/doc/examples.rst +++ b/doc/examples.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png ======== Examples @@ -68,7 +68,7 @@ Some examples are given here and in the accompanying test files: class X : boost::noncopyable { public: X* clone() const; ... }; // this will be found by the library by argument dependent lookup - X* allocate_clone( const X& x ) + X* new_clone( const X& x ) { return x.clone(); } // we can now use the interface that requires clonability @@ -89,7 +89,7 @@ Some examples are given here and in the accompanying test files: X x; // and 'X' can be stack-allocated ptr_list
std::auto_ptr<ptr_array> clone() const;
diff --git a/doc/ptr_array.rst b/doc/ptr_array.rst index 54a1773..5b9e451 100755 --- a/doc/ptr_array.rst +++ b/doc/ptr_array.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_array`` ------------------- diff --git a/doc/ptr_container.html b/doc/ptr_container.html index 1ce597f..cd7d0d3 100644 --- a/doc/ptr_container.html +++ b/doc/ptr_container.html @@ -12,7 +12,7 @@-
+ Pointer Container Library Pointer Container Librarydiff --git a/doc/ptr_container.rst b/doc/ptr_container.rst index b8059a8..0bc1571 100755 --- a/doc/ptr_container.rst +++ b/doc/ptr_container.rst @@ -3,7 +3,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png diff --git a/doc/ptr_deque.html b/doc/ptr_deque.html index b8e8c19..a658cb1 100644 --- a/doc/ptr_deque.html +++ b/doc/ptr_deque.html @@ -3,13 +3,13 @@ - + Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_deque
A ptr_deque<T> is a pointer container that uses an underlying std:deque<void*> @@ -64,7 +64,7 @@ namespace boost
Semantics
-+ -++ -++Semantics: pointer container requirements
auto_type replace( size_type idx, T* x );
diff --git a/doc/ptr_deque.rst b/doc/ptr_deque.rst index 14c077e..8af6db4 100755 --- a/doc/ptr_deque.rst +++ b/doc/ptr_deque.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_deque`` -------------------- diff --git a/doc/ptr_list.html b/doc/ptr_list.html index ce3a027..5bca916 100644 --- a/doc/ptr_list.html +++ b/doc/ptr_list.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_vector
A ptr_list<T> is a pointer container that uses an underlying std:list<void*> @@ -57,7 +57,7 @@ namespace boost
Semantics
-+ -++ -++ -++Semantics: pointer container requirements
bool transfer( iterator object, ptr_map_adapter& from );
diff --git a/doc/ptr_map_adapter.rst b/doc/ptr_map_adapter.rst index 36ae29f..0555cbc 100755 --- a/doc/ptr_map_adapter.rst +++ b/doc/ptr_map_adapter.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_map_adapter`` ------------------------- diff --git a/doc/ptr_multimap.html b/doc/ptr_multimap.html index 0850e43..6275f9e 100644 --- a/doc/ptr_multimap.html +++ b/doc/ptr_multimap.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_multimap
A ptr_multimap<Key,T> is a pointer container that uses an underlying std::multimap<Key,void*> to store the pointers.
diff --git a/doc/ptr_multimap.rst b/doc/ptr_multimap.rst index db61a22..b42149a 100755 --- a/doc/ptr_multimap.rst +++ b/doc/ptr_multimap.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_multimap`` ---------------------- diff --git a/doc/ptr_multimap_adapter.html b/doc/ptr_multimap_adapter.html index 8c65cad..89a4ff5 100644 --- a/doc/ptr_multimap_adapter.html +++ b/doc/ptr_multimap_adapter.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_multimap_adapter
This class is used to build custom pointer containers with @@ -20,7 +20,7 @@ of the interface from associative
- reversible_ptr_container
- associative_ptr_container
- ptr_multimap
-- new map iterators
+- new map iterators
Navigate:
-
@@ -57,7 +57,7 @@ namespace boost
Semantics
-+ -++Semantics: pointer container requirements
void transfer( iterator object, ptr_multimap_adapter& from );
diff --git a/doc/ptr_multimap_adapter.rst b/doc/ptr_multimap_adapter.rst index b6bf9d4..9f1c18c 100755 --- a/doc/ptr_multimap_adapter.rst +++ b/doc/ptr_multimap_adapter.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_multimap_adapter`` ------------------------------ diff --git a/doc/ptr_multiset.html b/doc/ptr_multiset.html index 106850e..ea74a77 100644 --- a/doc/ptr_multiset.html +++ b/doc/ptr_multiset.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_multiset
A ptr_multiset<T> is a pointer container that uses an underlying std::multiset<void*> to store the pointers.
diff --git a/doc/ptr_multiset.rst b/doc/ptr_multiset.rst index ccc1dac..fdedd7e 100755 --- a/doc/ptr_multiset.rst +++ b/doc/ptr_multiset.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_multiset`` ---------------------- diff --git a/doc/ptr_multiset_adapter.html b/doc/ptr_multiset_adapter.html index e79e8f1..57505b5 100644 --- a/doc/ptr_multiset_adapter.html +++ b/doc/ptr_multiset_adapter.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_multiset_adapter
This class is used to build custom pointer containers with @@ -56,7 +56,7 @@ namespace boost
Semantics
-+ -++Semantics: pointer container requirements
void transfer( iterator object, ptr_multiset_adapter& from );
diff --git a/doc/ptr_multiset_adapter.rst b/doc/ptr_multiset_adapter.rst index 45a067c..443d3cc 100755 --- a/doc/ptr_multiset_adapter.rst +++ b/doc/ptr_multiset_adapter.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_multiset_adapter`` ------------------------------ diff --git a/doc/ptr_sequence_adapter.html b/doc/ptr_sequence_adapter.html index 351dce5..4f4af2d 100644 --- a/doc/ptr_sequence_adapter.html +++ b/doc/ptr_sequence_adapter.html @@ -9,7 +9,7 @@-
+ Pointer Container Library Pointer Container LibraryClass ptr_sequence_adapter
This section describes all the common operations for all the pointer diff --git a/doc/ptr_sequence_adapter.rst b/doc/ptr_sequence_adapter.rst index 38e159c..2497536 100755 --- a/doc/ptr_sequence_adapter.rst +++ b/doc/ptr_sequence_adapter.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_sequence_adapter`` ------------------------------ diff --git a/doc/ptr_set.html b/doc/ptr_set.html index 055e0bf..82fcee9 100644 --- a/doc/ptr_set.html +++ b/doc/ptr_set.html @@ -9,7 +9,7 @@
-
+ Pointer Container Library Pointer Container LibraryClass ptr_set
A ptr_set<T> is a pointer container that uses an underlying std::set<void*> to store the pointers.
diff --git a/doc/ptr_set.rst b/doc/ptr_set.rst index e5699f7..dcfee5a 100755 --- a/doc/ptr_set.rst +++ b/doc/ptr_set.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_set`` ----------------- diff --git a/doc/ptr_set_adapter.html b/doc/ptr_set_adapter.html index 446c38a..95696ee 100644 --- a/doc/ptr_set_adapter.html +++ b/doc/ptr_set_adapter.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_set_adapter
This class is used to build custom pointer containers with @@ -56,7 +56,7 @@ namespace boost
Semantics
-+ -++Semantics: pointer container requirements
bool transfer( iterator object, ptr_set_adapter& from );
diff --git a/doc/ptr_set_adapter.rst b/doc/ptr_set_adapter.rst index 4545dcb..731c04b 100755 --- a/doc/ptr_set_adapter.rst +++ b/doc/ptr_set_adapter.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_set_adapter`` ------------------------- diff --git a/doc/ptr_vector.html b/doc/ptr_vector.html index 5d9f4fb..1adfea5 100644 --- a/doc/ptr_vector.html +++ b/doc/ptr_vector.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_vector
A ptr_vector<T> is a pointer container that uses an underlying std::vector<void*> @@ -66,7 +66,7 @@ namespace boost
Semantics
-+-Semantics: construction
ptr_vector( size_type to_reserve );
@@ -78,8 +78,8 @@ of size least to_reserve
++ -++-Semantics: element access
T& operator[]( size_type n );
@@ -128,8 +128,8 @@ of size least to_reserve
++Semantics: pointer container requirements
auto_type replace( size_type idx, T* x );
diff --git a/doc/ptr_vector.rst b/doc/ptr_vector.rst index 3f4a09e..8515ddb 100755 --- a/doc/ptr_vector.rst +++ b/doc/ptr_vector.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``ptr_vector`` -------------------- diff --git a/doc/reference.html b/doc/reference.html index 5197dfa..c6c7c2e 100644 --- a/doc/reference.html +++ b/doc/reference.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryReference
The documentation is divided into a an explanation for each container. All the common interface is explained only once, @@ -50,7 +50,7 @@ the Clone
- Class nullable
- Exception classes
-+The Clonable concept
Refinement of
-
@@ -200,7 +200,7 @@ users to apply custom allocators/deallocators for the cloned objects.
The library comes with two predefined clone allocators.
-Class heap_clone_allocator
+Class heap_clone_allocator
This is the default clone allocator used by all pointer containers. For most purposes you will never have to change this default.
Definition
@@ -227,7 +227,7 @@ namespace boost schemes by relying on new_clone() and delete_clone().-Class view_clone_allocator
+Class view_clone_allocator
This class provides a way to remove ownership properties of the pointer containers. As its name implies, this means that you can instead use the pointer containers as a view into an existing diff --git a/doc/reference.rst b/doc/reference.rst index dd24c00..7a55332 100755 --- a/doc/reference.rst +++ b/doc/reference.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png ========= Reference diff --git a/doc/reversible_ptr_container.html b/doc/reversible_ptr_container.html index 54a7b1d..510983d 100644 --- a/doc/reversible_ptr_container.html +++ b/doc/reversible_ptr_container.html @@ -9,7 +9,7 @@
-
+ Pointer Container Library Pointer Container LibraryClass reversible_ptr_container
This class is not a real class that can be found in the library. @@ -396,8 +396,8 @@ objects are compared and not the pointers to objects.
diff --git a/doc/reversible_ptr_container.rst b/doc/reversible_ptr_container.rst index 17ba5de..1df8889 100755 --- a/doc/reversible_ptr_container.rst +++ b/doc/reversible_ptr_container.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Class ``reversible_ptr_container`` ------------------------------------ diff --git a/doc/tutorial.html b/doc/tutorial.html index 2983d5a..c6a23ea 100644 --- a/doc/tutorial.html +++ b/doc/tutorial.html @@ -3,13 +3,13 @@ - +- Effects: return r.clone().release(); -
- Remarks: This function is only defined for concrete pointer containers, but not for -pointer container adapters. +
- Remarks: This function is only defined for concrete pointer containers, but not for +pointer container adapters.
Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryTutorial
The tutorial shows you the most simple usage of the library. It is assumed that the reader is familiar diff --git a/doc/tutorial.rst b/doc/tutorial.rst index 7ef831b..693404e 100755 --- a/doc/tutorial.rst +++ b/doc/tutorial.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png ======== Tutorial
list; list.push_back( x ); // clone 'x' and then insert the resulting pointer - list.push_back( allocate_clone( x ); // do it manually + list.push_back( new_clone( x ); // do it manually list.push_back( new X ); // always give the pointer directly to the container to avoid leaks list.push_back( &x ); // don't do this!!! @@ -150,24 +150,25 @@ Some examples are given here and in the accompanying test files: .. _array_test.cpp : ../test/ptr_array.cpp -9. A large example -++++++++++++++++++ +.. + 9. A large example + ++++++++++++++++++ -This examples shows many of the most common -features at work. + This examples shows many of the most common + features at work. -.. raw:: html - :file: tut1.html + .. raw:: html + :file: tut1.html -10. Changing the Clone Allocator -++++++++++++++++++++++++++++++++ + 10. Changing the Clone Allocator + ++++++++++++++++++++++++++++++++ -This example shows how we can change -the Clone Allocator to use the pointer containers -as view into other containers: + This example shows how we can change + the Clone Allocator to use the pointer containers + as view into other containers: -.. raw:: html - :file: tut2.html + .. raw:: html + :file: tut2.html **Navigate:** diff --git a/doc/faq.html b/doc/faq.html index d7dc42c..26eaa63 100644 --- a/doc/faq.html +++ b/doc/faq.html @@ -3,13 +3,13 @@ - + Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryFAQ
-
@@ -26,10 +26,10 @@
Since a pointer container is not Copy Constructible and Assignable, I cannot put them into standard containers; what do I do?
-Since they are Clonable, you simply put them in a pointer container.
+Since they are Clonable, you simply put them in a pointer container.
-Calling assign() is very costly and I do not really need to store cloned objects; I merely need to overwrite the existing ones; what do I do?
+Calling assign() is very costly and I do not really need to store cloned objects; I merely need to overwrite the existing ones; what do I do?
Call std::copy( first, last, c.begin() );.
@@ -41,7 +41,7 @@ important example is std::sort()< provided as member functions. -->-Why does ptr_map<T>::insert()/replace() take two arguments (the key and the pointer) instead of one std::pair? And why is the key passed by non-const reference?
+Why does ptr_map<T>::insert()/replace() take two arguments (the key and the pointer) instead of one std::pair? And why is the key passed by non-const reference?
This is the only way the function can be implemented in an exception-safe manner; since the copy-constructor of the key might throw, and since function arguments are not guaranteed to be evaluated from left to right, @@ -49,7 +49,7 @@ we need to ensure that evaluating the first argument does not throw. Passing the key as a reference achieves just that.
-When instantiating a pointer container with a type T, is T then allowed to be incomplete at that point?
+When instantiating a pointer container with a type T, is T then allowed to be incomplete at that point?
No. This is a distinct property of shared_ptr which implies some overhead.
However, one can leave T incomplete in the header file:
@@ -75,7 +75,7 @@ do so; the overhead is one heap-allocation which is relatively small compared to cloning N objects.
-What is the polymorphic class problem?
+What is the polymorphic class problem?
The problem refers to the relatively troublesome way C++ supports Object Oriented programming in connection with containers of pointers to polymorphic objects. In a language without garbage collection, you end up @@ -95,7 +95,7 @@ you have many small objects, it is not. Further reading can be found in these references: [11] and [12].
-When the stored pointers cannot be 0, how do I allow this "empty" behavior anyway?
+When the stored pointers cannot be 0, how do I allow this "empty" behavior anyway?
Storing a null-pointer among a list of pointers does not fit well into the Object Oriented paradigm. The most elegant design is to use the Null-Object Pattern where one basically makes a concrete class with dummy implementations of the virtual functions. See [13] for details.
diff --git a/doc/faq.rst b/doc/faq.rst index 18d8536..83102f6 100755 --- a/doc/faq.rst +++ b/doc/faq.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png === FAQ diff --git a/doc/guidelines.html b/doc/guidelines.html index 88bcada..8ac18cf 100644 --- a/doc/guidelines.html +++ b/doc/guidelines.html @@ -3,13 +3,13 @@ - +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryUsage Guidelines
The recommended usage pattern of the container classes are the same as the for normal standard containers.
diff --git a/doc/guidelines.rst b/doc/guidelines.rst index 69b3b6d..142dd00 100755 --- a/doc/guidelines.rst +++ b/doc/guidelines.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png ================ Usage Guidelines diff --git a/doc/headers.html b/doc/headers.html index 4d3fc36..95788fe 100644 --- a/doc/headers.html +++ b/doc/headers.html @@ -9,7 +9,7 @@-
+ Pointer Container Library Pointer Container LibraryLibrary headers
diff --git a/doc/headers.rst b/doc/headers.rst index 2209b95..a2cfc4b 100755 --- a/doc/headers.rst +++ b/doc/headers.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png =============== Library headers diff --git a/doc/indirect_fun.html b/doc/indirect_fun.html index 078fd35..5878a50 100644 --- a/doc/indirect_fun.html +++ b/doc/indirect_fun.html @@ -3,13 +3,13 @@ - + Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryIndirected functions
It is quite common that we have two pointers and what to compare the pointed to objects. Also, we have usually already defined how diff --git a/doc/indirect_fun.rst b/doc/indirect_fun.rst index e994624..488bd2c 100755 --- a/doc/indirect_fun.rst +++ b/doc/indirect_fun.rst @@ -2,7 +2,7 @@ |Boost| Pointer Container Library ++++++++++++++++++++++++++++++++++ -.. |Boost| image:: cboost.gif +.. |Boost| image:: boost.png Indirected functions -------------------- diff --git a/doc/ptr_array.html b/doc/ptr_array.html index 05ca880..ca0e288 100644 --- a/doc/ptr_array.html +++ b/doc/ptr_array.html @@ -3,13 +3,13 @@
- +Boost Pointer Container Library -
+ Pointer Container Library Pointer Container LibraryClass ptr_array
A ptr_array<T,size> is a pointer container that uses an underlying boost::array<void*,size> @@ -84,7 +84,7 @@ namespace boost
Semantics
-+ -++ -++ -++Semantics: pointer container requirements