Guides and Sample Code

Developer

The Swift Programming Language (Swift 4.1)

iBooks
On This Page

Subscripts
添え字

Classes, structures, and enumerations can define subscripts, which are shortcuts for accessing the member elements of a collection, list, or sequence. You use subscripts to set and retrieve values by index without needing separate methods for setting and retrieval. For example, you access elements in an Array instance as someArray[index] and elements in a Dictionary instance as someDictionary[key].
クラス、構造体、および列挙は、添え字を定義することができます、それは、コレクション、リスト、またはシーケンスのメンバー要素にアクセスするための近道です。あなたは添え字を使うことで、独立したメソッドを設定や検索のために必要とすることなしに、インデックスによって値を設定したり取得したりします。例えば、あなたはあるArrayインスタンスの中の要素にsomeArray[index]として、そしてあるDictionaryインスタンスの中の要素にsomeDictionary[key]のようにアクセスします。

You can define multiple subscripts for a single type, and the appropriate subscript overload to use is selected based on the type of index value you pass to the subscript. Subscripts are not limited to a single dimension, and you can define subscripts with multiple input parameters to suit your custom type’s needs.
あなたは一つの型のために複数の添え字を定義することができます、そしてあなたが添え字に渡すインデックス値の型に基づいて、使うのに適切な添え字のオーバーロードが選択されます。添え字は一つの次元に制限されません、なのであなたは複数の入力パラメータをもつ添え字を定義して、あなたのあつらえの型の必要を満たすことが出来ます。

Subscript Syntax
添え字の構文

Subscripts enable you to query instances of a type by writing one or more values in square brackets after the instance name. Their syntax is similar to both instance method syntax and computed property syntax. You write subscript definitions with the subscript keyword, and specify one or more input parameters and a return type, in the same way as instance methods. Unlike instance methods, subscripts can be read-write or read-only. This behavior is communicated by a getter and setter in the same way as for computed properties:
添え字は、あなたにそのインスタンス名の後で角括弧の中に一つ以上の値を書くことによって、ある型のインスタンスに問い合わせることを可能にします。それらの構文は、インスタンスメソッド構文と計算プロパティ構文に似ています。あなたは、添え字定義をsubscriptキーワードを使って書きます、そしてインスタンスメソッドと同じ方法で、一つ以上の入力パラメータと戻り型を指定します。インスタンスメソッドと違って、添え字は読み書き用であるか読み出し専用であることができます。この挙動は、計算プロパティに関してと同様に、ゲッターとセッターによって伝えられます:

  1. subscript(index: Int) -> Int {
  2. get {
  3. // return an appropriate subscript value here (適切な添え字値をここで返す)
  4. }
  5. set(newValue) {
  6. // perform a suitable setting action here (ふさわしい設定動作をここで行う)
  7. }
  8. }

The type of newValue is the same as the return value of the subscript. As with computed properties, you can choose not to specify the setter’s (newValue) parameter. A default parameter called newValue is provided to your setter if you do not provide one yourself.
newValueの型は、添え字の戻り値と同じものです。計算プロパティと同様に、あなたはセッターの(newValue)パラメータを指定しないほうを選ぶことができます。あなたが独自のものを提供しないならば、newValueと呼ばれる省略時のパラメータがあなたのセッターに提供されます。

As with read-only computed properties, you can simplify the declaration of a read-only subscript by removing the get keyword and its braces:
読み出し専用の計算プロパティでのように、あなたは読み出し専用の添え字の宣言を単純化することが、getキーワードとそれの波括弧を取り除くことによって行えます:

  1. subscript(index: Int) -> Int {
  2. // return an appropriate subscript value here (適切な添え字値をここで返す)
  3. }

Here’s an example of a read-only subscript implementation, which defines a TimesTable structure to represent an n-times-table of integers:
ここに読み出し専用の添え字の実施の例があります、それは、整数の九九のn段を表すTimesTable構造体を定義します:

  1. struct TimesTable {
  2. let multiplier: Int
  3. subscript(index: Int) -> Int {
  4. return multiplier * index
  5. }
  6. }
  7. let threeTimesTable = TimesTable(multiplier: 3)
  8. print("six times three is \(threeTimesTable[6])")
  9. // Prints "six times three is 18" (「6かける3は18です」を出力します)

