---
title: AscendStringToFormat
description: "将字符串转化为Format类型值。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/maintenref/basicdataapi/atlasopapi_07_00490.html
sourcePath: /source/zh/canncommercial/900/maintenref/basicdataapi/atlasopapi_07_00490.html
indexId: f634fcb6484c0d850bce06d406328022f51c2cde75ef858a3c1fca42515ba38a78
---
# AscendStringToFormat

#### 函数功能

将字符串转化为Format类型值。

使用该接口需要包含type_utils.h头文件。

```
#include "graph/utils/type_utils.h"
```


#### 函数原型

```
static Format AscendStringToFormat(const AscendString &str)
```


#### 参数说明

| 参数 | 输入/输出 | 说明 |
| --- | --- | --- |
| str | 输入 | 待转换的Format字符串形式，AscendString类型。 |


#### 返回值说明

输入合法时，返回转换后的Format enum值，枚举定义请参考Format；输入不合法时，返回FORMAT_RESERVED，并打印报错信息。


#### 约束说明

无。


#### 调用示例

```
ge::AscendString format_str("NHWC");
auto format = ge::TypeUtils::AscendStringToFormat(format_str); // 1
```