Placement new

In the programming language, placement new is a form of the operator that allows object construction into an existing memory buffer. Unlike other forms of new, the new object does not have to be in heap memory. The pointer returned by placement new is the pointer provided as an argument, cast to the type of the new object and possibly initialized.

Placement new is necessary for hardware that expects a certain object at a specific hardware address. It is also required for the construction of objects that need to reside in a certain memory area, such as an area that is shared between several processors of a multiprocessor computer.

Syntax

The syntax for placement new:
:p_var = new(p_place) typename;
where p_place provides a pointer of type void. When the user has provided the new function, p_place may also be the placement arguments to that function. p_var is a previously declared pointer of type typename. typename can be any basic data type or user-defined object (enum, class, and struct included). If typename is of class type, the default constructor is called to construct the object.

The syntax for initialization is as for ordinary constructors:

:p_var = new(p_place) type(initializer);
:p_var = new(p_place) type ;

Although an object created with the placement new is not normally deleted, it may be necessary to call its destructor. This is done with the following syntax:
:p_var->~type();

Main Menu

See Also

Main Menu