Swift 5 字符串插值之美

"There's \(value1) and \(value2)"

"There's \(String(describing: value1)) and \(String(describing: value2))"

extension String.StringInterpolation {
  /// 提供 `Optional` 字符串插值
  /// 而不必强制使用 `String(describing:)`
  public mutating func appendInterpolation(_ value: T?, default defaultValue: String) {
    if let value = value {
      appendInterpolation(value)
    } else {
      appendLiteral(defaultValue)
    }
  }
}

// There's 23 and nil
"There's \(value1, default: "nil") and \(value2, default: "nil")"

extension String.StringInterpolation {
  /// 可选值插值样式
  public enum OptionalStyle {
    /// 有值和没有值两种情况下都包含单词 `Optional`
    case descriptive
    /// 有值和没有值两种情况下都去除单词 `Optional`
    case stripped
    /// 使用系统的插值方式，在有值时包含单词 `Optional`，没有值时则不包含
    case `default`
  }

  /// 使用提供的 `optStyle` 样式来插入可选值
  public mutating func appendInterpolation(_ value: T?, optStyle style: String.StringInterpolation.OptionalStyle) {
    switch style {
    // 有值和没有值两种情况下都包含单词 `Optional`
    case .descriptive:
      if value == nil {
        appendLiteral("Optional(nil)")
      } else {
        appendLiteral(String(describing: value))
      }
    // 有值和没有值两种情况下都去除单词 `Optional`
    case .stripped:
      if let value = value {
        appendInterpolation(value)
      } else {
        appendLiteral("nil")
      }
    // 使用系统的插值方式，在有值时包含单词 `Optional`，没有值时则不包含
    default:
      appendLiteral(String(describing: value))
    }
  }

  /// 使用 `stripped` 样式来对可选值进行插值
  /// 有值和没有值两种情况下都省略单词 `Optional`
  public mutating func appendInterpolation(describing value: T?) {
    appendInterpolation(value, optStyle: .stripped)
  }
}

// "There's Optional(23) and nil"
"There's \(value1, optStyle: .default) and \(value2, optStyle: .default)"

// "There's Optional(23) and Optional(nil)"
"There's \(value1, optStyle: .descriptive) and \(value2, optStyle: .descriptive)"

// "There's 23 and nil"
"There's \(describing: value1) and \(describing: value2)"

// 成功时包含（感谢 Nate Cook）
extension String.StringInterpolation {
  /// 只有 `condition` 的返回值为 `true` 才进行插值
  mutating func appendInterpolation(if condition: @autoclosure () -> Bool, _ literal: StringLiteralType) {
    guard condition() else { return }
    appendLiteral(literal)
  }
}

// 旧写法
"Cheese Sandwich \(isStarred ? "(*)" : "")"

// 新写法
"Cheese Sandwich \(if: isStarred, "(*)")"