An enumeration defines a common type for a group of related values and enables you to work with those values in a type-safe way within your code.
列挙は、一群の関連した値のための共通の型を定義して、それらの値を型安全な方法であなたのコード内で扱えるようにします。

If you are familiar with C, you will know that C enumerations assign related names to a set of integer values. Enumerations in Swift are much more flexible, and do not have to provide a value for each case of the enumeration. If a value (known as a “raw” value) is provided for each enumeration case, the value can be a string, a character, or a value of any integer or floating-point type.
あなたがCに精通しているならば、あなたはCの列挙がひとまとめの整数値それぞれに対して関連した名前を割り当てるということを知っています。スウィフトの列挙は、ずっと柔軟で、列挙のケース節の各々に値を与える必要はありません。値（「生」の値として知られるもの）が列挙のケース節の各々のために提供されている場合には、その値は文字列、文字、またはあらゆる整数または浮動小数点型の値であることができます。

Alternatively, enumeration cases can specify associated values of any type to be stored along with each different case value, much as unions or variants do in other languages. You can define a common set of related cases as part of one enumeration, each of which has a different set of values of appropriate types associated with it.
代わりに、列挙ケース節は、ほとんど他の言語における共用体型やバリアント型がするように、それぞれ異なるケース節の値と一緒に格納されるために、あらゆる型の関連値を指定することが出来ます。あなたは、１つの列挙の一部として、関連したケース節のよくある集合を定義することができます、そのそれぞれはそれと結びつけられる適切な型の値の集合をそれぞれ別に持ちます。

Enumerations in Swift are first-class types in their own right. They adopt many features traditionally supported only by classes, such as computed properties to provide additional information about the enumeration’s current value, and instance methods to provide functionality related to the values the enumeration represents. Enumerations can also define initializers to provide an initial case value; can be extended to expand their functionality beyond their original implementation; and can conform to protocols to provide standard functionality.
スウィフトの列挙は、れっきとした第一級の型です。それらはクラスによってのみ伝統的に支えられる多くの特徴を採用します、例えば列挙の現在の値に関する追加の情報を提供する計算プロパティ、そして、列挙が表す値に関連した機能性を提供するインスタンスメソッドなど。列挙は、さらに、最初のケース節値を提供するためにイニシャライザを定義することができます；それらの本来の実装を越えてそれらの機能性を広げるために拡張されることができます；そして、標準の機能性を提供するためにプロトコルに準拠することができます。

For more about these capabilities, see Properties, Methods, Initialization, Extensions, and Protocols.
これらの能力に関する詳細は、プロパティ、メソッド、初期化、拡張、そしてプロトコルを見てください。

Enumeration Syntax
列挙構文

You introduce enumerations with the enum keyword and place their entire definition within a pair of braces:
あなたは、列挙をenumキーワードで始めて、一対の波括弧の内側にそれらの全ての定義を置きます：

Here’s an example for the four main points of a compass:
ここに、コンパスの主な４方位のための例があります：

The values defined in an enumeration (such as north, south, east, and west) are its enumeration cases. You use the case keyword to introduce new enumeration cases.
列挙で定義される値（例えばnorth、south、east、そしてwest）は、それの列挙ケース節です。あなたはcaseキーワードを使って、新しい列挙ケース節を導入することができます。

Multiple cases can appear on a single line, separated by commas:
複数のケース節は、コンマで区切られて、ただ一つの行に現れることができます：

Each enumeration definition defines a brand new type. Like other types in Swift, their names (such as CompassPoint and Planet) should start with a capital letter. Give enumeration types singular rather than plural names, so that they read as self-evident:
それぞれの列挙定義は、まっさらの新しい型を定義します。スウィフトにおける他の型のように、それらの名前（例えばCompassPointおよびPlanet）は、大文字から始めなければなりません。列挙型に複数形よりむしろ単数形の名前を与えてください、わかりきったことという印象を受けるので：

