Generic Structure

KeyValuePairs

A lightweight collection of key-value pairs. キー値ペアの軽量コレクション。

Declaration 宣言

@frozen struct KeyValuePairs<Key, Value>

Overview 概要

Use a KeyValuePairs instance when you need an ordered collection of key-value pairs and don’t require the fast key lookup that the Dictionary type provides. Unlike key-value pairs in a true dictionary, neither the key nor the value of a KeyValuePairs instance must conform to the Hashable protocol. KeyValuePairsインスタンスを使うのは、あなたがキー値ペアの順序付きコレクションを必要とするそしてDictionary型が提供する高速キー検索を要求しない場合です。本当の辞書におけるキー値ペアとは違い、KeyValuePairsインスタンスのキーも値もHashableプロトコルに準拠する必要はありません。

You initialize a KeyValuePairs instance using a Swift dictionary literal. Besides maintaining the order of the original dictionary literal, KeyValuePairs also allows duplicates keys. For example: あなたは、KeyValuePairsインスタンスをSwift辞書リテラルを使って初期化します。元の辞書リテラルの順番を保守するのと並んで、KeyValuePairsはまた重複キーを許可します。例えば:


let recordTimes: KeyValuePairs = ["Florence Griffith-Joyner": 10.49,
                                      "Evelyn Ashford": 10.76,
                                      "Evelyn Ashford": 10.79,
                                      "Marlies Gohr": 10.81]
print(recordTimes.first!)
// Prints "(key: "Florence Griffith-Joyner", value: 10.49)"

Some operations that are efficient on a dictionary are slower when using KeyValuePairs. In particular, to find the value matching a key, you must search through every element of the collection. The call to firstIndex(where:) in the following example must traverse the whole collection to find the element that matches the predicate: 辞書に効率の良いいくつかの演算は、KeyValuePairsを使う場合により遅くなります。特に、あるキーに合った値を見つけるには、あなたはコレクションのすべての要素を通して検索しなければなりません。firstIndex(where:)への呼び出しは以下の例において、コレクション全体を横断していき、述部に合致する要素を見つけます:


let runner = "Marlies Gohr"
if let index = recordTimes.firstIndex(where: { $0.0 == runner }) {
    let time = recordTimes[index].1
    print("\(runner) set a 100m record of \(time) seconds.")
} else {
    print("\(runner) couldn't be found in the records.")
}
// Prints "Marlies Gohr set a 100m record of 10.81 seconds."

Key-Value Pairs as a Function Parameter 関数パラメータとしてのキー値ペア

When calling a function with a KeyValuePairs parameter, you can pass a Swift dictionary literal without causing a Dictionary to be created. This capability can be especially important when the order of elements in the literal is significant. 関数をKeyValuePairsパラメータで呼び出す場合、あなたはSwift辞書リテラルを、あるDictionaryが作成されることを生じさせないで渡すことができます。この能力は、そのリテラル中の要素の順序が意味を持つ場合に特に重要となりえます。

For example, you could create an IntPairs structure that holds a list of two-integer tuples and use an initializer that accepts a KeyValuePairs instance. 例えば、あなたはIntPairs構造体を作成することができます、それは2整数のタプルのリストを保持して、KeyValuePairsインスタンスを受け入れるイニシャライザを使います。


struct IntPairs {
    var elements: [(Int, Int)]


    init(_ elements: KeyValuePairs<Int, Int>) {
        self.elements = Array(elements)
    }
}

When you’re ready to create a new IntPairs instance, use a dictionary literal as the parameter to the IntPairs initializer. The KeyValuePairs instance preserves the order of the elements as passed. あなたが新しいIntPairsインスタンスを作成する準備ができたら、辞書リテラルをパラメータとしてIntPairsイニシャライザに使ってください。KeyValuePairsインスタンスは、要素の順番を渡された通りに保全します。


let pairs = IntPairs([1: 2, 1: 1, 3: 4, 2: 1])
print(pairs.elements)
// Prints "[(1, 2), (1, 1), (3, 4), (2, 1)]"

Topics 話題

Type Aliases 型エイリアス

Initializers イニシャライザ

Instance Properties 様々なインスタンスプロパティ

Instance Methods インスタンスメソッド

Subscripts 添え字

See Also 参照

Special-Use Collections 特殊用途のコレクション