ASTContextAllocate.h File Reference (original) (raw)

#include <cstddef>

Namespaces
namespace	clang
	The JSON file list parser is used to communicate input to InstallAPI.

Functions
void *	operator new (size_t Bytes, const clang::ASTContext &C, size_t Alignment=8)
	Placement new for using the ASTContext's allocator.

void *	operator new[] (size_t Bytes, const clang::ASTContext &C, size_t Alignment=8)
	This placement form of operator new[] uses the ASTContext's allocator for obtaining memory.

void	operator delete (void *Ptr, const clang::ASTContext &C, size_t)
	Placement delete companion to the new above.

void	operator delete[] (void *Ptr, const clang::ASTContext &C, size_t)
	Placement delete[] companion to the new[] above.

◆ operator delete()

Placement delete companion to the new above.

This operator is just a companion to the new above. There is no way of invoking it directly; see the new operator for more details. This operator is called implicitly by the compiler if a placement new expression using the ASTContext throws in the object constructor.

Definition at line 3663 of file ASTContext.h.

◆ operator delete[]()

Placement delete[] companion to the new[] above.

This operator is just a companion to the new[] above. There is no way of invoking it directly; see the new[] operator for more details. This operator is called implicitly by the compiler if a placement new[] expression using the ASTContext throws in the object constructor.

Definition at line 3701 of file ASTContext.h.

◆ operator new()

Placement new for using the ASTContext's allocator.

This placement form of operator new uses the ASTContext's allocator for obtaining memory.

IMPORTANT: These are also declared in clang/AST/ASTContextAllocate.h! Any changes here need to also be made there.

We intentionally avoid using a nothrow specification here so that the calls to this operator will not perform a null check on the result – the underlying allocator never returns null pointers.

Usage looks like this (assuming there's an ASTContext 'Context' in scope):

IntegerLiteral *Ex = new (Context) IntegerLiteral(arguments);

IntegerLiteral *Ex2 = new (Context, 4) IntegerLiteral(arguments);

Memory allocated through this placement new operator does not need to be explicitly freed, as ASTContext will free all of this memory when it gets destroyed. Please note that you cannot use delete on the pointer.

Parameters

Bytes	The number of bytes to allocate. Calculated by the compiler.
C	The ASTContext that provides the allocator.
Alignment	The alignment of the allocated memory (if the underlying allocator supports it).

Returns

The allocated memory. Could be nullptr.

Definition at line 3652 of file ASTContext.h.

◆ operator new[]()

This placement form of operator new[] uses the ASTContext's allocator for obtaining memory.

We intentionally avoid using a nothrow specification here so that the calls to this operator will not perform a null check on the result – the underlying allocator never returns null pointers.

Usage looks like this (assuming there's an ASTContext 'Context' in scope):

char *data = new (Context) char[10];

char *data = new (Context, 4) char[10];

Memory allocated through this placement new[] operator does not need to be explicitly freed, as ASTContext will free all of this memory when it gets destroyed. Please note that you cannot use delete on the pointer.

Parameters

Bytes	The number of bytes to allocate. Calculated by the compiler.
C	The ASTContext that provides the allocator.
Alignment	The alignment of the allocated memory (if the underlying allocator supports it).

Returns

The allocated memory. Could be nullptr.

Definition at line 3690 of file ASTContext.h.