A lightweight collection of key-value pairs.
キー値ペアの軽量コレクション。
Availability
iOS 8.0+
iPadOS 8.0+
macOS 10.10+
Mac Catalyst 13.0+
tvOS 9.0+
watchOS 2.0+
Xcode 10.2+
Technology
Swift Standard Library
Swift標準ライブラリ
Declaration
宣言
@frozenstructKeyValuePairs<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はまた重複キーを許可します。例えば:
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:)への呼び出しは以下の例において、コレクション全体を横断していき、述部に合致する要素を見つけます:
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インスタンスを受け入れるイニシャライザを使います。
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インスタンスは、要素の順番を渡された通りに保全します。
The collection’s “past the end” position—that is, the position one greater than the last valid subscript argument.
コレクションの「終わりを過ぎた」位置—すなわち、最後の有効な添え字引数より1つ大きい位置。
A sequence containing the same elements as this sequence, but on which some operations, such as map and filter, are implemented lazily.
このシーケンスと同じ要素を含んでいるシーケンス、しかしそれの上で何らかの演算、例えばmapやfilterが遅延に実装されます。
Returns an array containing the non-nil results of calling the given transformation with each element of this sequence.
指定された変換をこのシーケンスの各要素で呼び出す結果で非-nilのものを含んでいる配列を返します。
Returns a Boolean value indicating whether the sequence contains an element that satisfies the given predicate.
指定された述部を満足させるある要素をシーケンスが含むかどうかを指し示すブール値を返します。
Returns the difference needed to produce this collection’s ordered elements from the given collection, using the given predicate as an equivalence test.
このコレクションのもつ順番付けられた要素をこの与えられたコレクションから生成するのに必要とされる差異を返します、与えられた述部を同等性テストとして使います。
Returns a subsequence by skipping elements while predicate returns true and returning the remaining elements.predicateがtrueを返す間は要素を飛ばして残りの要素を返すことによって、ある下位シーケンスを返します。
Returns a Boolean value indicating whether this sequence and another sequence contain equivalent elements in the same order, using the given predicate as the equivalence test.
このシーケンスともう一方のシーケンスが同等の要素を同じ順序で含むかどうかを、与えられた述部を同等テストとして使って、指し示しているブール値を返します。
Returns a sequence of pairs (n, x), where n represents a consecutive integer starting at zero and x represents an element of the sequence.
ペア (n, x) のシーケンスを返します、そこでnはゼロで開始する連続した数を表して、xはシーケンスの要素を表します。
Returns an array containing the concatenated results of calling the given transformation with each element of this sequence.
指定された変換をこのシーケンスの各要素で呼び出す結果を連結したものを含んでいる配列を返します。
Offsets the given index by the specified distance, or so that it equals the given limiting index.
与えられたインデックスをこの指定された隔たりで補います、またはそれでそれは与えられた限界インデックスと等しくなります。
Returns an index that is the specified distance from the given index, unless that distance is beyond a given limiting index.
与えられたインデックスから指定された隔たりのインデックスを返します、その隔たりが与えられた限界インデックスを越えない限りは。
Returns a Boolean value indicating whether the sequence precedes another sequence in a lexicographical (dictionary) ordering, using the given predicate to compare elements.
シーケンスが別のシーケンスの前に来るかどうかをある語彙筆記的順序(字典)順序において、与えられた述部を使って要素を比較して、指し示すブール値を返します。
Returns a subsequence, up to the specified maximum length, containing the initial elements of the collection.
下位シーケンスを、指定された最大長まで、コレクションの冒頭の要素を含めて返します。
Returns a subsequence containing the initial elements until predicate returns false and skipping the remaining elements.predicateがfalseを返すまで冒頭の要素を含んでいて残りの要素を飛ばしている、ある下位シーケンスを返します。
Returns the longest possible subsequences of the collection, in order, that don’t contain elements satisfying the given predicate.
与えられた述部を満たす要素を含んでいない、このコレクションの最も長くなりうる下位シーケンスそれらを順序どおりに返します。
Returns a Boolean value indicating whether the initial elements of the sequence are equivalent to the elements in another sequence, using the given predicate as the equivalence test.
シーケンスの最初の要素らが別のシーケンスの中の要素らと同等かどうかを、与えられた述部を同等性テストとして使って指し示すブール値を返します。