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

initialize(from:)

Initializes the buffer’s memory with the given elements. 与えられたいくらかの要素を使ってバッファの持つメモリを初期化します。

Declaration 宣言

func initialize<S>(from source: S) -> (S.Iterator, UnsafeMutableBufferPointer<Element>.Index) where Element == S.Element, S : Sequence

Parameters パラメータ

source

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

Return Value 戻り値

An iterator to any elements of source that didn’t fit in the buffer, and an index to the point in the buffer one past the last element written. sourceの何らかの要素で、バッファの中にぴったり合わないものに対するイテレータ、そして書かれた最後の要素を1つすぎたバッファの中の地点に対するインデックス。

Discussion 解説

When calling the initialize(from:) method on a buffer b, the memory referenced by b must be uninitialized or the Element type must be a trivial type. After the call, the memory referenced by this buffer up to, but not including, the returned index is initialized. The buffer must contain sufficient memory to accommodate source.underestimatedCount. initialize(from:)メソッドをバッファb上で呼び出す場合、bによって参照されるメモリは未初期化でなければなりません、またはElement型が自明型でなければなりません。この呼び出しの後、返されるインデックスまでの、しかしそれを含んでいない、このバッファによって参照されるメモリは、初期化されます。バッファは、source.underestimatedCountを収容するのに十分なメモリを含んでいなければなりません。

The returned index is the position of the element in the buffer one past the last element written. If source contains no elements, the returned index is equal to the buffer’s startIndex. If source contains an equal or greater number of elements than the buffer can hold, the returned index is equal to the buffer’s endIndex. 返されるインデックスは、書かれた最後の要素を1つすぎたバッファの中の要素の位置です。sourceが全く要素を含まないならば、返されるインデックスはバッファの持つstartIndexと等しいです。sourceがバッファが保持できるのと同じまたはより多い数の要素を含むならば、返されるインデックスはバッファの持つendIndexと等しいです。