2.11.4  allocate Clause

SummaryThe allocate clause specifies the memory allocator to be used to obtain storage for private variables of a directive.

Syntax

The syntax of the allocate clause is as follows:  

 
allocate([allocator:] list)
  

Description The storage for new list items that arise from list items that appear in the directive will be provided through a memory allocator. If an allocator is specified in the clause, that allocator will be used for allocations. For all directives except the target directive, if no allocator is specified in the clause then the memory allocator that is specified by the def-allocator-var ICV will be used for the list items that are specified in the allocate clause. The allocation of each list item will be byte aligned to at least the alignment required by the base language for the type of that list item.

For allocations that arise from this clause the null_fb value of the fallback allocator trait will behave as if the abort_fb had been specified.

Restrictions

• For any list item that is specified in the allocate clause on a directive, a data-sharing attribute clause that may create a private copy of that list item must be specified on the same directive.
• For task, taskloop or target directives, allocation requests to memory allocators with the trait access set to thread result in unspecified behavior.
• allocate clauses that appear on a target construct or on constructs in a target region must specify an allocator expression unless a requires directive with the dynamic_allocators clause is present in the same compilation unit.

Cross References

• def-allocator-var ICV, see Section 2.5.1 on page 172.
• Memory allocators, see Section 2.11.2 on page 428.
• omp_allocator_handle_t and omp_allocator_handle_kind, see Section 3.7.1 on page 1208.