0Pricing
Swift Academy · Aula

Quando Adicionar Anotações Explícitas

Adicione anotações para eliminar ambiguidades e documentar a intenção.

Quando Adicionar Anotações Explícitas é uma aula grátis de Swift Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Swift Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Swift Academy inclui 4 aulas no total.

Por que anotar

Embora a inferência seja poderosa, as anotações explícitas de tipo melhoram a clareza, resolvem ambiguidades e documentam a intenção.

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

Forçando um Double

Sem uma anotação, let x = 5 é um Int. Faça uma anotação para torná-lo um Double quando precisar de cálculos fracionários posteriormente.

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

Coleções vazias

Um literal vazio não tem elementos dos quais inferir o tipo, portanto é necessário declará-lo explicitamente.

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

Dicionário vazio

A mesma regra se aplica a dicionários vazios: anote explicitamente os tipos da chave e do valor.

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

Desambiguando sobrecargas

Quando vários inicializadores podem corresponder, uma anotação informa ao compilador qual deles pretende usar.

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

Documentando valores armazenados

Em propriedades armazenadas, os tipos explícitos são obrigatórios e servem como documentação para os leitores.

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

Anotando para melhorar a legibilidade

Para expressões longas ou não obvious, uma anotação ajuda os leitores a saber o tipo do resultado de imediato.

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

Tipos opcionais

É comum anotar os opcionais explicitamente, pois apenas nil não tem um tipo que possa ser inferido.

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

Fechamentos que não retornam nada

Quando um fechamento armazenado pode ser ambíguo, anote seu tipo completo.

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

Conversões de literais numéricos

As anotações permitem que um único literal seja atribuído a diferentes tipos numéricos sem chamadas manuais de conversão.

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

Equilibrando inferência e anotação

Regra prática: deixe a inferência cuidar dos casos obvious e anote quando o tipo for ambíguo, quando isso melhorar a clareza ou quando for obrigatório, como em coleções empty, propriedades e parâmetros.

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

Verificação rápida

Quando uma anotação é obrigatória?

Recapitulação

Adicione anotações explícitas para forçar um tipo numérico específico, declarar coleções empty e opcionais, desambiguar sobrecargas e documentar propriedades e APIs. Caso contrário, deixe a inferência manter o código limpo.

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

Perguntas Frequentes

A aula “Quando Adicionar Anotações Explícitas” é grátis?

Sim — o texto completo de “Quando Adicionar Anotações Explícitas” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Swift Academy, atualize para CoddyKit PRO. O curso de Swift Academy inclui 4 aulas no total.

O que vou aprender em “Quando Adicionar Anotações Explícitas”?

Adicione anotações para eliminar ambiguidades e documentar a intenção. Você pratica Swift Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Swift Academy?

Nenhuma experiência prévia é necessária. Swift Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Quando Adicionar Anotações Explícitas”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Swift Academy?

Sim. Cada aula de Swift Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Como Funciona a Inferência de Tipos
  2. Quando Adicionar Anotações Explícitas
  3. Inferência com Literais
  4. Inferência em Closures
← Voltar para Swift Academy