Extensions¶ 拡張¶

Extension Syntax¶ 拡張構文¶

Declare extensions with the extension keyword: extensionキーワードによって拡張を宣言してください：

An extension can extend an existing type to make it adopt one or more protocols. To add protocol conformance, you write the protocol names the same way as you write them for a class or structure: 拡張は、既存の型を拡張して、それが１つ以上のプロトコルを採用するようにできます。プロトコル準拠を加えるには、あなたはそれらプロトコル名を、あなたがそれらをクラスや構造体に対して書くのと同じ方法で記述します。

Adding protocol conformance in this way is described in Adding Protocol Conformance with an Extension. この方法でプロトコル準拠を加えることは拡張を使ってプロトコル準拠を加えるで記述されます。

An extension can be used to extend an existing generic type, as described in Extending a Generic Type. You can also extend a generic type to conditionally add functionality, as described in Extensions with a Generic Where Clause. 拡張は、既存の総称体型を拡張するために使われることができます、総称体型を拡張するで記述されるように。あなたはまた総称体型を拡張することで条件付きの機能性を追加することができます、総称体where節を持つ拡張で記述されるように。

Computed Properties¶ 計算プロパティ¶

Extensions can add computed instance properties and computed type properties to existing types. This example adds five computed instance properties to Swift’s built-in Double type, to provide basic support for working with distance units: 拡張は、既存の型に計算インスタンスプロパティと計算型プロパティを加えることができます。この例は、５つの計算インスタンスプロパティをスウィフトの組み込みのDouble型に加えて、距離単位を扱うための基本的な支持を提供します：

These computed properties express that a Double value should be considered as a certain unit of length. Although they’re implemented as computed properties, the names of these properties can be appended to a floating-point literal value with dot syntax, as a way to use that literal value to perform distance conversions. これらの計算プロパティは、Double値が長さの特定の単位とみなされなければならないことを表します。それらは計算プロパティとして実装されるけれども、これらのプロパティの名前はある浮動小数点リテラル値に、そのリテラル値を距離変換を実行するために使う方法として、ドット構文で追加されることが可能です。

In this example, a Double value of 1.0 is considered to represent “one meter”. This is why the m computed property returns self—the expression 1.m is considered to calculate a Double value of 1.0. この例では、1.0のDouble値は「１メートル」を表すと考慮されます。これがm計算プロパティがselfを返す理由です ― 式1.mは、1.0のDouble値を計算するものと考えられます。

Other units require some conversion to be expressed as a value measured in meters. One kilometer is the same as 1,000 meters, so the km computed property multiplies the value by 1_000.00 to convert into a number expressed in meters. Similarly, there are 3.28084 feet in a meter, and so the ft computed property divides the underlying Double value by 3.28084, to convert it from feet to meters. 他の単位は、メートルで計られる値として表されるためにいくらかの変換を必要とします。１キロメートルは1,000メートルと同じものですので、km計算プロパティは1_000.00を掛けられて、メートルで表される数に変換されます。同じように、１メートルは3.28084フィートあります、なのでft計算プロパティは、もとのDouble値を3.28084で割って、それをフィートからメートルに変換します。

These properties are read-only computed properties, and so they’re expressed without the get keyword, for brevity. Their return value is of type Double, and can be used within mathematical calculations wherever a Double is accepted: これらのプロパティは、読み出し専用の計算プロパティです、それでそれらは簡潔さのために、getキーワードなしで表わされます。それらの戻り値はDouble型です、そして数学計算内のDoubleが受け入れられるあらゆるところで使われることができます：

Initializers¶ イニシャライザ¶

Extensions can add new initializers to existing types. This enables you to extend other types to accept your own custom types as initializer parameters, or to provide additional initialization options that were not included as part of the type’s original implementation. 拡張は、新しいイニシャライザを既存の型に加えることができます。これは、あなたに別の型を拡張してあなた独自のあつらえの型をイニシャライザパラメータとして受け入れるようにすること、またはその型の最初の実装の一部として含まれなかった追加の初期化選択肢を提供することを可能にします。

Extensions can add new convenience initializers to a class, but they can’t add new designated initializers or deinitializers to a class. Designated initializers and deinitializers must always be provided by the original class implementation. 拡張は、新しい便利なイニシャライザをクラスに加えることができます、しかし、それは新しい指定イニシャライザまたはデイニシャライザをクラスに加えることができません。指定イニシャライザとデイニシャライザは、常に最初のクラス実施によって提供されなければなりません。

If you use an extension to add an initializer to a value type that provides default values for all of its stored properties and doesn’t define any custom initializers, you can call the default initializer and memberwise initializer for that value type from within your extension’s initializer. This wouldn’t be the case if you had written the initializer as part of the value type’s original implementation, as described in Initializer Delegation for Value Types. あなたが拡張を、その格納プロパティの全てに省略時の値を与えて全くあつらえのイニシャライザを定義しない値型に、イニシャライザを加えるために使うならば、あなたはその値型のための省略時のイニシャライザとメンバー関連イニシャライザを、あなたの拡張のイニシャライザ内から呼ぶことができます。値型のためのイニシャライザ委任で記述されるように、あなたがイニシャライザをその値型の最初の実装の一部として書いたならば、それはこの場合にはなりません。

