Generic Instance Method 総称体インスタンスメソッド

mapError(_:)

Returns a new result, mapping any failure value using the given transformation. 新しい結果を返します、あらゆる失敗値をこの与えられた変換を使ってマッピングします。

Declaration 宣言

func mapError<NewFailure>(_ transform: (Failure) -> NewFailure) -> Result<Success, NewFailure> where NewFailure : Error

Parameters パラメータ

transform

A closure that takes the failure value of the instance. インスタンスの失敗値をとるクロージャ。

Return Value 戻り値

A Result instance with the result of evaluating transform as the new failure value if this instance represents a failure. あるResultインスタンスでtransformを評価する結果をもちます、もしこのインスタンスが失敗を表すならば新しい失敗値として。

Discussion 解説

Use this method when you need to transform the value of a Result instance when it represents a failure. The following example transforms the error value of a result by wrapping it in a custom Error type: このメソッドを使ってください、あなたがResultインスタンスの値をそれが失敗を表す場合に変換する必要がある時に。以下の例は、ある結果のエラー値を、それをあるあつらえのError型の中のラップすることによって変換します:


struct DatedError: Error {
    var error: Error
    var date: Date


    init(_ error: Error) {
        self.error = error
        self.date = Date()
    }
}


let result: Result<Int, Error> = // ...
// result == .failure(<error value>)
let resultWithDatedError = result.mapError({ e in DatedError(e) })
// result == .failure(DatedError(error: <error value>, date: <date>))

See Also 参照

Transforming a Result 結果を変換する