Quand ajouter des annotations explicites
Ajoutez des annotations pour lever les ambiguïtés et documenter l’intention.
Quand ajouter des annotations explicites est une leçon Swift Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Swift Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Swift Academy comprend 4 leçons au total.
Pourquoi ajouter une annotation
Bien que l’inférence soit puissante, les annotations de type explicites améliorent la clarté, lèvent les ambiguïtés et documentent l’intention.
let temperature: Double = 36
print(temperature)
print(type(of: temperature))Forcer un Double
Sans annotation, let x = 5 est de type Int. Ajoutez une annotation pour en faire un Double lorsque vous aurez besoin de calculs fractionnaires par la suite.
let count: Double = 5
let average = count / 2
print(average)Collections vides
Un littéral vide ne contient aucun élément à partir duquel inférer un type : vous devez donc indiquer explicitement le type.
var scores: [Int] = []
scores.append(10)
print(scores)Dictionnaire vide
La même règle s’applique aux dictionnaires vides : annotez explicitement les types des clés et des valeurs.
var ages: [String: Int] = [:]
ages["Ada"] = 36
print(ages)Lever l’ambiguïté entre les surcharges
Lorsque plusieurs initialiseurs pourraient correspondre, une annotation indique au compilateur lequel vous voulez utiliser.
let small: Int8 = 100
let big: Int64 = 100
print(type(of: small), type(of: big))Documenter les valeurs stockées
Dans les propriétés stockées, les types explicites sont obligatoires et servent de documentation pour les lecteurs.
struct Account {
var balance: Double = 0
var owner: String = "Unknown"
}
let a = Account()
print(a.balance, a.owner)Annoter pour améliorer la lisibilité
Pour les expressions longues ou non évidentes, une annotation aide les lecteurs à connaître immédiatement le type du résultat.
let ratio: Double = 22 / 7
print(ratio)Types optionnels
Vous annotez souvent explicitement les types optionnels, car nil seul n’a aucun type qui puisse être inféré.
var nickname: String? = nil
nickname = "Ace"
print(nickname ?? "none")Fermetures ne renvoyant rien
Lorsqu’une fermeture stockée pourrait être ambiguë, annotez son type complet.
let action: () -> Void = {
print("ran")
}
action()Conversions de littéraux numériques
Les annotations permettent à un même littéral d’être utilisé avec différents types numériques sans appels de conversion manuels.
let cpu: UInt8 = 255
let wide: UInt32 = 255
print(cpu, wide)Équilibrer inférence et annotation
Règle générale : laissez l’inférence gérer les cas évidents et ajoutez une annotation lorsque le type est ambigu, lorsque cela améliore la clarté ou lorsque c’est obligatoire, notamment pour les collections vides, les propriétés et les paramètres.
let obvious = "clear" // inference is fine
let precise: Double = 9 // annotation needed
print(obvious, precise)Vérification rapide
Quand une annotation est-elle obligatoire ?
Récapitulatif
Ajoutez des annotations explicites pour imposer un type numérique précis, déclarer des collections vides et des types optionnels, lever l’ambiguïté entre des surcharges et documenter les propriétés et les interfaces de programmation. Dans les autres cas, laissez l’inférence garder le code clair.
var list: [String] = []
let rate: Double = 5
print(list, rate)Questions Fréquemment Posées
La leçon « Quand ajouter des annotations explicites » est-elle gratuite ?
Oui — le texte complet de « Quand ajouter des annotations explicites » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Swift Academy, passe à CoddyKit PRO. Le cours Swift Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Quand ajouter des annotations explicites » ?
Ajoutez des annotations pour lever les ambiguïtés et documenter l’intention. Tu pratiques Swift Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Swift Academy ?
Aucune expérience préalable n'est requise. Swift Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « Quand ajouter des annotations explicites » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Swift Academy ?
Oui. Chaque leçon Swift Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Fonctionnement de l’inférence des types
- Quand ajouter des annotations explicites
- Inférence avec les littéraux
- Inférence dans les fermetures