The type of directionToHead is inferred when it is initialized with one of the possible values of CompassPoint. Once directionToHead is declared as a CompassPoint, you can set it to a different CompassPoint value using a shorter dot syntax:
directionToHeadの型は、それがCompassPointの可能な値のうちの１つで初期化されるとき、推論されます。一旦directionToHeadが、あるCompassPointとして宣言されるならば、あなたはそれをより短いドット構文を使って、異なるCompassPoint値に設定することができます：

The type of directionToHead is already known, and so you can drop the type when setting its value. This makes for highly readable code when working with explicitly typed enumeration values.
directionToHeadの型はすでに知られています、それでその値を設定するとき、あなたは型を省くことができます。これは、明示的に型指定された列挙値を扱う場合に、非常に可読性の高いコードにします。

Matching Enumeration Values with a Switch Statement
スイッチ文で列挙値を照合する

You can match individual enumeration values with a switch statement:
あなたは、switch文を使って個々の列挙値を照合することができます：

You can read this code as:
あなたは、このコードを次のように読むことができます：

“Consider the value of directionToHead. In the case where it equals .north, print "Lots of planets have a north". In the case where it equals .south, print "Watch out for penguins".”
「directionToHeadの値を考慮する。それが.northに等しい場合には、"Lots of planets have a north"を出力する。それが.southに等しい場合には、"Watch out for penguins"を出力する。」

…and so on.
…などなど。

As described in Control Flow, a switch statement must be exhaustive when considering an enumeration’s cases. If the case for .west is omitted, this code does not compile, because it does not consider the complete list of CompassPoint cases. Requiring exhaustiveness ensures that enumeration cases are not accidentally omitted.
制御の流れで記述されるように、switch文は列挙のケース節を考慮するとき、徹底的でなければなりません。.westのためのcaseが省略されるならば、このコードはコンパイルしません、なぜなら、それがCompassPointのケース節の完全なリストを考慮しないからです。網羅性を要求することは、列挙ケース節のどれかがうっかり書き落とされないことを確実にします。

When it is not appropriate to provide a case for every enumeration case, you can provide a default case to cover any cases that are not addressed explicitly:
すべての列挙ケース節にcaseを提供することが妥当でないとき、あなたは明確に指定されないあらゆるケース節を扱うためにdefaultの場合を提供することができます：

Associated Values
関連値

The examples in the previous section show how the cases of an enumeration are a defined (and typed) value in their own right. You can set a constant or variable to Planet.earth, and check for this value later. However, it is sometimes useful to be able to store associated values of other types alongside these case values. This enables you to store additional custom information along with the case value, and permits this information to vary each time you use that case in your code.
前の節での例は、列挙のケース節がどのように自分だけで定義された（そして型付けされた）値であるかについて示します。あなたは、定数または変数をPlanet.earthに設定することができて、後でその値について調べることができます。しかし、他の型の関連値をこれらのケース節値の傍らに格納することができることは、時々役に立ちます。これはあなたに、ケース節値とともに追加の特注の情報を格納するのを可能にして、あなたがあなたのコードにおいてそのケース節を使うたびにこの情報が変化するのを許します。

You can define Swift enumerations to store associated values of any given type, and the value types can be different for each case of the enumeration if needed. Enumerations similar to these are known as discriminated unions, tagged unions, or variants in other programming languages.
あなたはスウィフト列挙を、どんな与えられた型の関連値でも格納するように定義することができます、そして値の型は列挙のケース節それぞれで異なっていることが可能です。これに似ている列挙は、他のプログラミング言語で判別共用体、タグ付き共用体、またはバリアントとして知られています。

For example, suppose an inventory tracking system needs to track products by two different types of barcode. Some products are labeled with 1D barcodes in UPC format, which uses the numbers 0 to 9. Each barcode has a “number system” digit, followed by five “manufacturer code” digits and five “product code” digits. These are followed by a “check” digit to verify that the code has been scanned correctly:
例えば、ある在庫追跡システムが、２つの異なる型のバーコードによって製品を追跡する必要があると思ってください。ある製品はUPC形式の一次元バーコードでラベルをつけられます、それは0から9までの数字を使います。各バーコードは、一つの「ナンバーシステム」桁、それに続く５桁の「製造者コード」そして５桁の「商品コード」を持ちます。これらの後にコードが正しくスキャンされたことを確認するための一つの「チェック」桁が続きます：

