Skip to content

Commit 4da3910

Browse files
authored
[oneDPL] Align with SYCL 2020 API (#476)
Also correct the API names used in an example
1 parent b1a323e commit 4da3910

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

source/elements/oneDPL/source/parallel_api.rst

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -196,30 +196,30 @@ Buffer wrappers
196196
namespace oneapi {
197197
namespace dpl {
198198
199-
template < typename T, typename AllocatorT, sycl::access::mode Mode >
199+
template < typename T, typename AllocatorT, typename TagT >
200200
/*unspecified*/ begin( sycl::buffer<T, /*dim=*/1, AllocatorT> buf,
201-
sycl::mode_tag_t<Mode> tag = sycl::read_write );
201+
TagT tag = sycl::read_write );
202202
203-
template < typename T, typename AllocatorT, sycl::access::mode Mode >
203+
template < typename T, typename AllocatorT, typename TagT >
204204
/*unspecified*/ begin( sycl::buffer<T, /*dim=*/1, AllocatorT> buf,
205-
sycl::mode_tag_t<Mode> tag, sycl::property::noinit );
205+
TagT tag, sycl::property::no_init );
206206
207207
template < typename T, typename AllocatorT >
208208
/*unspecified*/ begin( sycl::buffer<T, /*dim=*/1, AllocatorT> buf,
209-
sycl::property::noinit );
209+
sycl::property::no_init );
210210
211211
212-
template < typename T, typename AllocatorT, sycl::access::mode Mode >
212+
template < typename T, typename AllocatorT, typename TagT >
213213
/*unspecified*/ end( sycl::buffer<T, /*dim=*/1, AllocatorT> buf,
214-
sycl::mode_tag_t<Mode> tag = sycl::read_write );
214+
TagT tag = sycl::read_write );
215215
216-
template < typename T, typename AllocatorT, sycl::access::mode Mode >
216+
template < typename T, typename AllocatorT, typename TagT >
217217
/*unspecified*/ end( sycl::buffer<T, /*dim=*/1, AllocatorT> buf,
218-
sycl::mode_tag_t<Mode> tag, sycl::property::noinit );
218+
TagT tag, sycl::property::no_init );
219219
220220
template < typename T, typename AllocatorT >
221221
/*unspecified*/ end( sycl::buffer<T, /*dim=*/1, AllocatorT> buf,
222-
sycl::property::noinit );
222+
sycl::property::no_init );
223223
224224
}
225225
}
@@ -240,8 +240,8 @@ of an unspecified type that satisfies the following requirements:
240240
When invoking an algorithm, the buffer passed to ``begin`` should be the same
241241
as the buffer passed to ``end``. Otherwise, the behavior is undefined.
242242

243-
``sycl::mode_tag_t`` and ``sycl::property::noinit`` parameters allow to specify
244-
an access mode to be used for accessing the buffer by algorithms.
243+
SYCL deduction tags (the ``TagT`` parameters) and ``sycl::property::no_init``
244+
allow to specify an access mode to be used by algorithms for accessing the buffer.
245245
The mode serves as a hint, and can be overridden depending on semantics of the algorithm.
246246
When invoking an algorithm, the same access mode arguments should be used
247247
for ``begin`` and ``end``. Otherwise, the behavior is undefined.
@@ -251,9 +251,9 @@ for ``begin`` and ``end``. Otherwise, the behavior is undefined.
251251
using namespace oneapi;
252252
auto buf_begin = dpl::begin(buf, sycl::write_only);
253253
auto buf_end_1 = dpl::end(buf, sycl::write_only);
254-
auto buf_end_2 = dpl::end(buf, sycl::write_only, sycl::noinit);
255-
dpl::fill(dpl::dpcpp_default, buf_begin, buf_end_1, 42); // allowed
256-
dpl::fill(dpl::dpcpp_default, buf_begin, buf_end_2, 42); // not allowed
254+
auto buf_end_2 = dpl::end(buf, sycl::write_only, sycl::no_init);
255+
dpl::fill(dpl::execution::dpcpp_default, buf_begin, buf_end_1, 42); // allowed
256+
dpl::fill(dpl::execution::dpcpp_default, buf_begin, buf_end_2, 42); // not allowed
257257
258258
Iterators
259259
+++++++++

0 commit comments

Comments
 (0)