NS_Alloc

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.

See also

• NS_Free, nsIMemory, NS_GetMemoryManager