Funksiya anotasiyaları (Function Annotations) — Python funksiyalarında giriş (parametr) və çıxış (nəticə) tiplərini göstərmək üçün istifadə edilən bir xüsusiyyətdir. Onlar funksiyanın necə işlədiyini daha aydın, sənədləşdirilmiş və asudə başa düşülən edir. Lakin vacib qeyd: anotasiyalar sadəcə göstərişdirlər, Python tərəfindən icra vaxtında yoxlanmırlar.

Sintaksis:

def function_name(param1: type1, param2: type2) -> return_type:

pass

• param1: type1 – param1 parametrinin gözlənilən tipi type1-dir.
• -> return_type – funksiyanın qaytardığı nəticənin tipi return_type-dir.

Nümunə:

def toplama(a: int, b: int) -> int:

return a + b

Bu funksiyada a və b dəyişənlərinin tam ədəd (int) olacağı, və nəticənin də tam ədəd olacağı göstərilib.

Ancaq aşağıdakı kimi işləyəcək:

print(toplama("5", "7")) # Çıxış: 57

Yəni: Anotasiya olsa belə, Python tipə baxmır və səhv vermir. Bunun üçün əlavə yoxlama (type checking) üçün mypy, pylint, və ya pyright kimi vasitələr istifadə olunur.

Praktik istifadələr:

• Kodun oxunaqlığını artırır.
• IDE-lər (məs. PyCharm, VSCode) avtomatik tamamlanma (autocomplete) və tip yoxlaması üçün bu anotasiyalardan istifadə edə bilər.
• Komandada işləyərkən başqalarının kodu anlamaq rahatlaşır.
• Böyük layihələrdə səhvlərin qarşısını almağa kömək edir (xüsusilə type checker ilə birgə).

Kompleks növlər:

from typing import List, Tuple, Dict

def işləyənlər(siyahı: List[str]) -> Tuple[int, str]:

return len(siyahı), siyahı[0]