Generic Structure

CollectionDifference

A collection of insertions and removals that describe the difference between two ordered collection states. ２つの順序付きコレクション状態の間の差異を記述するいくらかの挿入と除去からなるあるコレクション。

Declaration 宣言 

struct CollectionDifference<ChangeElement>

Topics 話題

Type Aliases 型エイリアス

typealias CollectionDifference.Element
A type representing the sequence’s elements. このシーケンスの持つ要素を表している型。
typealias CollectionDifference.Indices
A type that represents the indices that are valid for subscripting the collection, in ascending order. 昇順での、コレクションの添え字として有効なインデックスを表す型。
typealias CollectionDifference.Iterator
A type that provides the collection’s iteration interface and encapsulates its iteration state. そのコレクションの持つ反復インターフェイスを提供してそれの反復状態をカプセル化するある型。
typealias CollectionDifference.SubSequence
A collection representing a contiguous subrange of this collection’s elements. The subsequence shares indices with the original collection.

Initializers イニシャライザ

init?<Changes>(Changes)
Creates a new collection difference from a collection of changes. 新しいコレクション差異を、変更それらからなるあるコレクションから作成します。
init(from: Decoder)
Creates a new instance by decoding from the given decoder. 与えられたデコーダからデコードすることで新しいインスタンスを作成します。
Available when ChangeElement conforms to Decodable and Encodable. ChangeElementがDecodableとEncodableに準拠する場合に利用可能です。

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

var count: Int
The number of elements in the collection. コレクションの中の要素の数。
var endIndex: CollectionDifference<ChangeElement>.Index
The collection’s “past the end” position—that is, the position one greater than the last valid subscript argument. コレクションの「終わりを過ぎた」位置—すなわち、最後の有効な添え字引数より１つ大きい位置。
var first: Change?
The first element of the collection. コレクションの最初の要素。
var hashValue: Int
The hash value. ハッシュ値。
Available when ChangeElement conforms to Hashable. ChangeElementがHashableに準拠する場合に利用可能です。
var indices: DefaultIndices<CollectionDifference<ChangeElement>>
The indices that are valid for subscripting the collection, in ascending order. コレクションの添え字に使うのに有効である、昇順でのインデックス。
let insertions: [CollectionDifference<ChangeElement>.Change]
The insertions contained by this difference, from lowest offset to highest. この差異によって含まれる挿入、最も低いオフセットから最も高い方へと。
var isEmpty: Bool
A Boolean value indicating whether the collection is empty. コレクションが空かどうかを指し示すブール値。
var lazy: LazySequence<CollectionDifference<ChangeElement>>
A sequence containing the same elements as this sequence, but on which some operations, such as map and filter, are implemented lazily. このシーケンスと同じ要素を含んでいるシーケンス、しかしそれの上で何らかの演算、例えばmapやfilterが遅延に実装されます。
let removals: [CollectionDifference<ChangeElement>.Change]
The removals contained by this difference, from lowest offset to highest. この差異によって含まれる除去、最も低いオフセットから最も高い方へと。
var startIndex: CollectionDifference<ChangeElement>.Index
The position of the first element in a nonempty collection. 空でないコレクションの中の最初の要素の位置。
var underestimatedCount: Int
A value less than or equal to the number of elements in the collection. このコレクションの中の要素の数より少ないか等しい値。

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

