list

Collection

Koleksi terurut yang dapat Anda buat, baca, ulangi, ubah strukturnya, dan perbarui saat skrip berjalan.

Sintaks

list(iterable=(), /)

Nilai yang dikembalikan

list

Contoh

numbers = list()
numbers.append(2)
numbers.extend([0, 3])
first = numbers[0]        # mengembalikan 2
count = len(numbers)      # mengembalikan 3

for value in numbers:
    wait(50)              # mengembalikan None

Metode

22 metode

list.constructor

Creation Method

Buat daftar kosong atau salin item dari satu iterable ke daftar baru yang dapat diubah.

Sintaks

list()
list(iterable, /)

Parameter

Nama	Deskripsi
`iterableIterable`	Nilai sumber untuk disalin ke daftar baru. Bergantung pada bentuk pemanggilan · Hanya posisi Default: `()`

Nilai yang dikembalikan

list — Daftar baru yang bisa berubah.

Contoh

numbers = list()
numbers.append(2)
numbers.append(3)

copied = list(numbers)

list.literal

Creation Method

Buat daftar sebaris literal. Ini adalah bentuk terpendek ketika Anda sudah mengetahui itemnya.

Sintaks

[1, 2, 3]

Parameter

Nama	Deskripsi
`itemAny?`	Each item written inside the brackets. Wajib · Posisi atau nama Tanpa nilai bawaan

Nilai yang dikembalikan

list — Daftar baru yang dapat diubah mempertahankan urutan literal.

Contoh

numbers = [2, 0, 3]
first = numbers[0]       # mengembalikan 2

list.comprehension

Creation Method

Buat daftar dengan mengulang iterable lainnya. Beberapa klausa for/if didukung, dan target loop tetap bersifat lokal bagi pemahaman.

Sintaks

[expr for target in iterable if condition]

Parameter

Nama	Deskripsi
`exprAny?`	Value to append for each accepted item. Wajib · Posisi atau nama Tanpa nilai bawaan
`targetName \| destructuring target`	Loop target for the current item. Starred targets are not supported. Wajib · Posisi atau nama Tanpa nilai bawaan
`iterableIterable`	Source values to loop through. Wajib · Posisi atau nama Tanpa nilai bawaan
`conditionBoolean`	Optional filter checked before appending. Opsional · Hanya posisi Default: `True`

Nilai yang dikembalikan

list — Daftar baru yang dapat diubah dengan item yang cocok dalam urutan iterasi.

Contoh

values = [1, 2, 3, 4]
evens = [x for x in values if x % 2 == 0]

list.range_source

Creation Method

Buat daftar bilangan bulat baru untuk loop, penghitung, dan rentang angka.

Sintaks

range(stop, /) | range(start, stop, step=1, /)

Parameter

Nama	Deskripsi
`startNumber`	Start value (inclusive). Bergantung pada bentuk pemanggilan · Hanya posisi Default: `0`
`stopNumber`	End value (exclusive). Wajib · Hanya posisi Tanpa nilai bawaan
`stepNumber`	Increment between items. Cannot be 0. Bergantung pada bentuk pemanggilan · Hanya posisi Default: `1`

Nilai yang dikembalikan

list[Int] — Daftar bilangan bulat baru.

Contoh

numbers = range(5)         # mengembalikan [0, 1, 2, 3, 4]
evens = range(0, 10, 2)   # mengembalikan [0, 2, 4, 6, 8]

list.length

Method

Hitung berapa banyak item dalam daftar.

Sintaks

len(list, /)

Parameter

Nama	Deskripsi
`listlist`	The list to count. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

Int — Jumlah item dalam daftar.

Contoh

numbers = range(3, 8)     # mengembalikan [3, 4, 5, 6, 7]
count = len(numbers)      # mengembalikan 5

list.index_access

Method

Baca satu item berdasarkan indeks. Indeks negatif dihitung dari akhir.

Sintaks

list[index]

Parameter

Nama	Deskripsi
`listlist`	The source list. Wajib · Posisi atau nama Tanpa nilai bawaan
`indexInt`	Item index. Use -1 for the last item. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

Any? — Item pada posisi tersebut. Memunculkan IndexError ketika indeks berada di luar daftar.

Contoh

numbers = range(10, 15)   # mengembalikan [10, 11, 12, 13, 14]
first = numbers[0]        # mengembalikan 10
third = numbers[2]        # mengembalikan 12
last = numbers[-1]        # mengembalikan 14

