Swift Academy · Lezione

Quando aggiungere annotazioni esplicite

Aggiungi annotazioni per disambiguare e documentare l’intento.

Quando aggiungere annotazioni esplicite è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 4 lezioni in totale.

Perché usare le annotazioni

Sebbene l'inferenza sia potente, le annotazioni esplicite dei tipi migliorano la chiarezza, risolvono le ambiguità e documentano l'intento.

let temperature: Double = 36
print(temperature)
print(type(of: temperature))

Forzare un Double

Senza un'annotazione, let x = 5 è un Int. Aggiunga un'annotazione per renderlo un Double quando in seguito Le serviranno calcoli frazionari.

let count: Double = 5
let average = count / 2
print(average)

Raccolte vuote

Un letterale vuoto non contiene elementi da cui dedurre il tipo, quindi deve indicarlo esplicitamente.

var scores: [Int] = []
scores.append(10)
print(scores)

Dizionario vuoto

La stessa regola si applica ai dizionari vuoti: annoti sia il tipo della chiave sia quello del valore.

var ages: [String: Int] = [:]
ages["Ada"] = 36
print(ages)

Disambiguare gli overload

Quando potrebbero corrispondere diversi inizializzatori, un'annotazione indica al compilatore quale intende utilizzare.

let small: Int8 = 100
let big: Int64 = 100
print(type(of: small), type(of: big))

Documentare i valori memorizzati

Nelle proprietà memorizzate, i tipi espliciti sono obbligatori e fungono da documentazione per chi legge il codice.

struct Account {
    var balance: Double = 0
    var owner: String = "Unknown"
}
let a = Account()
print(a.balance, a.owner)

Annotare per maggiore leggibilità

Per espressioni lunghe o non immediate, un'annotazione aiuta chi legge a conoscere a colpo d'occhio il tipo del risultato.

let ratio: Double = 22 / 7
print(ratio)

Tipi optional

Spesso si annotano esplicitamente gli optional perché nil da solo non ha un tipo inferibile.

var nickname: String? = nil
nickname = "Ace"
print(nickname ?? "none")

Closure che non restituiscono nulla

Quando una closure memorizzata potrebbe essere ambigua, ne annoti il tipo completo.

let action: () -> Void = {
    print("ran")
}
action()

Conversioni dei letterali numerici

Le annotazioni consentono a un singolo letterale di assumere diversi tipi numerici senza chiamate di conversione manuali.

let cpu: UInt8 = 255
let wide: UInt32 = 255
print(cpu, wide)

Bilanciare inferenza e annotazioni

Regola generale: lasci che l'inferenza gestisca i casi ovvi e aggiunga un'annotazione quando il tipo è ambiguo, quando migliora la chiarezza o quando è obbligatoria, ad esempio per raccolte vuote, proprietà e parametri.

let obvious = "clear"       // inference is fine
let precise: Double = 9     // annotation needed
print(obvious, precise)

Verifica rapida

Quando è necessaria un'annotazione?

Riepilogo

Aggiunga annotazioni esplicite per forzare un tipo numerico specifico, dichiarare raccolte vuote e optional, disambiguare gli overload e documentare proprietà e API. Negli altri casi, lasci che l'inferenza mantenga pulito il codice.

var list: [String] = []
let rate: Double = 5
print(list, rate)

Domande Frequenti

La lezione «Quando aggiungere annotazioni esplicite» è gratuita?

Sì — il testo completo di «Quando aggiungere annotazioni esplicite» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 4 lezioni in totale.

Cosa imparerò in «Quando aggiungere annotazioni esplicite»?

Aggiungi annotazioni per disambiguare e documentare l’intento. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Swift Academy?

Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «Quando aggiungere annotazioni esplicite»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Swift Academy?

Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Swift Academy