| Version: 3.3.1

Public Member Functions | List of all members
wxScopedPtr Class Reference
Class List by Category » Smart Pointers

`#include <wx/scopedptr.h>`

Inheritance diagram for wxScopedPtr:
[legend]

## Detailed Description

Deprecated equivalent of standard `unique_ptr` template class.

Please don't use this class, and especially its macro-based versions, in the new code.

This is a simple scoped smart pointer implementation that is similar to the Boost smart pointers (see http://www.boost.org) but rewritten to use macros instead.

Since wxWidgets 2.9.0 there is also a templated version of this class with the same name. See wxScopedPtr<T>.

A smart pointer holds a pointer to an object. The memory used by the object is deleted when the smart pointer goes out of scope. This class is different from the `std::auto_ptr<>` in so far as it doesn't provide copy constructor nor assignment operator. This limits what you can do with it but is much less surprising than the "destructive copy" behaviour of the standard class.

Example:

Below is an example of using a wxWidgets scoped smart pointer and pointer array.

class MyClass{ ... };
// declare a smart pointer to a MyClass called wxMyClassPtr
wxDECLARE_SCOPED_PTR(MyClass, wxMyClassPtr)
// declare a smart pointer to an array of chars
wxDECLARE_SCOPED_ARRAY(char, wxCharArray)
...
// define the first pointer class, must be complete
wxDEFINE_SCOPED_PTR(MyClass, wxMyClassPtr)
// define the second pointer class
wxDEFINE_SCOPED_ARRAY(char, wxCharArray)
// create an object with a new pointer to MyClass
wxMyClassPtr theObj(new MyClass());
// reset the pointer (deletes the previous one)
theObj.reset(new MyClass());
// access the pointer
theObj->MyFunc();
// create an object with a new array of chars
wxCharArray theCharObj(new char[100]);
// access the array
theCharObj[0] = "!";

# Declaring new smart pointer types

To declare the smart pointer class `CLASSNAME` containing pointer to a (possibly incomplete) type `TYPE` you should use

wxDECLARE_SCOPED_PTR( TYPE, // type of the values
CLASSNAME ); // name of the class

And later, when `TYPE` is fully defined, you must also use

wxDEFINE_SCOPED_PTR( TYPE, CLASSNAME );

to implement the scoped pointer class.

The first argument of these macro is the pointer type, the second is the name of the new smart pointer class being created. Below we will use wxScopedPtr to represent the scoped pointer class, but the user may create the class with any legal name.

Alternatively, if you don't have to separate the point of declaration and definition of this class and if you accept the standard naming convention, that is that the scoped pointer for the class `Foo` is called `FooPtr`, you can use a single macro which replaces two macros above:

wxDEFINE_SCOPED_PTR_TYPE( TYPE );

Once again, in this cass `CLASSNAME` will be `TYPEPtr`.

##

Library: wxBase
Category: Smart Pointers

See also
  wxScopedArray

## Public Member Functions
| wxScopedPtr (type *T=nullptr)
| Creates the smart pointer with the given pointer or none if nullptr. More...
| ~wxScopedPtr ()
| Destructor frees the pointer help by this object if it is not nullptr. More...
T * | get () const
| This operator gets the pointer stored in the smart pointer or returns nullptr if there is none. More...
T & | operator* () const
| This operator works like the standard C++ pointer operator to return the object being pointed to by the pointer. More...
T * | operator-> () const
| Smart pointer member access. More...
T * | release ()
| Returns the currently hold pointer and resets the smart pointer object to nullptr. More...
| reset (T *p=nullptr)
| Deletes the currently held pointer and sets it to p or to nullptr if no arguments are specified. More...
| swap (wxScopedPtr &other)
| Swap the pointer inside the smart pointer with other. More...

## Constructor & Destructor Documentation

## ◆ wxScopedPtr()

wxScopedPtr::wxScopedPtr | ( | type * | T = `nullptr` | ) |
| explicit

Creates the smart pointer with the given pointer or none if nullptr.

On compilers that support it, this uses the explicit keyword.

## ◆ ~wxScopedPtr()

wxScopedPtr::~wxScopedPtr | ( |  | ) |

Destructor frees the pointer help by this object if it is not nullptr.

## Member Function Documentation

## ◆ get()

T* wxScopedPtr::get | ( |  | ) | const

This operator gets the pointer stored in the smart pointer or returns nullptr if there is none.

## ◆ operator*()

T& wxScopedPtr::operator* | ( |  | ) | const

This operator works like the standard C++ pointer operator to return the object being pointed to by the pointer.

If the internal pointer is nullptr this method will cause an assert in debug mode.

## ◆ operator->()

T* wxScopedPtr::operator-> | ( |  | ) | const

Smart pointer member access.

Returns pointer to its object.

If the internal pointer is nullptr this method will cause an assert in debug mode.

## ◆ release()

T* wxScopedPtr::release | ( |  | ) |

Returns the currently hold pointer and resets the smart pointer object to nullptr.

Remarks
  After a call to this function the caller is responsible for deleting the pointer.

## ◆ reset()

wxScopedPtr::reset | ( | T * | p = `nullptr` | ) |

Deletes the currently held pointer and sets it to p or to nullptr if no arguments are specified.

Note
  This function does check to make sure that the pointer you are assigning is not the same pointer that is already stored.

## ◆ swap()

wxScopedPtr::swap | ( | wxScopedPtr & | other | ) |

Swap the pointer inside the smart pointer with other.

The pointer being swapped must be of the same type (hence the same class name).