If you use an extension to add an initializer to a structure that was declared in another module, the new initializer can’t access self until it calls an initializer from the defining module. あなたが拡張を使ってイニシャライザを別のモジュールの中で宣言された構造体へと加えるならば、その新しいイニシャライザはselfにアクセスすることが、それがあるイニシャライザを定義されているモジュールから呼び出すまでは出来ません。

The example below defines a custom Rect structure to represent a geometric rectangle. The example also defines two supporting structures called Size and Point, both of which provide default values of 0.0 for all of their properties: 下の例は、幾何学の長方形を表すためにあつらえのRect構造体を定義します。この例はまた、SizeとPointと呼ばれる２つの支援の構造体を定義します、その両方はそれらのプロパティの全てに0.0の省略時の値を提供します：

Because the Rect structure provides default values for all of its properties, it receives a default initializer and a memberwise initializer automatically, as described in Default Initializers. These initializers can be used to create new Rect instances: Rect構造体がそのプロパティの全てに省略時の値を与えるので、省略時のイニシャライザで記述されるように、それは自動的に省略時のイニシャライザとメンバー関連イニシャライザを受け取ります。これらのイニシャライザが、新しいRect例をつくるために使われることができます：

You can extend the Rect structure to provide an additional initializer that takes a specific center point and size: あなたは、Rect構造体を拡張して、特定の中心点と大きさをとる追加のイニシャライザを提供することができます：

This new initializer starts by calculating an appropriate origin point based on the provided center point and size value. The initializer then calls the structure’s automatic memberwise initializer init(origin:size:), which stores the new origin and size values in the appropriate properties: この新しいイニシャライザは、提供されたcenter点とsize値に基づいて適切な起源点を計算することによって始めます。イニシャライザはそれから、構造体の自動的なメンバー関連イニシャライザinit(origin:size:)を呼びます、それは、新しい原点とサイズ値を適切なプロパティに保管します：

Methods¶ メソッド¶

Extensions can add new instance methods and type methods to existing types. The following example adds a new instance method called repetitions to the Int type: 拡張は、新しいインスタンスメソッドと型メソッドを既存の型に加えることができます。以下の例は、repetitionsと呼ばれる新しいインスタンスメソッドをInt型に加えます：

The repetitions(task:) method takes a single argument of type () -> Void, which indicates a function that has no parameters and doesn’t return a value. repetitions(task:)メソッドは型() -> Voidの引数をひとつだけとります、それは、パラメータを持たず、値を返さない関数であることを示します。

After defining this extension, you can call the repetitions(task:) method on any integer to perform a task that many number of times: この拡張を定義した後、あなたはrepetitions(task:)メソッドをあらゆる整数上で呼び出して、ある作業をそれだけ多くの回数実行できます：

Subscripts¶ 添え字¶

Extensions can add new subscripts to an existing type. This example adds an integer subscript to Swift’s built-in Int type. This subscript [n] returns the decimal digit n places in from the right of the number: 拡張は、新しい添え字を既存の型に加えることができます。この例は、整数添え字をスウィフトの組み込みのInt型に加えます。この添え字[n]は、右の数からの10進桁n位置を返します：

• 123456789[0] returns 9 123456789[0]は9を返します
• 123456789[1] returns 8 123456789[1]は8を返します

…and so on: …などなど：

If the Int value doesn’t have enough digits for the requested index, the subscript implementation returns 0, as if the number had been padded with zeros to the left: Int値には要十分な桁が請されたインデックスに対してないならば、この添え字実装は、まるで数が左にゼロを詰められたように0を返します：

Nested Types¶ 入れ子にされた型¶

Extensions can add new nested types to existing classes, structures, and enumerations: 拡張は、新しい入れ子にされた型を既存のクラス、構造体、および列挙に加えることができます：

This example adds a new nested enumeration to Int. This enumeration, called Kind, expresses the kind of number that a particular integer represents. Specifically, it expresses whether the number is negative, zero, or positive. この例は、新しい入れ子にされた列挙をIntに加えます。この列挙は、Kindと呼ばれ、特定の整数を表わす数の種類を表わします。具体的には、それはその数が負、ゼロ、または正かを表わします。

This example also adds a new computed instance property to Int, called kind, which returns the appropriate Kind enumeration case for that integer. この例はまた、新しい計算インスタンスプロパティをIntに加えます、それは、kindと呼ばれ、その整数に対する適切なKind列挙ケース節を返します。

The nested enumeration can now be used with any Int value: 入れ子にされた列挙は今やあらゆるInt値で使われることができます：

This function, printIntegerKinds(_:), takes an input array of Int values and iterates over those values in turn. For each integer in the array, the function considers the kind computed property for that integer, and prints an appropriate description. この関数、printIntegerKinds(_:)は、Int値の配列の入力を取り、それらの値に最初から終わりまで順番に繰り返していきます。その配列の各整数に対して、この関数はその整数に対するkind計算プロパティを考慮して、適切な説明を出力します。