list

Mag-imbak ng mga item ayon sa pagkakasunod, kahit may magkakaparehong halaga. Basahin ang posisyon simula sa 0, ulitin ang mga item sa loop, o magdagdag, magpalit, at mag-alis sa mismong list.

Syntax

list(iterable=(), /)

Ibinabalik na halaga

Halimbawa

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

for value in numbers:
    wait(50)              # nagbabalik ng None

Mga method

22 method

list.constructor

Gumawa ng walang lamang list o bagong list mula sa source na maaaring ulitin sa loop, gaya ng string, list, o generator. Mananatili ang pagkakasunod ng mga item; ginagamit pa rin kasama ng source ang mga nakapaloob na collection.

Syntax

list()
list(iterable, /)

Mga parameter

PangalanPaglalarawan
iterableIterable
Mga source value na kokopyahin sa bagong listahan.
Depende sa paraan ng pagtawag · Ayon lang sa posisyon
Default: ()

Ibinabalik na halaga

list — Isang bagong nababagong listahan.

Halimbawa

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

copied = list(numbers)

list.literal

Gumawa ng list sa pamamagitan ng pagsulat ng mga item sa loob ng mga square bracket.

Syntax

[1, 2, 3]

Mga parameter

PangalanPaglalarawan
itemAny?
Each item written inside the brackets.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

list — Bagong list na may mga item ayon sa pagkakasulat.

Halimbawa

numbers = [2, 0, 3]
first = numbers[0]       # nagbabalik ng 2

list.comprehension

Bumuo ng list mula sa mga halagang ginawa ng expr habang inuulit sa loop ang source. Gamitin ang if para panatilihin lang ang tumugmang item; maaaring gumamit ng maraming for/if. Dito lang sa expression na ito ang mga variable ng loop.

Syntax

[expr for target in iterable if condition]

Mga parameter

PangalanPaglalarawan
exprAny?
Value to append for each accepted item.
Kailangan · Ayon sa posisyon o pangalan
Walang default
targetName | destructuring target
Variable o grupo ng mga variable na tumatanggap ng kasalukuyang item. Hindi sinusuportahan ang target gaya ng *rest.
Kailangan · Ayon sa posisyon o pangalan
Walang default
iterableIterable
Source na maaaring ulitin sa loop, gaya ng string, collection, o generator; mga key ang ibinibigay ng dictionary.
Kailangan · Ayon sa posisyon o pangalan
Walang default
conditionBoolean
Optional filter checked before appending.
Opsyonal · Ayon lang sa posisyon
Default: True

Ibinabalik na halaga

list — Isang bagong nababagong listahan na may mga tumutugmang item sa pagkakasunud-sunod ng pag-ulit.

Halimbawa

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

list.range_source

Gumawa ng bagong integer list para sa loops, counters, at numeric ranges.

Syntax

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

Mga parameter

PangalanPaglalarawan
startNumber
Start value (inclusive).
Depende sa paraan ng pagtawag · Ayon lang sa posisyon
Default: 0
stopNumber
End value (exclusive).
Kailangan · Ayon lang sa posisyon
Walang default
stepNumber
Halagang idinaragdag para sa susunod na item. Pababa ang bilang kapag negatibo; error ang 0. Kung palayo sa stop ang direksiyon ng step, walang laman ang resulta.
Depende sa paraan ng pagtawag · Ayon lang sa posisyon
Default: 1

Ibinabalik na halaga

list[Int] — Isang bagong listahan ng integer.

Halimbawa

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

list.length

Bilangin kung ilang item ang nasa listahan.

Syntax

len(list, /)

Mga parameter

PangalanPaglalarawan
listlist
The list to count.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

Int — Bilang ng mga item sa listahan.

Halimbawa

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

list.index_access

Basahin ang isang item ayon sa posisyon: 0 ang una, -1 ang huli, at mula sa dulo ang bilang ng ibang negatibong index.

Syntax

list[index]

Mga parameter

PangalanPaglalarawan
listlist
The source list.
Kailangan · Ayon sa posisyon o pangalan
Walang default
indexInt
Posisyon ng item: 0 ang una, -1 ang huli.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

