当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Swift String init(reflecting:)用法及代码示例


初始化器

init(reflecting:)

创建具有给定值的详细表示的字符串,适合调试。

声明

init<Subject>(reflecting subject: Subject)

详述

使用此初始化程序将任何类型的实例转换为其自定义调试表示。初始化程序根据其协议一致性以下列方式之一创建instance 的字符串表示:

  • 如果 subject 符合 CustomDebugStringConvertible 协议,则结果为 subject.debugDescription

  • 如果 subject 符合 CustomStringConvertible 协议,则结果为 subject.description

  • 如果 subject 符合 TextOutputStreamable 协议,则通过在空字符串 s 上调用 subject.write(to: s) 获得结果。

  • Swift 标准库会自动提供未指定的结果。

例如,这个自定义 Point 结构使用标准库提供的默认表示。


struct Point {
    let x: Int, y: Int
}


let p = Point(x: 21, y: 30)
print(String(reflecting: p))
// Prints "p: Point = {
//           x = 21
//           y = 30
//         }"

通过实现debugDescription 属性添加CustomDebugStringConvertible 一致性后,Point 提供了自己的自定义调试表示。


extension Point: CustomDebugStringConvertible {
    var debugDescription: String {
        return "Point(x: \(x), y: \(y))"
    }
}


print(String(reflecting: p))
// Prints "Point(x: 21, y: 30)"

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

相关用法


注:本文由纯净天空筛选整理自apple.com大神的英文原创作品 String init(reflecting:)。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。