Changeset 28271 in vbox for trunk/include

Timestamp:

Apr 13, 2010 7:29:42 PM (15 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

60013

Message:

IPRT: Some efence adjustments, adding RTMemAllocVar and RTMemAllocZVar for dealing with struct + string style allocations.

File:

• trunk/include/iprt/mem.h (modified) (3 diffs)

trunk/include/iprt/mem.h

@@ -112 +112 @@
  */
 RTDECL(void *)  RTMemAllocZ(size_t cb) RT_NO_THROW;
+
+/**
+ * Wrapper around RTMemAlloc for automatically aligning variable sized
+ * allocations so that the various electric fence heaps works correctly.
+ *
+ * @returns See RTMemAlloc.
+ * @param   cbUnaligned         The unaligned size.
+ */
+RTDECL(void *) RTMemAllocVar(size_t cbUnaligned);
+
+/**
+ * Wrapper around RTMemAllocZ for automatically aligning variable sized
+ * allocations so that the various electric fence heaps works correctly.
+ *
+ * @returns See RTMemAllocZ.
+ * @param   cbUnaligned         The unaligned size.
+ */
+RTDECL(void *) RTMemAllocZVar(size_t cbUnaligned);
 
 /**
@@ -376 +394 @@
 
 /**
+ * Same as RTMemAllocVar() except that it's fenced.
+ *
+ * @returns Pointer to the allocated memory. Free with RTMemEfFree().
+ * @returns NULL on failure.
+ * @param   cbUnaligned Size in bytes of the memory block to allocate.
+ */
+RTDECL(void *)  RTMemEfAllocVar(size_t cbUnaligned) RT_NO_THROW;
+
+/**
+ * Same as RTMemAllocZVar() except that it's fenced.
+ *
+ * @returns Pointer to the allocated memory.
+ * @returns NULL on failure.
+ * @param   cbUnaligned Size in bytes of the memory block to allocate.
+ */
+RTDECL(void *)  RTMemEfAllocZVar(size_t cbUnaligned) RT_NO_THROW;
+
+/**
  * Same as RTMemRealloc() except that it's fenced.
  *
@@ -422 +458 @@
 # define RTMemAlloc     RTMemEfAlloc
 # define RTMemAllocZ    RTMemEfAllocZ
+# define RTMemAllocVar  RTMemEfAllocVar
+# define RTMemAllocZVar RTMemEfAllocZVar
 # define RTMemRealloc   RTMemEfRealloc
 # define RTMemFree      RTMemEfFree