0Pricing
Swift Academy · Lección

Cuándo añadir anotaciones explícitas

Anote los tipos para desambiguar y documentar la intención.

Cuándo añadir anotaciones explícitas es una lección gratuita de Swift Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Swift Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Swift Academy incluye 4 lecciones en total.

Por qué añadir anotaciones

Aunque la inferencia es potente, las anotaciones de tipo explícitas mejoran la claridad, resuelven ambigüedades y documentan la intención.

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

Forzar un Double

Sin una anotación, let x = 5 es un Int. Añada una anotación para convertirlo en un Double cuando necesite realizar cálculos fraccionarios más adelante.

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

Colecciones vacías

Un literal vacío no tiene elementos de los que inferir el tipo, por lo que debe indicarlo explícitamente.

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

Diccionario vacío

La misma regla se aplica a los diccionarios vacíos: anote explícitamente los tipos de las claves y de los valores.

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

Desambiguar sobrecargas

Cuando podrían coincidir varios inicializadores, una anotación indica al compilador cuál pretende utilizar.

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

Documentar valores almacenados

En las propiedades almacenadas, los tipos explícitos son obligatorios y sirven como documentación para quienes leen el código.

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

Anotar para mejorar la legibilidad

En expresiones largas o poco evidentes, una anotación ayuda a saber de un vistazo cuál es el tipo del resultado.

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

Tipos opcionales

A menudo se anotan explícitamente los tipos opcionales porque nil por sí solo no tiene un tipo que se pueda inferir.

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

Closures que no devuelven nada

Cuando un closure almacenado podría resultar ambiguo, anote su tipo completo.

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

Conversiones de literales numéricos

Las anotaciones permiten que un mismo literal se adapte a distintos tipos numéricos sin llamadas de conversión manuales.

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

Equilibrar inferencia y anotaciones

Regla general: deje que la inferencia se encargue de los casos evidentes y añada anotaciones cuando el tipo sea ambiguo, cuando mejoren la claridad o cuando sean obligatorias (colecciones vacías, propiedades y parámetros).

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

Comprobación rápida

¿Cuándo es obligatoria una anotación?

Resumen

Añada anotaciones explícitas para forzar un tipo numérico concreto, declarar colecciones vacías y tipos opcionales, desambiguar sobrecargas y documentar propiedades y APIs. En los demás casos, deje que la inferencia mantenga limpio el código.

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

Preguntas frecuentes

¿La lección «Cuándo añadir anotaciones explícitas» es gratis?

Sí — el texto completo de «Cuándo añadir anotaciones explícitas» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Swift Academy, actualiza a CoddyKit PRO. El curso de Swift Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Cuándo añadir anotaciones explícitas»?

Anote los tipos para desambiguar y documentar la intención. Practicas Swift Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Swift Academy?

No se requiere experiencia previa. Swift Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «Cuándo añadir anotaciones explícitas»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Swift Academy?

Sí. Cada lección de Swift Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Cómo funciona la inferencia de tipos
  2. Cuándo añadir anotaciones explícitas
  3. Inferencia con literales
  4. Inferencia en cierres
← Volver a Swift Academy