---
title: 函数：push
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0863.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0863.html
indexId: 0909bb4de94af097e10e9e0f69d28b145e2b0b784e7e72e1ccf56e2874ad370171
---
# 函数：push

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |


#### 功能说明

msproftx用于记录事件发生的时间跨度的开始时间。

调用此接口后，Profiling自动在Stamp中记录开始的时间戳，将Event type设置为Push/Pop。


#### 函数原型

- C函数原型
  1 aclError aclprofPush(void *stamp)

- python函数
  1 ret = acl.prof.push(stamp)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| stamp | int，Stamp指针地址，指代msproftx事件标记。指定acl.prof.create\_stamp接口的指针地址。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| ret | int，错误码。 返回0表示成功。 返回其它值表示失败。 |


#### 约束说明

- 与  函数：pop
接口成对使用，表示时间跨度的开始和结束。
- 不能跨线程调用，若需要跨线程可使用  函数：range_start
/  函数：range_stop
接口。
- 在  函数：create_stamp
接口和  函数：destroy_stamp
接口之间调用。