Any? — Ang item sa posisyong iyon. Maglalabas ng IndexError kapag ang index ay nasa labas ng listahan.

Halimbawa

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

list.slice

Magbalik ng bagong list mula start hanggang bago ang end. Mula sa dulo ang bilang ng negatibong index. Kapag walang mga hangganan, pipiliin ang buong list ayon sa direksiyon ng step; ginagamit pa rin nang magkasama ang mga nakapaloob na collection.

Syntax

list[start:end[:step]]

Mga parameter

PangalanPaglalarawan
startInt
First item index to include.
Opsyonal · Ayon lang sa posisyon
Default: start of list
endInt
Stop before this item index.
Opsyonal · Ayon lang sa posisyon
Default: end of list
stepInt
Distance between items. Cannot be 0; negative values read backward.
Opsyonal · Ayon lang sa posisyon
Default: 1

Ibinabalik na halaga

list — Isang bagong nababagong hiwa ng listahan, na naka-clamp sa available na hanay.

Halimbawa

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

list.index_assignment

Palitan ang isang umiiral nang item sa pamamagitan ng index. Ang mga negatibong index ay binibilang mula sa dulo. Dapat nasa loob na ng listahan ang index.

Syntax

list[index] = value

Mga parameter

PangalanPaglalarawan
listlist
The mutable list to update.
Kailangan · Ayon sa posisyon o pangalan
Walang default
indexInt
Item index that already exists. Use -1 for the last item.
Kailangan · Ayon lang sa posisyon
Walang default
valueAny?
New value to store at that position.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang listahan ay na-update sa lugar.

Halimbawa

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

list.destructuring_assignment

Italaga ang mga item ng list sa mga variable mula kaliwa pakanan. Dapat pareho ang dami ng mga variable at item, kung hindi ay magkakaroon ng error. Maaaring may nakapaloob na grupo ng mga variable; hindi sinusuportahan ang *rest.

Syntax

a, b = list

Mga parameter

PangalanPaglalarawan
a, bTargets
Mga variable na tatanggap ng mga item; dapat katumbas ng haba ng list ang dami nila.
Kailangan · Ayon sa posisyon o pangalan
Walang default
listlist
Source list to unpack.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang mga target ay tumatanggap ng mga item sa listahan mula kaliwa hanggang kanan.

Halimbawa

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

list.append

Magdagdag ng isang bagong item sa dulo ng listahan.

Syntax

list.append(value, /)

Mga parameter

PangalanPaglalarawan
valueAny?
The value to add.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang listahan ay na-update sa lugar.

Halimbawa

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

list.extend

Idagdag ang bawat item mula sa source na maaaring ulitin sa loop sa dulo ng list na ito, ayon sa pagkakasunod sa source.

Syntax

list.extend(iterable, /)

Mga parameter

PangalanPaglalarawan
iterableIterable
Mga source value na ang mga item ay idaragdag.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang listahan ay lumalaki sa lugar.

Halimbawa

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

list.insert

Magsingit ng item bago ang ibinigay na posisyon. Nagsisimula sa 0 ang mga posisyon; mula sa dulo ang bilang ng negatibong index. Sa simula isisingit kung mas mababa sa saklaw ng list ang index; sa dulo kung lampas sa list.

Syntax

list.insert(index, value, /)

Mga parameter

PangalanPaglalarawan
indexInt
Posisyon kung saan ipapasok ang value bago nito.
Kailangan · Ayon lang sa posisyon
Walang default
valueAny?
Ang value na ipapasok.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang listahan ay na-update sa lugar.

Halimbawa

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

list.remove

Alisin ang unang item na ang halaga ay tumutugma sa ibinigay na halaga.

Syntax

list.remove(value, /)

Mga parameter

PangalanPaglalarawan
valueAny?
Value to find and remove from the list.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Itinataas ang ValueError kapag hindi nakita ang value.

Halimbawa

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

list.pop

Mag-alis ng isang item mula sa listahan at ibalik ito. Kapag walang index, aalisin ang huling item.

Syntax

list.pop(index=-1, /)

Mga parameter

