XCode 11.2 日本語化計画：Swift 標準ライブラリ: KeyPath

文書  >   Swift   >   Swift 標準ライブラリ   >   Key-Path 式   >   KeyPath   >   appending(path:)

汎用インスタンスメソッド

appending(path:)

与えられたキーパスをこのパスに付け加えることによって作成された新しいキーパスを返します。

宣言

パラメータ

戻り値

path を付け加えられる場合、このキーパスのルートから path の値型へのキーパス。パスを付け加えられない場合は、nil を返します。

議論

このメソッドを使用して、このキーパスを別のキーパスの値型に拡張します。path として渡されたキーパスを付け加えるのは、パスのルート型がこのキーパスの値型と一致する場合にのみ成功します。この例では、Array<Int> から String へのキーパスを作成し、互換性のあるキーパスと互換性のないキーパスを追加しようとします。

let arrayDescription: PartialKeyPath<Array<Int>> = \.description

// Creates a key path from `Array<Int>` to `Int`
let arrayDescriptionLength = arrayDescription.appending(path: \String.count)

let invalidKeyPath = arrayDescription.appending(path: \Double.isZero)
// invalidKeyPath == nil

appending(path:) の 2 番目の呼び出しは、nil を返します。これは、path パラメータのルート型 Double が arrayDescription の値型 String と一致しないためです。