A key path referring to storage that can be accessed through a value of type T
.
型T
の値を通してアクセス可能なストレージを参照しているキーパス。
offset(of:)
Availability
- iOS 8.0+
- iPadOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 10.0+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
static func offset(of key: PartialKeyPath
<T>) -> Int
?
Parameters パラメータ
key
Return Value 戻り値
The offset in bytes from a pointer to a value of type T
to a pointer to the storage referenced by key
, or nil
if no such offset is available for the storage referenced by key
. If the value is nil
, it can be because key
is computed, has observers, requires reabstraction, or overlaps storage with other properties.
型T
の値へのポインタから、key
によって参照されるストレージへのポインタまでのバイトでのオフセット、またはnil
、もしそのようなオフセットがkey
によって参照されるストレージに利用可能でないならば。値がnil
の場合、それが可能なのはkey
が計算される、オブザーバを持つ、再抽象化を要求する、またはストレージを他のプロパティでオーバーラップするからです。
Discussion 解説
You can use this method to find the distance in bytes that can be added to a pointer of type T
to get a pointer to the property referenced by key
. The offset is available only if the given key refers to inline, directly addressable storage within the in-memory representation of T
.
あなたはこのメソッドを使ってバイトでの隔たりを見つけることができます、それは型T
のポインタに加えることで、key
によって参照されるプロパティへのポインタを得ることができるものです。このオフセットは与えられたキーがインラインの、直接にアドレス指定可能なストレージをT
のインメモリ表現内で参照する場合にのみ利用可能です。
If the return value of this method is non-nil
, then accessing the value by key path or by an offset pointer are equivalent. For example, for a variable root
of type T
, a key path key
of type Writable
, and a value
of type U
:
このメソッドの戻り値が非nil
ならば、その時その値にキーパスによってまたはあるオフセットポインタによってアクセスすることは、等価です。例えば、変数root
で型T
、キーパスkey
で型Writable
、そしてvalue
で型U
に対して:
A property has inline, directly addressable storage when it is a stored property for which no additional work is required to extract or set the value. Properties are not directly accessible if they trigger any did
or will
accessors, perform any representation changes such as bridging or closure reabstraction, or mask the value out of overlapping storage as for packed bitfields. In addition, because class instance properties are always stored out-of-line, their positions are not accessible using offset(of:)
.
あるプロパティは、インラインに、直接にアドレス指定可能なストレージを持ちます、それが値を抽出または設定するのに追加的な仕事が要求されない格納プロパティである場合は。プロパティは直接にアクセス可能ではありません、もしそれらが何らかのdid
またはwill
アクセッサの引き金になる、何らかの表現変更の実行たとえばブリッジまたはクロージャ再抽象化など、またはオーバーラップしているストレージの外の値をパックされたビットフィールドとしてマスクするならば。その上、クラスインスタンスプロパティは常にアウトオブラインに格納されることから、それらの位置はoffset(of:)
によってアクセス可能ではありません。
For example, in the Product
type defined here, only \.update
, \.identifier
, and \.identifier
refer to properties with inline, directly addressable storage:
例えば、ここで定義されるProduct
型において、\.update
, \.identifier
、そして\.identifier
だけがインラインに、直接にアドレス指定可能なストレージでのプロパティを参照します。
When using offset(of:)
with a type imported from a library, don’t assume that future versions of the library will have the same behavior. If a property is converted from a stored property to a computed property, the result of offset(of:)
changes to nil
. That kind of conversion is nonbreaking in other contexts, but would trigger a runtime error if the result of offset(of:)
is force-unwrapped.
offset(of:)
をあるライブラリからインポートされる型で使う場合、そのライブラリの将来のバージョンが同じ挙動を持つと決めてかからないでください。プロパティが格納プロパティから計算プロパティに変換されるならば、offset(of:)
の結果はnil
に変わります。その種の変換は、他の文脈においては非破壊です、しかしoffset(of:)
の結果が強制アンラップされるならば実行時エラーの引き金となります。