Swift Academy · leksjon

CustomStringConvertible

Definer en lesbar beskrivelse for typene Deres.

Leksjon 1 av 413 trinn

CustomStringConvertible er en gratis leksjon i Swift Academy på CoddyKit. Dette er leksjon 1 av 4. Du kan lese valgfritt 3 leksjoner fra denne læringsstien gratis i sin helhet – deretter låser CoddyKit PRO opp alle leksjoner, samt praktisk øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Swift Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Swift Academy inneholder totalt 4 leksjoner.

Hva er CustomStringConvertible?

Denne protokollen lar deg styre hvordan typen vises når den skrives ut eller settes inn i en strenginterpolering. Du oppgir en description-egenskap.

Standardvisningen er lite lesbar

Uten den skriver strukturer ut hele medlemsformen, som ofte blir unødvendig omstendelig:

struct Point { let x: Int; let y: Int }
print(Point(x: 1, y: 2))  // Point(x: 1, y: 2)

Legge til description

Oppfyll protokollen og oppgi var description: String:

struct Point: CustomStringConvertible {
    let x: Int
    let y: Int
    var description: String { "(\(x), \(y))" }
}
print(Point(x: 1, y: 2))  // (1, 2)

Brukes av print og String(describing:)

Din description brukes av print og strenginterpolering:

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

description kontra direkte egenskaper

description er ment for lesbar tekst som vises til brukeren. Den skal ikke leses inn igjen for å gjenskape verdien — det er en annen oppgave som håndteres av Codable. Hold den lettlest.

Formatere en enum

Gi enums lettfattelige navn:

enum Suit: CustomStringConvertible {
    case hearts, spades
    var description: String {
        switch self {
        case .hearts: return "Hearts"
        case .spades: return "Spades"
        }
    }
}
print(Suit.hearts)  // Hearts

Sette sammen beskrivelser

Bygg en description fra medlemsbeskrivelsene:

struct Card: CustomStringConvertible {
    let rank: Int
    let suit: String
    var description: String { "\(rank) of \(suit)" }
}
let cards = [Card(rank: 1, suit: "H"), Card(rank: 13, suit: "S")]
print(cards.map { $0.description })  // ["1 of H", "13 of S"]

Inne i samlinger

Når en samling skrives ut, kalles description for hvert element:

struct Tag: CustomStringConvertible {
    let name: String
    var description: String { "#\(name)" }
}
print([Tag(name: "swift"), Tag(name: "ios")])  // [#swift, #ios]

Interpolering bruker description

Strenginterpolering henter automatisk description:

struct Temperature: CustomStringConvertible {
    let celsius: Int
    var description: String { "\(celsius)C" }
}
let t = Temperature(celsius: 21)
print("Now: \(t)")  // Now: 21C

Hold den enkel

description kan bli kalt ofte, for eksempel ved logging og feilsøking. Unngå omfattende arbeid i den; beregn en enkel streng fra de lagrede egenskapene.

struct ID: CustomStringConvertible {
    let value: Int
    var description: String { "ID#\(value)" }
}
print(ID(value: 42))  // ID#42

Betinget formatering

description kan velge mellom ulike tekster basert på tilstanden, slik at resultatet blir naturlig å lese:

struct Stock: CustomStringConvertible {
    let count: Int
    var description: String {
        count == 0 ? "Out of stock" : "\(count) in stock"
    }
}
print(Stock(count: 0))  // Out of stock
print(Stock(count: 5))  // 5 in stock

Hurtigsjekk

Hvilken egenskap krever CustomStringConvertible?

Besvar den i den interaktive leksjonen

Oppsummering

Du har lært om CustomStringConvertible:

Oppgi var description: String for tekst som vises til brukeren
Brukes av print, String(describing:) og strenginterpolering
Hold den lettlest og enkel; ikke prøv å støtte tur-retur-konvertering
Fungerer automatisk inne i samlinger

Neste: CustomDebugStringConvertible.

Gratis å komme i gang

Lær deg Swift med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs: 122
Leksjoner: 409

Start læringen gratis Se hele kurset

Ofte stilte spørsmål

Er leksjonen «CustomStringConvertible» gratis?

Ja – du kan lese valgfritt 3 av leksjonene i læringsstien Swift Academy, inkludert «CustomStringConvertible», gratis i sin helhet her på nettet. Deretter låser CoddyKit PRO opp alle leksjoner, samt interaktiv øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Kurset i Swift Academy inneholder totalt 4 leksjoner.

Hva lærer jeg i «CustomStringConvertible»?

Definer en lesbar beskrivelse for typene Deres. Du øver på Swift Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med Swift Academy?

Ingen tidligere erfaring er nødvendig. Swift Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 1 av 4.

Hvor lang tid tar leksjonen «CustomStringConvertible»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne Swift Academy-leksjonen?

Ja. Alle Swift Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

← Tilbake til Swift Academy