Merge pull request #515 from hdelan/clarify-host-task-ref-val-capture

Clarify that capture by ref host_task requires caution
KhronosGroup · Dec 14, 2023 · bfe3330 · bfe3330
2 parents cd5768d + 4e2439c
commit bfe3330
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 0 deletions.
diff --git a/adoc/chapters/acknowledgements.adoc b/adoc/chapters/acknowledgements.adoc
@@ -31,6 +31,7 @@
   * Verena Beckham, Codeplay
   * Aidan Belton, Codeplay
   * Gordon Brown, Codeplay
+  * Hugh Delaney, Codeplay
   * Morris Hafner, Codeplay
   * Alexander Johnston, Codeplay
   * Marios Katsigiannis, Codeplay

diff --git a/adoc/chapters/programming_interface.adoc b/adoc/chapters/programming_interface.adoc
@@ -14625,6 +14625,15 @@ interoperability member functions provided by the [code]#interop_handle# class.
 
 Local <<accessor,accessors>> cannot be used within a <<host-task>>.
 
+[NOTE]
+====
+If a C++ lambda is passed to a <<host-task>>, the lambda may capture by
+reference or by value.
+Since the <<host-task>> callable executes asynchronously, care must be taken to
+ensure that lifetimes of objects captured by reference by a <<host-task>> lambda
+last at least until the <<host-task>> completes.
+====
+
 // TODO: access mode/target resolution rules
 
 [source,,linenums]