[#BloombergLP-bslma-MallocFreeAllocator-allocate-0b]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslma.adoc[bslma]::xref:BloombergLP/bslma/MallocFreeAllocator.adoc[MallocFreeAllocator]::allocate
:relfileprefix: ../../../
:mrdocs:

Return a newly allocated block of memory of (at least) the specified positive `size` (in bytes). If `size` is 0, a null pointer is returned with no other effect. If this allocator cannot return the requested number of bytes, then it will return a null pointer. The behavior is undefined unless `0 <= size`. Note that the alignment of the address returned is the maximum alignment for any type defined on this platform. Also note that `std::malloc` is _not_ called when `size` is 0 (in order to avoid having to acquire a lock, and potential contention in multi‐treaded programs).

== Synopses

Declared in `<bslma_mallocfreeallocator.h>`

Return a newly allocated block of memory of (at least) the specified positive `size` (in bytes). If `size` is 0, a null pointer is returned with no other effect. If this allocator cannot return the requested number of bytes, then it will return a null pointer. The behavior is undefined unless `0 <= size`. Note that the alignment of the address returned is the maximum alignment for any type defined on this platform. Also note that `std::malloc` is _not_ called when `size` is 0 (in order to avoid having to acquire a lock, and potential contention in multi‐treaded programs).


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
void*
xref:BloombergLP/bslma/MallocFreeAllocator/allocate-06.adoc[allocate](xref:BloombergLP/bslma/Allocator/size_type.adoc[size_type] size) override;
----

[.small]#xref:BloombergLP/bslma/MallocFreeAllocator/allocate-06.adoc[_» more..._]#


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[nodiscard]]
void*
xref:BloombergLP/bslma/Allocator/allocate-034.adoc[allocate](
    size_t __bytes,
    size_t __alignment = _S_max_align);
----

[.small]#xref:BloombergLP/bslma/Allocator/allocate-034.adoc[_» more..._]#


[.small]#Created with https://www.mrdocs.com[MrDocs]#