func allSatisfy((Change) -> Bool) -> Bool
Returns a Boolean value indicating whether every element of a sequence satisfies a given predicate. シーケンスのすべての要素がある与えられた述部を満たすかどうかを指し示すブール値を返します。
func compactMap<ElementOfResult>((Change) -> ElementOfResult?) -> [ElementOfResult]
Returns an array containing the non-nil results of calling the given transformation with each element of this sequence. 指定された変換をこのシーケンスの各要素で呼び出す結果で非-nilのものを含んでいる配列を返します。
func contains(Change) -> Bool
Returns a Boolean value indicating whether the sequence contains the given element. 指定された要素をシーケンスが含むかどうかを指し示すブール値を返します。
func contains(where: (Change) -> Bool) -> Bool
Returns a Boolean value indicating whether the sequence contains an element that satisfies the given predicate. 指定された述部を満足させるある要素をシーケンスが含むかどうかを指し示すブール値を返します。
func distance(from: CollectionDifference<ChangeElement>.Index, to: CollectionDifference<ChangeElement>.Index) -> Int
Returns the distance between two indices. ２つのインデックス間の隔たりを返します。
func drop(while: (Change) -> Bool) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence by skipping elements while predicate returns true and returning the remaining elements. predicateがtrueを返す間は要素を飛ばして残りの要素を返すことによって、ある下位シーケンスを返します。
func dropFirst(Int) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence containing all but the given number of initial elements. 指定された数の冒頭要素以外すべてを含んでいる下位シーケンスを返します。
func dropLast(Int) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence containing all but the specified number of final elements. 指定された数の末尾要素以外すべてを含んでいる下位シーケンスを返します。
func elementsEqual<OtherSequence>(OtherSequence) -> Bool
Returns a Boolean value indicating whether this sequence and another sequence contain the same elements in the same order. このシーケンスともう一方のシーケンスが同じ要素を同じ順序で含むかどうかを指し示すブール値を返します。
func elementsEqual<OtherSequence>(OtherSequence, by: (Change, OtherSequence.Element) -> Bool) -> Bool
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. このシーケンスともう一方のシーケンスが同等の要素を同じ順序で含むかどうかを、与えられた述部を同等テストとして使って、指し示しているブール値を返します。
func encode(to: Encoder)
Encodes this value into the given encoder. この値を与えられたエンコーダにエンコードします。
Available when ChangeElement conforms to Decodable and Encodable. ChangeElementがDecodableとEncodableに準拠する場合に利用可能です。
func enumerated() -> EnumeratedSequence<CollectionDifference<ChangeElement>>
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はシーケンスの要素を表します。
func filter((Change) -> Bool) -> [Change]
Returns an array containing, in order, the elements of the sequence that satisfy the given predicate. 指定された述部を満足させるものであるシーケンスの要素を、順序通りに、含んでいる配列を返します。
func first(where: (Change) -> Bool) -> Change?
Returns the first element of the sequence that satisfies the given predicate. 与えられた述部を満たすこのシーケンスの最初の要素を返します。
func firstIndex(of: Change) -> Index?
Returns the first index where the specified value appears in the collection. 指定された値がコレクションにおいて現れるところの最初のインデックスを返します。
func firstIndex(where: (Change) -> Bool) -> Index?
Returns the first index in which an element of the collection satisfies the given predicate. 最初のインデックスで、それにおけるコレクションの要素が与えられた述部を満足させるものを返します。
func flatMap<SegmentOfResult>((Change) -> SegmentOfResult) -> [SegmentOfResult.Element]
Returns an array containing the concatenated results of calling the given transformation with each element of this sequence. 指定された変換をこのシーケンスの各要素で呼び出す結果を連結したものを含んでいる配列を返します。
func flatMap<ElementOfResult>((Change) -> ElementOfResult?) -> [ElementOfResult]Deprecated 非推奨
func forEach((Change) -> Void)
Calls the given closure on each element in the sequence in the same order as a for-in loop. 指定されたクロージャをそのシーケンスの各要素上でfor-inループと同じ順番で呼び出します。
func formIndex(inout CollectionDifference<ChangeElement>.Index, offsetBy: Int)
func formIndex(inout Index, offsetBy: Int, limitedBy: Index) -> Bool
Offsets the given index by the specified distance, or so that it equals the given limiting index. 与えられたインデックスをこの指定された隔たりで補います、またはそれでそれは与えられた限界インデックスと等しくなります。
func formIndex(after: inout Index)
Replaces the given index with its successor. 与えられたインデックスをそれの後に続くものと取り替えます。
func hash(into: inout Hasher)
Hashes the essential components of this value by feeding them into the given hasher. この値の本質的な構成要素を、それらをその与えられたhasherへと与えることによって、ハッシュ化します。
Available when ChangeElement conforms to Hashable. ChangeElementがHashableに準拠する場合に利用可能です。
func index(Index, offsetBy: Int) -> Index
Returns an index that is the specified distance from the given index. 与えられたインデックスから指定された隔たりのインデックスを返します。
func index(Index, offsetBy: Int, limitedBy: Index) -> Index?
Returns an index that is the specified distance from the given index, unless that distance is beyond a given limiting index. 与えられたインデックスから指定された隔たりのインデックスを返します、その隔たりが与えられた限界インデックスを越えない限りは。
func index(after: CollectionDifference<ChangeElement>.Index) -> CollectionDifference<ChangeElement>.Index
Returns the position immediately after the given index. 与えられたインデックスの直後の位置を返します。
func index(before: CollectionDifference<ChangeElement>.Index) -> CollectionDifference<ChangeElement>.Index
func index(of: Change) -> Index?
Returns the first index where the specified value appears in the collection. 指定された値がコレクションにおいて現れるところの最初のインデックスを返します。
Deprecated 非推奨
func inferringMoves() -> CollectionDifference<ChangeElement>
Returns a new collection difference with associations between individual elements that have been removed and inserted only once. ただ一度だけ除去および挿入された個々の要素の間の関連性それらをもつある新しいコレクション差異を返します。
Available when ChangeElement conforms to Hashable. ChangeElementがHashableに準拠する場合に利用可能です。
func inverse() -> CollectionDifference<ChangeElement>
func lexicographicallyPrecedes<OtherSequence>(OtherSequence, by: (Change, Change) -> Bool) -> Bool
Returns a Boolean value indicating whether the sequence precedes another sequence in a lexicographical (dictionary) ordering, using the given predicate to compare elements. シーケンスが別のシーケンスの前に来るかどうかをある語彙筆記的順序（字典）順序において、与えられた述部を使って要素を比較して、指し示すブール値を返します。
func makeIterator() -> IndexingIterator<CollectionDifference<ChangeElement>>
Returns an iterator over the elements of the collection. コレクションの要素すべてを対象としたイテレータを返します。
func map<T>((Change) -> T) -> [T]
Returns an array containing the results of mapping the given closure over the sequence’s elements. 与えられたクロージャをシーケンスのもつ要素全体にわたってマップする結果を含んでいる配列を返します。
func max(by: (Change, Change) -> Bool) -> Change?
Returns the maximum element in the sequence, using the given predicate as the comparison between elements. シーケンスの中の最大の要素を返します、与えられた述部を要素間の比較として使います。
func min(by: (Change, Change) -> Bool) -> Change?
Returns the minimum element in the sequence, using the given predicate as the comparison between elements. シーケンスの中の最小の要素を返します、与えられた述部を要素間の比較として使います。
func prefix(Int) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence, up to the specified maximum length, containing the initial elements of the collection. 下位シーケンスを、指定された最大長まで、コレクションの冒頭の要素を含めて返します。
func prefix(through: Index) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence from the start of the collection through the specified position. コレクションの始まりから指定された位置までも含む下位シーケンスを返します。
func prefix(upTo: Index) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence from the start of the collection up to, but not including, the specified position. コレクションの始まりから指定された位置まで、しかしそれは含めない下位シーケンスを返します。
func prefix(while: (Change) -> Bool) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence containing the initial elements until predicate returns false and skipping the remaining elements. predicateがfalseを返すまで冒頭の要素を含んでいて残りの要素を飛ばしている、ある下位シーケンスを返します。
func randomElement() -> Change?
Returns a random element of the collection. コレクションのある無作為の要素を返します。
func randomElement<T>(using: inout T) -> Change?
Returns a random element of the collection, using the given generator as a source for randomness. コレクションのある無作為な要素を返します、与えられた生成子を無作為さの出典として使って使います。
func reduce<Result>(Result, (Result, Change) -> Result) -> Result
Returns the result of combining the elements of the sequence using the given closure. 与えられたクロージャを使って、このシーケンスの要素それらを結合する結果を返します。
func reduce<Result>(into: Result, (inout Result, Change) -> ()) -> Result
Returns the result of combining the elements of the sequence using the given closure. 与えられたクロージャを使って、このシーケンスの要素それらを結合する結果を返します。
func reversed() -> [Change]
Returns an array containing the elements of this sequence in reverse order. このシーケンスの要素を逆順に含んでいる配列を返します。
func shuffled() -> [Change]
Returns the elements of the sequence, shuffled. 入れ替えた、シーケンスの要素を返します。
func shuffled<T>(using: inout T) -> [Change]
Returns the elements of the sequence, shuffled using the given generator as a source for randomness. シーケンスの要素を返します、与えられた生成子を無作為さの出典として使って混ぜ合わされます。
func sorted(by: (Change, Change) -> Bool) -> [Change]
Returns the elements of the sequence, sorted using the given predicate as the comparison between elements. 与えられた述部を要素間の比較として使ってソートされた、シーケンスの要素を返します。
func split(maxSplits: Int, omittingEmptySubsequences: Bool, whereSeparator: (Change) -> Bool) -> [Slice<CollectionDifference<ChangeElement>>]
Returns the longest possible subsequences of the collection, in order, that don’t contain elements satisfying the given predicate. 与えられた述部を満たす要素を含んでいない、このコレクションの最も長くなりうる下位シーケンスそれらを順序どおりに返します。
func split(separator: Change, maxSplits: Int, omittingEmptySubsequences: Bool) -> [ArraySlice<Change>]
Returns the longest possible subsequences of the sequence, in order, around elements equal to the given element. 与えられた要素と等しい要素を避けるようにして、このシーケンスの最も長くなりうる下位シーケンスを、順番に返します。
func split(separator: Change, maxSplits: Int, omittingEmptySubsequences: Bool) -> [Slice<CollectionDifference<ChangeElement>>]
Returns the longest possible subsequences of the collection, in order, around elements equal to the given element. 与えられた要素と等しい要素を避けるようにして、このコレクションの最も長くなりうる下位シーケンスを、順番に返します。
func starts<PossiblePrefix>(with: PossiblePrefix) -> Bool
Returns a Boolean value indicating whether the initial elements of the sequence are the same as the elements in another sequence. シーケンスの最初の要素らが別のシーケンスの中の要素らと同じかどうかを指し示すブール値を返します。
func starts<PossiblePrefix>(with: PossiblePrefix, by: (Change, PossiblePrefix.Element) -> Bool) -> Bool
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. シーケンスの最初の要素らが別のシーケンスの中の要素らと同等かどうかを、与えられた述部を同等性テストとして使って指し示すブール値を返します。
func suffix(Int) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence, up to the given maximum length, containing the final elements of the collection. 下位シーケンスを、指定された最大長まで、コレクションの末尾の要素を含めて返します。
func suffix(from: Index) -> Slice<CollectionDifference<ChangeElement>>
Returns a subsequence from the specified position to the end of the collection. 指定された位置からコレクションの終わりまでの下位シーケンスを返します。
func withContiguousStorageIfAvailable<R>((UnsafeBufferPointer<Change>) -> R) -> R?
Executes a closure on the sequence’s contiguous storage.

