#include </home/zeitlin/src/wx/github/interface/wx/buffer.h>
wxScopedCharTypeBuffer<T> is a template class for storing characters.
Data are stored in reference-counted buffer. In other words, making a copy of wxScopedCharTypeBuffer<T> will not make another copy of the stored string data, it will still point to the same location in memory.
wxScopedCharTypeBuffer<T> supports two storage modes: owned and non-owned. "Owned" data buffer (created with CreateOwned() or wxCharTypeBuffer<T> derived class) owns the data and frees them when the last buffer pointing to them is destroyed.
"Non-owned" buffer (created with CreateNonOwned()), on the other hand, references data owned by somebody else -- typical use is by wxString::mb_str() or wxString::wc_str(), which may return non-owned buffer pointing to wxString's internal store.
Because of this, the validity of data stored in wxScopedCharTypeBuffer<T> is limited by the lifetime of the "parent" object that created the buffer (e.g. the wxString on which mb_str() was called).
If you need to preserve the data for longer, assign it to wxCharTypeBuffer<T> instead of wxScopedCharTypeBuffer<T>. On the other hand, use wxScopedCharTypeBuffer<T> if the buffer is to be destroyed before the "parent" object -- typical use would be creating it on the stack and destroying when it goes out of scope (hence the class' name).
T | The type of the characters stored in this class. |
Public Types | |
typedef T | CharType |
Stored characters type. | |
Public Member Functions | |
wxScopedCharTypeBuffer () | |
Default constructor, creates NULL buffer. | |
wxScopedCharTypeBuffer (const wxScopedCharTypeBuffer &src) | |
Copy constructor. | |
wxScopedCharTypeBuffer & | operator= (const wxScopedCharTypeBuffer &src) |
Assignment operator behaves in the same way as the copy constructor. | |
~wxScopedCharTypeBuffer () | |
Destructor. | |
void | reset () |
Resets the buffer to NULL, freeing the data if necessary. | |
CharType * | data () |
Returns pointer to the stored data. | |
const CharType * | data () const |
Returns const pointer to the stored data. | |
size_t | length () const |
Returns length of the string stored. | |
operator const CharType * () const | |
Implicit conversion to C string. | |
CharType | operator[] (size_t n) const |
Random access to the stored C string. | |
Static Public Member Functions | |
static const wxScopedCharTypeBuffer | CreateNonOwned (const CharType *str, size_t len=wxNO_LEN) |
Creates non-owned buffer from string data str. | |
static const wxScopedCharTypeBuffer | CreateOwned (CharType *str, size_t len=wxNO_LEN) |
Creates owned buffer from str and takes ownership of it. |
typedef T wxScopedCharTypeBuffer< T >::CharType |
Stored characters type.
wxScopedCharTypeBuffer< T >::wxScopedCharTypeBuffer | ( | ) |
Default constructor, creates NULL buffer.
wxScopedCharTypeBuffer< T >::wxScopedCharTypeBuffer | ( | const wxScopedCharTypeBuffer< T > & | src | ) |
Copy constructor.
Increases reference count on the data, does not make wxStrdup() copy of the data.
wxScopedCharTypeBuffer< T >::~wxScopedCharTypeBuffer | ( | ) |
Destructor.
Frees stored data if it is in "owned" mode and data's reference count reaches zero.
static const wxScopedCharTypeBuffer wxScopedCharTypeBuffer< T >::CreateNonOwned | ( | const CharType * | str, |
size_t | len = wxNO_LEN |
||
) | [static] |
Creates non-owned buffer from string data str.
The buffer's destructor will not destroy str. The returned buffer's data is valid only as long as str is valid.
str | String data. |
len | If specified, length of the string, otherwise the string is considered to be NUL-terminated. |
static const wxScopedCharTypeBuffer wxScopedCharTypeBuffer< T >::CreateOwned | ( | CharType * | str, |
size_t | len = wxNO_LEN |
||
) | [static] |
Creates owned buffer from str and takes ownership of it.
The buffer's destructor will free str when its reference count reaches zero (initial count is 1).
str | String data. |
len | If specified, length of the string, otherwise the string is considered to be NUL-terminated. |
CharType* wxScopedCharTypeBuffer< T >::data | ( | ) |
Returns pointer to the stored data.
const CharType* wxScopedCharTypeBuffer< T >::data | ( | ) | const |
Returns const pointer to the stored data.
size_t wxScopedCharTypeBuffer< T >::length | ( | ) | const |
Returns length of the string stored.
wxScopedCharTypeBuffer< T >::operator const CharType * | ( | ) | const |
Implicit conversion to C string.
wxScopedCharTypeBuffer& wxScopedCharTypeBuffer< T >::operator= | ( | const wxScopedCharTypeBuffer< T > & | src | ) |
Assignment operator behaves in the same way as the copy constructor.
Reimplemented in wxCharTypeBuffer< T >.
CharType wxScopedCharTypeBuffer< T >::operator[] | ( | size_t | n | ) | const |
Random access to the stored C string.
void wxScopedCharTypeBuffer< T >::reset | ( | ) |
Resets the buffer to NULL, freeing the data if necessary.