PangalanPaglalarawan
indexInt
Opsyonal na index na aalisin. Ang negatibong index ay binibilang mula sa dulo.
Opsyonal · Ayon lang sa posisyon
Default: -1

Ibinabalik na halaga

Any? — Ang inalis na item. Maglalabas ng IndexError kapag walang laman ang listahan o nasa labas ng listahan ang index.

Halimbawa

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

list.clear

Alisin ang bawat item sa listahan.

Syntax

list.clear()

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang listahan ay nagiging walang laman.

Halimbawa

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

list.index

Ibalik ang unang index na ang item ay katumbas ng value sa loob ng opsyonal na start at stop bounds.

Syntax

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

Mga parameter

PangalanPaglalarawan
valueAny?
Value na hahanapin.
Kailangan · Ayon lang sa posisyon
Walang default
startInt
Unang posisyong hahanapan, kasama ito. Nagsisimula sa 0 ang mga posisyon; mula sa dulo ang bilang ng negatibong halaga.
Opsyonal · Ayon lang sa posisyon
Default: 0
stopInt
Huminto bago ang posisyong ito. Mula sa dulo ang bilang ng negatibong halaga.
Opsyonal · Ayon lang sa posisyon
Default: len(list)

Ibinabalik na halaga

Int — Ang tumutugmang index. Maglalabas ng ValueError kapag hindi nahanap ang value.

Halimbawa

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

list.count

Bilangin kung ilang item ang katumbas ng ibinigay na value.

Syntax

list.count(value, /)

Mga parameter

PangalanPaglalarawan
valueAny?
Value na bibilangin.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

Int — Bilang ng mga tumutugmang item.

Halimbawa

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

list.sort

Ayusin ang mismong list mula pinakamaliit hanggang pinakamalaki. Nananatili ang orihinal na pagkakasunod ng mga halagang magkatumbas sa paghahambing. Dapat maaaring paghambingin ang mga halaga: numero at boolean, string, o list/tuple na magkapareho ang uri at may mga item na maaaring paghambingin; error ang paghahalo ng di-magkatugmang uri.

Syntax

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

Mga parameter

PangalanPaglalarawan
keyCallable?
Opsiyonal na function na tinatawag nang isang beses bawat item para gumawa ng halagang pagbabatayan ng pag-aayos. Sa None, ang mismong mga item ang paghahambingin.
Opsyonal · Ayon lang sa pangalan
Default: None
reverseBoolean
Kapag true, ayusin mula pinakamalaki hanggang pinakamaliit.
Opsyonal · Ayon lang sa pangalan
Default: False

Ibinabalik na halaga

None — Walang direktang return value. Inaayos muli ang listahan sa mismong lugar.

Halimbawa

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

list.reverse

Baliktarin ang listahan sa mismong lugar.

Syntax

list.reverse()

Ibinabalik na halaga

None — Walang direktang return value. Binabaliktad ang ayos ng listahan sa mismong lugar.

Halimbawa

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

list.copy

Magbalik ng bagong list na may parehong mga item. Hindi mababago ang orihinal kapag nagdagdag, nag-alis, o nagpalit ng mga item sa kopya; ginagamit pa rin nang magkasama ang mga nakapaloob na collection.

Syntax

list.copy()

Ibinabalik na halaga

list — Bagong list; hindi kinokopya ang mga nakapaloob na collection.

Halimbawa

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

list.for_loop

I-loop ang mga item sa pagkakasunud-sunod mula kaliwa hanggang kanan.

Syntax

for item in list:

Mga parameter

PangalanPaglalarawan
itemAny
Current item inside the loop.
Kailangan · Ayon sa posisyon o pangalan
Walang default
listlist
The list to iterate.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Pinapatakbo ng loop ang katawan nito nang isang beses bawat item.

Halimbawa

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

list.truthy_check

Suriin kung ang listahan ay may kahit isang item. Ang isang walang laman na listahan ay itinuturing na hindi totoo.

Syntax

if list | if not list

Mga parameter

PangalanPaglalarawan
listlist
The list used in the condition.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Boolean condition — totoo kapag ang listahan ay walang laman, mali kapag ito ay walang laman.

Halimbawa

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