1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: interface of wxSharedPtr<T>
4 // Author: wxWidgets team
6 // Licence: wxWindows license
7 /////////////////////////////////////////////////////////////////////////////
10 A smart pointer with non-intrusive reference counting.
12 It is modeled after @c boost::shared_ptr<> and can be used with STL
13 containers and wxVector<T> unlike @c std::auto_ptr<> and wxScopedPtr<T>.
16 @category{smartpointers}
18 @see wxScopedPtr<T>, wxWeakRef<T>, wxObjectDataPtr<T>
27 Creates shared pointer from the raw pointer @a ptr and takes ownership
30 wxEXPLICIT
wxSharedPtr(T
* ptr
= NULL
);
35 wxSharedPtr(const wxSharedPtr
<T
>& tocopy
);
43 Returns pointer to its object or @NULL.
48 Conversion to a boolean expression (in a variant which is not
49 convertible to anything but a boolean expression).
51 If this class contains a valid pointer it will return @true, if it contains
52 a @NULL pointer it will return @false.
54 operator unspecified_bool_type() const;
57 Returns a reference to the object.
59 If the internal pointer is @NULL this method will cause an assert in debug mode.
64 Returns pointer to its object or @NULL.
66 T
* operator->() const;
71 Releases any previously held pointer and creates a reference to @a ptr.
73 wxSharedPtr
<T
>& operator=(T
* ptr
);
78 Releases any previously held pointer and creates a reference to the
79 same object as @a topcopy.
81 wxSharedPtr
<T
>& operator=(const wxSharedPtr
<T
>& tocopy
);
84 Reset pointer to @a ptr.
86 If the reference count of the previously owned pointer was 1 it will be deleted.
88 void reset(T
* ptr
= NULL
);
91 Returns @true if this is the only pointer pointing to its object.
96 Returns the number of pointers pointing to its object.
98 long use_count() const;