Swift Academy · Lekcja

Kiedy dodawać jawne adnotacje

Dodawanie adnotacji w celu usunięcia niejednoznaczności i udokumentowania intencji.

Kiedy dodawać jawne adnotacje to bezpłatna lekcja Swift Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Swift Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Swift Academy zawiera 4 lekcji w sumie.

Po co dodawać adnotacje

Chociaż wnioskowanie jest bardzo przydatne, jawne adnotacje typów poprawiają czytelność, rozstrzygają niejednoznaczności i dokumentują intencję.

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

Wymuszanie typu Double

Bez adnotacji let x = 5 ma typ Int. Należy dodać adnotację, aby nadać mu typ Double, gdy później potrzebne będą obliczenia ułamkowe.

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

Puste kolekcje

Pusty literał nie zawiera elementów, na podstawie których można wywnioskować typ, dlatego trzeba określić go jawnie.

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

Pusty słownik

Ta sama zasada dotyczy pustych słowników: należy dodać adnotacje zarówno dla typu kluczy, jak i wartości.

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

Rozstrzyganie przeciążeń

Gdy pasować może kilka inicjalizatorów, adnotacja informuje kompilator, który z nich mają Państwo na myśli.

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

Dokumentowanie przechowywanych wartości

W przypadku właściwości przechowywanych jawne typy są wymagane i pełnią funkcję dokumentacji dla czytelników kodu.

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

Dodawanie adnotacji dla czytelności

W przypadku długich lub nieoczywistych wyrażeń adnotacja pomaga czytelnikom od razu poznać typ wyniku.

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

Typy opcjonalne

Typy opcjonalne często określa się jawnie, ponieważ samo nil nie ma typu, który można wywnioskować.

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

Domknięcia niczego niezwracające

Jeśli przechowywane domknięcie może być niejednoznaczne, należy określić jego pełny typ.

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

Konwersje literałów liczbowych

Adnotacje pozwalają użyć tego samego literału w różnych typach liczbowych bez ręcznego wywoływania funkcji konwersji.

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

Równowaga między wnioskowaniem a adnotacjami

Zasada praktyczna: należy pozwolić wnioskowaniu obsługiwać oczywiste przypadki, a adnotacje dodawać wtedy, gdy typ jest niejednoznaczny, poprawiają czytelność lub są wymagane, na przykład w przypadku pustych kolekcji, właściwości i parametrów.

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

Szybkie sprawdzenie

Kiedy adnotacja jest wymagana?

Podsumowanie

Jawne adnotacje należy dodawać, aby wymusić konkretny typ liczbowy, zadeklarować puste kolekcje i typy opcjonalne, rozstrzygnąć przeciążenia oraz dokumentować właściwości i API. W pozostałych przypadkach warto pozwolić wnioskowaniu zachować przejrzystość kodu.

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

Często zadawane pytania

Czy lekcja „Kiedy dodawać jawne adnotacje” jest bezpłatna?

Tak — pełny tekst „Kiedy dodawać jawne adnotacje” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Swift Academy, przejdź na CoddyKit PRO. Kurs Swift Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Kiedy dodawać jawne adnotacje”?

Dodawanie adnotacji w celu usunięcia niejednoznaczności i udokumentowania intencji. Ćwiczysz Swift Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Swift Academy?

Nie wymagamy żadnego doświadczenia. Swift Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Kiedy dodawać jawne adnotacje”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Swift Academy?

Tak. Każda lekcja Swift Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Swift Academy