diff --git a/placeholder_accessors/index.md b/placeholder_accessors/index.md index 8308e4b..6dd2e2c 100644 --- a/placeholder_accessors/index.md +++ b/placeholder_accessors/index.md @@ -9,7 +9,7 @@ | Reply-to | Ruyman Reyes | | Original author | Ruyman Reyes | | Requirements | CP001 | -| Contributors | Gordon Brown , Victor Lomuller , Mehdi Goli , Peter Zuzek , Luke Iwanski | +| Contributors | Gordon Brown , Victor Lomuller , Mehdi Goli , Peter Zuzek , Luke Iwanski , Michael Haidl | ## Overview @@ -172,7 +172,10 @@ except for the aforementioned modifications. ### When `is_placeholder` returns true -The accessor API features constructors that don't take the handler parameter. +The accessor API features constructors that don't take the handler parameter +and/or memory object as a constructor. Accessors can then be default +constructed, and the memory object can be assigned later when registering +the accessor in the command group. In addition, a new method to obtain a normal accessor from the placeholder accessor is provided. @@ -192,6 +195,22 @@ The handler gains a new method, that registers the requirements of the placeholder accessor on the given command group. +Another method, that allows specifying the memory object the placeholder +accessor will be associated is also provided: + +`handler::require(buffer b, + accessor)` + +### Placeholder `accessor` without a buffer + +If a placeholder accessor which was not constructed with a buffer is not tied +to a buffer within a command group, then an exception is thrown. An accessor +can be checked for the existence of an associated a buffer using `has_buffer()`. + +|Member function |Description | +|-----------------------|---------------------------------------------------------| +|bool has_buffer() const|Returns true if the accessor is associated with a buffer,| +| |and false otherwise. | [1]: https://github.com/codeplaysoftware/sycl-blas "SYCL-BLAS" [2]: https://github.com/lukeiwanski/tensorflow "TensorFlow/Eigen"