Generic Structure

ManagedBufferPointer

Contains a buffer object, and provides access to an instance of Header and contiguous storage for an arbitrary number of Element instances stored in that buffer. バッファオブジェクトを収容します、そしてHeaderのインスタンスへのアクセスおよびそのバッファに格納される随意の数のElementインスタンスの隣接保管を提供します。

Declaration 宣言 

@frozen struct ManagedBufferPointer<Header, Element>

Overview 概要

For most purposes, the ManagedBuffer class can be used on its own. However, in cases where objects of various different classes must serve as storage, you need to also use ManagedBufferPointer.

A valid buffer class is non-@objc, with no declared stored properties. Its deinit must destroy its stored Header and any constructed Elements. 有効なバッファクラスは、非@objcで、宣言された保存プロパティを持ちません。それのdeinitは、それの格納されたHeaderとあらゆる構成されたElementを破棄しなければなりません。

Example Buffer Class バッファクラスの例 


 class MyBuffer<Element> { // non-@objc
   typealias Manager = ManagedBufferPointer<(Int, String), Element>
   deinit {
     Manager(unsafeBufferObject: self).withUnsafeMutablePointers {
       (pointerToHeader, pointerToElements) -> Void in
       pointerToElements.deinitialize(count: self.count)
       pointerToHeader.deinitialize(count: 1)
     }
   }


   // All properties are *computed* based on members of the Header
   var count: Int {
     return Manager(unsafeBufferObject: self).header.0
   }
   var name: String {
     return Manager(unsafeBufferObject: self).header.1
   }
 }

Topics 話題

Creating a Buffer バッファの作成

init(bufferClass: AnyClass, minimumCapacity: Int, makingHeaderWith: (AnyObject, (AnyObject) -> Int) -> Header)
Create with new storage containing an initial Header and space for at least minimumCapacity elements. ある初期Headerと少なくともminimumCapacity elementに対する空間を格納している新しいストレージを使って作成します。
init(unsafeBufferObject: AnyObject)
Manage the given buffer. 指定されたbufferを管理します。

Inspecting a Buffer バッファを調査する

var capacity: Int
The actual number of elements that can be stored in this object. このオブジェクトに格納できる要素の実際の数。
var header: Header
The stored Header instance. 格納されたHeaderインスタンス。
var buffer: AnyObject
Returns the object instance being used for storage. ストレージのために使われているオブジェクトインスタンスを返します。
func isUniqueReference() -> Bool
Returns true if self holds the only strong reference to its buffer; otherwise, returns false. trueを返します、もしselfがそれのバッファに対する強い参照のみを保持するならば；そうでなければ、falseを返します。

Accessing Buffer Contents バッファ内容にアクセスする

func withUnsafeMutablePointerToElements<R>((UnsafeMutablePointer<Element>) -> R) -> R
Call body with an UnsafeMutablePointer to the Element storage. ElementストレージへのUnsafeMutablePointerを使ってbodyを呼び出します。
func withUnsafeMutablePointerToHeader<R>((UnsafeMutablePointer<Header>) -> R) -> R
Call body with an UnsafeMutablePointer to the stored Header. この格納HeaderへのUnsafeMutablePointerを使ってbodyを呼び出します。
func withUnsafeMutablePointers<R>((UnsafeMutablePointer<Header>, UnsafeMutablePointer<Element>) -> R) -> R
Call body with UnsafeMutablePointers to the stored Header and raw Element storage. 格納HeaderおよびElement生ストレージそれぞれへのUnsafeMutablePointerを使ってbodyを呼び出します。

Comparing Buffers バッファの比較

static func != (ManagedBufferPointer<Header, Element>, ManagedBufferPointer<Header, Element>) -> Bool
Returns a Boolean value indicating whether two values are not equal. ２つの値が等しくないかどうかを指し示すブール値を返します。

Operator Functions 演算子関数

static func == (ManagedBufferPointer<Header, Element>, ManagedBufferPointer<Header, Element>) -> Bool
Returns a Boolean value indicating whether two values are equal. ２つの値が等しいかどうかを指し示すブール値を返します。

Relationships 関係

Conforms To 次に準拠

See Also 参照

Buffer Implementation Buffer 実装

class ManagedBuffer
A class whose instances contain a property of type Header and raw storage for an array of Element, whose size is determined at instance creation. あるクラス、そのインスタンスは型Headerのプロパティと、そのサイズがインスタンス作成時に決められる、Element配列の生のストレージを含みます。