Generic Instance Method 総称体インスタンスメソッド

initializeMemory(as:from:)

Initializes the buffer’s memory with the given elements, binding the initialized memory to the elements’ type. バッファのもつメモリを与えられた要素で初期化します、初期化されたメモリを要素のもつ型に束縛します。

Declaration 宣言

func initializeMemory<S>(as type: S.Element.Type, from source: S) -> (unwritten: S.Iterator, initialized: UnsafeMutableBufferPointer<S.Element>) where S : Sequence

Parameters パラメータ

type

The type of the elements to bind the buffer’s memory to. バッファのもつメモリをそれへと束縛する幾らかの要素の型。

source

A sequence of elements with which to initialize the buffer. 幾らかの要素からなるシーケンス、それに対してバッファを初期化します。

Return Value 戻り値

An iterator to any elements of source that didn’t fit in the buffer, and a typed buffer of the written elements. The returned buffer references memory starting at the same base address as this buffer. バッファに収まらないsourceの何らかの要素に対するイテレータ、そして書き出される要素の型付バッファ。返されるバッファは、このバッファと同じ基底アドレスで始まるメモリを参照します。

Discussion 解説

When calling the initializeMemory(as:from:) method on a buffer b, the memory referenced by b must be uninitialized or initialized to a trivial type, and must be properly aligned for accessing S.Element. The buffer must contain sufficient memory to accommodate source.underestimatedCount. initializeMemory(as:from:)メソッドをバッファb上で呼び出す場合、bによって参照されるメモリは未初期化であるか自明型に初期化される必要があります、そしてS.Elementにアクセスするために適切にアラインされなければなりません。バッファは、source.underestimatedCountを収容するのに十分なメモリを含んでいなければなりません。

This method initializes the buffer with elements from source until source is exhausted or, if source is a sequence but not a collection, the buffer has no more room for its elements. After calling initializeMemory(as:from:), the memory referenced by the returned UnsafeMutableBufferPointer instance is bound and initialized to type S.Element. このメソッドはsourceからの要素でバッファを初期化します、sourceが使い尽くされるまでまたは、sourceがシーケンスであるがコレクションではないならば、バッファがこれ以上それの要素のための部屋を持たなくなるまで。initializeMemory(as:from:)呼び出しの後、UnsafeMutableBufferPointerインスタンスによって参照されるメモリは、型S.Elementに束縛され初期化されます。