Other products are labeled with 2D barcodes in QR code format, which can use any ISO 8859-1 character and can encode a string up to 2,953 characters long:
別の製品はQRコード形式の二次元バーコードでラベルをつけられます、それはどんなISO 8859-1の文字でも使うことができて、2,953文字までの長さの文字列をコード化することができます：

It would be convenient for an inventory tracking system to be able to store UPC barcodes as a tuple of four integers, and QR code barcodes as a string of any length.
UPCバーコードを４つの整数のタプルとして、そしてQRコード・バーコードを任意の長さの文字列として格納できるのは、在庫追跡システムにとって便利です。

In Swift, an enumeration to define product barcodes of either type might look like this:
スウィフトにおいて、両方の種類の製品バーコードを定義する列挙は、これのように見えるかもしれません：

This can be read as:
これは、次のように解釈されることができます：

“Define an enumeration type called Barcode, which can take either a value of upc with an associated value of type (Int, Int, Int, Int), or a value of qrCode with an associated value of type String.”
「Barcodeと呼ばれる列挙型を定義します、それは型（Int、Int、Int、Int）の関連値をもつupcの値、または型Stringの関連値をもつqRCodeの値をとることができます。」

This definition does not provide any actual Int or String values—it just defines the type of associated values that Barcode constants and variables can store when they are equal to Barcode.upc or Barcode.qrCode.
この定義は、何ら実際のIntまたはString値を提供しません ― それは、ただ単に関連値の型を定義します、それは、Barcode定数と変数がBarcode.upcもしくはBarcode.qrCodeに等しいときに格納できる型です。

New barcodes can then be created using either type:
新しいバーコードは、それからどちらの型を使ってでも作成されることができます：

This example creates a new variable called productBarcode and assigns it a value of Barcode.upc with an associated tuple value of (8, 85909, 51226, 3).
この例は、productBarcodeと呼ばれる新しい変数をつくって、それにあるひとつのBarcode.upcの値を関連したタプル値(8, 85909, 51226, 3)とともに代入します。

The same product can be assigned a different type of barcode:
同じ製品は、異なる型のバーコードを代入されることができます：

At this point, the original Barcode.upc and its integer values are replaced by the new Barcode.qrCode and its string value. Constants and variables of type Barcode can store either a .upc or a .qrCode (together with their associated values), but they can only store one of them at any given time.
この点で、最初のBarcode.upcおよびその整数値は、新しいBarcode.qrCodeおよびその文字列値と取り替えられます。型Barcodeの定数と変数は、.upcまたは.qrCodeのどちらでも（それらの関連値と共に）格納することができます、しかしそれらはどんな時でもそれらの１つを格納することだけができます。

The different barcode types can be checked using a switch statement, as before. This time, however, the associated values can be extracted as part of the switch statement. You extract each associated value as a constant (with the let prefix) or a variable (with the var prefix) for use within the switch case’s body:
異なるバーコード型は、前の通り、スイッチ文を使って調べられることができます。この場合ではしかし、関連値がスイッチ文の一部として抽出されることができます。あなたは、関連値それぞれを定数（let接頭辞を使って）または変数（var接頭辞を使って）としてswitchのケース節の本文内で使用するために抽出します：

If all of the associated values for an enumeration case are extracted as constants, or if all are extracted as variables, you can place a single var or let annotation before the case name, for brevity:
列挙ケース節の関連値の全てが定数として抽出されるならば、または全てが変数として抽出されるならば、あなたは簡潔にvarまたはlet注釈一つだけをケース節名の前に置くことができます：

Raw Values
生の値

