Swift Array withUnsafeMutableBytes(_:)用法及代碼示例

實例方法

withUnsafeMutableBytes(_:)

使用指向數組可變連續存儲的底層字節的指針調用給定的閉包。

聲明

mutating func withUnsafeMutableBytes<R>(_ body: (UnsafeMutableRawBufferPointer) throws -> R) rethrows -> R

返回值

body 閉包參數的返回值(如果有)。

參數

body: 帶有 UnsafeMutableRawBufferPointer 參數的閉包，該參數指向數組的連續存儲。如果不存在這樣的存儲，則創建它。如果body 有返回值，則該值也用作withUnsafeMutableBytes(_:) 方法的返回值。該參數僅在閉包執行期間有效。

詳述

數組的 Element 類型必須是 trivial type ，隻需 bit-for-bit 副本即可複製，無需任何間接或引用計數操作。通常，不包含強引用或弱引用的原生 Swift 類型是微不足道的，導入的 C 結構和枚舉也是如此。

以下示例將字節從 byteValues 數組複製到 numbers ，即 Int32 數組：


var numbers: [Int32] = [0, 0]
var byteValues: [UInt8] = [0x01, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00]


numbers.withUnsafeMutableBytes { destBytes in
    byteValues.withUnsafeBytes { srcBytes in
        destBytes.copyBytes(from: srcBytes)
    }
}
// numbers == [1, 2]

作為參數傳遞給body 的指針僅在閉包的生命周期內有效。不要將其從封閉裝置中逃脫以備後用。

可用版本

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

相關用法

注：本文由純淨天空篩選整理自apple.com大神的英文原創作品 Array withUnsafeMutableBytes(_:)。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。