Optional Chaining¶ オプショナル連鎖¶

Optional Chaining as an Alternative to Forced Unwrapping¶ 強制アンラップに代わるものとしてのオプショナル連鎖¶

You specify optional chaining by placing a question mark (?) after the optional value on which you wish to call a property, method or subscript if the optional is non-nil. This is very similar to placing an exclamation point (!) after an optional value to force the unwrapping of its value. The main difference is that optional chaining fails gracefully when the optional is nil, whereas forced unwrapping triggers a runtime error when the optional is nil. あなたはオプショナル連鎖を、そのオプショナルがnilで無いならばあなたがプロパティ、メソッド、または添え字を呼び出したいオプショナルの値の後に疑問符（?）を置くことによって指定します。これは、その値を強制アンラップするためにオプショナルの値の後に感嘆符（!）を置くことに非常に似ています。大きな違いは、オプショナル連鎖はそのオプショナルがnilであるとき潔く失敗します、だけれども強制アンラップはそのオプショナルがnilであるとき実行時エラーの引き金となります。

To reflect the fact that optional chaining can be called on a nil value, the result of an optional chaining call is always an optional value, even if the property, method, or subscript you are querying returns a non-optional value. You can use this optional return value to check whether the optional chaining call was successful (the returned optional contains a value), or didn’t succeed due to a nil value in the chain (the returned optional value is nil). オプショナル連鎖はnil値上で呼ばれることができるという事実を反映するために、オプショナル連鎖呼び出しの結果は、たとえあなたが問い合わせているプロパティ、メソッド、または添え字が非オプショナルの値を返すとしても、常にオプショナルの値です。あなたは、このオプショナルの戻り値を使って、オプショナル連鎖呼び出しが成功した（返されたオプショナルが値を含む）か、あるいは連鎖の中のnil値のために成功しなかった（返されたオプショナルの値がnilである）かどうか確認することができます。

Specifically, the result of an optional chaining call is of the same type as the expected return value, but wrapped in an optional. A property that normally returns an Int will return an Int? when accessed through optional chaining. 具体的には、オプショナル連鎖の呼び出しの結果は、期待される戻り値と同じ型ですが、オプショナルの中にラップされています。通常はIntを返すプロパティは、オプショナル連鎖を通してアクセスされるときInt?を返します。

The next several code snippets demonstrate how optional chaining differs from forced unwrapping and enables you to check for success. 次のいくつかのコード切れっぱしは、どのようにオプショナル連鎖が強制アンラップと異なるか、そして成功をどのようにあなたが確認できるかを例示します。

First, two classes called Person and Residence are defined: 最初に、PersonとResidence（個人と邸宅）と呼ばれる２つのクラスが定義されます：

Residence instances have a single Int property called numberOfRooms, with a default value of 1. Person instances have an optional residence property of type Residence?. Residenceインスタンスは、numberOfRoomsと呼ばれる省略時の値1を持つIntプロパティただひとつを持ちます。Personインスタンスは、型Residence?のオプショナルresidenceプロパティを持ちます。

If you create a new Person instance, its residence property is default initialized to nil, by virtue of being optional. In the code below, john has a residence property value of nil: あなたが新しいPersonインスタンスをつくるならば、そのresidenceプロパティは、オプショナルである長所によって、省略時でnilに初期化されます。下記のコードにおいて、johnはnilのresidenceプロパティ値を持ちます：

If you try to access the numberOfRooms property of this person’s residence, by placing an exclamation point after residence to force the unwrapping of its value, you trigger a runtime error, because there’s no residence value to unwrap: あなたがこの人のresidenceのnumberOfRoomsプロパティに、その値を強制アンラップするためresidenceの後に感嘆符を置くことによって、アクセスしようとするならば、あなたは実行時エラーを引き起こします、なぜなら、アンラップするresidence値はないからです：

The code above succeeds when john.residence has a non-nil value and will set roomCount to an Int value containing the appropriate number of rooms. However, this code always triggers a runtime error when residence is nil, as illustrated above. john.residenceが非nil値を持って、roomCountを部屋の適当な数を含んでいるInt値に設定するとき、上のコードは成功します。しかし、residenceがnilのとき、上で説明するように、このコードは常に実行時エラーの引き金となります。

Optional chaining provides an alternative way to access the value of numberOfRooms. To use optional chaining, use a question mark in place of the exclamation point: オプショナル連鎖は、numberOfRoomsの値にアクセスする代わりの方法を提供します。オプショナル連鎖を使用するために、感嘆符の代わりに疑問符を使ってください：