Subscripts 添え字

subscript<R>(R) -> Slice<CollectionDifference<ChangeElement>>
Accesses the contiguous subrange of the collection’s elements specified by a range expression. 範囲式によって指定される、コレクションの要素からなる連続した下位範囲にアクセスします。
subscript((UnboundedRange_) -> ()) -> Slice<CollectionDifference<ChangeElement>>
subscript(Range<Index>) -> Slice<CollectionDifference<ChangeElement>>
Accesses a contiguous subrange of the collection’s elements. コレクションのもついくらかの要素からなるある連続した下位範囲にアクセスします。
subscript(CollectionDifference<ChangeElement>.Index) -> CollectionDifference<ChangeElement>.Element
Accesses the element at the specified position. 指定された位置で要素にアクセスします。

Operator Functions 演算子関数

static func != (CollectionDifference<ChangeElement>, CollectionDifference<ChangeElement>) -> Bool
Available when ChangeElement conforms to Equatable. ChangeElementがEquatableに準拠する場合に利用可能です。
static func == (CollectionDifference<ChangeElement>, CollectionDifference<ChangeElement>) -> Bool
Returns a Boolean value indicating whether two values are equal. ２つの値が等しいかどうかを指し示すブール値を返します。
Available when ChangeElement conforms to Equatable. ChangeElementがEquatableに準拠する場合に利用可能です。

