Swift Academy · Lektion

CustomDebugStringConvertible

Angiv mere detaljeret debug-output.

Lektion 2 af 413 trin

CustomDebugStringConvertible er en gratis Swift Academy-lektion på CoddyKit. Dette er lektion 2 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.

En separat fejlsøgningsvisning

CustomDebugStringConvertible leverer debugDescription — den repræsentation, der bruges af debugPrint, LLDB-kommandoen po og fejlsøgeren. Den kan være mere detaljeret end description.

Tilføjelse af debugDescription

Overhold protokollen, og lever egenskaben:

struct Point: CustomDebugStringConvertible {
    let x: Int
    let y: Int
    var debugDescription: String { "Point(x: \(x), y: \(y))" }
}
debugPrint(Point(x: 1, y: 2))  // Point(x: 1, y: 2)

debugPrint kontra print

print bruger description; debugPrint bruger debugDescription:

struct Money: CustomStringConvertible, CustomDebugStringConvertible {
    let cents: Int
    var description: String { "$\(Double(cents)/100)" }
    var debugDescription: String { "Money(cents: \(cents))" }
}
let m = Money(cents: 250)
print(m)       // $2.5
debugPrint(m)  // Money(cents: 250)

Hvornår du bør levere begge

Brug description til ren outputtekst til brugeren og debugDescription til diagnostiske detaljer (rå værdier og intern tilstand). Ved at levere begge får du det bedste i hver sammenhæng.

Flere detaljer i fejlsøgning

Vis interne detaljer, som brugere ikke bør se:

struct Session: CustomStringConvertible, CustomDebugStringConvertible {
    let user: String
    let token: String
    var description: String { "Session(\(user))" }
    var debugDescription: String { "Session(user: \(user), token: \(token))" }
}
let s = Session(user: "ann", token: "xyz")
print(s)       // Session(ann)
debugPrint(s)  // Session(user: ann, token: xyz)

Fejlfindingsoutput i samlinger

debugPrint af en samling bruger hvert elements debugDescription:

struct Tag: CustomDebugStringConvertible {
    let name: String
    var debugDescription: String { "Tag(\(name))" }
}
debugPrint([Tag(name: "a"), Tag(name: "b")])  // [Tag(a), Tag(b)]

String(reflecting:)

Ligesom String(describing:) bruger description, bruger String(reflecting:) debugDescription:

struct Code: CustomDebugStringConvertible {
    let n: Int
    var debugDescription: String { "Code<\(n)>" }
}
print(String(reflecting: Code(n: 7)))  // Code<7>

Reserveadfærd

Hvis en type kun leverer description, bruger debugPrint den som reserve. Hvis den kun leverer debugDescription, bruger almindelig print stadig standardformen fra Mirror:

struct Only: CustomStringConvertible {
    let v: Int
    var description: String { "Only(\(v))" }
}
debugPrint(Only(v: 3))  // Only(3)  -- falls back to description

Anførselstegn i fejlfindingsoutput

Bemærk, at debugPrint af en String tilføjer anførselstegn, fordi outputtet er beregnet til fejlsøgning:

print("hi")        // hi
debugPrint("hi")   // "hi"

Diagnostik uden datalæk

Hold hemmeligheder ude af description, men tillad dem kun i debugDescription, hvis loggene er sikre. Vælg bevidst, hvad hver af dem afslører.

struct Key: CustomStringConvertible {
    let secret: String
    var description: String { "Key(***)" }
}
print(Key(secret: "abc"))  // Key(***)

Fejlsøgningsdetaljer for en enum

Enums har gavn af en debugDescription, der viser den rå case og nyttelasten:

enum Load: CustomDebugStringConvertible {
    case idle
    case progress(Int)
    var debugDescription: String {
        switch self {
        case .idle: return "Load.idle"
        case .progress(let p): return "Load.progress(\(p))"
        }
    }
}
debugPrint(Load.progress(40))  // Load.progress(40)

Hurtigt tjek

Hvilken funktion bruger debugDescription i stedet for description?

Besvar den i den interaktive lektion

Opsummering

Du har lært om CustomDebugStringConvertible:

Lever var debugDescription: String til diagnostisk output
Bruges af debugPrint, String(reflecting:) og fejlsøgeren
print bruger description; debugPrint bruger debugDescription
Placér ekstra interne detaljer i fejlsøgningsvisningen og ren tekst i description

Næste: refleksion med Mirror.

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 “CustomDebugStringConvertible” gratis?

Ja — alle 3 lektioner i læringssporet Swift Academy, inklusive “CustomDebugStringConvertible”, 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 “CustomDebugStringConvertible”?

Angiv mere detaljeret debug-output. 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 2 af 4.

Hvor lang tid tager lektionen “CustomDebugStringConvertible”?

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