This tells Swift to “chain” on the optional residence property and to retrieve the value of numberOfRooms if residence exists. これはスウィフトに、オプショナルのresidenceプロパティの上に「繋げて」、そしてresidenceが存在するならばnumberOfRoomsの値を取り出すように言います。

Because the attempt to access numberOfRooms has the potential to fail, the optional chaining attempt returns a value of type Int?, or “optional Int”. When residence is nil, as in the example above, this optional Int will also be nil, to reflect the fact that it was not possible to access numberOfRooms. The optional Int is accessed through optional binding to unwrap the integer and assign the non-optional value to the roomCount constant. numberOfRoomsにアクセスする試みは失敗する可能性があるので、オプショナル連鎖は型Int?の値、すなわち「オプショナルのInt」、を返すことを試みます。residenceがnilのとき、上の例の場合のように、このオプショナルのIntはまたnilになり、numberOfRoomsにアクセスすることは可能でなかったという事実を反映します。オプショナルのIntは、オプショナル束縛を通してアクセスされることで、整数をアンラップして取り出して、その非オプショナル値をroomCount定数へ割り当てます。

Note that this is true even though numberOfRooms is a non-optional Int. The fact that it’s queried through an optional chain means that the call to numberOfRooms will always return an Int? instead of an Int. たとえnumberOfRoomsが非オプショナルのIntであるとしても、これが当てはまることに注意してください。それがオプショナル連鎖によって問い合わせられるという事実は、numberOfRoomsへの呼び出しが常にInt?を返すことを意味します、Intではなく。

You can assign a Residence instance to john.residence, so that it no longer has a nil value: あなたはjohn.residenceにResidenceインスタンスを代入することができます、それによってそれはもはやnil値を持ちません：

john.residence now contains an actual Residence instance, rather than nil. If you try to access numberOfRooms with the same optional chaining as before, it will now return an Int? that contains the default numberOfRooms value of 1: john.residenceは、今では実際のResidenceインスタンスを含みます、nilではなく。あなたが前と同じオプショナル連鎖でnumberOfRoomsにアクセスしようとするならば、それは今では省略時のnumberOfRooms値の1を含むInt?を返します：

Defining Model Classes for Optional Chaining¶ オプショナル連鎖のモデル・クラスを定義する¶

You can use optional chaining with calls to properties, methods, and subscripts that are more than one level deep. This enables you to drill down into subproperties within complex models of interrelated types, and to check whether it’s possible to access properties, methods, and subscripts on those subproperties. あなたは、深さ１階層以上であるプロパティ、メソッド、そして添え字への呼び出しでオプショナル連鎖を使うことができます。これはあなたに、相互に関係づけられた型である複雑なモデルの内部の下位情報に掘り下げていくこと、そしてそれらの下位情報上でプロパティ、メソッド、そして添え字にアクセスすることが可能であるかどうか確認することを可能にします。

The code snippets below define four model classes for use in several subsequent examples, including examples of multilevel optional chaining. These classes expand upon the Person and Residence model from above by adding a Room and Address class, with associated properties, methods, and subscripts. 下のコード切れっぱしは、複数階層のオプショナル連鎖の例を含む以降のいくつかの例のために、４つのモデル・クラスを定義します。これらのクラスは、関連するプロパティ、メソッド、そして添え字とともにRoomとAddressクラスを加えることによって、上記のPersonとResidenceモデルを拡張します。

The Person class is defined in the same way as before: Personクラスは、前の通りに定義されます：

The Residence class is more complex than before. This time, the Residence class defines a variable property called rooms, which is initialized with an empty array of type [Room]: Residenceクラスは、前より複雑です。今度は、Residenceクラスはroomsと呼ばれる変数プロパティを定義します、それは、型[Room]の空の配列で初期化されます：

Because this version of Residence stores an array of Room instances, its numberOfRooms property is implemented as a computed property, not a stored property. The computed numberOfRooms property simply returns the value of the count property from the rooms array. Residenceのこの改作がRoomインスタンスの配列を格納するので、そのnumberOfRoomsプロパティは計算プロパティとして実装されます、格納プロパティではなく。計算numberOfRoomsプロパティは、単にrooms配列からcountプロパティの値を返します。

As a shortcut to accessing its rooms array, this version of Residence provides a read-write subscript that provides access to the room at the requested index in the rooms array. そのrooms配列にアクセスすることへの近道として、Residenceのこの版は読み出し専用の添え字を提供します、それは、rooms配列の中の要求されたインデックスでの部屋へのアクセスを提供します。

