warp.capture_while#
- warp.capture_while(condition, while_body, stream=None, **kwargs)[source]#
Create a dynamic loop based on a condition.
The condition value is retrieved from the first element of the
conditionarray.The
while_bodycallback is responsible for updating the condition value so the loop can terminate.This function is particularly useful during graph capture, but can be used without graph capture as well. CUDA 12.4+ is required for CUDA graph conditional nodes. A
Graphloop body must be a finished capture on the same device asconditionand must not itself containcapture_if()orcapture_while(). CUDA captures withapic=Truedo not yet support aGraphloop body, and CPU captures do not yet support aGraphfromcapture_load().capture_save()rejects a CPU graph that records aGraphloop body.- Parameters:
condition (warp.array[warp.int32]) – Warp array holding the condition value.
while_body (Callable | Graph) – A callback function or
Graphto execute while the loop condition is True.stream (Stream | None) – The CUDA stream where the condition was written. If None, use the current stream on the device where
conditionresides.
Any additional keyword arguments are forwarded to the callback function.