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

Return a newly‐allocated maximally‐aligned block of memory of the specified `size` (in bytes) that has a read/write protected guard page located immediately before or after it according to the `GuardPageLocation` indicated at construction. If `size` is 0, no memory is allocated and 0 is returned. Note that a multiple of the platform's memory page size is allocated for _every_ call to this method.

== Synopsis

Declared in `<bdlma_guardingallocator.h>`

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


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