> ## Documentation Index > Fetch the complete documentation index at: https://v1-learn.neoartd.my.id/llms.txt > Use this file to discover all available pages before exploring further. # Fungsi Sebelum mulai mempelajari fungsi dalam Python, mari kita bahas terlebih dahulu tentang konsep dasar fungsi. ## Fungsi dalam Matematika Fungsi dalam pemrograman sebenarnya didasari oleh konsep pemetaan (asosiasi) dan fungsi dalam matematika. Fungsi pada matematika merupakan pemetaan antara dua himpunan nilai, yaitu **domain** dan **range**. Kita bisa bayangkan fungsi sebagai sebuah mesin yang memiliki input (**domain**) dan *output* (**range**). **Output** tersebut pasti terkait dengan **input** bagaimana pun kondisinya. [![dos:ed3b8eba1ecf3ee286c7cb9396c012e620230821195745.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:ed3b8eba1ecf3ee286c7cb9396c012e620230821195745.jpeg)](# "dos:ed3b8eba1ecf3ee286c7cb9396c012e620230821195745.jpeg") Notasi atau bentuk rumus fungsi dalam matematika beragam. Salah satu yang umum dijumpai adalah notasi berikut. [![dos:273ed8af66ad0b01cb35f7fa34072d8620230821195744.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:273ed8af66ad0b01cb35f7fa34072d8620230821195744.jpeg)](# "dos:273ed8af66ad0b01cb35f7fa34072d8620230821195744.jpeg") Dengan catatan sebagai berikut. 1. f = nama fungsi 2. x = input 3. 2x = apa yang harus dikeluarkan (output) Mari kita lihat salah satu soal fungsi sederhana dalam matematika. Asumsikan bahwa kita memiliki sebuah fungsi untuk **mengalikan bilangan bulat dengan nilai 2**. Jadi, berikut perhitungannya. [![dos:8356f943b63b412366f713e97830502b20230821195744.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:8356f943b63b412366f713e97830502b20230821195744.jpeg)](# "dos:8356f943b63b412366f713e97830502b20230821195744.jpeg") Perhatikan pada gambar tersebut. Sebab fungsi kita bertujuan untuk **mengalikan bilangan bulat dengan nilai 2**, setiap elemen yang berada pada **himpunan domain** akan dikalikan dua dan hasilnya ditampung pada **himpunan range**. Notasi **f(x)=2x** menunjukkan bahwa fungsi "f" mengambil "x" dan mengalikannya dengan 2. [![dos:8a7374f2deb2a7a746ee73b318067f9220230821195746.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:8a7374f2deb2a7a746ee73b318067f9220230821195746.jpeg)](# "dos:8a7374f2deb2a7a746ee73b318067f9220230821195746.jpeg") Sampai sini, kita sudah memahami secara mendasar mengenai fungsi dalam matematika. Ingat bahwa fungsi "f(x)=2x" yang kita deklarasikan akan mengalikan bilangan bulat dengan 2, berapa pun bilangannya. Mari kita lanjutkan mengenai fungsi dalam pemrograman. ## Fungsi dalam Pemrograman Fungsi dalam pemrograman didasari oleh fungsi dalam matematika. Jadi, baik fungsi pemrograman maupun fungsi matematika memiliki tujuan yang sama, yaitu **mengubah suatu bentuk menjadi bentuk lain dengan aturan yang sama.** Mari analogikan kembali dengan konsep lain, kita bisa umpamakan fungsi dalam pemrograman seperti merakit isi **black box**. [![dos:12421cb61d85ec03e27924ec87e9a20e20230821195743.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:12421cb61d85ec03e27924ec87e9a20e20230821195743.jpeg)](# "dos:12421cb61d85ec03e27924ec87e9a20e20230821195743.jpeg") Selayaknya **black box**, kita tidak perlu tahu tentang hal yang terjadi dalam kotak (fungsi) tersebut. Kita hanya perlu fokus pada keadaan awal yang merupakan himpunan nilai yang terdefinisi sebagai input (domain) dan keadaan akhir yang merupakan himpunan nilai yang terdefinisi sebagai output (range). Mari ambil contoh salah satu fungsi yang sedari materi awal sudah kita kenal, yakni fungsi "print()". Fungsi ini bertujuan untuk menampilkan teks ke layar tanpa kita perlu ketahui hal yang terjadi di dalamnya. Hal yang perlu kita lakukan adalah memasukkan teks yang diinginkan ke fungsi "print()". [![dos:64f2b1f070d203b47148a9a0fc6db02720230821195744.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:64f2b1f070d203b47148a9a0fc6db02720230821195744.jpeg)](# "dos:64f2b1f070d203b47148a9a0fc6db02720230821195744.jpeg") Contohnya pada gambar di atas, kita hanya perlu memasukkan teks "Hello World!" tanpa tahu proses fungsi di dalamnya. Fungsi tersebut akan menghasilkan output dengan memunculkan teks "Hello World!" ke layar. Jadi, kalau kita definisikan, fungsi dalam pemrograman adalah blok kode yang dapat digunakan kembali untuk mengeksekusi fungsionalitas tertentu saat dipanggil. Dalam Python, fungsi terbagi menjadi dua jenis. 1. ***Built-in Functions***\ *Built-in functions* atau dalam bahasa Indonesia berarti fungsi bawaan adalah kumpulan fungsi yang sudah terintegrasi dengan bahasa pemrograman Python sehingga tidak perlu mengimpor **modul** atau **library** tambahan. Fungsi bawaan ini menyediakan fungsi-fungsi inti dan dasar dari bahasa Python. Contoh dari fungsi bawaan adalah **print(), len(), type(), range(),** dan sebagainya. 2. ***User-defined Functions***\ *User-defined functions* atau dalam bahasa Indonesia berarti fungsi yang didefinisikan pengguna adalah jenis fungsi yang kita definisikan sendiri untuk melakukan tugas spesifik tertentu. Contoh dari **user-defined functions** adalah fungsi yang telah kita buat di awal materi ini tentang mencari luas persegi panjang. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang,lebar): luas_persegi_panjang = panjang*lebar return luas_persegi_panjang persegi_panjang_pertama = mencari_luas_persegi_panjang(5,10) print(persegi_panjang_pertama) persegi_panjang_kedua = mencari_luas_persegi_panjang(4,15) print(persegi_panjang_kedua) """ Output: 50 60 """ ``` Kita akan bahas lebih detail tentang fungsi ini nanti. Saat ini Anda cukup mengetahui bahwa kode di atas berperan layaknya **black box**. Kita perlu memasukkan angka yang merupakan **panjang dan lebar persegi** untuk dimasukkan ke fungsi dan akhirnya menerima output nilai luas persegi. Jika ingin menggunakan fungsi lain di luar dari **built-in functions**, Anda bisa mengimpor sebuah library. **Library** adalah koleksi dari banyaknya modul yang saling terkait dan dapat digunakan berulang kali. **Modul** adalah file berisi kode Python berupa fungsi, kelas, dan sebagainya. Library dalam Python terdiri dari dua jenis. 1. **Python Standard Library**\ Python Standard Library adalah jenis library yang telah terpasang secara otomatis ketika Anda melakukan instalasi Python. Python Standard Library berisi kumpulan modul dan paket yang disertakan secara default oleh Python. Paket (package) merupakan sebuah direktori berisi satu atau lebih modul yang terkait dan saling berhubungan. Anda tidak perlu melakukan instalasi untuk menggunakan Python Standard Library. Contoh Python Standard Library adalah **"os"**, **"datetime"**, **"re"**, dan sebagainya. Anda bisa melihat banyaknya jenis library ini pada laman website [berikut](https://docs.python.org/3/library/). 2. **External Library**\ Jika sebelumnya impor library tidak perlu dilakukan untuk Python Standard, berbeda halnya dengan external library yang mengharuskan Anda mengimpor library untuk bisa menggunakannya. External Library adalah jenis library yang dikembangkan oleh individu atau organisasi di luar tim inti pengembang Python. Sederhananya, di luar sana banyak developer yang turut membuat kode untuk diri mereka sendiri dan pada akhirnya disebarluaskan untuk digunakan oleh developer lainnya. Contoh dari external library adalah TensorFlow yang merupakan library populer untuk menyelesaikan permasalahan pemelajaran mesin (*machine learning*). Mari kita sederhanakan semua penjelasan dengan tabel berikut. | Nama | Definisi | Contoh | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | Fungsi | Blok kode yang dapat digunakan kembali untuk mengeksekusi fungsionalitas tertentu saat dipanggil. | print(), len(), mencari\_luas\_persegi\_panjang() | | Built-in functions | Kumpulan fungsi yang sudah terintegrasi dengan bahasa pemrograman Python sehingga tidak perlu mengimpor **modul** atau **library** tambahan. | print(), len(), range() | | User-defined functions | Jenis fungsi yang kita definisikan sendiri untuk melakukan tugas spesifik tertentu. | mencari\_luas\_persegi\_panjang() | | Modul | File berisi kode Python berupa **fungsi**, kelas, dan sebagainya. | Math, dan semua file yang kita buat sendiri dengan ekstensi ".py" (main.py, var.py, dan lain sebagainya) | | Package | Sebuah direktori berisi satu atau lebih **modul** yang terkait dan saling berhubungan. | NumPy, Pandas | | Library | Koleksi dari banyaknya **modul dan paket** yang saling terkait dan dapat digunakan berulang kali. | Matplotlib, TensorFlow, Beautiful Soup | Kerap kali kita salah mengartikan library, package, dan modul. Ketiga hal tersebut sebenarnya saling berkaitan. Misalnya, terkadang ketika menyebut NumPy sebagai library, sebenarnya itu sah-sah saja karena library berisi package dan juga modul. ## Kegunaan Fungsi  Mengapa kita harus menggunakan fungsi dalam pemrograman? Sebenarnya terdapat banyak sekali kegunaan fungsi yang dapat menyelesaikan masalah pada pemrograman. Beberapa kegunaannya sebagai berikut. 1. Program dapat dipecah menjadi bagian yang lebih kecil (sub). [![dos:ebf73bd121f15f7f3f3803e654b6255820230821200321.png](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:ebf73bd121f15f7f3f3803e654b6255820230821200321.png)](# "dos:ebf73bd121f15f7f3f3803e654b6255820230821200321.png") Ketika membuat kode program yang kompleks, Anda bisa membagi setiap programnya menjadi bagian-bagian kecil dengan mendefinisikan fungsi, dan di dalamnya setiap fungsi dapat dipanggil sebagai satu baris atau ekspresi dalam program utama. 2. Penggunaan ulang kode alih-alih menulis ulang kode. [![dos:51043f9d20256a385161aedf9744eaeb20230821200342.png](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:51043f9d20256a385161aedf9744eaeb20230821200342.png)](# "dos:51043f9d20256a385161aedf9744eaeb20230821200342.png") Ketika Anda merasa perlu membuat kode yang berulang-ulang, pemrograman akan menjadi lebih efisien jika kode tersebut diorganisasikan sebagai sebuah fungsi. Contohnya fungsi untuk mencari luas persegi panjang akan sangat berguna dalam berbagai jenis persoalan dengan nilai panjang dan lebar yang berbeda. 3. Setiap fungsi bersifat independen dan dapat diuji secara terpisah. [![dos:0ff839b28a4fb293f8ea4f61149e734820230821200403.png](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:0ff839b28a4fb293f8ea4f61149e734820230821200403.png)](# "dos:0ff839b28a4fb293f8ea4f61149e734820230821200403.png") Setiap fungsi bersifat independen, artinya Anda dapat menguji setiap fungsi tersebut dalam interpreter (mode interaktif Python) tanpa perlu membuat program utuh terlebih dahulu. Ketika bekerja dalam program yang lebih kompleks dan melibatkan banyak programmer, hal ini juga mempermudah pembagian tugas masing-masing. ## Mendefinisikan Fungsi dalam Python Baiklah, Anda sudah memahami secara mendasar tentang fungsi dan kegunaannya. Mari kita mulai membuat fungsi sendiri (*user-defined functions*). Secara umum, fungsi terdiri dari **header**, **body**, dan **return**, seperti gambar berikut. [![dos:8206efc98054c60d1c91e638d1f9ff9a20230821195745.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:8206efc98054c60d1c91e638d1f9ff9a20230821195745.jpeg)](# "dos:8206efc98054c60d1c91e638d1f9ff9a20230821195745.jpeg") Dengan catatan sebagai berikut. 1. *Function header* memberi tahu Python bahwa kita mulai mendefinisikan suatu fungsi. 2. *Function body* adalah blok kode yang diindentasi setelah header fungsi menentukan hal yang dilakukan fungsi tersebut. Kita menentukan semua kode yang akan dibuat dalam *function body*. Ingat bahwa bagian ini adalah blok kode sehingga Anda harus memperhatikan indentasi untuk menghindari kesalahan. 3. *Function return* adalah pernyataan yang digunakan dalam fungsi untuk mengembalikan nilai atau hasil eksekusi dari fungsi tersebut. Ketika sebuah fungsi dieksekusi, biasanya ada situasi bahwa kita ingin mendapatkan nilai atau hasil dari proses yang dilakukan oleh fungsi tersebut. Untuk itu, kita menggunakan pernyataan 'return' dalam fungsi untuk mengembalikan nilai kepada pemanggil fungsi. ### Membuat Fungsi Mari kita gunakan kembali fungsi yang sempat disebut di awal. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang,lebar): luas_persegi_panjang = panjang*lebar return luas_persegi_panjang ``` Ingat bahwa permasalahan yang ingin diselesaikan adalah kita tidak ingin mengulang untuk menulis rumus luas persegi panjang. Jadi, kita menggunakan fungsi untuk membungkus rumus tersebut. Perhatikan gambar di bawah ini untuk lebih menjelaskan setiap elemen fungsi. [![dos:4da1b6deac6e0d0cb5d554f67432f21220230821195745.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:4da1b6deac6e0d0cb5d554f67432f21220230821195745.jpeg)](# "dos:4da1b6deac6e0d0cb5d554f67432f21220230821195745.jpeg") Fungsi yang kita buat sebelumnya terdiri dari beberapa elemen, yakni berikut. 1. **def** digunakan sebagai pernyataan bahwa kita membuat fungsi. 2. "**mencari\_luas\_persegi\_panjang**" merupakan nama fungsi yang kita tentukan. 3. Setiap fungsi memiliki **parameter** bertujuan untuk menyimpan nilai yang akan digunakan oleh fungsi dalam proses eksekusinya. Dalam contoh mencari luas persegi panjang, parameter "panjang, lebar" akan menyimpan setiap input yang masuk, seperti jika Anda memasukkan panjang 5cm dan lebar 10cm. 4. Setiap definisi fungsi harus diakhiri dengan ***colon*** **atau titik dua ":"** untuk menandakan awal blok kode fungsi. 5. Setelah **function header** selesai, selanjutnya kita definisikan **function body** yang berisi kode untuk dieksekusi. Dalam contoh mencari luas persegi panjang, kita memasukkan rumus luas persegi di bagian ini. Hasil dari rumus tersebut disimpan dalam variabel "luas\_persegi\_panjang". 6. Terakhir, kita menggunakan **return keyword** yang merupakan bagian dari **return statement**. Return statement bertujuan untuk mengembalikan nilai atau hasil eksekusi fungsi tersebut. Dalam contoh di atas, kita mengembalikan variabel "luas\_persegi\_panjang" sebagai hasil dari proses eksekusi fungsi. ### Memanggil Fungsi Sekarang, bagaimana cara memanggil fungsi tersebut? Pada dasarnya, kita bisa memanggil fungsi dengan cara menuliskan nama fungsi seperti kita menggunakan "print()", "len()", dan sebagainya. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang,lebar): luas_persegi_panjang = panjang*lebar return luas_persegi_panjang mencari_luas_persegi_panjang(10,5) # Ini adalah pemanggil fungsi ``` Namun, layar tidak menampilkan hasil eksekusi dari fungsi karena kita tidak menampilkannya ke layar atau menggunakan "print()". Maka dari itu, umumnya programmer akan menggunakan variabel untuk menyimpan hasil dari eksekusi fungsi. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang,lebar): luas_persegi_panjang = panjang*lebar return luas_persegi_panjang persegi_panjang_pertama = mencari_luas_persegi_panjang(5,10) print(persegi_panjang_pertama) """ Output: 50 """ ``` Dari kode di atas, secara sekuensial program akan berjalan seperti berikut. 1. Pertama, kita menggunakan fungsi bernama "**mencari\_luas\_persegi\_panjang()**" yang memiliki dua parameter, yaitu panjang dan lebar. Fungsi ini menghitung luas persegi panjang dengan mengalikan nilai panjang dan lebar serta mengembalikan hasilnya. 2. Ketika memanggil fungsi "mencari\_luas\_persegi\_panjang(5, 10)", kita menyimpan hasilnya dalam variabel bernama "**persegi\_panjang\_pertama**". Dalam pemanggilan ini, angka 5 dianggap sebagai nilai panjang dan angka 10 dianggap sebagai nilai lebar. 3. Kemudian, dalam fungsi, nilai panjang dan lebar digunakan untuk menjalankan kode "**panjang \* lebar"**. Hasil dari operasi ini disimpan dalam variabel "luas\_persegi\_panjang". 4. Selanjutnya, kita mengembalikan nilai luas\_persegi\_panjang kepada pemanggil fungsi dengan menggunakan pernyataan "return". 5. Sekarang, nilai yang dikembalikan oleh fungsi tersebut disimpan dalam variabel "persegi\_panjang\_pertama" sehingga kita dapat mencetaknya ke layar menggunakan fungsi "print(persegi\_panjang\_pertama)". Ke depannya, kita bisa menggunakan variabel tersebut berulang-ulang. Secara struktur, pemanggil fungsi terdiri beberapa elemen, yakni berikut. [![dos:7a967ccf3f3526c2cb6bfa40cfeb348320230821195745.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:7a967ccf3f3526c2cb6bfa40cfeb348320230821195745.jpeg)](# "dos:7a967ccf3f3526c2cb6bfa40cfeb348320230821195745.jpeg") Ketika Anda memanggil sebuah fungsi, ada dua elemen sebagai berikut. 1. Nama fungsi; tentu Anda harus menyebutkan nama fungsi yang ingin digunakan. Namun ingat, gunakan kurung tutup "()" untuk memanggilnya. 2. Argumen bisa dikatakan sebagai nilai yang diberikan kepada fungsi. Nantinya, nilai tersebut akan disimpan dalam parameter fungsi. Pada contoh fungsi di atas, argumen 5 dan 10 merepresentasikan parameter panjang dan lebar dalam fungsi "mencari\_luas\_persegi\_panjang()" yang kita buat sebelumnya. ### Docstring Terakhir, untuk membuat fungsi lebih mudah dipahami oleh programmer lain, kita bisa membuat **dokumentasi berupa** ***docstring***. *Docstring* adalah akronim dari *documentation string*, bertujuan untuk membuat dokumentasi terhadap fungsi yang dibuat. Umumnya, dokumentasi yang dijelaskan berupa argumen, return, deskripsi fungsi, dan sebagainya. Mari lihat contoh penerapannya di bawah ini. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang,lebar): """ Fungsi ini digunakan untuk menghitung luas persegi panjang. Args: panjang (int): Panjang persegi panjang. lebar (int): Lebar persegi panjang. Returns: int: Luas persegi panjang hasil perhitungan. """ luas_persegi_panjang = panjang*lebar return luas_persegi_panjang persegi_panjang_pertama = mencari_luas_persegi_panjang(5,10) print(persegi_panjang_pertama) """ Output: 50 """ ``` Pada kode di atas, kita mendefinisikan docstring dengan memberikan blok komentar dengan tiga double quote (""") tepat di bawah "def" keyword. Hal ini untuk menegaskan sebelum kode dibaca, kita harus memahami dokumentasi di bawahnya terlebih dahulu. Dokumentasi di atas memiliki tiga elemen, yakni berikut. 1. Deskripsi: Teks yang menjelaskan tujuan dari fungsi yang dibuat. Pada contoh di atas, kita mendefinisikan teks "Fungsi ini digunakan untuk menghitung luas persegi panjang" yang artinya fungsi ini ditujukan untuk menghitung luas persegi panjang. 2. Argumen: bagian yang menjelaskan argumen yang diterima oleh fungsi. Dalam contoh di atas, argumen yang diterima adalah panjang dan lebar dengan keduanya termasuk bilangan bulat atau bertipe data integer. 3. Return: Bagian ini menjelaskan nilai yang akan dikembalikan oleh fungsi. Dalam contoh di atas, fungsi akan mengembalikan nilai luas persegi panjang hasil perhitungan yang termasuk bilangan bulat atau bertipe data integer. ## Argumen dan Parameter Ingat bahwa argumen dan parameter adalah hal yang berbeda, sering kali programmer tertukar akan kedua istilah tersebut. Sederhananya, Anda bisa bayangkan **parameter seperti black box** yang akan **menampung nilai** dan **nilai tersebut adalah argumen**. Contohnya, saat Anda membuat fungsi berikut. [![dos:d67ea68f34c8e3646d66d7fc3bb307c020230821195745.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:d67ea68f34c8e3646d66d7fc3bb307c020230821195745.jpeg)](# "dos:d67ea68f34c8e3646d66d7fc3bb307c020230821195745.jpeg") Ketika Anda membuat fungsi di atas, **a, b, c** merupakan parameter. Namun pada saat Anda memanggilnya, **nilai 1, b=50,  c='Dicoding'** menjadi argumen. [![dos:a814a1590f0b64afe2c12abe17ee6c0520230821195745.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:a814a1590f0b64afe2c12abe17ee6c0520230821195745.jpeg)](# "dos:a814a1590f0b64afe2c12abe17ee6c0520230821195745.jpeg") Keterkaitan antara argumen dan parameter dapat dilihat pada gambar bergerak (GIF) berikut. [![dos:f4c3b81d37b3a5fcd4efe3f5c9116a2e20230821201037.gif](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:f4c3b81d37b3a5fcd4efe3f5c9116a2e20230821201037.gif)](# "dos:f4c3b81d37b3a5fcd4efe3f5c9116a2e20230821201037.gif") ### Argumen Argumen adalah nilai yang akan diberikan kepada fungsi. Setidaknya ada dua jenis argumen yang dikenal dalam Python. 1. *Keyword Argument*\ *Keyword Argument* adalah jenis argumen yang disertai dengan nama parameter (*identifier*) dan secara eksplisit disebutkan. Ketika nama parameter dalam sebuah argumen secara langsung disebutkan, artinya kita menggunakan keyword argument. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang,lebar): luas_persegi_panjang = panjang*lebar return luas_persegi_panjang persegi_panjang_pertama = mencari_luas_persegi_panjang(panjang=5, lebar=10) print(persegi_panjang_pertama) """ Output: 50 """ ``` Ketika kita memanggil fungsi "mencari\_luas\_persegi\_panjang" dengan menuliskan nama parameter diikuti tanda sama dengan (=) dan nilai yang ingin diberikan, itu disebut **keyword argument**. Pada contoh di atas, keyword argument "panjang=5" dan "lebar=10" diberikan saat pemanggilan fungsi. Kelebihan dari jenis argumen ini adalah walaupun kita harus menuliskan lebih banyak kata, urutan parameter fungsi tidak perlu dipikirkan. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang,lebar): luas_persegi_panjang = panjang*lebar return luas_persegi_panjang persegi_panjang_pertama = mencari_luas_persegi_panjang(lebar=10, panjang=5) print(persegi_panjang_pertama) """ Output: 50 """ ``` Contohnya pada kode di atas, kita menuliskan "lebar=10" terlebih dahulu dan diikuti oleh "panjang=5". Padahal, dalam fungsi yang kita buat urutan parameternya adalah panjang dan lebar. 2. *Positional Argument*\ Kebalikan dari *keyword* adalah *positional*, artinya Anda tidak menyebutkan nama parameter (*identifier*) secara eksplisit. Ketika memanggil fungsi, Anda hanya harus memasukkan nilai yang ingin diberikan. Namun, Anda harus mengikuti urutan dari parameter fungsi tersebut. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang,lebar): luas_persegi_panjang = panjang*lebar return luas_persegi_panjang persegi_panjang_pertama = mencari_luas_persegi_panjang(5,10) print(persegi_panjang_pertama) """ Output: 50 """ ``` Pada contoh di atas, kita memanggil fungsi "mencari\_luas\_persegi\_panjang" dengan argumen 5 dan 10. Masing-masing nilai tersebut merepresentasikan parameter panjang dan lebar. Jika kita menukar urutan nilai tersebut yang awalnya "5, 10" menjadi "10, 5", program akan menganggap panjangnya 10 dan lebarnya 5. ### Parameter Menurut [dokumentasi resmi](https://docs.python.org/3/glossary.html#term-parameter) Python, ada 5 jenis parameter yang bisa kita atur. 1. *Positional-or-Keyword*\ Jenis ini merupakan parameter default dalam Python. Dengan jenis ini, kita dapat menggunakan *positional* maupun *keyword* *argument* ketika memanggil fungsi. ```python:line-numbers theme={null} def greeting(nama, pesan): return "Halo, " + nama + "! " + pesan print(greeting("Dicoding", "Selamat pagi!")) print(greeting(pesan="Selamat sore!", nama="Dicoding")) """ Output: Halo, Dicoding! Selamat pagi! Halo, Dicoding! Selamat sore! """ ``` Pada contoh di atas, kita membuat fungsi untuk menyapa dengan parameternya adalah “**nama” dan “pesan”**. Ketika memanggil fungsi tersebut, kita bisa menggunakan dua jenis argumen, yakni **positional** dan **keyword**. 2. *Positional-Only*\ Parameter ini hanya dapat dimanfaatkan dengan menggunakan jenis argumen posisi saat pemanggilan fungsi. Parameter ini ditentukan menggunakan sintaks "/". ```python:line-numbers theme={null} def penjumlahan(a, b, /): return a + b print(penjumlahan(8, 50)) """ Output: 58 """ ``` Pada contoh di atas, kita memanggil fungsi yang telah didefinisikan menggunakan positional argument. Perhatikan juga bahwa kita mendefinisikan parameter fungsi dengan sintaks "/". Silakan ganti kode pemanggil fungsi dengan kode berikut untuk mengetahui hal yang terjadi jika kita menggunakan keyword argument. ```python theme={null} print(penjumlahan(a=3, b=5)) ``` 3. *Keyword-Only*\ Jenis ketiga adalah kebalikan dari yang sebelumnya. Kita harus menggunakan keyword argument untuk memanggil fungsi dengan jenis parameter ini. Ia ditentukan dengan sintaks "\*" (asterisk). ```python:line-numbers theme={null} def greeting(*, nama, pesan): return "Halo, " + nama + "! " + pesan print(greeting(pesan="Selamat sore!",nama="Dicoding")) """ Output: Halo, Dicoding! Selamat sore! """ ``` Pada contoh di atas, kita menggunakan keyword argument untuk memanggil fungsi yang telah dibuat. Perhatikan bahwa kita menggunakan sintaks "\*" untuk mendefinisikan bahwa parameter fungsi ini hanya bisa dipanggil menggunakan keyword argument. Silakan ganti baris pemanggil kode dengan kode di bawah ini untuk mengetahui hal yang terjadi jika kita menggunakan positional argument. ```python theme={null} print(greeting("Selamat sore!","Dicoding")) ``` 4. *Var-Positional* (*Variadic Positional Parameter*)\ Parameter ini menampung jumlah argumen posisi yang bervariasi saat pemanggilan fungsi. Parameter ini ditentukan dengan menggunakan sintaks **\*args**. ```python:line-numbers theme={null} def hitung_total(*args): print(type(args)) total = sum(args) return total print(hitung_total(1, 2, 3)) """ Output: 6 """ ``` Pada contoh di atas, parameter **\*args** mengumpulkan semua argumen posisi yang diberikan saat pemanggilan fungsi dan membungkusnya menjadi tuple "args". Dalam situasi ini, Anda bisa memasukkan angka sebanyak apa pun dalam argumen fungsi. Silakan tambahkan integer lainnya sebanyak yang Anda mau pada kode pemanggil fungsi di atas untuk mengetahui perbedaannya. Contohnya Anda bisa memasukan kode berikut. ```python theme={null} print(hitung_total(1, 2, 3, 4, 5, 6, 7, 8)) ``` 5. *Var-Keyword* (*Variadic Keyword Parameter*)\ Parameter ini dapat menampung jumlah keyword argument yang bervariasi saat pemanggilan fungsi. Parameter ini ditentukan dengan menggunakan sintaks \***\*kwargs** yang berperan sebagai dictionary (seperti tipe datanya). Argumen pada pemanggil fungsi akan berperan sebagai **value** dan parameter (identifier) berperan sebagai **key**. ```python:line-numbers theme={null} def cetak_info(**kwargs): info = "" for key, value in kwargs.items(): info += key + ': ' + value + ", " return info print(cetak_info(nama="Dicoding", usia="17", pekerjaan="Python Programmer")) """ Output: nama: Dicoding, usia: 17, pekerjaan: Python Programmer, """ ``` Pada contoh di atas, parameter \***\*kwargs** akan mengumpulkan semua pasangan key-value yang diberikan sebagai keyword argument. Dalam situasi ini, Anda bisa menambahkan parameter dan argumen sejumlah yang diinginkan. Silakan tambahkan keyword argument tambahan pada saat pemanggilan fungsi, seperti alamat, tempat tanggal lahir, dan sebagainya. Contohnya Anda bisa memasukan kode berikut. ```python theme={null} print(cetak_info(nama="Dicoding", usia="17", pekerjaan="Python Programmer", tempat_lahir="Bandung", lulusan="ITB")) ``` ### Fungsi Anonim (Lambda Expression) Terakhir, mari kita pelajari cara membuat fungsi tanpa mendeklarasikan **def**. Cara ini dikenal dengan ekspresi lambda yang digunakan untuk membuat fungsi tanpa perlu menyebutkan **def** ketika membuatnya. Anda bisa mengasumsikan fungsi anonim ini sebagai fungsi one-liner. Secara umum, struktur fungsi anonim sebagai berikut. [![dos:dd49bf104db4abb1fe3d6ab85adf16a020230821195745.jpeg](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:dd49bf104db4abb1fe3d6ab85adf16a020230821195745.jpeg)](# "dos:dd49bf104db4abb1fe3d6ab85adf16a020230821195745.jpeg") Kita akan menggunakan ekspresi lambda untuk melakukan operasi layaknya **def** didefinisikan. Keterkaitan antara def dan lambda dapat dilihat pada gambar bergerak (GIF) berikut. [![dos:569269a8cc44cec440aef319dab44e9020230821202944.gif](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:569269a8cc44cec440aef319dab44e9020230821202944.gif)](# "dos:569269a8cc44cec440aef319dab44e9020230821202944.gif") **Nama fungsi (func)** setara dengan nama variabel yang digunakan untuk menyimpan ekspresi lambda, **args** adalah argumen yang dibutuhkan untuk dioperasikan, dan **ret\_val** merupakan nilai yang kita kembalikan (return). Perhatikan contoh di bawah ini. Mari kita ubah contoh fungsi mencari luas persegi panjang menjadi fungsi anonim. ```python:line-numbers theme={null} mencari_luas_persegi_panjang = lambda panjang, lebar: panjang*lebar print(mencari_luas_persegi_panjang(5,10)) """ Output: 50 """ ``` Pada contoh kode di atas, kita membuat fungsi dengan nama "mencari\_luas\_persegi\_panjang" yang menjadi nama variabel. Argumen yang digunakan adalah **panjang dan lebar**, kita mendefinisikan ini tepat setelah pernyataan **lambda**. Lalu, kita menambahkan isi fungsi, yaitu **panjang\*lebar** dan hasilnya merupakan **return value**. Terakhir, pemanggilan pada fungsi anonim sama seperti biasanya. Isi fungsi dalam lambda dapat Anda ganti menjadi sebuah nilai, alih-alih variabel. Hal ini karena umumnya bertujuan untuk melakukan operasi sederhana dan perlu melibatkan fungsi yang tidak terlalu kompleks hingga perlu menggunakan **def**. Silakan ganti **panjang\*lebar** dengan nilai integer yang Anda mau untuk mengetahui maksud dari pernyataan di atas. Sebuah fungsi lambda dapat menerima argumen dalam jumlah berapa pun, tetapi hanya mengembalikan satu nilai ekspresi. Dalam contoh di atas, Anda bisa menambahkan argumen selain panjang dan lebar, tetapi hanya bisa menggunakan satu operasi, yaitu **panjang\*lebar**. ### Variabel Global dan Lokal Dalam Python, ada konsep "scope" yang mengatur jangkauan variabel dan fungsi dalam suatu program. Konsep ini lebih dikenal sebagai *scope variable* yang mengacu pada wilayah di dalam program tempat variabel dapat diakses dan digunakan. Ada dua jenis scope yang umum dijumpai, khususnya ketika Anda membuat fungsi dan program yang lebih kompleks. 1. Variabel Global\ Suatu variabel yang didefinisikan di luar fungsi atau blok kode apa pun dan dapat diakses dari seluruh bagian program. Mari lihat penerapannya di bawah ini, asumsikan bahwa kita membuat sebuah fungsi penjumlahan dengan satu nilai yang sudah ditetapkan, yaitu 10. ```python:line-numbers theme={null} a = 10 def add(b): result = a+b return result bilanganPertama = add(20) print(bilanganPertama) """ Output: 30 """ ``` Pada contoh di atas, kita mendeklarasikan **variabel a** dan menginisialisasikannya dengan nilai 10. Pada tahap ini, kita menetapkan bahwa variabel a merupakan **variabel global** dan dapat digunakan pada seluruh bagian program yang kita buat. Selanjutnya, fungsi penjumlahan didefinisikan dan akan menjumlahkan variabel a yang telah dibuat dengan bilangan yang dapat kita tentukan. Pada contoh di atas, kita menambahkan variabel a bernilai 10 dengan nilai 20 dan hasilnya adalah 30. 2. Variabel Lokal\ Variabel ini didefinisikan dalam suatu fungsi atau blok kode tertentu. Jenis ini hanya dapat diakses dari dalam fungsi atau blok kode tempat variabel tersebut didefinisikan. Mari lihat contohnya di bawah ini, asumsikan bahwa kita membuat fungsi untuk penjumlahan yang menerima dua bilangan untuk dijumlahkan. Namun, kali ini setiap dua bilangan tersebut dioperasikan akan dikurangi oleh lokal variabel bernilai 5. ```python:line-numbers theme={null} def add(a, b): lokal_var = 5 result = a+b-lokal_var return result bilanganPertama = add(10,20) print(bilanganPertama) """ Output: 25 """ ``` Pada contoh di atas, kita mendefinisikan fungsi penjumlahan bernama "add" dengan dua parameter, yakni a dan b. Dalam fungsi tersebut, kita mengoperasikan penjumlahan antara a dan b lalu dikurangi variabel lokal bernama "lokal\_var" dengan nilai 5. Ingat bahwa variabel lokal hanya dapat diakses dari dalam fungsi atau blok kode tempat variabel tersebut didefinisikan. Silakan coba cetak ke layar "lokal\_var" menggunakan fungsi **print().** Salin dan tempel kode berikut ke dalam program di atas tepat setelah perintah **print(bilanganPertama).** ```python theme={null} print(lokal_var) ``` Apa output yang dikeluarkan? Program akan menampilkan pesan error bahwa **"lokal\_var is not defined"**. Hal ini karena variabel tersebut kita definisikan dalam fungsi dan hanya dapat digunakan dalam fungsi tersebut. ## Menulis Modul pada Python Pembahasan terakhir terkait fungsi adalah kita akan mempelajari cara memanggil sebuah fungsi dari berkas lain. Masih ingat dengan modul? Ia adalah sebuah file berisi kode Python dan di dalamnya terdapat fungsi, kelas, dan sebagainya. Sebab setiap file berekstensi .py dapat direferensikan sebagai modul, Anda bisa melakukan **impor** file dari satu file ke yang lainnya. Layaknya ketika Anda menggunakan library, modul, dan sebagainya. Untuk mengikuti materi kali ini, kami rekomendasikan untuk menggunakan IDE, seperti Visual Studio Code atau PyCharm untuk memaksimalkan pembelajaran. Selain itu, kita akan membuat dua buah file. Pastikan kedua file tersebut berada dalam folder atau direktori yang sama. Mari kita mulai. 1. Pertama, buat sebuah file bernama **hello.py** berisi fungsi yang ingin kita impor. Berikut kodenya. ```python:line-numbers theme={null} def mencari_luas_persegi_panjang(panjang, lebar): luas_persegi_panjang = panjang*lebar return luas_persegi_panjang ``` Kode di atas merupakan fungsi untuk mencari luas persegi panjang dengan parameter panjang dan lebar. Kita akan memanggil fungsi ini pada file Python lain. 2. Kedua, buat sebuah file bernama **main.py**. Pastikan ia berada dalam satu folder atau direktori dengan file sebelumnya.\ [![dos:2270ee3bcd69aee7007d02ec69d4224620230821203023.png](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:2270ee3bcd69aee7007d02ec69d4224620230821203023.png)](# "dos:2270ee3bcd69aee7007d02ec69d4224620230821203023.png")Pada file main.py, masukkan kode pemanggil fungsi berikut. ```python:line-numbers theme={null} import hello persegi_panjang_pertama = hello.mencari_luas_persegi_panjang(5,10) print(persegi_panjang_pertama) ``` Pertama, kita perlu mengimpor file berisi fungsi yang sebelumnya dibuat dengan cara mendefinisikan "import hello". Ingat bahwa hello adalah nama file kita sebelumnya. Baris kedua dan seterusnya adalah cara yang sama dengan yang telah kita pelajari. Namun, perbedaannya adalah kita memanggil fungsi memakai cara "hello.mencari\_luas\_persegi\_panjang(5,10)" dengan hello adalah nama modul atau file yang telah kita impor. Sekarang, jalankan file main.py pada terminal Anda. Gunakan kode di bawah ini dan pastikan terminal yang Anda buka sedang berada pada direktori yang sama dengan file yang telah dibuat. ```python theme={null} python main.py ``` Hasilnya, terminal Anda akan menampilkan output program tersebut. Berikut contohnya.\ [![dos:e02856f28ef25649db6f19084615f4c220230821203220.png](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:e02856f28ef25649db6f19084615f4c220230821203220.png)](# "dos:e02856f28ef25649db6f19084615f4c220230821203220.png") 3. Ketiga, tambahkan variabel baru pada file **hello.py**.\ Selanjutnya, kita coba eksplor lebih jauh dengan menambahkan variabel baru pada file **hello.py**. Tambahkan kode di bawah ini tepat setelah fungsi yang sebelumnya dideklarasikan. ```python theme={null} nama = "Dicoding Indonesia" ``` 4. Terakhir, kembali pada file **main.py**, sekarang kita tampilkan variabel **nama** tersebut dengan menggunakan kode di bawah ini, tepat setelah pemanggilan fungsi sebelumnya. ```python theme={null} print(hello.nama) ``` Terlihat pada kode di atas bahwa untuk menampilkan variabel kita tidak menggunakan kurung tutup "()" seperti pada saat pemanggilan fungsi. Namun, kita tetap menggunakan "hello" sebagai modul yang telah kita impor sebelumnya. Untuk catatan, Anda juga bisa mengimpor variabel atau fungsi secara spesifik dari suatu modul. Dalam contoh di atas, artinya Anda bisa langsung mengimpor fungsi “mencari\_luas\_persegi\_panjang” dan variabel “nama” dari modul hello. ```python:line-numbers theme={null} from hello import mencari_luas_persegi_panjang, nama persegi_panjang_pertama = mencari_luas_persegi_panjang(5,10) print(persegi_panjang_pertama) print(nama) ``` Pada contoh di atas, kita melakukan impor fungsi dan variabel secara spesifik dari modul hello. Jika Anda cermati, sekarang kita tidak perlu menyebutkan hello pada setiap kode yang berhasil diimpor dari modul hello. Contohnya pada perintah menampilkan nama ke layar, sekarang kita cukup menyebutkan “print(nama)” dibanding “print(hello.nama)”. Pada kode di bawah ini, kita melakukan impor fungsi “mencari\_luas\_persegi\_panjang” dan variabel “nama” dari modul hello. ```python theme={null} from hello import mencari_luas_persegi_panjang, nama ``` Kode setelah “from” adalah nama modul yang ingin diimpor, sedangkan kode setelah “import” adalah nama fungsi dan variabel yang ingin kita impor. Sebenarnya, impor tidak hanya terbatas pada fungsi dan variabel, Anda juga bisa mengimpor kelas, method, dan sebagainya. Terakhir, berikut adalah tampilan ketika kita menjalankan file dengan cara yang disebutkan di atas.\ [![dos:84467280aaafb7e6809af288af5f7c0620230821203431.png](https://dicoding-web-img.sgp1.cdn.digitaloceanspaces.com/original/academy/dos:84467280aaafb7e6809af288af5f7c0620230821203431.png)](# "dos:84467280aaafb7e6809af288af5f7c0620230821203431.png") Kita sudah menyelesaikan seluruh materi mengenai fungsi pada Python, mari kita lanjut pada jenis subprogram kedua, yakni prosedur.