ICU 50.2 50.2
localpointer.h
Go to the documentation of this file.
1/*
2*******************************************************************************
3*
4* Copyright (C) 2009-2012, International Business Machines
5* Corporation and others. All Rights Reserved.
6*
7*******************************************************************************
8* file name: localpointer.h
9* encoding: US-ASCII
10* tab size: 8 (not used)
11* indentation:4
12*
13* created on: 2009nov13
14* created by: Markus W. Scherer
15*/
16
17#ifndef __LOCALPOINTER_H__
18#define __LOCALPOINTER_H__
19
38
39#include "unicode/utypes.h"
40
41#if U_SHOW_CPLUSPLUS_API
42
44
63template<typename T>
65public:
71 explicit LocalPointerBase(T *p=NULL) : ptr(p) {}
77 ~LocalPointerBase() { /* delete ptr; */ }
83 UBool isNull() const { return ptr==NULL; }
89 UBool isValid() const { return ptr!=NULL; }
97 bool operator==(const T *other) const { return ptr==other; }
105 bool operator!=(const T *other) const { return ptr!=other; }
111 T *getAlias() const { return ptr; }
117 T &operator*() const { return *ptr; }
123 T *operator->() const { return ptr; }
130 T *orphan() {
131 T *p=ptr;
132 ptr=NULL;
133 return p;
134 }
135
142 void adoptInstead(T *p) {
143 // delete ptr;
144 ptr=p;
145 }
146protected:
151 T *ptr;
152private:
153 // No comparison operators with other LocalPointerBases.
154 bool operator==(const LocalPointerBase &other);
155 bool operator!=(const LocalPointerBase &other);
156 // No ownership transfer: No copy constructor, no assignment operator.
158 void operator=(const LocalPointerBase &other);
159 // No heap allocation. Use only on the stack.
160 static void * U_EXPORT2 operator new(size_t size);
161 static void * U_EXPORT2 operator new[](size_t size);
162#if U_HAVE_PLACEMENT_NEW
163 static void * U_EXPORT2 operator new(size_t, void *ptr);
164#endif
165};
166
185template<typename T>
187public:
193 explicit LocalPointer(T *p=NULL) : LocalPointerBase<T>(p) {}
201
211};
212
231template<typename T>
232class LocalArray : public LocalPointerBase<T> {
233public:
239 explicit LocalArray(T *p=NULL) : LocalPointerBase<T>(p) {}
246 }
247
253 void adoptInstead(T *p) {
256 }
257
264 T &operator[](ptrdiff_t i) const { return LocalPointerBase<T>::ptr[i]; }
265};
266
290#define U_DEFINE_LOCAL_OPEN_POINTER(LocalPointerClassName, Type, closeFunction) \
291 class LocalPointerClassName : public LocalPointerBase<Type> { \
292 public: \
293 explicit LocalPointerClassName(Type *p=NULL) : LocalPointerBase<Type>(p) {} \
294 ~LocalPointerClassName() { closeFunction(ptr); } \
295 void adoptInstead(Type *p) { \
296 closeFunction(ptr); \
297 ptr=p; \
298 } \
299 }
300
302
303#endif /* U_SHOW_CPLUSPLUS_API */
304#endif /* __LOCALPOINTER_H__ */
T & operator[](ptrdiff_t i) const
Array item access (writable).
void adoptInstead(T *p)
Deletes the array it owns, and adopts (takes ownership of) the one passed in.
LocalArray(T *p=NULL)
Constructor takes ownership.
~LocalArray()
Destructor deletes the array it owns.
T * ptr
Actual pointer.
T * getAlias() const
Access without ownership change.
bool operator!=(const T *other) const
Comparison with a simple pointer, so that existing code with !=NULL need not be changed.
T * operator->() const
Access without ownership change.
void adoptInstead(T *p)
Deletes the object it owns, and adopts (takes ownership of) the one passed in.
T * orphan()
Gives up ownership; the internal pointer becomes NULL.
UBool isNull() const
NULL check.
LocalPointerBase(T *p=NULL)
Constructor takes ownership.
~LocalPointerBase()
Destructor deletes the object it owns.
bool operator==(const T *other) const
Comparison with a simple pointer, so that existing code with ==NULL need not be changed.
UBool isValid() const
NULL check.
T & operator*() const
Access without ownership change.
~LocalPointer()
Destructor deletes the object it owns.
LocalPointer(T *p=NULL)
Constructor takes ownership.
void adoptInstead(T *p)
Deletes the object it owns, and adopts (takes ownership of) the one passed in.
int8_t UBool
The ICU boolean type.
Definition umachine.h:200
Basic definitions for ICU, for both C and C++ APIs.
#define NULL
Define NULL if necessary, to 0 for C++ and to ((void *)0) for C.
Definition utypes.h:186
#define U_NAMESPACE_END
This is used to end a declaration of a public ICU C++ API.
Definition uversion.h:130
#define U_NAMESPACE_BEGIN
This is used to begin a declaration of a public ICU C++ API.
Definition uversion.h:129