ICU 56.1
56.1
|
"Smart pointer" class, deletes objects via the C++ array delete[] operator. More...
#include <localpointer.h>
Public Member Functions | |
LocalArray (T *p=NULL) | |
Constructor takes ownership. | |
LocalArray (T *p, UErrorCode &errorCode) | |
Constructor takes ownership and reports an error if NULL. | |
~LocalArray () | |
Destructor deletes the array it owns. | |
LocalArray< T > & | moveFrom (LocalArray< T > &src) U_NOEXCEPT |
Move assignment, leaves src with isNull(). | |
void | swap (LocalArray< T > &other) U_NOEXCEPT |
Swap pointers. | |
void | adoptInstead (T *p) |
Deletes the array it owns, and adopts (takes ownership of) the one passed in. | |
void | adoptInsteadAndCheckErrorCode (T *p, UErrorCode &errorCode) |
Deletes the array it owns, and adopts (takes ownership of) the one passed in. | |
T & | operator[] (ptrdiff_t i) const |
Array item access (writable). | |
![]() | |
LocalPointerBase (T *p=NULL) | |
Constructor takes ownership. | |
~LocalPointerBase () | |
Destructor deletes the object it owns. | |
UBool | isNull () const |
NULL check. | |
UBool | isValid () const |
NULL check. | |
bool | operator== (const T *other) const |
Comparison with a simple pointer, so that existing code with ==NULL need not be changed. | |
bool | operator!= (const T *other) const |
Comparison with a simple pointer, so that existing code with !=NULL need not be changed. | |
T * | getAlias () const |
Access without ownership change. | |
T & | operator* () const |
Access without ownership change. | |
T * | operator-> () const |
Access without ownership change. | |
T * | orphan () |
Gives up ownership; the internal pointer becomes NULL. |
Friends | |
void | swap (LocalArray< T > &p1, LocalArray< T > &p2) U_NOEXCEPT |
Non-member LocalArray swap function. |
Additional Inherited Members | |
![]() | |
T * | ptr |
Actual pointer. |
"Smart pointer" class, deletes objects via the C++ array delete[] operator.
For most methods see the LocalPointerBase base class. Adds operator[] for array item access.
Usage example:
Definition at line 338 of file localpointer.h.
|
inlineexplicit |
Constructor takes ownership.
p | simple pointer to an array of T objects that is adopted |
Definition at line 345 of file localpointer.h.
|
inline |
Constructor takes ownership and reports an error if NULL.
This constructor is intended to be used with other-class constructors that may report a failure UErrorCode, so that callers need to check only for U_FAILURE(errorCode) and not also separately for isNull().
p | simple pointer to an array of T objects that is adopted |
errorCode | in/out UErrorCode, set to U_MEMORY_ALLOCATION_ERROR if p==NULL and no other failure code had been set |
Definition at line 360 of file localpointer.h.
References NULL, U_MEMORY_ALLOCATION_ERROR, and U_SUCCESS.
|
inline |
|
inline |
Deletes the array it owns, and adopts (takes ownership of) the one passed in.
p | simple pointer to an array of T objects that is adopted |
Reimplemented from icu::LocalPointerBase< T >.
Definition at line 437 of file localpointer.h.
|
inline |
Deletes the array it owns, and adopts (takes ownership of) the one passed in.
If U_FAILURE(errorCode), then the current array is retained and the new one deleted.
If U_SUCCESS(errorCode) but the input pointer is NULL, then U_MEMORY_ALLOCATION_ERROR is set, the current array is deleted, and NULL is set.
p | simple pointer to an array of T objects that is adopted |
errorCode | in/out UErrorCode, set to U_MEMORY_ALLOCATION_ERROR if p==NULL and no other failure code had been set |
Definition at line 457 of file localpointer.h.
References NULL, U_MEMORY_ALLOCATION_ERROR, and U_SUCCESS.
|
inline |
Move assignment, leaves src with isNull().
The behavior is undefined if *this and src are the same object.
Can be called explicitly, does not need C++11 support.
src | source smart pointer |
Definition at line 405 of file localpointer.h.
References NULL, and icu::LocalPointerBase< T >::ptr.
|
inline |
Array item access (writable).
No index bounds check.
i | array index |
Definition at line 476 of file localpointer.h.
|
inline |
Swap pointers.
other | other smart pointer |
Definition at line 416 of file localpointer.h.
References icu::LocalPointerBase< T >::ptr.
|
friend |
Non-member LocalArray swap function.
p1 | will get p2's pointer |
p2 | will get p1's pointer |
Definition at line 427 of file localpointer.h.