|
| |
|
| Category: allocators | | Component type: function |
template <class T1, class T2> void construct(T1* p, const T2& value);
In C++, the operator
new allocates memory for an object and then creates an object at that location by calling a constructor. Occasionally, however, it is useful to separate those two operations.
[1] If
p is a pointer to memory that has been allocated but not initialized, then
construct(p, value) creates an object of type
T1 at the location pointed to by
p. The argument
value is passed as an argument to
T1's constructor.
Defined in the standard header
memory, and in the nonstandard backward-compatibility header
algo.h. The
construct algorithm is no longer part of the C++ standard; it was present in early drafts, and it is retained in this implementation for backward compatibility.
-
T1 must have a constructor that takes a single argument of type T2.
-
p is a valid pointer that points to a region of memory whose size is at least sizeof(T1).
-
The memory pointed to by
p is uninitialized. That is, no object has been constructed at the location p.
double* dp = (double*) malloc(sizeof(double));
construct(dp, 3);
assert(*dp == 3);
[1] In particular,
construct, along with other low-level memory allocation primitives, is used to implement container classes.
Allocators,
destroy,
uninitialized_copy,
uninitialized_fill,
uninitialized_fill_n,
raw_storage_iterator