list.slice

Method

Salin bagian dari daftar menggunakan pemotongan gaya Python. Batas yang dihilangkan menggunakan awal atau akhir; indeks negatif dihitung dari akhir.

Sintaks

list[start:end[:step]]

Parameter

Nama	Deskripsi
`startInt`	First item index to include. Opsional · Hanya posisi Default: `start of list`
`endInt`	Stop before this item index. Opsional · Hanya posisi Default: `end of list`
`stepInt`	Distance between items. Cannot be 0; negative values read backward. Opsional · Hanya posisi Default: `1`

Nilai yang dikembalikan

list — Potongan daftar baru yang dapat diubah, dijepit ke rentang yang tersedia.

Contoh

numbers = [0, 1, 2, 3, 4]
middle = numbers[1:4]     # mengembalikan [1, 2, 3]
tail = numbers[-2:]       # mengembalikan [3, 4]
reverse = numbers[::-1]   # mengembalikan [4, 3, 2, 1, 0]

list.index_assignment

Method

Ganti satu item yang ada berdasarkan indeks. Indeks negatif dihitung dari akhir. Indeks harus sudah ada di dalam daftar.

Sintaks

list[index] = value

Parameter

Nama	Deskripsi
`listlist`	The mutable list to update. Wajib · Posisi atau nama Tanpa nilai bawaan
`indexInt`	Item index that already exists. Use -1 for the last item. Wajib · Hanya posisi Tanpa nilai bawaan
`valueAny?`	New value to store at that position. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Daftar ini diperbarui pada tempatnya.

Contoh

numbers = [12, 12, 21, 3, 2, 1]
numbers[4] = 3            # numbers menjadi [12, 12, 21, 3, 3, 1]

list.destructuring_assignment

Method

Buka paket item daftar ke dalam target tugas yang cocok. Target bertumpuk didukung, namun target berbintang seperti *sisanya tidak didukung.

Sintaks

a, b = list

Parameter

Nama	Deskripsi
`a, bTargets`	Assignment targets matching the list item count. Wajib · Posisi atau nama Tanpa nilai bawaan
`listlist`	Source list to unpack. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Target menerima item daftar dari kiri ke kanan.

Contoh

point = [500, 900]
x, y = point

list.append

Method

Tambahkan satu item baru ke akhir daftar.

Sintaks

list.append(value, /)

Parameter

Nama	Deskripsi
`valueAny?`	The value to add. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Daftar ini diperbarui pada tempatnya.

Contoh

numbers = [2, 0]
numbers.append(3)
last = numbers[-1]        # mengembalikan 3

list.extend

Method

Tambahkan setiap item dari iterable lain ke akhir daftar saat ini.

Sintaks

list.extend(iterable, /)

Parameter

Nama	Deskripsi
`iterableIterable`	Nilai sumber yang itemnya akan ditambahkan. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Daftarnya terus bertambah.

Contoh

numbers = [1]
numbers.extend([2, 3])
count = len(numbers)      # mengembalikan 3

list.insert

Method

Sisipkan satu item sebelum indeks yang diberikan. Indeks negatif dan terlalu besar dibatasi seperti Python.

Sintaks

list.insert(index, value, /)

Parameter

Nama	Deskripsi
`indexInt`	Posisi sebelum nilai disisipkan. Wajib · Hanya posisi Tanpa nilai bawaan
`valueAny?`	Nilai yang akan disisipkan. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Daftar ini diperbarui pada tempatnya.

Contoh

numbers = [1, 3]
numbers.insert(1, 2)      # numbers menjadi [1, 2, 3]

list.remove

Method

Hapus item pertama yang nilainya cocok dengan nilai yang diberikan.

Sintaks

list.remove(value, /)

Parameter

Nama	Deskripsi
`valueAny?`	Value to find and remove from the list. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Menimbulkan ValueError ketika nilai tidak ditemukan.

Contoh

numbers = [1, 2, 2, 3]
numbers.remove(2)         # numbers menjadi [1, 2, 3]

list.pop

Method

Hapus satu item dari daftar lalu kembalikan item itu. Jika indeks dihilangkan, item terakhir akan dihapus.

Sintaks

list.pop(index=-1, /)

Parameter

Nama	Deskripsi
`indexInt`	Indeks opsional untuk dihapus. Indeks negatif dihitung dari akhir daftar. Opsional · Hanya posisi Default: `-1`

Nilai yang dikembalikan

