Bagaimanakah parameter fungsi dan hujah default berfungsi?

Question

Accepted Answer

Fungsi Python menyokong hujah **positional** dan **keyword**, serta **nilai default**. Memahami bagaimana ia digabungkan — dan satu perangkap default-argument yang terkenal — adalah penting.

## Hujah positional, keyword, dan default

```python
def greet(name, greeting="Hello", punctuation="!"):
    return f"{greeting}, {name}{punctuation}"

greet("Ann")                          # positional → "Hello, Ann!"
greet("Ann", "Hi")                    # "Hi, Ann!"
greet("Ann", punctuation=".")          # keyword arg → "Hello, Ann."
greet(name="Ann", greeting="Hey")      # all by keyword
```

Parameter dengan default adalah pilihan; anda boleh melewatkan hujah mengikut kedudukan atau mengikut nama (hujah keyword meningkatkan kebolehbacaan dan membenarkan anda melangkau parameter pilihan lebih awal).

## Perangkap terkenal: hujah default yang boleh diubah

```python
# ❌ DANGER — the default list is created ONCE and SHARED across all calls
def add_item(item, items=[]):
    items.append(item)
    return items

add_item("a")   # ["a"]
add_item("b")   # ["a", "b"]  ← surprise! the SAME list persisted
```

Nilai default dinilai **sekali** apabila fungsi ditakrifkan, bukan setiap panggilan. Default yang boleh diubah (senarai/dict) dengan itu dikongsi antara panggilan — pepijat klasik. Perbaikan:

```python
# ✅ use None as the default and create a fresh object inside
def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items
```

## Parameter keyword-only dan positional-only

```python
def f(a, b, *, key):       # `*` → `key` MUST be passed by keyword
    ...
f(1, 2, key=3)             # ✅   f(1, 2, 3) ❌

def g(a, b, /, c):         # `/` → a, b MUST be positional
    ...
```

Penanda `*` dan `/` membenarkan anda menguatkuasakan cara hujah dilewatkan — berguna untuk API yang jelas dan stabil.

## Mengapa ia penting

Memahami pengendalian parameter adalah asas untuk menulis dan memanggil fungsi Python dengan betul.

Nilai default menjadikan fungsi fleksibel, dan hujah keyword menjadikan panggilan self-documenting.

Dengan penting, **perangkap hujah default yang boleh diubah** adalah salah satu pepijat Python yang paling umum dan mengelirukan — mengetahui bahawa default dinilai sekali (jadi default yang boleh diubah berterusan merentas panggilan) dan pembaikan sentinel `None` mencegah seluruh kelas ralat halus.

Pengetahuan ini adalah asas untuk merancang API fungsi yang bersih dan dapat diramalkan.