---
title: GetOptionalInputFormat
description: "根据算子原型定义中的输入索引获取对应的可选输入Format指针。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/maintenref/basicdataapi/atlasopapi_07_00575.html
sourcePath: /source/zh/canncommercial/900/maintenref/basicdataapi/atlasopapi_07_00575.html
indexId: fa50cef2ae03fc4fb010b3ba6b8e36ad7c0ec463cab0e99f6fe1760f6e188b2178
---
# GetOptionalInputFormat

#### 函数功能

根据算子原型定义中的输入索引获取对应的可选输入Format指针。


#### 函数原型

```
StorageFormat *GetOptionalInputFormat(const size_t ir_index)
```


#### 参数说明

| 参数 | 输入/输出 | 说明 |
| --- | --- | --- |
| ir\_index | 输入 | IR原型定义中的index，从0开始计数。 |


#### 返回值说明

输入Format指针，ir_index非法或该输入没有实例化时，返回空指针。

关于StorageFormat类型的定义，请参见StorageFormat。


#### 约束说明

无。


#### 调用示例

```
ge::graphStatus InferFormatForXXX(InferFormatContext *context) {
  const auto format = context->GetOptionalInputFormat(0);        // 获取第0个输入的format
  GE_ASSERT_NOTNULL(format);
  // ...
}
```