Summary
Infallibly allocates a block of memory using the XPCOM memory manager.
#include "nsXPCOM.h" void* NS_Alloc( PRSize aSize );
Parameters
- aSize
- [in] The size in bytes of the block to allocate.
Return Values
This function returns a pointer to the allocated block of memory, which is suitably aligned for any kind of variable, or null if the allocation failed.
Remarks
This function provides a convenient way to access the XPCOM memory manager. It is equivalent to calling alloc
on the nsIMemory
instance returned from NS_GetMemoryManager
.
History
This function was finalized for Mozilla 1.8. See bug 267767 for details.