Swift中CGPoint与CGFloat扩展的round函数调用不一致问题

问题现象 #

在CGPoint扩展中调用round函数处理坐标值可正常编译运行，但在CGFloat扩展中使用相同逻辑时，触发三个编译错误：

• Cannot convert value of type '()' to expected argument type 'Int'
• Cannot convert value of type 'CGFloat' to expected argument type 'FloatingPointRoundingRule'
• Cannot use mutating member on immutable value: 'self' is immutable

相关代码如下：

extension CGPoint {
    var coordx : String {
        let xx = round(x * 10 * scaleFactor)/10   // 无编译问题
        return "\(xx)"
    }

    var coordy : String {
        let yy = round(y * 10 * scaleFactor)/10   // 无编译问题
        return "\(yy)"
    }
}

extension CGFloat {
    var scaled : String {
        let yy = round(self * 10 * scaleFactor)/10   // 触发编译错误
        return "\(yy)"
    }

    var scaled2 : String {
        return CGPoint(x: self, y: self).coordx   // 无编译问题
    }
}

底层原因 #

核心问题是编译器在不同上下文匹配了不同的round函数：

• CGPoint扩展场景：CGPoint的x/y实际为Double类型，此时编译器匹配的是全局泛型函数：func round<T>(_ x: T) -> T where T : FloatingPoint。该函数接收浮点型参数并返回同类型结果，完全符合代码逻辑。
• CGFloat扩展场景：Swift的方法查找规则会优先匹配类型自身的实例方法。CGFloat有一个mutating实例方法：func round(_ rule: FloatingPointRoundingRule)，这个方法用于按指定规则修改自身值，参数是枚举类型而非浮点数值。
  编译器误将代码中的round(self * ...)匹配到这个实例方法：
  1. 需要传入FloatingPointRoundingRule枚举，但实际传入的是CGFloat计算值，导致类型不匹配错误；
  2. 该方法是mutating的，而只读属性中的self是不可变值，触发不可变值调用mutating方法的错误；
  3. 实例方法返回值为Void（即()），后续的/10操作试图将()转为Int，引发类型转换错误。

即使改为Double扩展，也会遇到相同问题——因为Double同样拥有同名的mutating实例方法round(_:)，编译器依然会优先匹配实例方法而非全局函数。

解决方案 #

有三种可行的解决方式：

1. 显式指定全局round函数：通过模块名明确调用全局函数，避免实例方法干扰：

   var scaled : String {
       let yy = Foundation.round(self * 10 * scaleFactor)/10
       return "\(yy)"
   }
   

2. 转换类型后调用：将self转为Double，让编译器匹配全局round函数：

   var scaled : String {
       let yy = round(Double(self) * 10 * scaleFactor)/10
       return "\(yy)"
   }
   

3. 使用rounded()实例方法：替代全局round函数，该方法返回新值而非修改自身，逻辑更清晰：

   var scaled : String {
       let yy = (self * 10 * scaleFactor).rounded() / 10
       return "\(yy)"
   }
   

内容的提问来源于stack exchange，提问作者Victor Engel