Selain pernyataan baru saja diperkenalkan, Python menggunakan pernyataan kontrol aliran yang biasa dikenal dari bahasa lain, dengan beberapa twist.
4.1. Pernyataan >>> a = ['Mary', 'had', 'a', 'little', 'lamb']
>>> for i in range[len[a]]:
... print[i, a[i]]
...
0 Mary
1 had
2 a
3 little
4 lamb
7
Mungkin tipe pernyataan yang paling terkenal adalah pernyataan . Sebagai contoh:
>>> x = int[input["Please enter an integer: "]] Please enter an integer: 42 >>> if x >> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb7 ...
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb9 ...
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb9 ... adalah urutan pengganti untuk pernyataan
>>> range[10] range[0, 10]5 atau
>>> range[10] range[0, 10]6 yang ditemukan dalam bahasa lain.
If you're comparing the same value to several constants, or checking for specific types or attributes, you may also find the
>>> range[10] range[0, 10]7 statement useful. For more details see .
4.2. Pernyataan >>> range[10]
range[0, 10]
8
Pernyataan dalam Python sedikit berbeda dari apa yang mungkin Anda gunakan di C atau Pascal. Alih-alih selalu mengulangi perkembangan angka dalam aritmatika [seperti dalam Pascal], atau memberikan pengguna kemampuan untuk menentukan langkah iterasi dan kondisi berhenti [seperti C], Python pernyataan
>>> range[10] range[0, 10]8 diulangi pada item-item dari urutan apa pun [daftar list atau string], dalam urutan yang muncul dalam urutan. Misalnya [tidak ada permainan kata-kata]:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
Kode yang memodifikasi koleksi collection sambil mengulangi koleksi yang sama bisa sulit untuk diperbaiki. Sebagai gantinya, biasanya lebih mudah untuk mengulang salinan koleksi atau membuat koleksi baru:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status
4.3. Fungsi
Jika Anda perlu mengulangi urutan angka, fungsi bawaan berguna. Ini menghasilkan urutan pregressions aritmatika:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 4
Titik akhir yang diberikan tidak pernah menjadi bagian dari urutan yang dihasilkan;
>>> sum[range[4]] # 0 + 1 + 2 + 3 63 menghasilkan 10 nilai, indeks sah legal untuk item dengan urutan panjang 10. Dimungkinkan untuk membiarkan rentang mulai dari nomor lain, atau untuk menentukan kenaikan yang berbeda [bahkan negatif; kadang-kadang ini disebut 'step']:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]
Untuk beralih pada indeks urutan, Anda dapat menggabungkan dan sebagai berikut:
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb
Dalam kebanyakan kasus seperti itu, bagaimanapun, lebih mudah untuk menggunakan fungsi , lihat .
Hal aneh terjadi jika Anda hanya mencetak rentang range:
>>> range[10] range[0, 10]
Dalam banyak hal objek dikembalikan oleh berperilaku seolah-olah itu adalah daftar list, tetapi sebenarnya tidak. Ini adalah objek yang mengembalikan item berurutan dari urutan yang diinginkan ketika Anda mengulanginya, tetapi itu tidak benar-benar membuat daftar list, sehingga menghemat ruang.
Kami mengatakan bahwa objek seperti itu adalah , yaitu, cocok sebagai target untuk fungsi dan konstruksi yang mengharapkan sesuatu dari mana mereka dapat memperoleh item berturut-turut sampai pasokan habis. Kita telah melihat bahwa pernyataan adalah konstruksi seperti itu, sedangkan contoh fungsi yang membutuhkan sebuah iterable adalah :
>>> sum[range[4]] # 0 + 1 + 2 + 3 6
Later we will see more functions that return iterables and take iterables as arguments. In chapter , we will discuss in more detail about .
4.4. Pernyataan >>> for n in range[2, 10]:
... for x in range[2, n]:
... if n % x == 0:
... print[n, 'equals', x, '*', n//x]
... break
... else:
... # loop fell through without finding a factor
... print[n, 'is a prime number']
...
2 is a prime number
3 is a prime number
4 equals 2 * 2
5 is a prime number
6 equals 2 * 3
7 is a prime number
8 equals 2 * 4
9 equals 3 * 3
1 dan >>> for n in range[2, 10]:
... for x in range[2, n]:
... if n % x == 0:
... print[n, 'equals', x, '*', n//x]
... break
... else:
... # loop fell through without finding a factor
... print[n, 'is a prime number']
...
2 is a prime number
3 is a prime number
4 equals 2 * 2
5 is a prime number
6 equals 2 * 3
7 is a prime number
8 equals 2 * 4
9 equals 3 * 3
2, dan >>> range[10]
range[0, 10]
0 Klausa pada Perulangan Loops
Pernyataan , seperti dalam C, keluar dari bagian terdalam yang terlampir perulangan atau .
Pernyataan perulangan loop mungkin memiliki klausa
>>> range[10] range[0, 10]0; itu dieksekusi ketika loop berakhir melalui selesainya exhaustion iterable [dengan ] atau ketika kondisi menjadi salah [dengan ], tetapi tidak ketika loop diakhiri oleh pernyataan . Ini dicontohkan oleh perulangan berikut, yang mencari bilangan prima:
>>> for n in range[2, 10]: ... for x in range[2, n]: ... if n % x == 0: ... print[n, 'equals', x, '*', n//x] ... break ... else: ... # loop fell through without finding a factor ... print[n, 'is a prime number'] ... 2 is a prime number 3 is a prime number 4 equals 2 * 2 5 is a prime number 6 equals 2 * 3 7 is a prime number 8 equals 2 * 4 9 equals 3 * 3
[Ya, ini adalah kode yang benar. Perhatikan baik-baik: klausul
>>> range[10] range[0, 10]0 milik perulangan , not pernyataan .]
Ketika digunakan dengan sebuah perulangan, klausa
>>> range[10] range[0, 10]0 memiliki lebih banyak kesamaan dengan klausa
>>> range[10] range[0, 10]0 dari pernyataan dibandingkan dengan pernyataan : sebuah klausa
>>> range[10] range[0, 10]0 pernyataan berjalan ketika tidak ada pengecualian terjadi, dan klausa
>>> range[10] range[0, 10]0 perulangan berjalan ketika tidak ada
>>> for n in range[2, 10]: ... for x in range[2, n]: ... if n % x == 0: ... print[n, 'equals', x, '*', n//x] ... break ... else: ... # loop fell through without finding a factor ... print[n, 'is a prime number'] ... 2 is a prime number 3 is a prime number 4 equals 2 * 2 5 is a prime number 6 equals 2 * 3 7 is a prime number 8 equals 2 * 4 9 equals 3 * 31 terjadi. Untuk lebih lanjut tentang pernyataan
>>> for num in range[2, 10]: ... if num % 2 == 0: ... print["Found an even number", num] ... continue ... print["Found an odd number", num] ... Found an even number 2 Found an odd number 3 Found an even number 4 Found an odd number 5 Found an even number 6 Found an odd number 7 Found an even number 8 Found an odd number 96 dan pengecualian, lihat .
Pernyataan , juga dipinjam dari C, melanjutkan dengan pengulangan berikutnya dari loop:
>>> for num in range[2, 10]: ... if num % 2 == 0: ... print["Found an even number", num] ... continue ... print["Found an odd number", num] ... Found an even number 2 Found an odd number 3 Found an even number 4 Found an odd number 5 Found an even number 6 Found an odd number 7 Found an even number 8 Found an odd number 9
4.5. Pernyataan >>> # Measure some strings:
... words = ['cat', 'window', 'defenestrate']
>>> for w in words:
... print[w, len[w]]
...
cat 3
window 6
defenestrate 12
04
Pernyataan tidak melakukan apa-apa. Ini dapat digunakan ketika pernyataan diperlukan secara sintaksis tetapi program tidak memerlukan tindakan. Sebagai contoh:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 120
Ini biasanya digunakan untuk membuat kelas minimal:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 121
Tempat lain dapat digunakan adalah sebagai tempat-penampung place-holder untuk fungsi atau badan bersyarat conditional body saat Anda bekerja pada kode baru, memungkinkan Anda untuk terus berpikir pada tingkat yang lebih abstrak.
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1204 diabaikan secara diam-diam:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 122
4.6. >>> range[10]
range[0, 10]
7 Statements
A statement takes an expression and compares its value to successive patterns given as one or more case blocks. This is superficially similar to a switch statement in C, Java or JavaScript [and many other languages], but it's more similar to pattern matching in languages like Rust or Haskell. Only the first pattern that matches gets executed and it can also extract components [sequence elements or object attributes] from the value into variables.
The simplest form compares a subject value against one or more literals:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 123
Note the last block: the "variable name"
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1210 acts as a wildcard and never fails to match. If no case matches, none of the branches is executed.
You can combine several literals in a single pattern using
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1211 ["or"]:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 124
Patterns can look like unpacking assignments, and can be used to bind variables:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 125
Study that one carefully! The first pattern has two literals, and can be thought of as an extension of the literal pattern shown above. But the next two patterns combine a literal and a variable, and the variable binds a value from the subject [
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1212]. The fourth pattern captures two values, which makes it conceptually similar to the unpacking assignment
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1213.
If you are using classes to structure your data you can use the class name followed by an argument list resembling a constructor, but with the ability to capture attributes into variables:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 126
You can use positional parameters with some builtin classes that provide an ordering for their attributes [e.g. dataclasses]. You can also define a specific position for attributes in patterns by setting the
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1214 special attribute in your classes. If it's set to ["x", "y"], the following patterns are all equivalent [and all bind the
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1215 attribute to the
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1216 variable]:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 127
A recommended way to read patterns is to look at them as an extended form of what you would put on the left of an assignment, to understand which variables would be set to what. Only the standalone names [like
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1216 above] are assigned to by a match statement. Dotted names [like
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1218], attribute names [the
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1219 and
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1220 above] or class names [recognized by the "[...]" next to them like
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1221 above] are never assigned to.
Patterns can be arbitrarily nested. For example, if we have a short list of points, we could match it like this:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 128
We can add an
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb7 clause to a pattern, known as a "guard". If the guard is false,
>>> range[10] range[0, 10]7 goes on to try the next case block. Note that value capture happens before the guard is evaluated:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 129
Several other key features of this statement:
Like unpacking assignments, tuple and list patterns have exactly the same meaning and actually match arbitrary sequences. An important exception is that they don't match iterators or strings.
Sequence patterns support extended unpacking:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
24 and>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
25 work similar to unpacking assignments. The name after>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
26 may also be>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
10, so>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
28 matches a sequence of at least two items without binding the remaining items.Mapping patterns:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
29 captures the>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
30 and>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
31 values from a dictionary. Unlike sequence patterns, extra keys are ignored. An unpacking like>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
32 is also supported. [But>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
33 would be redundant, so it is not allowed.]Subpatterns may be captured using the
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
34 keyword:# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status
0will capture the second element of the input as
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
35 [as long as the input is a sequence of two points]Most literals are compared by equality, however the singletons
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
36,>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
37 and>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
38 are compared by identity.Patterns may use named constants. These must be dotted names to prevent them from being interpreted as capture variable:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status
1
For a more detailed explanation and additional examples, you can look into PEP 636 which is written in a tutorial format.
4.7. Mendefinisikan Fungsi
Kita dapat membuat fungsi yang menulis seri Fibonacci ke batas acak arbitrary:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status2
Kata kunci memperkenalkan fungsi definition. Itu harus diikuti oleh nama fungsi dan daftar parameter formal yang di dalam tanda kurung. Pernyataan yang membentuk tubuh fungsi mulai dari baris berikutnya, dan harus diberi indentasi.
Pernyataan pertama dari tubuh fungsi secara opsional dapat berupa string literal; string literal ini adalah string dokumentasi fungsi, atau docstring. [Lebih lanjut tentang docstring dapat ditemukan di bagian .] Ada alat yang menggunakan docstring untuk secara otomatis menghasilkan dokumentasi online atau cetak, atau untuk membiarkan pengguna menelusuri kode secara interaktif; itu praktik yang baik untuk memasukkan dokumen dalam kode yang Anda tulis, jadi biasakan seperti itu.
execution dari suatu fungsi memperkenalkan tabel simbol baru yang digunakan untuk variabel lokal dari fungsi tersebut. Lebih tepatnya, semua tugas variabel dalam suatu fungsi menyimpan nilai dalam tabel simbol lokal; sedangkan referensi variabel pertama-tama terlihat pada tabel simbol lokal, kemudian pada tabel simbol lokal lampiran enclosing fungsi, kemudian pada tabel simbol global, dan akhirnya pada tabel nama bawaan. Dengan demikian, variabel global dan variabel lampiran enclosing fungsi tidak dapat secara langsung menetapkan nilai dalam suatu fungsi [kecuali, untuk variabel global, disebutkan dalam pernyataan , atau, untuk variabel lampiran enclosing fungsi, dinamai dalam pernyataan ], meskipun mungkin direferensikan.
The actual parameters [arguments] to a function call are introduced in the local symbol table of the called function when it is called; thus, arguments are passed using call by value [where the value is always an object reference, not the value of the object]. When a function calls another function, or calls itself recursively, a new local symbol table is created for that call.
Definisi fungsi mengasosiasikan nama fungsi dengan objek fungsi dalam tabel simbol saat ini. Sebuah interpreter dapat mengenali objek yang ditunjuk dengan nama itu sebagai fungsi yang ditentukan oleh pengguna. Nama lain juga dapat menunjuk ke objek fungsi yang sama dan juga dapat digunakan untuk mengakses fungsi tersebut:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status3
Berasal dari bahasa lain, Anda mungkin keberatan bahwa
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1242 bukan fungsi melainkan prosedur karena tidak mengembalikan nilai. Bahkan, fungsi bahkan tanpa pernyataan mengembalikan nilai, meskipun yang agak membosankan. Nilai ini disebut
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1238 [ini adalah nama bawaan]. Menulis nilai
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1238 biasanya dihilangkan suppressed oleh interpreter jika itu akan menjadi satu-satunya nilai yang ditulis. Anda dapat melihatnya jika Anda benar-benar ingin menggunakan :
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status4
Sangat mudah untuk menulis fungsi yang mengembalikan daftar list nomor seri Fibonacci, alih-alih mencetaknya:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status5
Contoh ini, seperti biasa, menunjukkan beberapa fitur Python baru:
Pernyataan kembali dengan nilai dari suatu fungsi.
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
43 tanpa argumen ekspresi mengembalikan>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
38. Keluar dari akhir suatu fungsi juga mengembalikan>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
38.Pernyataan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
51 memanggil method dari objek daftar list>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
52. Sebuah metode adalah fungsi yang 'milik' sebuah objek dan dinamai>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
53, di mana>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
54 adalah suatu objek [ini mungkin sebuah ekspresi], dan>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
55 adalah nama dari metode yang ditentukan oleh tipe objek. Jenis yang berbeda menentukan metode yang berbeda. Metode tipe yang berbeda mungkin memiliki nama yang sama tanpa menimbulkan ambiguitas. [Dimungkinkan untuk menentukan jenis dan metode objek Anda sendiri, menggunakan classes, lihat ] Metode>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
56 yang ditunjukkan pada contoh didefinisikan untuk objek daftar; itu menambahkan elemen baru di akhir daftar. Dalam contoh ini setara dengan>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
57, tetapi lebih efisien.
4.8. Lebih lanjut tentang Mendefinisikan Fungsi
Dimungkinkan juga untuk mendefinisikan fungsi dengan sejumlah variabel argumen. Ada tiga bentuk, yang bisa digabungkan.
4.8.1. Nilai Argumen Bawaan
Bentuk yang paling berguna adalah menentukan nilai bawaan untuk satu atau lebih argumen. Ini menciptakan fungsi yang bisa dipanggil dengan argumen yang lebih sedikit daripada yang didefinisikan untuk diizinkan. Sebagai contoh:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status6
Fungsi ini dapat dipanggil dengan beberapa cara:
hanya memberikan argumen wajib:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
58memberikan salah satu argumen opsional:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
59atau bahkan memberikan semua argumen:
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 12
60
Contoh ini juga memperkenalkan kata kunci . Ini menguji apakah suatu urutan berisi nilai tertentu atau tidak.
Nilai bawaan dievaluasi pada titik definisi fungsi dalam lingkup defining, sehingga:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status7
akan mencetak
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1262.
Peringatan penting: Nilai bawaan dievaluasi hanya sekali. Ini membuat perbedaan ketika bawaan adalah objek yang dapat diubah seperti daftar list, kamus dictionary, atau instances dari sebagian besar kelas. Misalnya, fungsi berikut mengakumulasi argumen yang diteruskan pada panggilan berikutnya:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status8
Ini akan mencetak:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status9
Jika Anda tidak ingin bawaan dibagi dengan panggilan berikutnya, Anda dapat menulis fungsi seperti ini sebagai gantinya:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 40
4.8.2. Argumen Kata Kunci Keyword Arguments
Fungsi juga dapat dipanggil menggunakan dari bentuk
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1263. Misalnya, fungsi berikut:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 41
menerima satu argumen yang diperlukan [
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1264] dan tiga argumen opsional [
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1265,
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1266, dan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1267]. Fungsi ini dapat dipanggil dengan salah satu cara berikut:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 42
tetapi semua pemanggilan berikut ini tidak valid:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 43
Dalam pemanggilan fungsi, argumen kata kunci keyword argument harus mengikuti argumen posisi. Semua argumen kata kunci keyword argument yang diteruskan harus cocok dengan salah satu argumen yang diterima oleh fungsi [mis.
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1268 bukan argumen yang valid untuk fungsi
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1269], dan urutannya tidak penting. Ini juga termasuk argumen non-opsional [mis.
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1270 juga valid]. Tidak ada argumen yang dapat menerima nilai lebih dari sekali. Berikut ini contoh yang gagal karena batasan ini:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 44
Ketika parameter formal terakhir dari bentuk
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1271 ada, ia menerima kamus dictionary [lihat ] yang berisi semua argumen kata kunci keyword argument kecuali yang terkait dengan parameter formal. Ini dapat digabungkan dengan parameter formal dari bentuk
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1272 [dijelaskan dalam subbagian berikutnya] yang menerima yang berisi argumen posisi di luar daftar parameter formal. [
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1272 harus ada sebelum
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1271.] Misalnya, jika kita mendefinisikan fungsi seperti ini:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 45
Ini bisa disebut seperti ini:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 46
dan tentu saja itu akan mencetak:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 47
Perhatikan bahwa bagaimana urutan argumen kata kunci dicetak telah dijamin sesuai dengan urutan yang disediakan dalam pemanggilan fungsi.
4.8.3. Parameter spesial
Secara bawaan, argumen dapat diteruskan ke fungsi Python baik dengan posisi atau secara eksplisit oleh kata kunci. Untuk keterbacaan dan kinerja, masuk akal untuk membatasi cara argumen dapat dilewatkan sehingga pengembang hanya perlu melihat definisi fungsi untuk menentukan apakah item dilewatkan secara posisi saja, posisi atau kata kunci, atau kata kunci saja.
Definisi fungsi mungkin terlihat seperti:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 48
di mana
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 dan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1226 adalah opsional. Jika digunakan, simbol-simbol ini menunjukkan jenis parameter dengan cara argumen dilewatkan ke fungsi: posisi-saja, posisi-atau-kata kunci, dan kata kunci-saja. Parameter kata kunci juga disebut sebagai parameter bernama.
4.8.3.1. Argumen Posisi-atau-Kata Kunci
Jika
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 dan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1226 tidak ada dalam definisi fungsi, argumen dapat diteruskan ke fungsi dengan posisi atau kata kunci.
4.8.3.2. Parameter Posisi-saja
Melihat ini sedikit lebih detail, dimungkinkan untuk menandai parameter tertentu sebagai positional-only. Jika positional-only, urutan parameter penting, dan parameter tidak dapat dilewatkan dengan kata kunci. Parameter posisi-saja ditempatkan sebelum
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 [garis miring].
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 Digunakan untuk secara logis memisahkan parameter posisi-saja dari parameter lainnya. Jika tidak ada
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 dalam definisi fungsi, tidak ada parameter posisi-saja.
Parameter yang mengikuti
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 dapat berupa positional-or-keyword atau keyword-only.
4.8.3.3. Argumen Kata Kunci-saja
Untuk menandai parameter sebagai keyword-only, yang menunjukkan parameter harus dilewatkan dengan argumen kata kunci, tempatkan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1226 dalam daftar argumen tepat sebelum parameter keyword-only.
4.8.3.4. Contoh Fungsi
Perhatikan definisi fungsi contoh berikut dengan memperhatikan marker
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 dan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1226:
>>> for i in range[5]: ... print[i] ... 0 1 2 3 49
Definisi fungsi pertama,
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1286, bentuk yang paling akrab, tidak menempatkan batasan pada konvensi pemanggilan dan argumen dapat dilewatkan dengan posisi atau kata kunci:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]0
Fungsi kedua
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1287 dibatasi hanya menggunakan parameter posisi karena ada
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 dalam definisi fungsi:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]1
Fungsi ketiga
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1289 hanya memungkinkan argumen kata kunci keyword argument seperti ditunjukkan oleh
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1226 dalam definisi fungsi:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]2
Dan yang terakhir menggunakan ketiga konvensi pemanggilan dalam definisi fungsi yang sama:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]3
Akhirnya, pertimbangkan definisi fungsi ini yang memiliki potensi tabrakan antara argumen posisi
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1291 dan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1292 yang memiliki
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1291 sebagai kunci:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]4
Tidak ada kemungkinan panggilan yang memungkinkan untuk mengembalikan ke dalam True'' karena kata kunci `` 'nama' 'akan selalu terikat ke parameter pertama. Sebagai contoh:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]5
Tetapi menggunakan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1275 [argumen posisi saja], ini dimungkinkan karena memungkinkan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1291 sebagai argumen posisi dan
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1296 sebagai kunci dalam argumen kata kunci keyword argument:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]6
Dengan kata lain, nama-nama parameter posisi-saja dapat digunakan dalam
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1292 tanpa ambiguitas.
4.8.3.5. Rekap
Contoh kasus dimana akan menentukan parameter mana yang akan digunakan dalam definisi fungsi:
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]7
Sebagai pedoman:
Gunakan posisi-saja jika Anda ingin nama parameter tidak tersedia bagi pengguna. Ini berguna ketika nama parameter tidak memiliki arti nyata, jika Anda ingin menegakkan urutan argumen ketika fungsi dipanggil atau jika Anda perlu mengambil beberapa parameter posisi dan kata kunci bergantian arbitrary.
Gunakan kata kunci-saja ketika nama memiliki makna dan definisi fungsi lebih mudah dipahami dengan secara eksplisit menggunakan nama atau Anda ingin mencegah pengguna mengandalkan posisi argumen yang dikirimkan.
Untuk API, gunakan posisi-saja untuk mencegah perubahan yang merusak dari API jika nama parameter diubah di masa mendatang.
4.8.4. Daftar Argumen Berubah-ubah Arbitrary
Akhirnya, opsi yang paling jarang digunakan adalah menentukan bahwa suatu fungsi dapat dipanggil dengan sejumlah argumen acak arbitrary. Argumen-argumen ini akan dibungkus dalam sebuah tuple [lihat tuttuples]. Sebelum jumlah variabel argumen, nol atau lebih argumen normal dapat muncul.
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]8
Normally, these variadic arguments will be last in the list of formal parameters, because they scoop up all remaining input arguments that are passed to the function. Any formal parameters which occur after the
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1298 parameter are 'keyword-only' arguments, meaning that they can only be used as keywords rather than positional arguments.
>>> list[range[5, 10]] [5, 6, 7, 8, 9] >>> list[range[0, 10, 3]] [0, 3, 6, 9] >>> list[range[-10, -100, -30]] [-10, -40, -70]9
4.8.5. Pembukaan Paket Unpacking Daftar Argumen
Situasi sebaliknya terjadi ketika argumen sudah ada dalam daftar list atau tuple tetapi perlu dibongkar untuk panggilan fungsi yang membutuhkan argumen posisi terpisah. Sebagai contoh, fungsi bawaan mengharapkan argumen terpisah start dan stop. Jika tidak tersedia secara terpisah, tulis fungsi panggilan dengan operator-
>>> # Measure some strings: ... words = ['cat', 'window', 'defenestrate'] >>> for w in words: ... print[w, len[w]] ... cat 3 window 6 defenestrate 1226 untuk membongkar argumen dari daftar list atau tuple:
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb0
Dengan cara yang sama, kamus dapat mengirimkan argumen kata kunci dengan operator-
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status01:
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb1
4.8.6. Ekspresi Lambda
Fungsi kecil anonim dapat dibuat dengan kata kunci . Fungsi ini mengembalikan jumlah dari dua argumennya:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status03. Fungsi Lambda dapat digunakan di mana pun objek fungsi diperlukan. Mereka secara sintaksis terbatas pada satu ekspresi. Secara semantik, mereka hanya pemanis sintaksis untuk definisi fungsi normal. Seperti definisi fungsi bersarang, fungsi lambda dapat mereferensikan variabel dari cakupan yang mengandung
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb2
Contoh di atas menggunakan ekspresi lambda untuk mengembalikan fungsi. Penggunaan lain adalah untuk melewatkan fungsi kecil sebagai argumen:
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb3
4.8.7. String Dokumentasi
Berikut adalah beberapa konvensi tentang konten dan format string dokumentasi.
Baris pertama harus selalu berupa ringkasan singkat dan ringkas dari tujuan objek. Untuk singkatnya, itu tidak boleh secara eksplisit menyatakan nama atau jenis objek, karena ini tersedia dengan cara lain [kecuali jika nama tersebut merupakan kata kerja yang menggambarkan operasi fungsi]. Baris ini harus dimulai dengan huruf kapital dan diakhiri dengan titik.
Jika ada lebih banyak baris dalam string dokumentasi, baris kedua harus kosong, memisahkan ringkasan secara visual dari sisa deskripsi. Baris berikut harus satu atau lebih paragraf yang menggambarkan konvensi pemanggilan objek, efek sampingnya, dll.
Pengurai Python tidak menghapus lekukan dari string multi-baris literal di Python, jadi alat yang memproses dokumentasi harus menghapus indentasi jika diinginkan. Ini dilakukan dengan menggunakan konvensi berikut. Baris tidak-kosong pertama setelah baris pertama string menentukan jumlah indentasi untuk seluruh string dokumentasi. [Kami tidak dapat menggunakan baris pertama karena umumnya berbatasan dengan tanda kutip pembukaan string sehingga indentasinya tidak terlihat dalam string literal.] Spasi "equivalent" untuk indentasi ini kemudian dihilangkan dari awal semua baris string. Baris yang indentasi lebih sedikit seharusnya tidak terjadi, tetapi jika terjadi semua spasi whitespace utama harus dihilangkan. Kesetaraan spasi harus diuji setelah ekspansi tab [hingga 8 spasi, biasanya].
Berikut adalah contoh dari multi-baris docstring:
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb4
4.8.8. Anotasi Fungsi
informasi metadata yang sepenuhnya opsional tentang jenis yang digunakan oleh fungsi yang ditentukan pengguna [lihat PEP 3107 dan PEP 484 untuk informasi lebih lanjut].
are stored in the
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status04 attribute of the function as a dictionary and have no effect on any other part of the function. Parameter annotations are defined by a colon after the parameter name, followed by an expression evaluating to the value of the annotation. Return annotations are defined by a literal
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status05, followed by an expression, between the parameter list and the colon denoting the end of the statement. The following example has a required argument, an optional argument, and the return value annotated:
>>> a = ['Mary', 'had', 'a', 'little', 'lamb'] >>> for i in range[len[a]]: ... print[i, a[i]] ... 0 Mary 1 had 2 a 3 little 4 lamb5
4.9. Intermezzo: Gaya Coding
Sekarang Anda akan menulis potongan Python yang lebih panjang dan lebih kompleks, ini adalah saat yang tepat untuk berbicara tentang coding style. Sebagian besar bahasa dapat ditulis [atau lebih ringkas, formatted] dalam gaya yang berbeda; beberapa lebih mudah dibaca daripada yang lain. Memudahkan orang lain untuk membaca kode Anda selalu merupakan ide yang baik, dan mengadopsi gaya pengkodean yang bagus sangat membantu untuk itu.
Untuk Python, PEP 8 telah muncul sebagai panduan gaya yang dipatuhi sebagian besar proyek; itu mempromosikan gaya pengkodean yang sangat mudah dibaca dan menyenangkan. Setiap pengembang Python harus membacanya di beberapa bagian; di sini adalah poin paling penting yang ditunjukkan untuk Anda:
Gunakan lekukan 4-spasi, dan tanpa tab.
4 spasi adalah kompromi yang baik antara indentasi kecil [memungkinkan kedalaman bersarang lebih besar] dan indentasi besar [lebih mudah dibaca]. Tab menimbulkan kebingungan, dan sebaiknya ditinggalkan.
Bungkus wrap garis agar tidak melebihi 79 karakter.
Ini membantu pengguna dengan tampilan kecil dan memungkinkan untuk memiliki beberapa file kode berdampingan pada tampilan yang lebih besar.
Gunakan baris kosong untuk memisahkan fungsi dan kelas, dan blok kode yang lebih besar di dalam fungsi.
Jika memungkinkan, berikan komentar pada baris terkait.
Gunakan String Dokumentasi docstrings.
Gunakan spasi di sekitar operator dan setelah koma, tetapi tidak secara langsung di dalam konstruksi kurung bracketing:
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status
07.Beri nama kelas dan fungsi Anda secara konsisten; konvensi ini menggunakan
# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status
08 untuk kelas dan# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status
09 untuk fungsi dan metode. Selalu gunakan# Create a sample collection users = {'Hans': 'active', 'Éléonore': 'inactive', '景太郎': 'active'} # Strategy: Iterate over a copy for user, status in users.copy[].items[]: if status == 'inactive': del users[user] # Strategy: Create a new collection active_users = {} for user, status in users.items[]: if status == 'active': active_users[user] = status
10 sebagai nama untuk argumen metode pertama [lihat tut-firstclass untuk lebih lanjut tentang kelas dan metode].Jangan gunakan pengkodean ajaib fancy encodings jika kode Anda dimaksudkan untuk digunakan di lingkungan internasional. Default Python, UTF-8, atau bahkan ASCII biasa berfungsi paling baik dalam hal apa pun.
Demikian juga, jangan gunakan karakter non-ASCII dalam pengidentifikasi jika hanya ada sedikit kesempatan orang berbicara bahasa yang berbeda akan membaca atau merawat kode.
Catatan kaki
Sebenarnya, call by object reference akan menjadi deskripsi yang lebih baik, karena jika objek yang bisa ditransmisikan dilewatkan, pemanggil akan melihat perubahan yang dibuat oleh yang dipanggil callee [item dimasukkan ke dalam daftar].