Silabus Pelajaran 25 dari 250 · Fungsi
Fungsi

Docstrings dan Type Hints

Dua sentuhan kecil mengubah fungsi yang berjalan menjadi profesional: docstring dan type hints.

A docstring adalah string literal yang diletakkan sebagai baris pertama di dalam body fungsi. Ini menjelaskan apa yang dilakukan fungsi tersebut. Tools dan help() membacanya, dan Python menyimpannya di function.__doc__:

def add(a, b):
    """Return the sum of a and b."""
    return a + b

print(add.__doc__)   # Return the sum of a and b.

Tanda kutip tiga membuat docstring bisa mencakup beberapa baris, yang berguna untuk penjelasan yang lebih panjang.

Type hints memberi tahu tipe data apa yang diharapkan untuk parameter dan nilai kembalian. Kamu menulis name: type untuk setiap parameter dan -> type untuk nilai kembalian:

def add(a: int, b: int) -> int:
    """Return the sum of a and b."""
    return a + b

Hints tidak memaksa apa pun saat dijalankan. Python tidak akan menghentikanmu saat mengirimkan string. Mereka adalah dokumentasi yang digunakan editor dan pengecek untuk menangkap kesalahan lebih awal, dan mereka membuat signature kamu bisa dipahami sendiri. Tipe hint umum termasuk int, float, str, dan bool.

Mulai sekarang, tulis fungsi dengan keduanya: docstring yang jelas dan type hints yang jujur.

Giliranku

Definisikan fungsi multiply dengan type hints def multiply(a: int, b: int) -> int: dan docstring (baris pertamanya) yang berbunyi tepat Return the product of a and b.. Isinya harus return a * b.

Ada masalah di pelajaran ini? Laporkan · Tanya tentang pelajaran ini

Latihan ini akan segera dibuka

Selesaikan pelajaran sebelumnya agar pelajaran ini terbuka. Seluruh kursus ini gratis, tidak butuh akun, dan kamu bisa baca pelajaran ini sekarang.