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(_:)。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。