The barcode example in Associated Values shows how cases of an enumeration can declare that they store associated values of different types. As an alternative to associated values, enumeration cases can come prepopulated with default values (called raw values), which are all of the same type.
関連値におけるバーコード例は、それらが異なる型の関連値を格納することを、ある列挙のケース節たちがどのように宣言可能かを示します。関連値に代わるものとして、列挙ケース節は全て同じ型の（生の値と呼ばれる）初期値があらかじめ入れられた状態であることが出来ます。

Here’s an example that stores raw ASCII values alongside named enumeration cases:
指定した列挙ケース節の傍らに生のASCII値を格納する例は、ここにあります：

Here, the raw values for an enumeration called ASCIIControlCharacter are defined to be of type Character, and are set to some of the more common ASCII control characters. Character values are described in Strings and Characters.
ここでは、ASCIIControlCharacterと呼ばれる列挙に対する生の値は、型Characterであると定義されて、たいへんありふれたASCII制御文字のいくつかに設定されます。Character値は文字列と文字で記述されます。

Raw values can be strings, characters, or any of the integer or floating-point number types. Each raw value must be unique within its enumeration declaration.
生の値は、文字列、文字、または何らかの整数や浮動小数点数型であることができます。生の値それぞれは、その列挙宣言の範囲内で固有でなければなりません。

Recursive Enumerations
再帰列挙

A recursive enumeration is an enumeration that has another instance of the enumeration as the associated value for one or more of the enumeration cases. You indicate that an enumeration case is recursive by writing indirect before it, which tells the compiler to insert the necessary layer of indirection.
再帰列挙は、１つ以上の列挙ケース節のための関連値としてその列挙の別のインスタンスを持つ列挙です。あなたは、ある列挙ケース節が再帰することをそれの前にindirectを書くことによって指し示します、それは、コンパイラに不可欠な間接参照の階層を差し入れるように伝えます。

For example, here is an enumeration that stores simple arithmetic expressions:
例えば、ここに単純な算術式を格納する列挙があります：

You can also write indirect before the beginning of the enumeration to enable indirection for all of the enumeration’s cases that have an associated value:
あなたはまた、列挙の始まりの前にindirectを書くことで、列挙の持つケース節で関連値を持つもの全てに対して間接参照を可能にできます。

This enumeration can store three kinds of arithmetic expressions: a plain number, the addition of two expressions, and the multiplication of two expressions. The addition and multiplication cases have associated values that are also arithmetic expressions—these associated values make it possible to nest expressions. For example, the expression (5 + 4) * 2 has a number on the right-hand side of the multiplication and another expression on the left-hand side of the multiplication. Because the data is nested, the enumeration used to store the data also needs to support nesting—this means the enumeration needs to be recursive. The code below shows the ArithmeticExpression recursive enumeration being created for (5 + 4) * 2:
この列挙は、３種類の算術式：普通の数字、２つの式の加算、そして２つの式の乗算を格納することができます。additionとmultiplicationケース節は、それもまた算術式である関連値を持ちます—これらの関連値がそれを入れ子式可能なものにします。例えば、式(5 + 4) * 2は、１つの数を掛け算の右手側に、そして別の式を掛け算の左手側に持ちます。データが入れ子にされるため、データを格納するために使われる列挙もまた、入れ子をサポートする必要があります—これは列挙が再帰することを必要とするのを意味します。以下のコードは、(5 + 4) * 2に対して作成されている再帰列挙ArithmeticExpressionを示します：

A recursive function is a straightforward way to work with data that has a recursive structure. For example, here’s a function that evaluates an arithmetic expression:
再帰関数は、率直な方法で再帰構造を持つデータを扱います。例えば、ここに算術式の数値を求める関数があります：

This function evaluates a plain number by simply returning the associated value. It evaluates an addition or multiplication by evaluating the expression on the left-hand side, evaluating the expression on the right-hand side, and then adding them or multiplying them.
この関数は、普通の数字を単に関連値を返すことによって評価します。それは加算や乗算を、左手側の式を評価し、右手側の式を評価して、それからそれらを加算や乗算することで評価します。