Generic Structure

UnsafeBufferPointer

A nonowning collection interface to a buffer of elements stored contiguously in memory. メモリ中に隣接して格納された、いくらかの要素からなるあるバッファに対する非所有コレクションインターフェイス。

Declaration 宣言 

@frozen struct UnsafeBufferPointer<Element>

Overview 概要

You can use an UnsafeBufferPointer instance in low level operations to eliminate uniqueness checks and, in release mode, bounds checks. Bounds checks are always performed in debug mode. あなたは、UnsafeBufferPointerインスタンスを低レベル演算において使うことで、特有性検査をそして、リリースモードでは、境界検査を省くことができます。境界検査は、デバッグモードにおいて常に実行されます。

UnsafeBufferPointer Semantics UnsafeBufferPointer意味論

An UnsafeBufferPointer instance is a view into memory and does not own the memory that it references. Copying a value of type UnsafeBufferPointer does not copy the instances stored in the underlying memory. However, initializing another collection with an UnsafeBufferPointer instance copies the instances out of the referenced memory and into the new collection. UnsafeBufferPointerインスタンスは、メモリに対するあるビューであり、それが参照するメモリ自体ではありません。型UnsafeBufferPointerの値をコピーすることは、基礎をなすメモリをコピーしません。しかしながら、別のコレクションをUnsafeBufferPointerインスタンスで初期化することは、インスタンスを参照されたメモリから外へそして新しいコレクションへとコピーします、

Topics 話題

Type Aliases 型エイリアス

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

Initializers イニシャライザ

init(AudioBuffer)
init(UnsafeMutableBufferPointer<Element>)
Creates an immutable typed buffer pointer referencing the same memory as the given mutable buffer pointer. 不変の型付バッファポインタを作成します、与えられた可変バッファポインタと同じメモリを参照しています。
init(MLMultiArray)
init(rebasing: Slice<UnsafeMutableBufferPointer<Element>>)
Creates a buffer over the same memory as the given buffer slice. 指定されたバッファスライスと同じメモリのすべてを覆うバッファを作成します。
init(rebasing: Slice<UnsafeBufferPointer<Element>>)
Creates a buffer over the same memory as the given buffer slice. 指定されたバッファスライスと同じメモリのすべてを覆うバッファを作成します。
init(start: UnsafePointer<Element>?, count: Int)
Creates a new buffer pointer over the specified number of contiguous instances beginning at the given pointer. 指定されたポインタで始まっている指定された数の隣接インスタンスすべてを覆う新しいバッファポインタを作成します。

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

