1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
/*
* Copyright 2008-2013 NVIDIA Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*! \file device_new.h
* \brief Constructs new elements in device memory
*/
#pragma once
#include <thrust/detail/config.h>
#if defined(_CCCL_IMPLICIT_SYSTEM_HEADER_GCC)
# pragma GCC system_header
#elif defined(_CCCL_IMPLICIT_SYSTEM_HEADER_CLANG)
# pragma clang system_header
#elif defined(_CCCL_IMPLICIT_SYSTEM_HEADER_MSVC)
# pragma system_header
#endif // no system header
// #include this for size_t
#include <cstddef>
#include <thrust/device_ptr.h>
THRUST_NAMESPACE_BEGIN
/*!
* \addtogroup memory_management Memory Management
* \{
*/
/*! \p device_new implements the placement \c new operator for types
* resident in device memory. \p device_new calls <tt>T</tt>'s null
* constructor on a array of objects in device memory.
* No memory is allocated by this function.
*
* \param p A \p device_ptr to a region of device memory into which
* to construct one or many <tt>T</tt>s.
* \param n The number of objects to construct at \p p.
* \return p, casted to <tt>T</tt>'s type.
*
* \see device_ptr
*/
template <typename T>
device_ptr<T> device_new(device_ptr<void> p,
const size_t n = 1);
/*! \p device_new implements the placement new operator for types
* resident in device memory. \p device_new calls <tt>T</tt>'s copy
* constructor on a array of objects in device memory. No memory is
* allocated by this function.
*
* \param p A \p device_ptr to a region of device memory into which to
* construct one or many <tt>T</tt>s.
* \param exemplar The value from which to copy.
* \param n The number of objects to construct at \p p.
* \return p, casted to <tt>T</tt>'s type.
*
* \see device_ptr
* \see fill
*/
template <typename T>
device_ptr<T> device_new(device_ptr<void> p,
const T &exemplar,
const size_t n = 1);
/*! \p device_new implements the new operator for types resident in device memory.
* It allocates device memory large enough to hold \p n new objects of type \c T.
*
* \param n The number of objects to allocate. Defaults to \c 1.
* \return A \p device_ptr to the newly allocated region of device memory.
*/
template <typename T>
device_ptr<T> device_new(const size_t n = 1);
/*! \} // memory_management
*/
THRUST_NAMESPACE_END
#include <thrust/detail/device_new.inl>
|