This version of Residence also provides a method called printNumberOfRooms, which simply prints the number of rooms in the residence. Residenceのこの版もprintNumberOfRoomsと呼ばれるメソッドを提供します、それは、単にその住居の部屋数を出力します。

Finally, Residence defines an optional property called address, with a type of Address?. The Address class type for this property is defined below. 最終的に、Residenceはaddressと呼ばれるオプショナルのプロパティを、Address?の型で定義します。このプロパティのためのAddressクラス型は、下で定義されます。

The Room class used for the rooms array is a simple class with one property called name, and an initializer to set that property to a suitable room name: rooms配列のために使用されるRoomクラスは、nameと呼ばれる１つのプロパティ、そしてそのプロパティを適切な部屋名に設定するイニシャライザをもつ単純なクラスです：

The final class in this model is called Address. This class has three optional properties of type String?. The first two properties, buildingName and buildingNumber, are alternative ways to identify a particular building as part of an address. The third property, street, is used to name the street for that address: このモデルの中の最後のクラスは、Addressと呼ばれています。このクラスは、型String?の３つのオプショナルのプロパティを持ちます。最初の２つのプロパティ、buildingNameとbuildingNumberは、アドレスの一部として特定の建物を同定するそれぞれ代替の方法です。第３のプロパティ、streetは、そのアドレスの通りのために使われます：

The Address class also provides a method called buildingIdentifier(), which has a return type of String?. This method checks the properties of the address and returns buildingName if it has a value, or buildingNumber concatenated with street if both have values, or nil otherwise. Addressクラスはまた、buildingIdentifier()と呼ばれるメソッドを提供します、それは、String?の戻り型を持ちます。このメソッドは、アドレスのプロパティを調べて、それが値を持つならばbuildingNameを、または両方とも値を持つならばbuildingNumberに繋げてstreetを、またはそれ以外ではnilを返します。

Accessing Properties Through Optional Chaining¶ オプショナル連鎖を通してプロパティにアクセスする¶

As demonstrated in Optional Chaining as an Alternative to Forced Unwrapping, you can use optional chaining to access a property on an optional value, and to check if that property access is successful. 強制アンラップに代わるものとしてのオプショナル連鎖で例示されるように、あなたはオプショナル連鎖を使って、あるオプショナル上でプロパティにアクセスして、そのプロパティへのアクセスが成功したか調べることができます。

Use the classes defined above to create a new Person instance, and try to access its numberOfRooms property as before: 上のクラス定義を使って、新しいPersonインスタンスをつくって、前のようにそのnumberOfRoomsプロパティにアクセスすることを試みてください：

Because john.residence is nil, this optional chaining call fails in the same way as before. john.residenceがnilであるため、このオプショナル連鎖呼び出しは前と同じやり方で失敗します。

You can also attempt to set a property’s value through optional chaining: あなたはまたプロパティの値をオプショナル連鎖を通して設定することを試みることができます：

In this example, the attempt to set the address property of john.residence will fail, because john.residence is currently nil. この例において、john.residenceのaddressプロパティを設定する試みは失敗します、なぜならjohn.residenceが現在nilだからです。

The assignment is part of the optional chaining, which means none of the code on the right-hand side of the = operator is evaluated. In the previous example, it’s not easy to see that someAddress is never evaluated, because accessing a constant doesn’t have any side effects. The listing below does the same assignment, but it uses a function to create the address. The function prints “Function was called” before returning a value, which lets you see whether the right-hand side of the = operator was evaluated. この代入はオプショナル連鎖の一部です、それが意味するのは、=演算子の右手側で評価されるコードは何もないということです。前の例において、someAddressが決して評価されないというのはわかりやすいとはいえません、なぜならある定数を代入することは、何ら副作用を持たないからです。下でのコード出力は、同じ代入を行います、しかしそれはある関数を使ってアドレスを作成します。この関数は、値を返す前に「Function was called（関数は呼び出された）」を出力します、それはあなたに=演算子の右手側が評価されたかどうかを確かめさせます。

You can tell that the createAddress() function isn’t called, because nothing is printed. あなたは、createAddress()関数が呼ばれなかったと言うことができます、なぜなら何も出力されなかったからです。

Calling Methods Through Optional Chaining¶ オプショナル連鎖を通してメソッドを呼ぶ¶

You can use optional chaining to call a method on an optional value, and to check whether that method call is successful. You can do this even if that method doesn’t define a return value. あなたはオプショナル連鎖を使って、オプショナルの値の上でメソッドを呼んで、そしてそのメソッド呼び出しが成功しているかどうか調べることができます。たとえそのメソッドが戻り値を定義しないとしても、あなたはこれをすることができます。

