Swift Optional.Publisher mapError(_:)用法及代码示例

实例方法

mapError(_:)

将来自上游发布者的任何失败转换为新错误。

声明

func mapError<E>(_ transform: @escaping (Self.Failure) -> E) -> Publishers.MapError<Self, E> where E : Error

返回值

使用 transform 闭包产生的新错误替换任何上游故障的发布者。

参数

transform: 一个闭包，它将上游失败作为参数并返回一个新的错误以供发布者终止。

详述

当您需要将一种错误类型替换为另一种错误类型时，或者下游运算符需要其输入的错误类型匹配时，请使用 Publisher/mapError(_:) 运算符。

以下示例使用 Publisher/tryMap(_:) 运算符将 1 除以序列发布者生成的每个元素。当发布者生成 0 时，Publisher/tryMap(_:) 失败并显示 DivisionByZeroError 。 Publisher/mapError(_:) 运算符将其转换为 MyGenericError 。


struct DivisionByZeroError: Error {}
struct MyGenericError: Error { var wrappedError: Error }


func myDivide(_ dividend: Double, _ divisor: Double) throws -> Double {
       guard divisor != 0 else { throw DivisionByZeroError() }
       return dividend / divisor
   }


let divisors: [Double] = [5, 4, 3, 2, 1, 0]
divisors.publisher
    .tryMap { try myDivide(1, $0) }
    .mapError { MyGenericError(wrappedError: $0) }
    .sink(
        receiveCompletion: { print ("completion: \($0)") ,
        receiveValue: { print ("value: \($0)", terminator: " ") }
     )


// Prints: "0.2 0.25 0.3333333333333333 0.5 1.0 completion: failure(MyGenericError(wrappedError: DivisionByZeroError()))"

可用版本

iOS 13.0+, iPadOS 13.0+, macOS 10.15+, Mac Catalyst 13.0+, tvOS 13.0+, watchOS 6.0+

相关用法

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