Structures 構造体

struct CollectionDifference.Index
The position of a collection difference. あるコレクション差異の位置。

Enumerations 列挙

enum CollectionDifference.Change
A single change to a collection. あるコレクションに対するある単一の変更。

Relationships 関係

Conforms To 次に準拠

  • Collection
  • Decodable
    Conforms when ChangeElement conforms to Decodable and Encodable. ChangeElementがDecodableとEncodableに準拠する時に準拠します。
  • Encodable
    Conforms when ChangeElement conforms to Decodable and Encodable. ChangeElementがDecodableとEncodableに準拠する時に準拠します。
  • Equatable
    Conforms when ChangeElement conforms to Equatable. ChangeElementがEquatableに準拠する時に準拠します。
  • Hashable
    Conforms when ChangeElement conforms to Hashable. ChangeElementがHashableに準拠する時に準拠します。

See Also 参照

Wrappers for Algorithms アルゴリズムに対するラッパー

struct DropFirstSequence
A sequence that lazily consumes and drops n elements from an underlying Base iterator before possibly returning the first available element. おそらくは最初の利用可能な要素が返る前にn個の要素をある基礎をなすBaseイテレータから遅延に消費して落とすあるシーケンス。
struct DropWhileSequence
A sequence that lazily consumes and drops n elements from an underlying Base iterator before possibly returning the first available element. おそらくは最初の利用可能な要素が返る前にn個の要素をある基礎をなすBaseイテレータから遅延に消費して落とすあるシーケンス。
struct EnumeratedSequence
An enumeration of the elements of a sequence or collection. シーケンスまたはコレクションの要素の列挙。
typealias FlattenCollection
struct FlattenSequence
A sequence consisting of all the elements contained in each segment contained in some Base sequence. 何らかのBaseシーケンスに含まれる各断片の中に含まれるいくらかの要素から成るシーケンス。
struct JoinedSequence
A sequence that presents the elements of a base sequence of sequences concatenated using a given separator. あるシーケンス、それはいくらかのシーケンスからなるある基盤となるシーケンスの要素らを、与えられた分離子を使って連結して提示します。
struct PrefixSequence
A sequence that only consumes up to n elements from an underlying Base iterator. 最大でn個の要素まで基礎をなすBaseイテレータからただ消費しきるあるシーケンス。
struct Repeated
A collection whose elements are all identical. あるコレクション、その要素は全て同一です。
struct ReversedCollection
A collection that presents the elements of its base collection in reverse order. あるコレクション、それは、それの基盤コレクションの要素を逆順で提示します。
struct StrideTo
A sequence of values formed by striding over a half-open interval. ある半開間隔の全体をまたぐことで形成されるいくつかの値からなるシーケンス。
struct StrideThrough
A sequence of values formed by striding over a closed interval. ある完結間隔の全体をまたぐことで形成されるいくつかの値からなるシーケンス。
struct UnfoldSequence
A sequence whose elements are produced via repeated applications of a closure to some mutable state. あるクロージャをある何らかの可変の状態へ繰り返し適用することでその要素が生み出されるシーケンス。
struct Zip2Sequence
A sequence of pairs built out of two underlying sequences. ２つの根底にあるシーケンスから組み立てられるペアからなるシーケンス。