The printNumberOfRooms() method on the Residence class prints the current value of numberOfRooms. Here’s how the method looks: Residenceクラス上のprintNumberOfRooms()メソッドは、numberOfRoomsの現在の値を出力します。どのようにそのメソッドが見えるかは、ここにあります：

This method doesn’t specify a return type. However, functions and methods with no return type have an implicit return type of Void, as described in Functions Without Return Values. This means that they return a value of (), or an empty tuple. このメソッドは、戻り型を指定しません。しかし、戻り値のない関数で記述されるように、戻り型のない関数やメソッドは、Voidの暗黙の戻り型を持ちます。これは、それらが値()、または空のタプルを返すことを意味します。

If you call this method on an optional value with optional chaining, the method’s return type will be Void?, not Void, because return values are always of an optional type when called through optional chaining. This enables you to use an if statement to check whether it was possible to call the printNumberOfRooms() method, even though the method doesn’t itself define a return value. Compare the return value from the printNumberOfRooms call against nil to see if the method call was successful: あなたがこのメソッドをあるオプショナルの値の上でオプショナル連鎖を使って呼ぶならば、メソッドの戻り値はVoid?になります、Voidではなく、なぜならば、オプショナル連鎖を通して呼び出されるとき戻り値は常にオプショナルだからです。これはあなたにif文をprintNumberOfRooms()メソッドを呼び出すことが可能か調べるために使うことを可能にします、たとえそのメソッドがそれ自身では戻り値を定義しないとしてもです。printNumberOfRooms呼び出しからの戻り値をnilと比較して、そのメソッドがうまく呼び出されたか見てください：

The same is true if you attempt to set a property through optional chaining. The example above in Accessing Properties Through Optional Chaining attempts to set an address value for john.residence, even though the residence property is nil. Any attempt to set a property through optional chaining returns a value of type Void?, which enables you to compare against nil to see if the property was set successfully: 同じことは、あなたがプロパティをオプショナル連鎖を通して設定しようと試みる場合にも当てはまります。オプショナル連鎖を通してプロパティにアクセスするでの前の例は、あるaddress値をjohn.residenceに対して設定することを試みます、たとえresidenceプロパティがnilであるとしてもです。オプショナル連鎖を通してプロパティを設定しようとするあらゆる試みは、型Void?の値を返します、それは、あなたにnilと比較することでそのプロパティがうまく設定されたかどうか調べることを可能にします。

Accessing Subscripts Through Optional Chaining¶ オプショナル連鎖を通して添え字にアクセスする¶

You can use optional chaining to try to retrieve and set a value from a subscript on an optional value, and to check whether that subscript call is successful. あなたは、オプショナル連鎖を使って、あるオプショナルの値上の添え字から値を取り出したり設定したりすること、そしてその添え字がうまく呼び出されるかどうかを調べることができます。

The example below tries to retrieve the name of the first room in the rooms array of the john.residence property using the subscript defined on the Residence class. Because john.residence is currently nil, the subscript call fails: 下の例は、Residenceクラス上で定義される添え字を使って、john.residenceプロパティのrooms配列での最初の部屋の名前を取り出そうとします。john.residenceが現在nilなので、添え字呼び出しは失敗します：

The optional chaining question mark in this subscript call is placed immediately after john.residence, before the subscript brackets, because john.residence is the optional value on which optional chaining is being attempted. この添え字呼び出しでのオプショナル連鎖の疑問符は、john.residenceの直後、添え字の角括弧の前に置かれます、なぜなら、john.residenceがオプショナル連鎖が試みられているオプショナルの値であるからです。

Similarly, you can try to set a new value through a subscript with optional chaining: 同じように、あなたはオプショナル連鎖を使う添え字を通して、新しい値の設定を試みることができます：

This subscript setting attempt also fails, because residence is currently nil. この添え字設定の試みはまた失敗します、なぜならresidenceが現在nilだからです。

If you create and assign an actual Residence instance to john.residence, with one or more Room instances in its rooms array, you can use the Residence subscript to access the actual items in the rooms array through optional chaining: あなたが実際のResidenceインスタンスをつくってjohn.residenceに代入して、そのrooms配列の中に１つ以上のRoomインスタンスをもつならば、あなたはResidence添え字を使って、オプショナル連鎖を通してrooms配列の実際の項目にアクセスすることができます。

Linking Multiple Levels of Chaining¶ 連鎖の複数の階層を結ぶ¶