Any? — Item yang dihapus. Memunculkan IndexError ketika daftar kosong atau indeks berada di luar daftar.

Contoh

numbers = [2, 0, 3]
removed = numbers.pop()   # mengembalikan 3
first = numbers.pop(0)    # mengembalikan 2

list.clear

Method

Hapus setiap item dari daftar.

Sintaks

list.clear()

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Daftarnya menjadi kosong.

Contoh

numbers = [2, 0, 3]
numbers.clear()
text(str(len(numbers)))   # mengembalikan 0

list.index

Method

Kembalikan indeks pertama yang itemnya sama dengan value dalam batas start dan stop opsional.

Sintaks

list.index(value, start=0, stop=len(list), /)

Parameter

Nama	Deskripsi
`valueAny?`	Nilai yang dicari. Wajib · Hanya posisi Tanpa nilai bawaan
`startInt`	Batas awal opsional. Nilai negatif dihitung dari akhir daftar. Opsional · Hanya posisi Default: `0`
`stopInt`	Batas akhir opsional. Item pada indeks ini tidak ikut dihitung. Opsional · Hanya posisi Default: `len(list)`

Nilai yang dikembalikan

Int — Indeks yang cocok. Memunculkan ValueError ketika nilai tidak ditemukan.

Contoh

numbers = [1, 2, 1, 3]
first_one = numbers.index(1)       # mengembalikan 0
later_one = numbers.index(1, 1)    # mengembalikan 2

list.count

Method

Hitung berapa banyak item yang sama dengan nilai yang diberikan.

Sintaks

list.count(value, /)

Parameter

Nama	Deskripsi
`valueAny?`	Nilai yang akan dihitung. Wajib · Hanya posisi Tanpa nilai bawaan

Nilai yang dikembalikan

Int — Jumlah item yang cocok.

Contoh

numbers = [1, 2, 1, 3]
ones = numbers.count(1)   # mengembalikan 2

list.sort

Method

Urutkan daftar di tempat menggunakan aturan urutan stabil yang sama seperti sorted().

Sintaks

list.sort(*, key=None, reverse=False)

Parameter

Nama	Deskripsi
`keyCallable?`	Fungsi opsional yang mengembalikan kunci pembanding untuk setiap item. Opsional · Hanya nama Default: `None`
`reverseBoolean`	Jika true, urutkan dari terbesar ke terkecil. Opsional · Hanya nama Default: `False`

Nilai yang dikembalikan

None — Tidak ada nilai balik langsung. Daftar diurutkan ulang di tempat.

Contoh

numbers = [3, 1, 2]
numbers.sort()
text(str(numbers))        # mengembalikan [1, 2, 3]

list.reverse

Method

Balik urutan daftar di tempat.

Sintaks

list.reverse()

Nilai yang dikembalikan

None — Tidak ada nilai balik langsung. Urutan daftar dibalik di tempat.

Contoh

numbers = [1, 2, 3]
numbers.reverse()         # numbers menjadi [3, 2, 1]

list.copy

Method

Buat salinan daftar yang dangkal dan bisa diubah.

Sintaks

list.copy()

Nilai yang dikembalikan

list — Daftar baru yang bisa diubah dengan referensi item yang sama.

Contoh

numbers = [1, 2]
copied = numbers.copy()
copied.append(3)
count = len(numbers)      # mengembalikan 2

list.for_loop

Method

Ulangi item secara berurutan dari kiri ke kanan.

Sintaks

for item in list:

Parameter

Nama	Deskripsi
`itemAny`	Current item inside the loop. Wajib · Posisi atau nama Tanpa nilai bawaan
`listlist`	The list to iterate. Wajib · Posisi atau nama Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Loop menjalankan tubuhnya satu kali per item.

Contoh

steps = range(1, 4)      # mengembalikan [1, 2, 3]
for step in steps:
    wait(step * 100)      # mengembalikan None

list.truthy_check

Method

Periksa apakah daftar tersebut memiliki setidaknya satu item. Daftar kosong dianggap salah.

Sintaks

if list | if not list

Parameter

Nama	Deskripsi
`listlist`	The list used in the condition. Wajib · Posisi atau nama Tanpa nilai bawaan

Nilai yang dikembalikan

Boolean condition — benar jika daftarnya tidak kosong, salah jika daftarnya kosong.

Contoh

numbers = range(0)        # mengembalikan []
if not numbers:
    text("No items")      # mengembalikan None