Swift Academy · Lektion

withUnsafeBytes og C-interoperabilitet

Forbind til C-API’er, der forventer rå bytes.

Lektion 4 af 413 trin

withUnsafeBytes og C-interoperabilitet er en gratis Swift Academy-lektion på CoddyKit. Dette er lektion 4 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Swift Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Swift Academy-kurset indeholder 4 lektioner i alt.

Fra typer til rå bytes

Nogle gange skal du se en værdi ikke som en Int eller en struct, men som en sekvens af rå bytes – for at beregne dens hashværdi, skrive den til en fil eller give den videre til en C-API. withUnsafeBytes giver dig netop det: en midlertidig visning af en værdis lagring som UInt8.

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

UnsafeRawBufferPointer

Lukningen modtager en UnsafeRawBufferPointer – en buffer med bytes uden elementtype. Du bruger indeks til at læse individuelle UInt8-værdier. Den er skrivebeskyttet; den ændringsbare form er withUnsafeMutableBytes.

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

Byteorden er vigtig

Den rækkefølge af bytes, du ser, afhænger af platformens byteorden. På little-endian-maskiner (Apple silicon, Intel) kommer den mindst betydende byte først. Når du serialiserer til en protokol, skal du konvertere eksplicit med bigEndian eller 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))
}

Bytes i en struktur

withUnsafeBytes(of:) fungerer på enhver værdi, også strukturer. Bufferens længde svarer til MemoryLayout<T>.size, og eventuelle fyldbytes er inkluderet, men deres indhold er ikke specificeret.

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
}

Indlæsning af en værdi fra bytes

Hvis du vil fortolke rå bytes som en værdi med en bestemt type, skal du bruge load(fromByteOffset:as:) på en rå buffer. Forskydningen skal overholde typens justering, og bytesene skal faktisk repræsentere en gyldig værdi af den pågældende type.

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 til pakkede data

Binære formater pakker ofte felter uden fyld til justering. Det er udefineret adfærd at kalde load ved en ujusteret forskydning; brug i stedet loadUnaligned(fromByteOffset:as:) til at læse sikkert fra enhver forskydning.

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

Forbindelse mellem Swift Data og C

Mange C-funktioner accepterer en const void * plus en længde. Data og arrays stiller withUnsafeBytes til rådighed, så du kan sende baseAddress og count direkte uden at kopiere.

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)
    }
}

Modtagelse af en C-peger

Når et C-callback giver dig en const void * og en længde, skal du omslutte den i en UnsafeRawBufferPointer for at kunne iterere sikkert. Swift importerer C-pegere som 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 og genfortolkning

Hvis du vil behandle et råt område som typede elementer, fortæller bindMemory(to:capacity:) compileren, hvordan det skal fortolkes. Misbrug af dette – ved at binde den samme hukommelse til to inkompatible typer – overtræder Swifts strenge aliaseringsregler og er udefineret.

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 kontra bindMemory

bindMemory ændrer permanent, hvordan hukommelsen fortolkes; assumingMemoryBound(to:) hævder, at den allerede er bundet til den type, uden at ændre noget. Brug kun den sidste, når du er sikker på den eksisterende binding, for eksempel med hukommelse, som du ved indeholder den angivne type.

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
}

Tjekliste for sikkerhed

Det er i rå bytehåndtering og C-integration, at de fleste nedbrud gemmer sig. Husk:

Lad aldrig lukningens peger slippe ud.
Respektér justeringen, eller brug Unaligned-varianterne.
Håndtér endianness eksplicit ved serialisering.
Bind ikke hukommelsen igen til modstridende typer.
Beskyt dig mod en nil baseAddress for tomme buffere.

// 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()
    }
}

Hurtigt tjek

Tjek din forståelse af læsning af pakkede binære data.

Besvar den i den interaktive lektion

Opsummering

Du har lært at forbinde Swift-værdier og C gennem rå bytes:

withUnsafeBytes(of:) viser enhver værdi som UInt8.
load / loadUnaligned genfortolker bytes som værdier med en bestemt type og overholder justeringen.
Data og arrays stiller withUnsafeBytes til rådighed, så du kan sende peger + længde til C.
bindMemory og assumingMemoryBound styrer, hvordan rå hukommelse typificeres.
Byteorden, justering og det, at pegere slipper ud, er de største farer.

Gratis at komme i gang

Lær Swift med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser: 122
Lektioner: 409

Start gratis Se hele kurset

Ofte stillede spørgsmål

Er lektionen “withUnsafeBytes og C-interoperabilitet” gratis?

Ja — alle 3 lektioner i læringssporet Swift Academy, inklusive “withUnsafeBytes og C-interoperabilitet”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Swift Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “withUnsafeBytes og C-interoperabilitet”?

Forbind til C-API’er, der forventer rå bytes. Du øver dig i Swift Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Swift Academy?

Der kræves ingen tidligere erfaring. Swift Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 4 af 4.

Hvor lang tid tager lektionen “withUnsafeBytes og C-interoperabilitet”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Swift Academy-lektion?

Ja. Alle Swift Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

← Tilbage til Swift Academy