Generic Function

withUnsafeBytes(of:_:)

Invokes the given closure with a buffer pointer covering the raw bytes of the given argument. 与えられたクロージャを、与えられた引数の生のバイトを変換しているバッファポインタとともに発動します。

Declaration 宣言 

func withUnsafeBytes<T, Result>(of value: T, _ body: (UnsafeRawBufferPointer) throws -> Result) rethrows -> Result

Parameters パラメータ

value

An instance to temporarily access through a raw buffer pointer. 生のバッファポインタを通して一時的にアクセスされることになるインスタンス。

body

A closure that takes a raw buffer pointer to the bytes of value as its sole argument. If the closure has a return value, that value is also used as the return value of the withUnsafeBytes(of:_:) function. The buffer pointer argument is valid only for the duration of the closure’s execution. It is undefined behavior to attempt to mutate through the pointer by conversion to UnsafeMutableRawBufferPointer or any other mutable pointer type. If you want to mutate a value by writing through a pointer, use withUnsafeMutableBytes(of:_:) instead. valueのバイトへの生のバッファポインタをそれの唯一の引数として取るクロージャ。クロージャが戻り値を持つならば、その値はまたwithUnsafeBytes(of:_:)関数の戻り値としても使われます。バッファポインタは、ただクロージャの実行の間に対してのみ有効とされます。ポインタを通してUnsafeMutableRawBufferPointerまたは何か他の可変ポインタ型への変換によって変化させようと試みることは、未定義挙動です。あなたがある値をポインタを通して書き込むことで変化させたいならば、withUnsafeMutableBytes(of:_:)を代わりに使ってください。

Return Value 戻り値

The return value, if any, of the body closure. bodyクロージャの、もしあれば、戻り値。

Discussion 解説

The buffer pointer argument to the body closure provides a collection interface to the raw bytes of value. The buffer is the size of the instance passed as value and does not include any remote storage. bodyクロージャへのバッファポインタ引数は、valueの生のバイトへのコレクションインターフェイスを提供します。バッファは、valueとして渡されるインスタンスの大きさで、あらゆるリモートストレージを含みません。

See Also 参照

Memory Access メモリアクセス

func withUnsafePointer<T, Result>(to: T, (UnsafePointer<T>) -> Result) -> Result
Invokes the given closure with a pointer to the given argument. 与えられたクロージャを、与えられた引数に対するポインタとともに発動します。
func withUnsafePointer<T, Result>(to: inout T, (UnsafePointer<T>) -> Result) -> Result
Invokes the given closure with a pointer to the given argument. 与えられたクロージャを、与えられた引数に対するポインタとともに発動します。
func withUnsafeMutablePointer<T, Result>(to: inout T, (UnsafeMutablePointer<T>) -> Result) -> Result
Calls the given closure with a mutable pointer to the given argument. 与えられたクロージャを与えられた引数に対する可変ポインタを使って呼び出します。
func withUnsafeBytes<T, Result>(of: inout T, (UnsafeRawBufferPointer) -> Result) -> Result
Invokes the given closure with a buffer pointer covering the raw bytes of the given argument. 与えられたクロージャを、与えられた引数の生のバイトを変換しているバッファポインタとともに発動します。
func withUnsafeMutableBytes<T, Result>(of: inout T, (UnsafeMutableRawBufferPointer) -> Result) -> Result
Invokes the given closure with a mutable buffer pointer covering the raw bytes of the given argument. 与えられたクロージャを、与えられた引数の生のバイトを変換している可変バッファポインタとともに発動します。
func swap<T>(inout T, inout T)
Exchanges the values of the two arguments. ２つの引数の値を交換します。