In this example, a new instance of TimesTable is created to represent the three-times-table. This is indicated by passing a value of 3 to the structure’s initializer as the value to use for the instance’s multiplier parameter.
この例では、TimesTableの新しいインスタンスは、九九の3の段を表すためにつくられます。これは、値3をこの構造体のinitializerにインスタンスのmultiplierパラメータのために使う値として渡すことによって示されます。

You can query the threeTimesTable instance by calling its subscript, as shown in the call to threeTimesTable[6]. This requests the sixth entry in the three-times-table, which returns a value of 18, or 3 times 6.
あなたは、threeTimesTableインスタンスにその添え字を呼ぶことによって問い合わせることがthreeTimesTable[6]への呼び出しで示されるように可能です。これは九九の3の段において6番目の部分を要請します、それは値18、つまり3掛ける6を返します。

Subscript Usage
添え字の使用法

The exact meaning of “subscript” depends on the context in which it is used. Subscripts are typically used as a shortcut for accessing the member elements in a collection, list, or sequence. You are free to implement subscripts in the most appropriate way for your particular class or structure’s functionality.
「添え字」の正確な意味は、それが使われる前後関係に依存します。添え字は、一般的に、コレクション、リスト、またはシーケンスの中のメンバー要素にアクセスするための近道として使われます。あなたは、あなたの特定のクラスまたは構造体の機能性に最も適切な方法で、添え字を実装して結構です。

For example, Swift’s Dictionary type implements a subscript to set and retrieve the values stored in a Dictionary instance. You can set a value in a dictionary by providing a key of the dictionary’s key type within subscript brackets, and assigning a value of the dictionary’s value type to the subscript:
例えば、スウィフトのDictionary型は、Dictionaryインスタンスに格納される値を設定したり取り出すために添え字を実装します。あなたは、添え字角括弧内にその辞書のキー型のキーを提供し、そしてその添え字に辞書の値型の値を代入することによって、値を辞書に設定することができます:

  1. var numberOfLegs = ["spider": 8, "ant": 6, "cat": 4]
  2. numberOfLegs["bird"] = 2

The example above defines a variable called numberOfLegs and initializes it with a dictionary literal containing three key-value pairs. The type of the numberOfLegs dictionary is inferred to be [String: Int]. After creating the dictionary, this example uses subscript assignment to add a String key of "bird" and an Int value of 2 to the dictionary.
上の例は、numberOfLegsと呼ばれる変数を定義して、3つの「キーと値」の対を含んでいる辞書リテラルでそれを初期化します。numberOfLegs辞書の型は、[String: Int]であると推測されます。辞書を作成した後に、この例は、辞書にStringキーの"bird"Int値の2を加えるために添え字代入を使います。

For more information about Dictionary subscripting, see Accessing and Modifying a Dictionary.
Dictionaryで添え字を使うことの詳細については、辞書へのアクセスと修正を見てください。

Subscript Options
添え字オプション

Subscripts can take any number of input parameters, and these input parameters can be of any type. Subscripts can also return any type. Subscripts can use variadic parameters, but they can’t use in-out parameters or provide default parameter values.
添え字は、任意の数の入力パラメータをとることができます、そしてこれらの入力パラメータはどんな型でもかまいません。添え字は、また、どんな型でも返すことができます。添え字は、可変長パラメータを使うことができます、しかしそれはin-outパラメータを使うことや省略時のパラメータ値を提供することはできません。

A class or structure can provide as many subscript implementations as it needs, and the appropriate subscript to be used will be inferred based on the types of the value or values that are contained within the subscript brackets at the point that the subscript is used. This definition of multiple subscripts is known as subscript overloading.
クラスや構造体はそれが必要とする多くの添え字実装を提供することが可能です、そして使用されるのに適切な添え字が、添え字が使われる時点でその添え字角括弧内に含まれる値または複数の値の型に基づいて、推論されます。この複数の添え字の定義は、添え字オーバーロードとして知られています。

