Function: memset

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas training product	√
Atlas inference product	√
Atlas 200I/500 A2 inference product	√

Description

Initializes memory to a specified value.

The system determines whether the memory to be initialized is on the host or device based on the address. If the host memory is not allocated by calling an acl API (for example, acl.rt.malloc_host), undefined behavior will occur.

Prototype

C Prototype

aclError aclrtMemset(void *devPtr, size_t maxCount, int32_t value, size_t count)

Python Function

ret = acl.rt.memset(dev_ptr, max_count, value, count)

Parameters

Parameter	Description
dev_ptr	Int, start address of the memory.
max_count	Int, maximum memory size, in bytes.
value	Int, value to be set.
count	Int, memory length to be set to a specified value, in bytes.

Return Value

Return Value	Description
ret	Int, error code. 0 on success; else, failure.

Restrictions

This API initializes the memory immediately. No implicit device synchronization or stream synchronization is performed within the function.

Parent topic: Memory Management