Version: 3.0.3
wxCharTypeBuffer< T > Class Template Reference

#include <wx/buffer.h>

+ Inheritance diagram for wxCharTypeBuffer< T >:

Detailed Description

template<typename T>
class wxCharTypeBuffer< T >

wxCharTypeBuffer<T> is a template class for storing characters.

The difference from wxScopedCharTypeBuffer<T> is that this class doesn't have non-owned mode and the data stored in it are valid for as long as the buffer instance exists. Other than that, this class' behaviour is the same as wxScopedCharTypeBuffer<T>'s – in particular, the data are reference-counted and copying the buffer is cheap.

wxScopedCharTypeBuffer<T> buffers can be converted into wxCharTypeBuffer<T>.

Template Parameters
TThe type of the characters stored in this class.
Since
2.9.0

Library:  None; this class implementation is entirely header-based.
Category:  Data Structures

Public Member Functions

 wxCharTypeBuffer (const CharType *str=NULL, size_t len=wxNO_LEN)
 Creates (owned) buffer from str and takes ownership of it. More...
 
 wxCharTypeBuffer (size_t len)
 Creates (owned) buffer of size len. More...
 
 wxCharTypeBuffer (const wxCharTypeBuffer &src)
 Copy constructor. More...
 
 wxCharTypeBuffer (const wxScopedCharTypeBuffer< T > &src)
 Makes a copy of scoped buffer src. More...
 
wxCharTypeBufferoperator= (const CharType *str)
 Assigns str to this buffer and takes ownership of it (i.e. the buffer becomes "owned"). More...
 
wxCharTypeBufferoperator= (const wxCharTypeBuffer &src)
 Assignment operator behaves in the same way as the copy constructor. More...
 
wxCharTypeBufferoperator= (const wxScopedCharTypeBuffer< T > &src)
 Assigns a scoped buffer to this buffer. More...
 
bool extend (size_t len)
 Extends the buffer to have size len. More...
 
bool shrink (size_t len)
 Shrinks the buffer to have size len and NUL-terminates the string at this length. More...
 
- Public Member Functions inherited from wxScopedCharTypeBuffer< T >
 wxScopedCharTypeBuffer ()
 Default constructor, creates NULL buffer. More...
 
 wxScopedCharTypeBuffer (const wxScopedCharTypeBuffer &src)
 Copy constructor. More...
 
wxScopedCharTypeBufferoperator= (const wxScopedCharTypeBuffer &src)
 Assignment operator behaves in the same way as the copy constructor. More...
 
 ~wxScopedCharTypeBuffer ()
 Destructor. More...
 
void reset ()
 Resets the buffer to NULL, freeing the data if necessary. More...
 
CharTypedata ()
 Returns pointer to the stored data. More...
 
const CharTypedata () const
 Returns const pointer to the stored data. More...
 
size_t length () const
 Returns length of the string stored. More...
 
 operator const CharType * () const
 Implicit conversion to C string. More...
 
CharType operator[] (size_t n) const
 Random access to the stored C string. More...
 

Additional Inherited Members

- Public Types inherited from wxScopedCharTypeBuffer< T >
typedef T CharType
 Stored characters type. More...
 
- Static Public Member Functions inherited from wxScopedCharTypeBuffer< T >
static const wxScopedCharTypeBuffer CreateNonOwned (const CharType *str, size_t len=wxNO_LEN)
 Creates non-owned buffer from string data str. More...
 
static const wxScopedCharTypeBuffer CreateOwned (CharType *str, size_t len=wxNO_LEN)
 Creates owned buffer from str and takes ownership of it. More...
 

Constructor & Destructor Documentation

template<typename T>
wxCharTypeBuffer< T >::wxCharTypeBuffer ( const CharType str = NULL,
size_t  len = wxNO_LEN 
)

Creates (owned) buffer from str and takes ownership of it.

Parameters
strString data.
lenIf specified, length of the string, otherwise the string is considered to be NUL-terminated.
See also
wxScopedCharTypeBuffer<T>::CreateOwned()
template<typename T>
wxCharTypeBuffer< T >::wxCharTypeBuffer ( size_t  len)

Creates (owned) buffer of size len.

See also
wxScopedCharTypeBuffer<T>::CreateOwned()
template<typename T>
wxCharTypeBuffer< T >::wxCharTypeBuffer ( const wxCharTypeBuffer< T > &  src)

Copy constructor.

Increases reference count on the data, does not make wxStrdup() copy of the data.

template<typename T>
wxCharTypeBuffer< T >::wxCharTypeBuffer ( const wxScopedCharTypeBuffer< T > &  src)

Makes a copy of scoped buffer src.

If src is a non-owned buffer, a copy of its data is made using wxStrdup(). If src is an owned buffer, this constructor behaves in the usual way (reference count on buffer data is incremented).

Member Function Documentation

template<typename T>
bool wxCharTypeBuffer< T >::extend ( size_t  len)

Extends the buffer to have size len.

Can only be called on buffers that don't share data with another buffer (i.e. reference count of the data is 1).

See also
shrink()
template<typename T>
wxCharTypeBuffer& wxCharTypeBuffer< T >::operator= ( const CharType str)

Assigns str to this buffer and takes ownership of it (i.e. the buffer becomes "owned").

template<typename T>
wxCharTypeBuffer& wxCharTypeBuffer< T >::operator= ( const wxCharTypeBuffer< T > &  src)

Assignment operator behaves in the same way as the copy constructor.

template<typename T>
wxCharTypeBuffer& wxCharTypeBuffer< T >::operator= ( const wxScopedCharTypeBuffer< T > &  src)

Assigns a scoped buffer to this buffer.

If src is a non-owned buffer, a copy of its data is made using wxStrdup(). If src is an owned buffer, the assignment behaves in the usual way (reference count on buffer data is incremented).

template<typename T>
bool wxCharTypeBuffer< T >::shrink ( size_t  len)

Shrinks the buffer to have size len and NUL-terminates the string at this length.

Can only be called on buffers that don't share data with another buffer (i.e. reference count of the data is 1).

Parameters
lenLength to shrink to. Must not be larger than current length.
Note
The string is not reallocated to take less memory.
Since
2.9.0
See also
extend()