var baseAddress: UnsafePointer<Element>?
A pointer to the first element of the buffer. このバッファの最初の要素へのポインタ。
let count: Int
The number of elements in the buffer. このバッファの中の要素の数。
var debugDescription: String
A textual representation of the buffer, suitable for debugging. そのバッファのテキスト表現、デバッグに適するもの。
var endIndex: Int
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 indices: UnsafeBufferPointer<Element>.Indices
The indices that are valid for subscripting the collection, in ascending order. コレクションの添え字に使うのに有効である、昇順でのインデックス。
var isEmpty: Bool
A Boolean value indicating whether the collection is empty. コレクションが空かどうかを指し示すブール値。
var last: Element?
The last element of the collection. コレクションの最後の要素。
var lazy: LazySequence<UnsafeBufferPointer<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 regions: CollectionOfOne<UnsafeBufferPointer<UInt8>>
Available when Element is UInt8. ElementがUInt8である時に利用可能です。
var startIndex: Int
The index of the first element in a nonempty buffer. 空でないバッファの中の最初の要素のインデックス。
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 deallocate()
Deallocates the memory block previously allocated at this buffer pointer’s base address. このバッファポインタのもつベースアドレスで以前に割り当てられたメモリブロックを割り当て解除します。
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 distance(from: Int, to: Int) -> Int
Returns the distance between two indices. ２つのインデックス間の隔たりを返します。
func drop(while: (Element) -> Bool) -> Slice<UnsafeBufferPointer<Element>>
Returns a subsequence by skipping elements while predicate returns true and returning the remaining elements. predicateがtrueを返す間は要素を飛ばして残りの要素を返すことによって、ある下位シーケンスを返します。
func dropFirst(Int) -> Slice<UnsafeBufferPointer<Element>>
Returns a subsequence containing all but the given number of initial elements. 指定された数の冒頭要素以外すべてを含んでいる下位シーケンスを返します。
func dropLast(Int) -> Slice<UnsafeBufferPointer<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<UnsafeBufferPointer<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) -> Int
Returns an index that is the specified distance from the given index. 与えられたインデックスから指定された隔たりのインデックスを返します。
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: Int) -> Int
Returns the position immediately after the given index. 与えられたインデックスの直後の位置を返します。
func index(before: Int) -> Int
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<UnsafeBufferPointer<Element>>
Returns the elements of this sequence of sequences, concatenated. このシーケンスに属する複数のシーケンスの要素を、鎖状に連結して返します。
Available when Element conforms to Sequence. ElementがSequenceに準拠する時に利用可能です。
func joined<Separator>(separator: Separator) -> JoinedSequence<UnsafeBufferPointer<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() -> UnsafeBufferPointer<Element>.Iterator
Returns an iterator over the elements of this buffer. このバッファの要素すべてを対象としたイテレータを返します。
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 prefix(Int) -> Slice<UnsafeBufferPointer<Element>>
Returns a subsequence, up to the specified maximum length, containing the initial elements of the collection. 下位シーケンスを、指定された最大長まで、コレクションの冒頭の要素を含めて返します。
func prefix(through: Int) -> Slice<UnsafeBufferPointer<Element>>
Returns a subsequence from the start of the collection through the specified position. コレクションの始まりから指定された位置までも含む下位シーケンスを返します。
func prefix(upTo: Int) -> Slice<UnsafeBufferPointer<Element>>
Returns a subsequence from the start of the collection up to, but not including, the specified position. コレクションの始まりから指定された位置まで、しかしそれは含めない下位シーケンスを返します。
func prefix(while: (Element) -> Bool) -> Slice<UnsafeBufferPointer<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 reversed() -> ReversedCollection<UnsafeBufferPointer<Element>>
Returns a view presenting the elements of the collection in reverse order. コレクションの要素を逆順に表しているある見方を返します。
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 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<UnsafeBufferPointer<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<UnsafeBufferPointer<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<UnsafeBufferPointer<Element>>
Returns a subsequence, up to the given maximum length, containing the final elements of the collection. 下位シーケンスを、指定された最大長まで、コレクションの末尾の要素を含めて返します。
func suffix(from: Int) -> Slice<UnsafeBufferPointer<Element>>
Returns a subsequence from the specified position to the end of the collection. 指定された位置からコレクションの終わりまでの下位シーケンスを返します。
func withContiguousStorageIfAvailable<R>((UnsafeBufferPointer<Element>) -> R) -> R?
Executes a closure on the sequence’s contiguous storage.
func withMemoryRebound<T, Result>(to: T.Type, (UnsafeBufferPointer<T>) -> Result) -> Result
Executes the given closure while temporarily binding the memory referenced by this buffer to the given type. 与えられたクロージャを実行します、その間はこのバッファによって参照されるメモリを与えられた型に一時的に束縛しています。
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<UnsafeBufferPointer<Element>>
Accesses the contiguous subrange of the collection’s elements specified by a range expression. 範囲式によって指定される、コレクションの要素からなる連続した下位範囲にアクセスします。
subscript((UnboundedRange_) -> ()) -> Slice<UnsafeBufferPointer<Element>>
subscript(Range<Int>) -> Slice<UnsafeBufferPointer<Element>>
Accesses a contiguous subrange of the buffer’s elements. バッファの持つ要素の隣接下位範囲にアクセスします。

Structures 構造体

struct UnsafeBufferPointer.Iterator
An iterator for the elements in the buffer referenced by an UnsafeBufferPointer or UnsafeMutableBufferPointer instance. UnsafeBufferPointerまたはUnsafeMutableBufferPointerによって参照されるバッファの中の要素のためのイテレータ。

Relationships 関係

Conforms To 次に準拠

See Also 参照

Typed Pointers 型付ポインタ

struct UnsafePointer
A pointer for accessing data of a specific type. ある特定の型の日付にアクセスするためのボインタ。
struct UnsafeMutablePointer
A pointer for accessing and manipulating data of a specific type. ある特定の型のデータにアクセスおよび操作するためのポインタ。
struct UnsafeMutableBufferPointer
A nonowning collection interface to a buffer of mutable elements stored contiguously in memory. メモリ中に隣接して格納された、いくらかの可変の要素からなるあるバッファに対する非所有コレクションインターフェイス。