dpctl.SyclQueue.copy_async

SyclQueue.copy_async(dest, src, count, dEvents=None, dtype='u1')

Copy count elements of type dtype from src to dest asynchronously.

Internally, this dispatches sycl::queue::copy. The number of bytes transferred is count multiplied by the size of dtype. The default dtype of "u1" (a single byte) makes the default a byte-wise copy.

Parameters:

  • dest – Destination USM object or Python object supporting writable buffer protocol.

  • src – Source USM object or Python object supporting buffer protocol.

  • count (int) – Number of elements to copy.

  • dEvents (List[dpctl.SyclEvent], optional) – Events that this copy depends on.

  • dtype (str, optional) – Data type string of the elements to copy. Determines the element size used to convert count into a byte count. Defaults to "u1" (one byte per element). Supported types: i1, u1, i2, u2, i4, u4, i8, u8, f4, f8.

Returns:

Event associated with the copy operation.

Return type:

dpctl.SyclEvent