0Pricing
Swift Academy · 课时

withUnsafeBytes 与 C 互操作

桥接到需要原始字节的 C API。

withUnsafeBytes 与 C 互操作 是 CoddyKit 上的免费 Swift Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。

从类型化数据到原始字节

有时，您需要看到的不是 Int 或 struct 这样的值，而是一串原始字节，例如对其进行哈希处理、写入文件，或将其交给 C 接口。withUnsafeBytes 正是为此而生：将值的存储临时视为 UInt8。

var value: UInt32 = 0x01020304
withUnsafeBytes(of: &value) { rawBuffer in
    print(rawBuffer.count) // 4 bytes
}

UnsafeRawBufferPointer

闭包接收一个 UnsafeRawBufferPointer，它是一个没有元素类型的字节缓冲区。您可以使用下标访问它，以读取单个 UInt8 值。它是只读的；可变形式是 withUnsafeMutableBytes。

var value: UInt32 = 0x01020304
withUnsafeBytes(of: &value) { bytes in
    for b in bytes { print(String(format: "%02x", b)) }
}
// Order depends on endianness

字节序很重要

您观察到的字节顺序取决于平台的字节序。在小端机器（Apple silicon、Intel）上，最低有效字节位于最前面。为协议进行序列化时，请使用 bigEndian 或 littleEndian 进行显式转换。

let host: UInt32 = 0x01020304
let networkOrder = host.bigEndian
var be = networkOrder
withUnsafeBytes(of: &be) { bytes in
    // Always 01 02 03 04 regardless of platform
    print(Array(bytes))
}

结构体的字节

withUnsafeBytes(of:) 适用于任何值，包括结构体。缓冲区长度等于 MemoryLayout<T>.size，其中也包括任何填充字节，但这些字节的内容未指定。

struct RGB { var r: UInt8; var g: UInt8; var b: UInt8 }
var color = RGB(r: 255, g: 128, b: 0)
withUnsafeBytes(of: &color) { bytes in
    print(bytes[0], bytes[1], bytes[2]) // 255 128 0
}

从字节加载值

要将原始字节重新解释为类型化值，请在原始缓冲区上使用 load(fromByteOffset:as:)。偏移量必须符合该类型的对齐要求，并且这些字节实际上必须表示该类型的有效值。

let raw: [UInt8] = [0x04, 0x03, 0x02, 0x01]
let n = raw.withUnsafeBytes { ptr in
    ptr.load(fromByteOffset: 0, as: UInt32.self)
}
print(String(format: "0x%08x", n))

用于紧凑数据的 loadUnaligned

二进制格式通常会在没有对齐填充的情况下紧凑排列字段。在未对齐的偏移量处调用 load 会产生未定义行为；请改用 loadUnaligned(fromByteOffset:as:)，以便从任意偏移量安全地读取。

let packet: [UInt8] = [0xFF, 0x04, 0x03, 0x02, 0x01]
let field = packet.withUnsafeBytes { ptr in
    ptr.loadUnaligned(fromByteOffset: 1, as: UInt32.self)
}
print(field)

将 Swift Data 桥接到 C

许多 C 函数接受一个 const void * 和一个长度。Data 和数组提供了 withUnsafeBytes，因此您可以直接传入 baseAddress 和 count，而无需复制数据。

import Foundation
let data = Data([0x68, 0x69]) // "hi"
data.withUnsafeBytes { (raw: UnsafeRawBufferPointer) in
    if let base = raw.baseAddress {
        // c_consume(base, raw.count)
        print("ptr", base, "len", raw.count)
    }
}

接收 C 指针

当 C 回调向您传递一个 const void * 和长度时，请将其包装在 UnsafeRawBufferPointer 中，以便安全地遍历。Swift 会将 C 指针导入为 UnsafeRawPointer?。

func handleC(_ ptr: UnsafeRawPointer, _ len: Int) {
    let buffer = UnsafeRawBufferPointer(start: ptr, count: len)
    let checksum = buffer.reduce(0) { $0 &+ Int($1) }
    print("checksum:", checksum)
}

bindMemory 与重新解释

要将一段原始区域视为类型化元素，bindMemory(to:capacity:) 会告诉编译器应如何解释它。错误使用此功能（将同一块内存绑定到两个不兼容的类型）会违反 Swift 的严格别名规则，并产生未定义行为。

let raw = UnsafeMutableRawPointer.allocate(
    byteCount: 8, alignment: 8)
defer { raw.deallocate() }
let typed = raw.bindMemory(to: Int.self, capacity: 1)
typed.pointee = 1234
print(typed.pointee)

assumingMemoryBound 与 bindMemory

bindMemory 会永久改变内存的解释方式；assumingMemoryBound(to:) 则断言内存已经绑定到该类型，而不会改变任何内容。只有在确定现有绑定的情况下，才应使用后者，例如对于您确定存储着给定类型的内存。

func sumInts(_ raw: UnsafeRawPointer, _ count: Int) -> Int {
    let p = raw.assumingMemoryBound(to: Int.self)
    var total = 0
    for i in 0..<count { total += p[i] }
    return total
}

安全检查清单

原始字节和 C 互操作是最容易出现崩溃的地方。请记住：

  • 绝不要让闭包中的指针逃逸。
  • 遵守对齐要求，或使用 Unaligned 变体。
  • 序列化时，请显式处理 endianness。
  • 不要将内存重新绑定到冲突的类型。
  • 对于空缓冲区，请防范 nil 的 baseAddress。
// Convert any value to a hex string safely
import Foundation
func hex<T>(_ v: T) -> String {
    var value = v
    return withUnsafeBytes(of: &value) { bytes in
        bytes.map { String(format: "%02x", $0) }.joined()
    }
}

快速检查

测试您对读取紧凑二进制数据的掌握程度。

总结

您学会了如何通过原始字节在 Swift 值与 C 之间进行桥接：

  • withUnsafeBytes(of:) 将任何值视为 UInt8。
  • load / loadUnaligned 会在遵守对齐要求的情况下，将字节重新解释为类型化值。
  • Data 和数组提供 withUnsafeBytes，以便将指针和长度传递给 C。
  • bindMemory 和 assumingMemoryBound 控制原始内存的类型解释方式。
  • 字节序、对齐和指针逃逸是主要风险。

常见问题解答

「withUnsafeBytes 与 C 互操作」课时是免费的吗？

是的 — 「withUnsafeBytes 与 C 互操作」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。

「withUnsafeBytes 与 C 互操作」这节课中我会学到什么？

桥接到需要原始字节的 C API。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「withUnsafeBytes 与 C 互操作」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. MemoryLayout 与对齐
  2. UnsafePointer 与 UnsafeMutablePointer
  3. 不安全缓冲区指针
  4. withUnsafeBytes 与 C 互操作
← 返回 Swift Academy