You can link together multiple levels of optional chaining to drill down to properties, methods, and subscripts deeper within a model. However, multiple levels of optional chaining don’t add more levels of optionality to the returned value. あなたは、オプショナル連鎖の複数の階層を結びつけて、あるモデル内のより深いプロパティ、メソッド、そして添え字に掘り下げていくことができます。しかし、オプショナル連鎖の複数の階層は、返された値にさらにオプショナルの階層を加えません。

To put it another way: 言い換えれば：

• If the type you are trying to retrieve isn’t optional, it will become optional because of the optional chaining. あなたが取り出そうとしている型がオプショナルでないならば、それはオプショナル連鎖であることからオプショナルになります。
• If the type you are trying to retrieve is already optional, it will not become more optional because of the chaining. あなたが取り出そうとしている型がすでにオプショナルならば、それは連鎖であることからさらにオプショナルにはなりません。

Therefore: したがって：

• If you try to retrieve an Int value through optional chaining, an Int? is always returned, no matter how many levels of chaining are used. あなたがオプショナル連鎖を通してInt値を取り出そうと試すならば、Int?が常に返されます、どんなに多くの連鎖階層が使われようともです。
• Similarly, if you try to retrieve an Int? value through optional chaining, an Int? is always returned, no matter how many levels of chaining are used. 同じように、あなたがオプショナル連鎖を通してInt?値を取り出そうと試すならば、Int?が常に返されます、どんなに多くの連鎖階層が使われようともです。

The example below tries to access the street property of the address property of the residence property of john. There are two levels of optional chaining in use here, to chain through the residence and address properties, both of which are of optional type: 下の例は、johnのresidenceプロパティのaddressプロパティのstreetプロパティにアクセスしようとします。ここで使用されるオプショナル連鎖の２つの階層があります、そしてresidenceとaddressプロパティを通り抜けて繋げます、その両方ともオプショナル型です：

The value of john.residence currently contains a valid Residence instance. However, the value of john.residence.address is currently nil. Because of this, the call to john.residence?.address?.street fails. john.residenceの値は、現在は有効なResidenceインスタンスを含みます。しかし、john.residence.addressの値は、現在はnilです。このことから、john.residence?.address?.streetへの呼び出しは、失敗します。

Note that in the example above, you are trying to retrieve the value of the street property. The type of this property is String?. The return value of john.residence?.address?.street is therefore also String?, even though two levels of optional chaining are applied in addition to the underlying optional type of the property. 上の例で、あなたがstreetプロパティの値を取り出そうとしている点に注意してください。このプロパティの型は、String?です。john.residence?.address?.streetの戻り値は、したがってまた、String?です、その下のプロパティのオプショナル型に加えて２つのオプショナル連鎖の階層が適用されるとしてもです。

If you set an actual Address instance as the value for john.residence.address, and set an actual value for the address’s street property, you can access the value of the street property through multilevel optional chaining: あなたが実際のAddressインスタンスをjohn.residence.addressのための値として設定して、そしてアドレスのもつstreetプロパティのために実際の値を設定するならば、あなたは複数階層のオプショナル連鎖を通してstreetプロパティの値にアクセスすることができます：

In this example, the attempt to set the address property of john.residence will succeed, because the value of john.residence currently contains a valid Residence instance. この例において、john.residenceのaddressプロパティを設定しようとする試みは成功します、なぜならjohn.residenceの値は現在は有効なResidenceインスタンスを含むからです。

Chaining on Methods with Optional Return Values¶ オプショナルの戻り値をもつメソッド上で連鎖する¶

The previous example shows how to retrieve the value of a property of optional type through optional chaining. You can also use optional chaining to call a method that returns a value of optional type, and to chain on that method’s return value if needed. 前の例は、オプショナル連鎖を通してオプショナルの型のプロパティの値を取り出す方法を示します。あなたはまたオプショナル連鎖を使って、オプショナルの型の値を返すメソッドを呼び出すこと、そして必要ならば、そのメソッドの戻り値の上で連鎖することができます。

The example below calls the Address class’s buildingIdentifier() method through optional chaining. This method returns a value of type String?. As described above, the ultimate return type of this method call after optional chaining is also String?: 下の例は、オプショナル連鎖を通してAddressクラスのbuildingIdentifier()メソッドを呼び出します。このメソッドは、型String?の値を返します。先に述べたように、オプショナル連鎖の後ろのこのメソッド呼び出しの最終的な戻り型は、また、String?です：

If you want to perform further optional chaining on this method’s return value, place the optional chaining question mark after the method’s parentheses: あなたがこのメソッドの戻り値の上でさらにオプショナル連鎖を実行したいならば、メソッドの丸括弧の後にオプショナル連鎖の疑問符を置いてください：