ICU 58.2  58.2
Data Structures | Namespaces | Macros
localpointer.h File Reference

C++ API: "Smart pointers" for use with and in ICU4C C++ code. More...

#include "unicode/utypes.h"

Go to the source code of this file.

Data Structures

class  icu::LocalPointerBase< T >
 "Smart pointer" base class; do not use directly: use LocalPointer etc. More...
 
class  icu::LocalPointer< T >
 "Smart pointer" class, deletes objects via the standard C++ delete operator. More...
 
class  icu::LocalArray< T >
 "Smart pointer" class, deletes objects via the C++ array delete[] operator. More...
 

Namespaces

 icu
 File coll.h.
 

Macros

#define U_DEFINE_LOCAL_OPEN_POINTER(LocalPointerClassName, Type, closeFunction)
 "Smart pointer" definition macro, deletes objects via the closeFunction. More...
 

Detailed Description

C++ API: "Smart pointers" for use with and in ICU4C C++ code.

These classes are inspired by

but none of those provide for all of the goals for ICU smart pointers:

For details see http://site.icu-project.org/design/cpp/scoped_ptr

Definition in file localpointer.h.

Macro Definition Documentation

#define U_DEFINE_LOCAL_OPEN_POINTER (   LocalPointerClassName,
  Type,
  closeFunction 
)
Value:
class LocalPointerClassName : public LocalPointerBase<Type> { \
public: \
using LocalPointerBase<Type>::operator*; \
using LocalPointerBase<Type>::operator->; \
explicit LocalPointerClassName(Type *p=NULL) : LocalPointerBase<Type>(p) {} \
~LocalPointerClassName() { closeFunction(ptr); } \
LocalPointerClassName &moveFrom(LocalPointerClassName &src) U_NOEXCEPT { \
if (ptr != NULL) { closeFunction(ptr); } \
LocalPointerBase<Type>::ptr=src.ptr; \
src.ptr=NULL; \
return *this; \
} \
void swap(LocalPointerClassName &other) U_NOEXCEPT { \
Type *temp=LocalPointerBase<Type>::ptr; \
LocalPointerBase<Type>::ptr=other.ptr; \
other.ptr=temp; \
} \
friend inline void swap(LocalPointerClassName &p1, LocalPointerClassName &p2) U_NOEXCEPT { \
p1.swap(p2); \
} \
void adoptInstead(Type *p) { \
if (ptr != NULL) { closeFunction(ptr); } \
ptr=p; \
} \
}
#define NULL
Define NULL if necessary, to 0 for C++ and to ((void *)0) for C.
Definition: utypes.h:188
#define U_NOEXCEPT
"noexcept" if supported, otherwise empty.
Definition: platform.h:531

"Smart pointer" definition macro, deletes objects via the closeFunction.

Defines a subclass of LocalPointerBase which works just like LocalPointer<Type> except that this subclass will use the closeFunction rather than the C++ delete operator.

Usage example:

1 LocalUCaseMapPointer csm(ucasemap_open(localeID, options, &errorCode));
2 utf8OutLength=ucasemap_utf8ToLower(csm.getAlias(),
3  utf8Out, (int32_t)sizeof(utf8Out),
4  utf8In, utf8InLength, &errorCode);
5 if(U_FAILURE(errorCode)) { return; } // no need to explicitly delete the UCaseMap
See also
LocalPointerBase
LocalPointer
Stable:
ICU 4.4

Definition at line 530 of file localpointer.h.