init?(rawValue : Self.RawValue)
Overview 概要
With a Raw
type, you can switch back and forth between a custom type and an associated Raw
type without losing the value of the original Raw
type. Using the raw value of a conforming type streamlines interoperation with Objective-C and legacy APIs and simplifies conformance to other protocols, such as Equatable
, Comparable
, and Hashable
.
Raw
型で、あなたはあつらえの型と関連Raw
型との間を行ったり戻ったり切り替えることが元のRaw
型の値の損失なしに可能です。準拠する型の生の値を使うことは、Objective-CおよびレガシーAPIとの相互運用を能率的にします、そして他のプロトコル、例えばEquatable
、Comparable
、およびHashable
などへの準拠を簡単にします。
The Raw
protocol is seen mainly in two categories of types: enumerations with raw value types and option sets.
Raw
プロトコルが主に見られるのは、2つの部類の型:列挙で生の値型を持つものとオプションセットにおいてです。
Enumerations with Raw Values 生の値を持つ列挙
For any enumeration with a string, integer, or floating-point raw type, the Swift compiler automatically adds Raw
conformance. When defining your own custom enumeration, you give it a raw type by specifying the raw type as the first item in the enumeration’s type inheritance list. You can also use literals to specify values for one or more cases.
文字列、整数、または浮動小数点の生の型を持つ何らかの列挙に対して、Swiftコンパイラは自動的にRaw
準拠を加えます。あなた独自のあつらえの列挙を定義している場合、あなたはそれに生の型を与えることを、その生の型を列挙の型継承リストの最初の項目として指定することによって行います。あなたはまた、リテラルを使うことで値を1つ以上のケース節に指定することができます。
For example, the Counter
enumeration defined here has an Int
raw value type and gives the first case a raw value of 1
:
例えば、ここで定義されるCounter
列挙は、Int
の生の値型を持ち、そして最初のケース節に生の値の1
を与えます:
You can create a Counter
instance from an integer value between 1 and 5 by using the init?(raw
initializer declared in the Raw
protocol. This initializer is failable because although every case of the Counter
type has a corresponding Int
value, there are many Int
values that don’t correspond to a case of Counter
.
あなたはCounter
インスタンスを1と5の間の整数値から作成することが、Raw
プロトコルにおいて宣言されるinit?(raw
イニシャライザを使うことによって可能です。このイニシャライザは失敗可能です、なぜならすべてのCounter
型のケース節は対応するInt
値を持つけれども、Counter
のケース節に対応しない多くのInt
値が存在するからです。
Option Sets オプションセット
Option sets all conform to Raw
by inheritance using the Option
protocol. Whether using an option set or creating your own, you use the raw value of an option set instance to store the instance’s bitfield. The raw value must therefore be of a type that conforms to the Fixed
protocol, such as UInt8
or Int
. For example, the Direction
type defines an option set for the four directions you can move in a game.
オプションセットすべては、Raw
への準拠をOption
プロトコルを使って継承することによって行います。あるオプションセットを使用するかあなた自身で作成する場合、あなたはオプションセットインスタンスの生の値を使って、そのインスタンスの持つビットフィールドを格納します。生の値はしたがって、Fixed
プロトコルに準拠する型、例えばUInt8
またはInt
などのものでなければなりません。例えば、Direction
型はオプションセットをあるゲームにおいてあなたが動かせる4つの方向のために定義します。
Unlike enumerations, option sets provide a nonfailable init(raw
initializer to convert from a raw value, because option sets don’t have an enumerated list of all possible cases. Option set values have a one-to-one correspondence with their associated raw values.
列挙と異なり、オプションセットは生の値から変換するために失敗できないinit(raw
イニシャライザを提供します、なぜならオプションセットは可能な場合全てを列挙したリストを持たないからです。オプションセット値それらは、それらの関連する生の値と一対一の対応を持ちます。
In the case of the Directions
option set, an instance can contain zero, one, or more of the four defined directions. This example declares a constant with three currently allowed moves. The raw value of the allowed
instance is the result of the bitwise OR of its three members’ raw values:
Directions
オプションセットの場合では、あるインスタンスは4つ定義された方向のうちゼロ、1つ、またはそれ以上を含むことができます。この例は3つの現在許される動きを持つある定数を宣言します。allowed
インスタンスの生の値は、それの3つのメンバの持つ生の値のビット単位ORの結果です:
Option sets use bitwise operations on their associated raw values to implement their mathematical set operations. For example, the contains()
method on allowed
performs a bitwise AND operation to check whether the option set contains an element.
オプションセットは、ビット単位演算をそれらの関連する生の値上で使うことで、それらの数学的集合演算を実施します。例えば、contains()
メソドはallowed
上で、ビット単位AND演算を実行して、オプションセットがある要素を含むかどうか調べます。