Zen API
 All Classes Files Functions Variables Typedefs Friends Macros Modules Pages
kAlloc.h
Go to the documentation of this file.
1 
10 #include <kApi/kApiDef.h> //--inclusion order controlled by kApiDef
11 
12 #ifndef K_API_ALLOC_H
13 #define K_API_ALLOC_H
14 
15 #include <kApi/kAlloc.x.h>
16 
24 /*
25 * Public
26 */
27 
37 kInlineFx(kStatus) kAlloc_Get(kAlloc alloc, kSize size, void* mem)
38 {
39  return xkAlloc_VTable(alloc)->VGet(alloc, size, mem);
40 }
41 
51 kInlineFx(kStatus) kAlloc_GetZero(kAlloc alloc, kSize size, void* mem)
52 {
53  kCheck(kAlloc_Get(alloc, size, mem));
54 
55  kCheck(kMemSet(kPointer_ReadAs(mem, kPointer), 0, size));
56 
57  return kOK;
58 }
59 
69 kInlineFx(kStatus) kAlloc_GetObject(kAlloc alloc, kType type, void* mem)
70 {
72 
73  return kAlloc_Get(alloc, kType_InnerSize(type), mem);
74 }
75 
84 kInlineFx(kStatus) kAlloc_Free(kAlloc alloc, void* mem)
85 {
86  return xkAlloc_VTable(alloc)->VFree(alloc, mem);
87 }
88 
98 {
99  kCheck(kAlloc_Free(alloc, *(void**)mem));
100 
102 
103  return kOK;
104 }
105 
116 kInlineFx(kStatus) kAlloc_Export(kAlloc alloc, void* dest, const void* src, kSize size)
117 {
118  return xkAlloc_VTable(alloc)->VExport(alloc, dest, src, size);
119 }
120 
129 {
130  kObj(kAlloc, alloc);
131 
132  return obj->canGetObject;
133 }
134 
143 {
144  kObj(kAlloc, alloc);
145 
146  return obj->isForeign;
147 }
148 
149 
160 {
161  return xkAlloc_Static()->appAlloc;
162 }
163 
176 {
177  return xkAlloc_Static()->systemAlloc;
178 }
179 
188 {
189  return kIsNull(alloc) ? kAlloc_App() : alloc;
190 }
191 
192 /*
193 * Protected
194 */
195 
207 kFx(kStatus) kAlloc_Init(kAlloc alloc, kType type, kAlloc allocator);
208 
217 kFx(kStatus) kAlloc_VRelease(kAlloc alloc);
218 
230 kFx(kStatus) kAlloc_VGet(kAlloc alloc, kSize size, void* mem);
231 
242 kFx(kStatus) kAlloc_VFree(kAlloc alloc, void* mem);
243 
254 kFx(kStatus) kAlloc_VExport(kAlloc alloc, void* dest, const void* src, kSize size);
255 
256 #endif
kStatus kAlloc_VRelease(kAlloc alloc)
Protected virtual method that deallocates any resources owned by the object.
#define kPointer_WriteAs(POINTER, VALUE, TYPE)
Deferences a pointer, assuming the specified type, and assigns a value to the resulting reference...
Definition: kApiDef.h:329
kAlloc kAlloc_Fallback(kAlloc alloc)
Returns the passed allocator, or if null, the App allocator.
Definition: kAlloc.h:187
kStatus kAlloc_Init(kAlloc alloc, kType type, kAlloc allocator)
Protected method called by derived classes to initialize the kAlloc base class.
Represents a void pointer.
#define kIsNull(POINTER)
Tests for equality with null pointer.
Definition: kApiDef.h:339
kAlloc kAlloc_App()
Gets the allocator that should normally be used by applications to request memory.
Definition: kAlloc.h:159
Represents an unsigned integer that can store a pointer address.
Abstract base class for memory allocator types.
kBool kAlloc_CanGetObject(kAlloc alloc)
Reports whether this allocator is suitable for allocating objects.
Definition: kAlloc.h:128
kStatus kAlloc_Free(kAlloc alloc, void *mem)
Frees a block of memory.
Definition: kAlloc.h:84
#define kCheck(EXPRESSION)
Executes a return statement if the given expression is not kOK.
Definition: kApiDef.h:559
kStatus kAlloc_GetObject(kAlloc alloc, kType type, void *mem)
Allocates a block of memory large enough for an object of the specified type.
Definition: kAlloc.h:69
#define kInlineFx(TYPE)
Inline method declaration helper.
Definition: kApiDef.h:26
kAlloc kAlloc_System()
Gets the system allocator.
Definition: kAlloc.h:175
kStatus kAlloc_Export(kAlloc alloc, void *dest, const void *src, kSize size)
Copies memory from the allocator's address space to the host address space.
Definition: kAlloc.h:116
#define kObj(TypeName_T, T_object)
Declares a local "obj" (this-pointer) variable and initializes it from a type-checked object handle...
Definition: kApiDef.h:2921
Core Zen type declarations.
kStatus kAlloc_VGet(kAlloc alloc, kSize size, void *mem)
Protected virtual method that allocates memory.
#define kCheckArgs(EXPRESSION)
Executes a return statement if the given expression is not kTRUE.
Definition: kApiDef.h:582
kStatus kAlloc_FreeRef(kAlloc alloc, void *mem)
Frees a block of memory and sets the memory pointer to kNULL.
Definition: kAlloc.h:97
kBool kAlloc_IsForeign(kAlloc alloc)
Reports whether memory will be allocated in a foreign address space.
Definition: kAlloc.h:142
Represents metadata about a type (class, interface, or value).
kSize kType_InnerSize(kType type)
Gets the internal size of a type.
Definition: kType.h:321
kStatus kAlloc_VFree(kAlloc alloc, void *mem)
Protected virtual method that frees memory.
#define kOK
Operation successful.
Definition: kApiDef.h:513
Represents an error code.
#define kNULL
Null pointer.
Definition: kApiDef.h:267
#define kPointer_ReadAs(POINTER, TYPE)
Deferences a pointer, assuming the specified type, and returns the resulting value.
Definition: kApiDef.h:318
kStatus kAlloc_Get(kAlloc alloc, kSize size, void *mem)
Allocates a block of memory.
Definition: kAlloc.h:37
kStatus kAlloc_VExport(kAlloc alloc, void *dest, const void *src, kSize size)
Protected virtual method that copies memory from the allocator's address space to the host address sp...
Represents a boolean value.
kStatus kAlloc_GetZero(kAlloc alloc, kSize size, void *mem)
Allocates a block of memory and zero-initializes the block.
Definition: kAlloc.h:51
kStatus kMemSet(void *dest, kByte fill, kSize size)
Sets a block of memory to the given byte value.