Generic Structure

CollectionOfOne

A collection containing a single element. 単一の要素を含んでいるコレクション。

Declaration 宣言 

@frozen struct CollectionOfOne<Element>

Overview 概要

You can use a CollectionOfOne instance when you need to efficiently represent a single value as a collection. For example, you can add a single element to an array by using a CollectionOfOne instance with the concatenation operator (+): あなたは、CollectionOfOneインスタンスを、あなたが単一の値をコレクションとして効率的に表す必要がある場合に使えます。例えば、あなたは単一の要素を配列へと追加することが、CollectionOfOneインスタンスを連結演算子（+）とともに使うことによって可能です： 


let a = [1, 2, 3, 4]
let toAdd = 100
let b = a + CollectionOfOne(toAdd)
// b == [1, 2, 3, 4, 100]

Topics 話題

Type Aliases 型エイリアス

typealias CollectionOfOne.SubSequence
A collection representing a contiguous subrange of this collection’s elements. The subsequence shares indices with the original collection.
typealias CollectionOfOne.Index
A type that represents a position in the collection. コレクションの中のある位置を表す型。
typealias CollectionOfOne.Indices
A type that represents the indices that are valid for subscripting the collection, in ascending order. 昇順での、コレクションの添え字として有効なインデックスを表す型。

Initializers イニシャライザ

init(Element)
Creates an instance containing just the given element. 与えられた要素だけを含んでいるインスタンスを作成します。

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

var count: Int
The number of elements in the collection, which is always one. コレクションの中の要素数、それは常に１つです。
var customMirror: Mirror
The custom mirror for this instance. このインスタンスのためのあつらえのミラー。
var debugDescription: String
A textual representation of the collection, suitable for debugging. コレクションのテキスト表現、デバッグに適するもの。
var endIndex: CollectionOfOne<Element>.Index
The “past the end” position—that is, the position one greater than the last valid subscript argument. 「終わりを過ぎた」位置—すなわち、最後の有効な添え字引数より１つ大きい位置。
var first: Element?
The first element of the collection. コレクションの最初の要素。
var isEmpty: Bool
A Boolean value indicating whether the collection is empty. コレクションが空かどうかを指し示すブール値。
var last: Element?
The last element of the collection. コレクションの最後の要素。
var lazy: LazySequence<CollectionOfOne<Element>>
A sequence containing the same elements as this sequence, but on which some operations, such as map and filter, are implemented lazily. このシーケンスと同じ要素を含んでいるシーケンス、しかしそれの上で何らかの演算、例えばmapやfilterが遅延に実装されます。
var startIndex: CollectionOfOne<Element>.Index
The position of the first element. 最初の要素の位置。
var underestimatedCount: Int
A value less than or equal to the number of elements in the collection. このコレクションの中の要素の数より少ないか等しい値。

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

