2026a

# round

四舍五入为最近的小数或整数

# 语法

Y = round(X)
Y = round(X,direction...)
Y = round(_; digits=N, base=T)
Y = round(_; sigdigits=N, base=T)

# 说明

Y = round(X) 将 X 四舍五入为最近的整数。在舍入机会均等的情况下，即有元素的十进制小数部分为 0.5（在舍入误差内）时，round 函数会接近零四舍五入到最接近的具有更小幅值的整数。示例

Y = round(X,direction...) 按照 direction 指定的方向对结值进行舍入，其中 direction 的类型为 RoundingMode，默认值为 RoundNearest。如果 X 是复数，则可以分别对实部和虚部进行指定舍入方向，此时对实部指定舍入选项在前，对虚部指定舍入选项在后。例如：round(3.14 + 4.5im, RoundUp, RoundNearestTiesUp)。示例

Y = round(_; digits=N, base=T) 指定关键字参数 digits，将 X 四舍五入到 N 位数，其中 N 为整数；关键字参数 base 表示进制位数。示例

N > 0：舍入到小数点右侧的第 N 位数；
N = 0：四舍五入到最接近的整数；
N < 0：舍入到小数点左侧的第 N 位数。

Y = round(_; sigdigits=N, base=T) 指定关键字参数 sigdigits，将 X 四舍五入到 N 位有效位数，其中 N 为整数；关键字参数 base 表示进制位数。示例

# 示例

复数取整

对复数的实部和虚部分别进行四舍五入。

Y = round(3.14 + 4.5im)

Y = 3.0 + 4.0im

分别对实部和虚部指定舍入方向。

Y = round(3.14 + 4.5im, RoundUp, RoundNearestTiesAway)

Y = 4.0 + 5.0im

调整四舍五入的取整模式

对 1.7 进行四舍五入。

round(1.7)

ans = 2.0

设置输出数据类型为 Int。

round(Int, 1.7)

ans = 2

对 pi 进行四舍五入，保留 2 位小数。

round(pi; digits=2)

ans = 3.14

对 123.456 进行四舍五入，保留 2 位有效数字。

round(123.456; sigdigits=2)

ans = 120.0

# 输入参数

X - 输入数组

标量 | 向量 | 矩阵 | 多维数组

输入数组，指定为标量。对于复数 X，round 会分开处理实部和虚部。

对于向量、矩阵或多维数组等输入，通过 . 操作符进行向量化计算。

示例： A = [1.2,3.2,4.1] ,round.(A;digits=0) = [1.0,3.0,4.0]

数据类型： Int | Float | Bool

复数支持：是

direction - 舍入方向

舍入方向，指定为 RoundToZero、RoundFromZero、RoundDown、RoundUp、RoundNearest、RoundNearestTiesAway、RoundNearestTiesUp，其类型都为 RoundingMode。

RoundToZero —— 朝零方向舍入到最接近的整数，这相当于删除小数点后的所有位数；
RoundFromZero —— 从零朝无穷方向舍入到最接近的整数；
RoundDown —— 朝负无穷方向舍入到最接近的整数；
RoundUp —— 朝正无穷方向舍入到最接近的整数；
RoundNearest —— 舍入到最接近的整数。如果元素的小数部分恰好为 0.5，则它朝接近零的方向舍入到模更小的整数；
RoundNearestTiesAway —— 舍入到最接近的整数。如果元素的小数部分恰好为 0.5，则它朝偏离零的方向舍入到模更大的整数；
RoundNearestTiesUp —— 舍入到最接近的整数。如果元素的小数部分恰好为 0.5，则它朝正无穷的方向舍入到数值更大的整数。

# 名称-值对组参数

关键字参数

关键字参数	关键字意义
digits	四舍五入后保留的小数位数
sigdigits	四舍五入后保留的有效位数
base	进制位数

# 另请参阅

ceil | floor | trunc