The type to bind this memory to. このメモリに束縛することになる型。
Generic Instance Method
総称体インスタンスメソッド
initialize
initializeMemory(as:from:count:)
Initializes the memory referenced by this pointer with the values starting at the given pointer, binds the memory to the values’ type, and returns a typed pointer to the initialized memory.
このポインタによって参照されるメモリを与えられたポインタで始まる値で初期化して、そのメモリを値の型に束縛し、そして初期化されたメモリへの型付ポインタを返します。
Availability
- iOS 8.0+
- iPadOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 8.0+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
@discardableResult func initializeMemory<T>(as type: T.Type, from source: UnsafePointer <T>, count: Int) -> UnsafeMutablePointer <T>Parameters パラメータ
typesourceA pointer to the values to copy. The memory in the region
source..<(source + count)must be initialized to typeTand must not overlap the destination region. コピーされる値に対するポインタ。領域source..<(source + count)の中のメモリは、型Tに初期化されなければなりません、そして行き先の領域と重なってはいけません。countThe number of copies of
valueto copy into memory.countmust not be negative. メモリにコピーすることになるvalueのコピー数。countは負数であってはいけません。
Return Value 戻り値
A typed pointer to the memory referenced by this raw pointer. この生のポインタによって参照されるメモリへの型付ポインタ。
Discussion 解説
The memory referenced by this pointer must be uninitialized or initialized to a trivial type, and must be properly aligned for accessing T.
このポインタによって参照されるメモリは、未初期化状態にされるまたは自明型に初期化されなければなりません、そしてTにアクセスするために適切にアラインされなければなりません。
The following example allocates enough raw memory to hold four instances of Int8, and then uses the initialize method to initialize the allocated memory.
以下の例は、生のメモリを必要なだけアロケートすることで、４つのInt8インスタンスを保持して、それからinitializeメソッドを使ってアロケートされたメモリを初期化します。
let count = 4
let bytesPointer = UnsafeMutableRawPointer.allocate(
byteCount: count * MemoryLayout<Int8>.stride,
alignment: MemoryLayout<Int8>.alignment)
let values: [Int8] = [1, 2, 3, 4]
let int8Pointer = values.withUnsafeBufferPointer { buffer in
return bytesPointer.initializeMemory(as: Int8.self,
from: buffer.baseAddress!,
count: buffer.count)
}
// int8Pointer.pointee == 1
// (int8Pointer + 3).pointee == 4
// After using 'int8Pointer':
int8Pointer.deallocate()After calling this method on a raw pointer p, the region starting at p and continuing up to p + count * Memory is bound to type T and initialized. If T is a nontrivial type, you must eventually deinitialize or move from the values in this region to avoid leaks. The instances in the region source..<(source + count) are unaffected.
このメソッドを生のポインタp上で呼び出した後、pで始まってp + count * Memoryまで続く領域は、型Tに束縛されて初期化されます。Tが非自明型ならば、あなたはゆくゆくはデイニシャライズするかまたはこの領域の値から移動してリークを防がなければなりません。領域source..<(source + count)の中のインスタンスは、影響を受けません。