NS Alloc

From MDC

« XPCOM API Reference

Contents 1 Summary 2 Parameters 3 Return Values 4 Remarks 5 History 6 See Also

[edit] Summary

Allocates a block of memory using the XPCOM memory manager.

#include "nsXPCOM.h"
 
void* NS_Alloc(
  PRSize aSize
);

[edit] Parameters

aSize

[in] The size in bytes of the block to allocate.

[edit] 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.

[edit] 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.

[edit] History

This function was finalized for Mozilla 1.8. See bug 267767 for details.

[edit] See Also

NS_Free, nsIMemory, NS_GetMemoryManager