---
title: aclCreateIntArray
description: "创建aclIntArray对象，作为单算子API的入参。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/aolapi/operatorlist_00016.html
sourcePath: /source/zh/canncommercial/900/API/aolapi/operatorlist_00016.html
indexId: 8395537597038ad42fe0ea116ceb7ee73d0801fe93396a4bdf877588dedae08664
---
# aclCreateIntArray

#### 功能说明

创建aclIntArray对象，作为单算子API的入参。

aclCreateIntArray是框架定义的一种用来管理和存储整型数据的数组结构，开发者无需关注其内部实现，直接使用即可。


#### 函数原型

```
aclIntArray *aclCreateIntArray(const int64_t *value, uint64_t size)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| value | 输入 | Host侧的int64\_t类型的指针，其指向的值会拷贝给aclIntArray。 |
| size | 输入 | 整型数组的长度，取值为正整数。 |


#### 返回值说明

成功则返回创建好的aclIntArray，否则返回nullptr。


#### 约束说明

- 本接口需与  aclDestroyIntArray
接口配套使用，分别完成aclIntArray的创建与销毁。
- 调用  aclGetIntArraySize
接口可以获取aclIntArray的大小。


#### 调用示例

关键代码示例如下，仅供参考，不支持直接拷贝运行。

```
// 创建aclIntArray
std::vector<int64_t> sizeData = {1, 1, 2, 3};
aclIntArray *size = aclCreateIntArray(sizeData.data(),sizeData.size());
// aclIntArray作为单算子API的入参
auto ret = aclxxXxxGetWorkspaceSize(srcTensor, size, ..., outTensor, ..., &workspaceSize, &executor);
ret = aclxxXxx(...);
// 销毁aclIntArray
ret = aclDestroyIntArray(size);
```