---
title: GetUBSizeInBytes
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_0189.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_0189.html
indexId: d24457842ed5630ff1cfb41751ec6628b3ff52cc6a926afe3bd2939976d3b18976
---
# GetUBSizeInBytes

#### 产品支持情况

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


#### 功能说明

获取UB空间的大小，单位为byte。开发者根据UB的大小来计算循环次数等参数值。


#### 函数原型

```
__aicore__ inline constexpr uint32_t GetUBSizeInBytes()
```


#### 参数说明

无


#### 返回值说明

UB空间的大小，单位为byte。


#### 约束说明

无


#### 调用示例

本调用示例通过GetUBSizeInBytes获取的UB空间大小，来计算tileNum的值。

```
// 定义待处理的总数据长度 (元素个数)
uint32_t totalLength = 16384;
// GetUBSizeInBytes() / sizeof(half) -> 计算 UB 能容纳多少个 half 类型元素
// 除2 -> 预留 50% 的 UB 空间
uint32_t tileLength = AscendC::GetUBSizeInBytes() / sizeof(half) / 2;
// 防止分片大小超过实际数据总量
if (totalLength < tileLength) {
tileLength = totalLength;
}
// 需要迭代的分片数量：16384 / 63488 = 1
uint32_t tileNum = totalLength / tileLength;
```