func allSatisfy((Element) -> Bool) -> Bool
Returns a Boolean value indicating whether every element of a sequence satisfies a given predicate. シーケンスのすべての要素がある与えられた述部を満たすかどうかを指し示すブール値を返します。
func compactMap<ElementOfResult>((Element) -> ElementOfResult?) -> [ElementOfResult]
Returns an array containing the non-nil results of calling the given transformation with each element of this sequence. 指定された変換をこのシーケンスの各要素で呼び出す結果で非-nilのものを含んでいる配列を返します。
func contains(Element) -> Bool
Returns a Boolean value indicating whether the sequence contains the given element. 指定された要素をシーケンスが含むかどうかを指し示すブール値を返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
func contains(where: (Element) -> Bool) -> Bool
Returns a Boolean value indicating whether the sequence contains an element that satisfies the given predicate. 指定された述部を満足させるある要素をシーケンスが含むかどうかを指し示すブール値を返します。
func difference<C>(from: C) -> CollectionDifference<Element>
Returns the difference needed to produce this collection’s ordered elements from the given collection. このコレクションのもつ順番付けられた要素をこの与えられたコレクションから生成するのに必要とされる差異を返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
func difference<C>(from: C, by: (C.Element, Element) -> Bool) -> CollectionDifference<Element>
Returns the difference needed to produce this collection’s ordered elements from the given collection, using the given predicate as an equivalence test. このコレクションのもつ順番付けられた要素をこの与えられたコレクションから生成するのに必要とされる差異を返します、与えられた述部を同等性テストとして使います。
func drop(while: (Element) -> Bool) -> Slice<CollectionOfOne<Element>>
Returns a subsequence by skipping elements while predicate returns true and returning the remaining elements. predicateがtrueを返す間は要素を飛ばして残りの要素を返すことによって、ある下位シーケンスを返します。
func dropFirst(Int) -> Slice<CollectionOfOne<Element>>
Returns a subsequence containing all but the given number of initial elements. 指定された数の冒頭要素以外すべてを含んでいる下位シーケンスを返します。
func dropLast(Int) -> Slice<CollectionOfOne<Element>>
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. このシーケンスともう一方のシーケンスが同じ要素を同じ順序で含むかどうかを指し示すブール値を返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
func elementsEqual<OtherSequence>(OtherSequence, by: (Element, 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 enumerated() -> EnumeratedSequence<CollectionOfOne<Element>>
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((Element) -> Bool) -> [Element]
Returns an array containing, in order, the elements of the sequence that satisfy the given predicate. 指定された述部を満足させるものであるシーケンスの要素を、順序通りに、含んでいる配列を返します。
func first(where: (Element) -> Bool) -> Element?
Returns the first element of the sequence that satisfies the given predicate. 与えられた述部を満たすこのシーケンスの最初の要素を返します。
func firstIndex(of: Element) -> Int?
Returns the first index where the specified value appears in the collection. 指定された値がコレクションにおいて現れるところの最初のインデックスを返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
func firstIndex(where: (Element) -> Bool) -> Int?
Returns the first index in which an element of the collection satisfies the given predicate. 最初のインデックスで、それにおけるコレクションの要素が与えられた述部を満足させるものを返します。
func flatMap<SegmentOfResult>((Element) -> SegmentOfResult) -> [SegmentOfResult.Element]
Returns an array containing the concatenated results of calling the given transformation with each element of this sequence. 指定された変換をこのシーケンスの各要素で呼び出す結果を連結したものを含んでいる配列を返します。
func flatMap<ElementOfResult>((Element) -> ElementOfResult?) -> [ElementOfResult]Deprecated 非推奨
func forEach((Element) -> 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 Int, offsetBy: Int)
Offsets the given index by the specified distance. 与えられたインデックスを指定された間隔で補います。
func formIndex(inout Int, offsetBy: Int, limitedBy: Int) -> Bool
Offsets the given index by the specified distance, or so that it equals the given limiting index. 与えられたインデックスをこの指定された隔たりで補います、またはそれでそれは与えられた限界インデックスと等しくなります。
func formIndex(after: inout Int)
Replaces the given index with its successor. 与えられたインデックスをそれの後に続くものと取り替えます。
func formIndex(before: inout Int)
Replaces the given index with its predecessor. 与えられたインデックスをそれの前のものと取り替えます。
func index(Int, offsetBy: Int, limitedBy: Int) -> Int?
Returns an index that is the specified distance from the given index, unless that distance is beyond a given limiting index. 与えられたインデックスから指定された隔たりのインデックスを返します、その隔たりが与えられた限界インデックスを越えない限りは。
func index(after: CollectionOfOne<Element>.Index) -> CollectionOfOne<Element>.Index
Returns the position immediately after the given index. 与えられたインデックスの直後の位置を返します。
func index(before: CollectionOfOne<Element>.Index) -> CollectionOfOne<Element>.Index
Returns the position immediately before the given index. 与えられたインデックスの直前の位置を返します。
func index(of: Element) -> Int?
Returns the first index where the specified value appears in the collection. 指定された値がコレクションにおいて現れるところの最初のインデックスを返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
Deprecated 非推奨
func joined() -> FlattenSequence<CollectionOfOne<Element>>
Returns the elements of this sequence of sequences, concatenated. このシーケンスに属する複数のシーケンスの要素を、鎖状に連結して返します。
Available when Element conforms to Sequence. ElementがSequenceに準拠する時に利用可能です。
func joined<Separator>(separator: Separator) -> JoinedSequence<CollectionOfOne<Element>>
Returns the concatenated elements of this sequence of sequences, inserting the given separator between each element. 各要素の間に与えられた分離子を挿入して、このシーケンスに属する複数のシーケンスの要素を鎖状に連結して返します。
Available when Element conforms to Sequence. ElementがSequenceに準拠する時に利用可能です。
func joined(separator: String) -> String
Returns a new string by concatenating the elements of the sequence, adding the given separator between each element. 各要素の間に与えられた分離子を加えて、シーケンスの要素を連結することによる新しい文字列を返します。
Available when Element is String. ElementがStringである時に利用可能です。
func joined(separator: String) -> String
Returns a new string by concatenating the elements of the sequence, adding the given separator between each element. 各要素の間に与えられた分離子を加えて、シーケンスの要素を連結することによる新しい文字列を返します。
Available when Element conforms to StringProtocol. ElementがStringProtocolに準拠する時に利用可能です。
func last(where: (Element) -> Bool) -> Element?
Returns the last element of the sequence that satisfies the given predicate. 与えられた述部を満たす、シーケンスの最後の要素を返します。
func lastIndex(of: Element) -> Int?
Returns the last index where the specified value appears in the collection. 指定された値がコレクションにおいて現れるところの最後のインデックスを返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
func lastIndex(where: (Element) -> Bool) -> Int?
Returns the index of the last element in the collection that matches the given predicate. 与えられた述部に合致する、コレクションの中の最後の要素のインデックスを返します。
func lexicographicallyPrecedes<OtherSequence>(OtherSequence) -> Bool
Returns a Boolean value indicating whether the sequence precedes another sequence in a lexicographical (dictionary) ordering, using the less-than operator (<) to compare elements. そのシーケンスが別のシーケンスの前に来るかどうかを、ある語彙筆記的順序（字典）順序において、より小さい演算子（<）を使って要素を比較して、指し示すブール値を返します。
Available when Element conforms to Comparable. ElementがComparableに準拠する時に利用可能です。
func lexicographicallyPrecedes<OtherSequence>(OtherSequence, by: (Element, Element) -> 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() -> CollectionOfOne<Element>.Iterator
Returns an iterator over the elements of this collection. このコレクションの要素すべてを対象としたイテレータを返します。
func map<T>((Element) -> T) -> [T]
Returns an array containing the results of mapping the given closure over the sequence’s elements. 与えられたクロージャをシーケンスのもつ要素全体にわたってマップする結果を含んでいる配列を返します。
func max() -> Element?
Returns the maximum element in the sequence. シーケンスの中の最大の要素を返します。
Available when Element conforms to Comparable. ElementがComparableに準拠する時に利用可能です。
func max(by: (Element, Element) -> Bool) -> Element?
Returns the maximum element in the sequence, using the given predicate as the comparison between elements. シーケンスの中の最大の要素を返します、与えられた述部を要素間の比較として使います。
func min() -> Element?
Returns the minimum element in the sequence. シーケンスの中の最小の要素を返します。
Available when Element conforms to Comparable. ElementがComparableに準拠する時に利用可能です。
func min(by: (Element, Element) -> Bool) -> Element?
Returns the minimum element in the sequence, using the given predicate as the comparison between elements. シーケンスの中の最小の要素を返します、与えられた述部を要素間の比較として使います。
func partition(by: (Element) -> Bool) -> Int
Reorders the elements of the collection such that all the elements that match the given predicate are after all the elements that don’t match. コレクションの要素を再配列します、例えば、与えられた述部にマッチする要素すべてが、合致しない要素すべての後になるなど。
func prefix(Int) -> Slice<CollectionOfOne<Element>>
Returns a subsequence, up to the specified maximum length, containing the initial elements of the collection. 下位シーケンスを、指定された最大長まで、コレクションの冒頭の要素を含めて返します。
func prefix(through: Int) -> Slice<CollectionOfOne<Element>>
Returns a subsequence from the start of the collection through the specified position. コレクションの始まりから指定された位置までも含む下位シーケンスを返します。
func prefix(upTo: Int) -> Slice<CollectionOfOne<Element>>
Returns a subsequence from the start of the collection up to, but not including, the specified position. コレクションの始まりから指定された位置まで、しかしそれは含めない下位シーケンスを返します。
func prefix(while: (Element) -> Bool) -> Slice<CollectionOfOne<Element>>
Returns a subsequence containing the initial elements until predicate returns false and skipping the remaining elements. predicateがfalseを返すまで冒頭の要素を含んでいて残りの要素を飛ばしている、ある下位シーケンスを返します。
func randomElement() -> Element?
Returns a random element of the collection. コレクションのある無作為の要素を返します。
func randomElement<T>(using: inout T) -> Element?
Returns a random element of the collection, using the given generator as a source for randomness. コレクションのある無作為な要素を返します、与えられた生成子を無作為さの出典として使って使います。
func reduce<Result>(Result, (Result, Element) -> Result) -> Result
Returns the result of combining the elements of the sequence using the given closure. 与えられたクロージャを使って、このシーケンスの要素それらを結合する結果を返します。
func reduce<Result>(into: Result, (inout Result, Element) -> ()) -> Result
Returns the result of combining the elements of the sequence using the given closure. 与えられたクロージャを使って、このシーケンスの要素それらを結合する結果を返します。
func reverse()
Reverses the elements of the collection in place. コレクションの要素をその場で逆順にします。
func reversed() -> ReversedCollection<CollectionOfOne<Element>>
Returns a view presenting the elements of the collection in reverse order. コレクションの要素を逆順に表しているある見方を返します。
func shuffle()
Shuffles the collection in place. コレクションをその場で混ぜ合わせます。
func shuffle<T>(using: inout T)
Shuffles the collection in place, using the given generator as a source for randomness. コレクションをその場で混ぜ合わせます、与えられた生成子を無作為さの出典として使います。
func shuffled() -> [Element]
Returns the elements of the sequence, shuffled. 入れ替えた、シーケンスの要素を返します。
func shuffled<T>(using: inout T) -> [Element]
Returns the elements of the sequence, shuffled using the given generator as a source for randomness. シーケンスの要素を返します、与えられた生成子を無作為さの出典として使って混ぜ合わされます。
func sort()
Sorts the collection in place. コレクションをその場でソートします。
Available when Element conforms to Comparable. ElementがComparableに準拠する時に利用可能です。
func sort(by: (Element, Element) -> Bool)
Sorts the collection in place, using the given predicate as the comparison between elements. コレクションをその場でソートします、与えられた述部を要素間の比較として使います。
func sorted() -> [Element]
Returns the elements of the sequence, sorted. シーケンスに属する要素を、ソートして返します。
Available when Element conforms to Comparable. ElementがComparableに準拠する時に利用可能です。
func sorted(by: (Element, Element) -> Bool) -> [Element]
Returns the elements of the sequence, sorted using the given predicate as the comparison between elements. 与えられた述部を要素間の比較として使ってソートされた、シーケンスの要素を返します。
func split(maxSplits: Int, omittingEmptySubsequences: Bool, whereSeparator: (Element) -> Bool) -> [Slice<CollectionOfOne<Element>>]
Returns the longest possible subsequences of the collection, in order, that don’t contain elements satisfying the given predicate. 与えられた述部を満たす要素を含んでいない、このコレクションの最も長くなりうる下位シーケンスそれらを順序どおりに返します。
func split(separator: Element, maxSplits: Int, omittingEmptySubsequences: Bool) -> [Slice<CollectionOfOne<Element>>]
Returns the longest possible subsequences of the collection, in order, around elements equal to the given element. 与えられた要素と等しい要素を避けるようにして、このコレクションの最も長くなりうる下位シーケンスを、順番に返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
func split(separator: Element, maxSplits: Int, omittingEmptySubsequences: Bool) -> [ArraySlice<Element>]
Returns the longest possible subsequences of the sequence, in order, around elements equal to the given element. 与えられた要素と等しい要素を避けるようにして、このシーケンスの最も長くなりうる下位シーケンスを、順番に返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
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. シーケンスの最初の要素らが別のシーケンスの中の要素らと同じかどうかを指し示すブール値を返します。
Available when Element conforms to Equatable. ElementがEquatableに準拠する時に利用可能です。
func starts<PossiblePrefix>(with: PossiblePrefix, by: (Element, 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<CollectionOfOne<Element>>
Returns a subsequence, up to the given maximum length, containing the final elements of the collection. 下位シーケンスを、指定された最大長まで、コレクションの末尾の要素を含めて返します。
func suffix(from: Int) -> Slice<CollectionOfOne<Element>>
Returns a subsequence from the specified position to the end of the collection. 指定された位置からコレクションの終わりまでの下位シーケンスを返します。
func swapAt(Int, Int)
Exchanges the values at the specified indices of the collection. そのコレクションの指定インデックスでの値を交換します。
func withContiguousMutableStorageIfAvailable<R>((inout UnsafeMutableBufferPointer<Element>) -> R) -> R?
Executes a closure on the collection’s contiguous storage.
func withContiguousStorageIfAvailable<R>((UnsafeBufferPointer<Element>) -> R) -> R?
Executes a closure on the sequence’s contiguous storage.
func withUnsafeBytes<R>((UnsafeRawBufferPointer) -> R) -> R
Available when Element is UInt8. ElementがUInt8である時に利用可能です。

Subscripts 添え字

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

Structures 構造体

struct CollectionOfOne.Iterator
An iterator that produces one or zero instances of an element. ある要素のインスタンスを１つまたは０個生み出すイテレータ。

Relationships 関係

Conforms To 次に準拠

See Also 参照

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

func repeatElement<T>(T, count: Int) -> Repeated<T>
Creates a collection containing the specified number of the given element. 指定された数の与えられた要素を含んでいるコレクションを作成します。
struct EmptyCollection
A collection whose element type is Element but that is always empty. それの要素型はElementである、しかし常に空であるコレクション。
struct KeyValuePairs
A lightweight collection of key-value pairs. キー値ペアの軽量コレクション。
typealias DictionaryLiteralDeprecated 非推奨