While it is most common for a subscript to take a single parameter, you can also define a subscript with multiple parameters if it is appropriate for your type. The following example defines a Matrix structure, which represents a two-dimensional matrix of Double values. The Matrix structure’s subscript takes two integer parameters:
添え字がただ一つのパラメータをとることが最も普通であるけれども、あなたはまた、それがあなたの型に適切ならば、複数のパラメータをもつ添え字を定義することができます。以下の例はMatrix構造体を定義します、それはDouble値からなる2次元行列を表します。Matrix構造体の添え字は、2つの整数パラメータをとります:

  1. struct Matrix {
  2. let rows: Int, columns: Int
  3. var grid: [Double]
  4. init(rows: Int, columns: Int) {
  5. self.rows = rows
  6. self.columns = columns
  7. grid = Array(repeating: 0.0, count: rows * columns)
  8. }
  9. func indexIsValid(row: Int, column: Int) -> Bool {
  10. return row >= 0 && row < rows && column >= 0 && column < columns
  11. }
  12. subscript(row: Int, column: Int) -> Double {
  13. get {
  14. assert(indexIsValid(row: row, column: column), "Index out of range")
  15. return grid[(row * columns) + column]
  16. }
  17. set {
  18. assert(indexIsValid(row: row, column: column), "Index out of range")
  19. grid[(row * columns) + column] = newValue
  20. }
  21. }
  22. }

Matrix provides an initializer that takes two parameters called rows and columns, and creates an array that is large enough to store rows * columns values of type Double. Each position in the matrix is given an initial value of 0.0. To achieve this, the array’s size, and an initial cell value of 0.0, are passed to an array initializer that creates and initializes a new array of the correct size. This initializer is described in more detail in Creating an Array with a Default Value.
Matrixはひとつのイニシャライザを提供します、それはrowscolumnsと呼ばれる2つのパラメータをとり、型Doubleで個数rows * columnsの値を格納するのに十分大きい配列をつくります。行列の中の各位置は、0.0の初期値を与えられます。これを達成するために、この配列の大きさ、そして0.0の初期セル値は、正しいサイズの新しい配列をつくって初期化する配列イニシャライザに渡されます。このイニシャライザは、更に詳細に配列を1つの初期値で作成するで記述されます。

You can construct a new Matrix instance by passing an appropriate row and column count to its initializer:
あなたは、そのイニシャライザに適切な行と列の数を渡すことによって新しいMatrixインスタンスを造ることができます:

  1. var matrix = Matrix(rows: 2, columns: 2)

The example above creates a new Matrix instance with two rows and two columns. The grid array for this Matrix instance is effectively a flattened version of the matrix, as read from top left to bottom right:
上の例は、2つの行と2つの列で新しいMatrixインスタンスをつくります。このMatrixインスタンスのためのgrid配列は、実際にはこのMatrix 行列の、左上から右下へと読まれる、平らにされた改変板です:

image: ../Art/subscriptMatrix01_2x.png

Values in the matrix can be set by passing row and column values into the subscript, separated by a comma:
行列の中の値は、コンマで区切った行と列の値を添え字に渡すことによって設定されることができます:

  1. matrix[0, 1] = 1.5
  2. matrix[1, 0] = 3.2

These two statements call the subscript’s setter to set a value of 1.5 in the top right position of the matrix (where row is 0 and column is 1), and 3.2 in the bottom left position (where row is 1 and column is 0):
これらの2つの文は、添え字のセッターを呼び出して、この行列の右上位置(row0column1のところ)に1.5の値を、そして左下位置(row1column0のところ)に3.2を設定します:

image: ../Art/subscriptMatrix02_2x.png

The Matrix subscript’s getter and setter both contain an assertion to check that the subscript’s row and column values are valid. To assist with these assertions, Matrix includes a convenience method called indexIsValid(row:column:), which checks whether the requested row and column are inside the bounds of the matrix:
Matrix添え字のゲッターとセッターは両方とも、添え字のもつrowcolumn値が有効なことを確認するためにひとつの表明を含みます。これらの表明を手伝うために、MatrixindexIsValid(row:column:)と呼ばれるある便利なメソッドを含みます、それは要請されたrowcolumnが行列の境界の内側にあるかどうか確認します:

  1. func indexIsValid(row: Int, column: Int) -> Bool {
  2. return row >= 0 && row < rows && column >= 0 && column < columns
  3. }

An assertion is triggered if you try to access a subscript that is outside of the matrix bounds:
あなたがマトリックス境界の外にある添え字にアクセスしようとするならば、表明が引き起こされます:

  1. let someValue = matrix[2, 2]
  2. // this triggers an assert, because [2, 2] is outside of the matrix bounds (これはある表明の引き金となります、なぜなら [2, 2]はマトリックス境界の外であるからです)