`builtins` — sisäänrakennetut funktiot ja poikkeukset¶

Kaikki sisäänrakennetut funktiot ja poikkeukset on kuvattu tässä. Ne ovat käytettävissä myös builtins-moduulin kautta.

Funktiot ja tyypit¶

abs(x: Any) → Any¶: Palauttaa luvun itseisarvon. Argumentti voi olla kokonaisluku, liukuluku tai mikä tahansa olio, joka toteuttaa __abs__()-metodin.

all(iterable: Iterable[Any]) → bool¶: Palauttaa True, jos kaikki iterable-olion alkiot ovat tosia (tai jos iteroitava on tyhjä).

any(iterable: Iterable[Any]) → bool¶: Palauttaa True, jos jokin iterable-olion alkio on tosi. Palauttaa False, jos iteroitava on tyhjä.

bin(x: int) → str¶: Muuntaa kokonaisluvun binäärimerkkijonoksi, jonka etuliite on "0b". Argumentin on oltava Python-kokonaisluku tai sen on toteutettava __index__()-metodi.

class bool(x: Any = False)¶: Palauttaa totuusarvon, eli joko True tai False. x muunnetaan käyttäen tavanomaista totuustestausmenettelyä.

class bytearray(source: int | str | Iterable[int] | bytes = b'', encoding: str = 'utf-8', errors: str = 'strict')¶

Muuttuva kokonaislukujen jono välillä 0-255. Rakentaminen noudattaa samoja sääntöjä kuin bytes: kokonaisluvusta (joka luo kyseisen kokoisen nollalla täytetyn puskurin), kokonaislukujen iteroitavasta, merkkijonosta encoding-koodauksen kanssa tai mistä tahansa puskuriprotokollaa tukevasta oliosta. Tukee tavanomaisia jono-operaatioita sekä paikallaan tapahtuvaa muokkausta.

classmethod fromhex(string: str) → bytearray¶: Rakentaa bytearray-olion heksadesimaalinumeroparien merkkijonosta. Numeroparien välinen tyhjätila ohitetaan; heksanumeroon kuulumaton merkki nostaa ValueError-poikkeuksen.

append(val: int) → None¶: Lisää yksittäisen arvon (kokonaisluvun välillä 0-255) bytearray-olion loppuun kasvattaen sitä yhdellä tavulla.

center(width: int, fillbyte: bytes) → bytes¶: Palauttaa sisällöstä kopion keskitettynä width-pituiseen jonoon, täytettynä fillbyte-tavulla. Toisin kuin CPythonissa, fillbyte on pakollinen. Data palautetaan muuttumattomana, kun width ei ole nykyistä pituutta suurempi.

count(sub: bytes, start: int = 0, end: int = -1) → int¶: Palauttaa sub-osajonon päällekkäin menemättömien esiintymien lukumäärän viipaleessa [start:end].

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool¶: Palauttaa True, jos sisältö päättyy päätteeseen suffix. Toisin kuin CPythonissa, suffix ei voi olla arvojen monikko.

extend(iterable: Iterable[int]) → None¶: Lisää kaikki iterable-olion alkiot bytearray-olion loppuun. CPythonin laajennuksena voidaan käyttää mitä tahansa puskuriprotokollaa tukevaa oliota.

find(sub: bytes, start: int = 0, end: int = -1) → int¶: Palauttaa pienimmän indeksin, josta sub löytyy viipaleen [start:end] sisältä, tai -1, jos sitä ei löydy.

format(*args: Any, **kwargs: Any) → str¶: Suorittaa merkkijonon muotoiluoperaation käyttäen sisältöä muotoilumerkkijonona ja palauttaa muotoillun tuloksen.

hex(sep: str = '') → str¶: Palauttaa merkkijonon, jossa on kaksi heksadesimaalinumeroa jokaista tavua kohti. Jos valinnainen sep (pituuden 1 merkkijono) annetaan, se lisätään peräkkäisten tavuarvojen väliin.

index(sub: bytes, start: int = 0, end: int = -1) → int¶: Kuten find(), mutta nostaa ValueError-poikkeuksen, kun sub ei löydy.

isalpha() → bool¶: Palauttaa True, jos kaikki tavut ovat aakkosellisia ASCII-merkkejä ja tavuja on vähintään yksi, muutoin False.

isdigit() → bool¶: Palauttaa True, jos kaikki tavut ovat ASCII-desimaalinumeroita ja tavuja on vähintään yksi, muutoin False.

islower() → bool¶: Palauttaa True, jos kaikki kirjainkoolliset tavut ovat pieniä kirjaimia ja kirjainkoollisia tavuja on vähintään yksi, muutoin False.

isspace() → bool¶: Palauttaa True, jos kaikki tavut ovat ASCII-tyhjätilaa ja tavuja on vähintään yksi, muutoin False.

isupper() → bool¶: Palauttaa True, jos kaikki kirjainkoolliset tavut ovat suuria kirjaimia ja kirjainkoollisia tavuja on vähintään yksi, muutoin False.

join(iterable: Iterable[bytes]) → bytes¶: Palauttaa bytes-olion, joka on iterable-olion alkioiden yhdistelmä, käyttäen bytearray-olion sisältöä erottimena.

lower() → bytes¶: Palauttaa sisällöstä kopion, jossa kaikki ASCII-isot kirjaimet on muunnettu pieniksi.

lstrip(chars: bytes | None = None) → bytes¶: Palauttaa kopion, josta on poistettu alkutavut. chars määrittää poistettavien tavujen joukon; jos se jätetään pois tai on None, ASCII-tyhjätila poistetaan.

partition(sep: bytes) → tuple¶: Jakaa sep-erottimen ensimmäisestä esiintymästä ja palauttaa (head, sep, tail). Jos sep ei löydy, palauttaa sisällön, jota seuraa kaksi tyhjää oliota.

replace(old: bytes, new: bytes, count: int = -1) → bytes¶: Palauttaa kopion, jossa kaikki old-esiintymät on korvattu new-arvolla. Jos count annetaan, korvataan vain count ensimmäistä esiintymää.

rfind(sub: bytes, start: int = 0, end: int = -1) → int¶: Palauttaa suurimman indeksin, josta sub löytyy viipaleen [start:end] sisältä, tai -1, jos sitä ei löydy.

rindex(sub: bytes, start: int = 0, end: int = -1) → int¶: Kuten rfind(), mutta nostaa ValueError-poikkeuksen, kun sub ei löydy.

rpartition(sep: bytes) → tuple¶: Jakaa sep-erottimen viimeisestä esiintymästä ja palauttaa (head, sep, tail). Jos sep ei löydy, palauttaa kaksi tyhjää oliota, joita seuraa sisältö.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list¶: Jakaa sep-erottimen esiintymien kohdalta osien listaksi suorittaen enintään maxsplit jakoa oikealta lukien. Jos sep on None tai jätetään pois, jaetaan ASCII-tyhjätilan jaksojen kohdalta.

rstrip(chars: bytes | None = None) → bytes¶: Palauttaa kopion, josta on poistettu lopputavut. chars määrittää poistettavien tavujen joukon; jos se jätetään pois tai on None, ASCII-tyhjätila poistetaan.

split(sep: bytes | None = None, maxsplit: int = -1) → list¶: Jakaa sep-erottimen esiintymien kohdalta osien listaksi. Jos sep on None tai jätetään pois, jaetaan ASCII-tyhjätilan jaksojen kohdalta ja alku- ja lopputyhjätila jätetään huomiotta.

splitlines(keepends: bool = False) → list¶: Palauttaa listan riveistä jakaen kohdista \n, \r ja \r\n. Rivinvaihdot jätetään pois, ellei keepends ole tosi.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool¶: Palauttaa True, jos sisältö alkaa etuliitteellä prefix. Toisin kuin CPythonissa, prefix ei voi olla monikko, ja end hyväksytään mutta jätetään huomiotta.

strip(chars: bytes | None = None) → bytes¶: Palauttaa kopion, josta on poistettu alku- ja lopputavut. chars määrittää poistettavien tavujen joukon; jos se jätetään pois tai on None, ASCII-tyhjätila poistetaan.

upper() → bytes¶: Palauttaa sisällöstä kopion, jossa kaikki ASCII-pienet kirjaimet on muunnettu suuriksi.

class bytes(source: int | str | Iterable[int] = b'', encoding: str = 'utf-8', errors: str = 'strict')¶

Muuttumaton kokonaislukujen jono välillä 0-255. Luodaan kokonaisluvusta (nollalla täytetty puskuri), kokonaislukujen iteroitavasta, merkkijonosta encoding-koodauksen kanssa tai mistä tahansa puskuriprotokollaa tukevasta oliosta. Bytes-literaalit käyttävät b'...'-syntaksia.

classmethod fromhex(string: str) → bytes¶: Rakentaa bytes-olion heksadesimaalinumeroparien merkkijonosta. Numeroparien välinen tyhjätila ohitetaan; heksanumeroon kuulumaton merkki nostaa ValueError-poikkeuksen.

center(width: int, fillbyte: bytes) → bytes¶: Palauttaa kopion keskitettynä width-pituiseen jonoon, täytettynä fillbyte-tavulla (pituuden 1 bytes, joka antaa täytetavun). Toisin kuin CPythonissa, fillbyte on pakollinen. Alkuperäinen olio palautetaan muuttumattomana, kun width ei ole sen pituutta suurempi.

count(sub: bytes, start: int = 0, end: int = -1) → int¶: Palauttaa sub-osajonon päällekkäin menemättömien esiintymien lukumäärän viipaleessa [start:end].

decode(encoding: str = 'utf-8') → str¶: Palauttaa tavuista dekoodatun str-olion. MicroPythonissa encoding-argumentti hyväksytään mutta jätetään käytännössä huomiotta (tavut tulkitaan uudelleen UTF-8-muotoisina).

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool¶: Palauttaa True, jos tavut päättyvät päätteeseen suffix. Toisin kuin CPythonissa, suffix ei voi olla kokeiltavien arvojen monikko.

find(sub: bytes, start: int = 0, end: int = -1) → int¶: Palauttaa pienimmän indeksin, josta osajono sub löytyy viipaleen [start:end] sisältä, tai -1, jos sitä ei löydy.

format(*args: Any, **kwargs: Any) → str¶: Suorittaa merkkijonon muotoiluoperaation käyttäen tavuja muotoilumerkkijonona ja palauttaa muotoillun tuloksen.

hex(sep: str = '') → str¶: Palauttaa merkkijonon, jossa on kaksi heksadesimaalinumeroa jokaista tavua kohti. Jos valinnainen sep (pituuden 1 merkkijono) annetaan, se lisätään peräkkäisten tavuarvojen väliin.

index(sub: bytes, start: int = 0, end: int = -1) → int¶: Kuten find(), mutta nostaa ValueError-poikkeuksen, kun sub ei löydy.

isalpha() → bool¶: Palauttaa True, jos kaikki tavut ovat aakkosellisia ASCII-merkkejä ja tavuja on vähintään yksi, muutoin False.

isdigit() → bool¶: Palauttaa True, jos kaikki tavut ovat ASCII-desimaalinumeroita ja tavuja on vähintään yksi, muutoin False.

islower() → bool¶: Palauttaa True, jos kaikki kirjainkoolliset tavut ovat pieniä kirjaimia ja kirjainkoollisia tavuja on vähintään yksi, muutoin False.

isspace() → bool¶: Palauttaa True, jos kaikki tavut ovat ASCII-tyhjätilaa ja tavuja on vähintään yksi, muutoin False.

isupper() → bool¶: Palauttaa True, jos kaikki kirjainkoolliset tavut ovat suuria kirjaimia ja kirjainkoollisia tavuja on vähintään yksi, muutoin False.

join(iterable: Iterable[bytes]) → bytes¶: Palauttaa bytes-olion, joka on iterable-olion alkioiden yhdistelmä, käyttäen bytes-oliota itseään erottimena.

lower() → bytes¶: Palauttaa kopion, jossa kaikki ASCII-isot kirjaimet on muunnettu pieniksi.

lstrip(chars: bytes | None = None) → bytes¶: Palauttaa kopion, josta on poistettu alkutavut. chars määrittää poistettavien tavujen joukon; jos se jätetään pois tai on None, ASCII-tyhjätila poistetaan.

partition(sep: bytes) → tuple¶: Jakaa sep-erottimen ensimmäisestä esiintymästä ja palauttaa (head, sep, tail). Jos sep ei löydy, palauttaa tavut, joita seuraa kaksi tyhjää bytes-oliota.

replace(old: bytes, new: bytes, count: int = -1) → bytes¶: Palauttaa kopion, jossa kaikki old-esiintymät on korvattu new-arvolla. Jos count annetaan, korvataan vain count ensimmäistä esiintymää.

rfind(sub: bytes, start: int = 0, end: int = -1) → int¶: Palauttaa suurimman indeksin, josta sub löytyy viipaleen [start:end] sisältä, tai -1, jos sitä ei löydy.

rindex(sub: bytes, start: int = 0, end: int = -1) → int¶: Kuten rfind(), mutta nostaa ValueError-poikkeuksen, kun sub ei löydy.

rpartition(sep: bytes) → tuple¶: Jakaa sep-erottimen viimeisestä esiintymästä ja palauttaa (head, sep, tail). Jos sep ei löydy, palauttaa kaksi tyhjää bytes-oliota, joita seuraa tavut.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list¶: Jakaa sep-erottimen esiintymien kohdalta osien listaksi suorittaen enintään maxsplit jakoa oikealta lukien. Jos sep on None tai jätetään pois, jaetaan ASCII-tyhjätilan jaksojen kohdalta.

rstrip(chars: bytes | None = None) → bytes¶: Palauttaa kopion, josta on poistettu lopputavut. chars määrittää poistettavien tavujen joukon; jos se jätetään pois tai on None, ASCII-tyhjätila poistetaan.

split(sep: bytes | None = None, maxsplit: int = -1) → list¶: Jakaa sep-erottimen esiintymien kohdalta osien listaksi. Jos sep on None tai jätetään pois, jaetaan ASCII-tyhjätilan jaksojen kohdalta ja alku- ja lopputyhjätila jätetään huomiotta.

splitlines(keepends: bool = False) → list¶: Palauttaa listan riveistä jakaen kohdista \n, \r ja \r\n. Rivinvaihdot jätetään pois, ellei keepends ole tosi.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool¶: Palauttaa True, jos tavut alkavat etuliitteellä prefix. Toisin kuin CPythonissa, prefix ei voi olla monikko, ja end hyväksytään mutta jätetään huomiotta.

strip(chars: bytes | None = None) → bytes¶: Palauttaa kopion, josta on poistettu alku- ja lopputavut. chars määrittää poistettavien tavujen joukon; jos se jätetään pois tai on None, ASCII-tyhjätila poistetaan.

upper() → bytes¶: Palauttaa kopion, jossa kaikki ASCII-pienet kirjaimet on muunnettu suuriksi.

callable(obj: Any) → bool¶: Palauttaa True, jos obj vaikuttaa kutsuttavalta, muutoin False.

chr(i: int) → str¶: Palauttaa yhden merkin pituisen merkkijonon, jonka Unicode-koodipiste on kokonaisluku i.

classmethod(func: Callable[..., Any]) → classmethod¶: Muuntaa metodin luokkametodiksi. Yleensä käytetään koristelijana.

compile(source: str | bytes, filename: str, mode: str) → Any¶: Kääntää source-lähdekoodin koodiolioksi, jonka exec() tai eval() voi suorittaa. mode on yksi arvoista "exec", "eval" tai "single".

class complex(real: float | str = 0, imag: float = 0)¶: Luo kompleksiluvun reaali- ja imaginaariosasta tai merkkijonosta.

delattr(obj, name: str) → None¶: Argumentin name tulee olla merkkijono, ja tämä funktio poistaa nimetyn attribuutin oliosta obj.

class dict(*args, **kwargs)¶

Luo uuden sanakirjan. Vastaa CPythonin dict-tyyppiä.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) → dict¶: Luo uuden sanakirjan, jonka avaimet otetaan iterable-oliosta ja kukin kuvautuu arvoon value (oletuksena None). Kutsutaan tyypille, esim. dict.fromkeys(...).

clear() → None¶: Poistaa kaikki alkiot sanakirjasta jättäen sen tyhjäksi. Nostaa TypeError-poikkeuksen, jos sanakirja on kiinteä (vain luku).

copy() → dict¶: Palauttaa sanakirjan pinnallisen kopion. Palautettu olio on samaa tyyppiä kuin alkuperäinen (dict tai OrderedDict), mutta ei ole kiinteä.

get(key: Any, default: Any = None) → Any¶: Palauttaa arvon avaimelle key, jos se on sanakirjassa, muutoin palauttaa arvon default (joka itsessään on oletuksena None, joten tämä ei koskaan nosta KeyError-poikkeusta). Sanakirjaa ei muokata.

items() → Any¶: Palauttaa dynaamisen näkymäolion (key, value)-pareista, joka heijastaa sanakirjaan myöhemmin tehtyjä muutoksia ja tukee iterointia, len()-funktiota, in-operaattoria ja joukkovertailuoperaattoreita.

keys() → Any¶: Palauttaa dynaamisen näkymäolion avaimista, joka heijastaa sanakirjaan myöhemmin tehtyjä muutoksia ja tukee iterointia, len()-funktiota, in-operaattoria ja joukkovertailuoperaattoreita.

pop(key: Any, default: Any = None) → Any¶: Poistaa avaimen key sanakirjasta ja palauttaa sen arvon. Jos key ei ole läsnä, palauttaa arvon default, jos se annettiin; muutoin nostaa KeyError-poikkeuksen. Nostaa TypeError-poikkeuksen, jos sanakirja on kiinteä.

popitem() → tuple¶: Poistaa ja palauttaa mielivaltaisen (key, value)-parin 2-monikkona. Tavallisen dict-olion kohdalla valittu pari on määrittelemätön; OrderedDict-olion kohdalla viimeksi lisätty pari poistetaan (LIFO). Nostaa KeyError-poikkeuksen, jos sanakirja on tyhjä, tai TypeError-poikkeuksen, jos se on kiinteä.

setdefault(key: Any, default: Any = None) → Any¶: Jos key on sanakirjassa, palauttaa sen arvon. Muutoin lisää avaimen key arvolla default (oletuksena None) ja palauttaa tämän arvon. Nostaa TypeError-poikkeuksen, jos sanakirja on kiinteä.

update(*args: Any, **kwargs: Any) → None¶: Päivittää sanakirjan paikallaan. Hyväksytään enintään yksi positionaalinen argumentti: joko toinen sanakirja tai kahden alkion (key, value)-parien iteroitava (kunkin on tuotettava tasan kaksi alkiota, muutoin nostetaan ValueError-poikkeus). Avainsana-argumentit lisätään tämän jälkeen merkkijonoavaimisina alkioina. Olemassa olevat avaimet ylikirjoitetaan. Nostaa TypeError-poikkeuksen, jos sanakirja on kiinteä.

values() → Any¶: Palauttaa dynaamisen näkymäolion arvoista, joka heijastaa sanakirjaan myöhemmin tehtyjä muutoksia ja tukee iterointia ja len()-funktiota.

__getitem__(key: Any) → Any¶: Palauttaa self[key]. Toteuttaa indeksointioperaattorin d[key]; nostaa KeyError-poikkeuksen, jos key ei ole läsnä.

__setitem__(key: Any, value: Any) → None¶: Asettaa self[key] arvoon value. Toteuttaa d[key] = value.

__delitem__(key: Any) → None¶: Poistaa self[key]. Toteuttaa del d[key]; nostaa KeyError-poikkeuksen, jos key ei ole läsnä.

dir(obj: Any = None) → list¶: Ilman argumentteja palauttaa nykyisen paikallisen näkyvyysalueen nimien listan. Argumentin kanssa palauttaa listan kyseisen olion kelvollisista attribuuteista.

divmod(a: Any, b: Any) → tuple¶: Palauttaa parin (a // b, a % b) monikkona kahdelle (ei-kompleksiselle) luvulle.

enumerate(iterable: Iterable[Any], start: int = 0) → Iterator[tuple]¶: Palauttaa enumerate-olion, joka tuottaa (index, value)-pareja iterable-oliosta indeksin alkaessa arvosta start.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) → Any¶: Evaluoi merkkijonona (tai käännettynä koodioliona) annetun Python-lausekkeen ja palauttaa tuloksen.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) → None¶: Suorittaa dynaamisesti merkkijonona tai käännettynä koodioliona annettua Python-koodia.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) → Iterator[Any]¶: Rakentaa iteraattorin niistä iterable-olion alkioista, joille function palauttaa toden. Jos function on None, oletetaan identiteettifunktio.

class float(x: str | bytes | int | float = 0.0)¶: Palauttaa liukuluvun, joka muodostetaan luvusta tai merkkijonosta x.

class frozenset(iterable: Iterable[Any] = ())¶

Palauttaa uuden frozenset-olion, valinnaisesti iterable-oliosta otetuilla alkioilla. frozenset on muuttumaton, tiivistettävä set-tyypin muunnelma.

copy() → frozenset¶: Palauttaa frozenset-olion pinnallisen kopion.

difference(*others: Iterable[Any]) → frozenset¶: Palauttaa uuden frozenset-olion alkioilla, jotka ovat frozenset-oliossa mutta eivät missään others-olioista. Kukin argumentti voi olla mikä tahansa iteroitava.

intersection(other: Iterable[Any]) → frozenset¶: Palauttaa uuden frozenset-olion alkioilla, jotka ovat yhteisiä frozenset-oliolle ja other-oliolle. MicroPythonissa hyväksytään vain yksi other-argumentti (CPython hyväksyy useita).

isdisjoint(other: Iterable[Any]) → bool¶: Palauttaa True, jos frozenset-oliolla ei ole yhtään yhteistä alkiota other-olion kanssa.

issubset(other: Iterable[Any]) → bool¶: Palauttaa True, jos jokainen frozenset-olion alkio on other-oliossa.

issuperset(other: Iterable[Any]) → bool¶: Palauttaa True, jos jokainen other-olion alkio on frozenset-oliossa.

symmetric_difference(other: Iterable[Any]) → frozenset¶: Palauttaa uuden frozenset-olion alkioilla, jotka ovat joko frozenset-oliossa tai other-oliossa mutta eivät molemmissa. MicroPythonissa hyväksytään vain yksi other-argumentti.

union(other: Iterable[Any]) → frozenset¶: Palauttaa uuden frozenset-olion frozenset-olion ja other-olion alkioilla. MicroPythonissa hyväksytään vain yksi other-argumentti (CPython hyväksyy useita).

getattr(obj: Any, name: str, default: Any = None) → Any¶: Palauttaa olion obj nimetyn attribuutin arvon. Jos attribuuttia ei ole olemassa, palautetaan default, jos se on annettu, muutoin nostetaan AttributeError-poikkeus.

globals() → dict¶: Palauttaa sanakirjan, joka edustaa nykyisen moduulin globaalia symbolitaulua.

hasattr(obj: Any, name: str) → bool¶: Palauttaa True, jos oliolla obj on attribuutti annetulla nimellä name, muutoin False.

hash(obj: Any) → int¶: Palauttaa olion obj tiivistearvon (jos sellainen on). Tiivistearvot ovat kokonaislukuja, joita käytetään sanakirjan avainten nopeaan vertailuun sanakirjahaun aikana.

hex(x: int) → str¶: Muuntaa kokonaisluvun pienikirjaimiseksi heksadesimaalimerkkijonoksi, jonka etuliite on "0x".

id(obj: Any) → int¶: Palauttaa olion identiteetin. Tämä on kokonaisluku, jonka taataan olevan yksilöllinen ja vakio tälle oliolle sen elinkaaren ajan.

input(prompt: str = '') → str¶: Lukee rivin vakiosyötteestä ja palauttaa sen merkkijonona (ilman lopussa olevaa rivinvaihtoa). Jos prompt annetaan, se kirjoitetaan ensin vakiotulosteeseen ilman lopussa olevaa rivinvaihtoa.

class int(x: str | bytes | int | float = 0, base: int = 10)¶

classmethod from_bytes(bytes: bytes, byteorder: str) → int¶: MicroPythonissa byteorder-parametrin on oltava positionaalinen (tämä on yhteensopiva CPythonin kanssa).

to_bytes(size: int, byteorder: str) → bytes¶: MicroPythonissa byteorder-parametrin on oltava positionaalinen (tämä on yhteensopiva CPythonin kanssa).

Muista

CPythonin valinnaista signed-avainsana-argumenttia ei tueta. MicroPython muuntaa tällä hetkellä negatiiviset kokonaisluvut etumerkillisinä ja positiiviset etumerkittöminä. (Lisätietoja.)

isinstance(obj: Any, classinfo: type | tuple) → bool¶: Palauttaa True, jos obj on classinfo-luokan tai jonkin sen aliluokan ilmentymä. classinfo voi olla luokka tai luokkien monikko.

issubclass(cls: type, classinfo: type | tuple) → bool¶: Palauttaa True, jos cls on classinfo-luokan aliluokka (suora, epäsuora tai virtuaalinen).

iter(obj: Any, sentinel: Any = None) → Iterator[Any]¶: Palauttaa iteraattoriolion. Yhdellä argumentilla obj-olion on tuettava iterointiprotokollaa. Kahdella argumentilla obj-olion on oltava kutsuttava, ja iterointi pysähtyy, kun se palauttaa arvon sentinel.

len(obj: Any) → int¶: Palauttaa säiliön alkioiden lukumäärän.

class list(iterable: Iterable[Any] = ())¶

Rakentaa uuden listan, valinnaisesti täytettynä iterable-olion alkioilla.

append(object: Any) → None¶: Lisää object-olion listan loppuun.

clear() → None¶: Poistaa kaikki alkiot listasta jättäen sen tyhjäksi.

copy() → list¶: Palauttaa listan pinnallisen kopion.

count(value: Any) → int¶: Palauttaa niiden listan alkioiden lukumäärän, jotka ovat yhtä suuria kuin value.

extend(iterable: Iterable[Any]) → None¶: Lisää kaikki iterable-olion alkiot listan loppuun. Jos iterable on itse lista, sen alkiot kopioidaan suoraan; muutoin sen yli iteroidaan.

index(value: Any, start: int = 0, stop: int = -1) → int¶: Palauttaa ensimmäisen value-arvoa vastaavan alkion indeksin etsien viipaleesta [start:stop]. Nostaa ValueError-poikkeuksen, jos value ei ole läsnä.

insert(index: int, object: Any) → None¶: Lisää object-olion ennen sijaintia index. Negatiivinen index tulkitaan suhteessa listan loppuun, ja indeksi rajataan kelvolliselle alueelle (joten kummankin pään yli menevät arvot lisäävät alkuun tai loppuun).

pop(index: int = -1) → Any¶: Poistaa ja palauttaa alkion sijainnista index (oletuksena viimeisen alkion). Nostaa IndexError-poikkeuksen, jos lista on tyhjä tai index on alueen ulkopuolella.

remove(value: Any) → None¶: Poistaa ensimmäisen value-arvoa vastaavan alkion. Nostaa ValueError-poikkeuksen, jos value ei ole läsnä.

reverse() → None¶: Kääntää listan alkioiden järjestyksen paikallaan.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) → None¶: Järjestää listan alkiot paikallaan. key ja reverse ovat vain avainsana-argumentteja. key, jos annetaan, on funktio, joka sovelletaan kuhunkin alkioon vertailuarvon tuottamiseksi; reverse järjestää laskevaan järjestykseen.

Muista

Toisin kuin CPythonissa, MicroPythonin listan järjestäminen ei ole vakaa.

locals() → dict¶: Palauttaa sanakirjan, joka edustaa nykyistä paikallista symbolitaulua.

map(function: Callable[..., Any], *iterables: Iterable[Any]) → Iterator[Any]¶: Palauttaa iteraattorin, joka soveltaa funktiota function jokaiseen iterables-olioiden alkioon ja tuottaa tulokset.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any¶: Yhdellä iteroitavalla argumentilla palauttaa sen suurimman alkion. Kahdella tai useammalla argumentilla palauttaa suurimman argumentin.

class memoryview(obj: Any)¶: Luo memoryview-olion, joka viittaa olioon obj, jonka on tuettava puskuriprotokollaa (esim. bytes, bytearray, array.array). Mahdollistaa taustalla olevan muistin kopioimattoman käytön ja viipaloinnin; memoryview-olion viipalointi palauttaa toisen memoryview-olion eikä kopiota.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any¶: Yhdellä iteroitavalla argumentilla palauttaa sen pienimmän alkion. Kahdella tai useammalla argumentilla palauttaa pienimmän argumentin.

next(iterator: Iterator[Any], default: Any = None) → Any¶: Hakee seuraavan alkion iteraattorista iterator. Jos default annetaan ja iteraattori on tyhjentynyt, palautetaan default sen sijaan, että nostettaisiin StopIteration-poikkeus.

class object¶: Palauttaa uuden ominaisuudettoman olion. object on kaikkien luokkien kantaluokka.

oct(x: int) → str¶: Muuntaa kokonaisluvun oktaalimerkkijonoksi, jonka etuliite on "0o".

open(file: str, mode: str = 'r', **kwargs) → Any¶: Avaa tiedoston file ja palauttaa vastaavan tiedosto-olion. mode on oletuksena "r" tekstin lukemista varten.

ord(c: str) → int¶: Palauttaa yhden merkin pituisen merkkijonon c Unicode-koodipisteen kokonaislukuna.

pow(base: Any, exp: Any, mod: Any | None = None) → Any¶: Palauttaa base-luvun korotettuna potenssiin exp. Jos mod annetaan, palauttaa base ** exp % mod (laskettuna tehokkaammin kuin eksplisiittinen muoto).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) → None¶: Tulostaa objects-oliot tekstivirtaan file erotettuna sep-erottimella ja perään lisätään end.

property(fget: Callable[[Any], Any] | None = None, fset: Callable[[Any, Any], None] | None = None, fdel: Callable[[Any], None] | None = None, doc: str | None = None) → property¶: Palauttaa property-attribuutin. Yleensä käytetään koristelijana hallittujen attribuuttien määrittelemiseen luokassa.

range(*args: int) → range¶: Palauttaa muuttumattoman kokonaislukujen jonon. Kutsutaan muodossa range(stop), range(start, stop) tai range(start, stop, step).

repr(obj: Any) → str¶: Palauttaa merkkijonon, joka sisältää olion obj tulostettavan esitysmuodon.

reversed(seq: Any) → Iterator[Any]¶: Palauttaa käänteisen iteraattorin annetun jonon arvojen yli.

round(number: Any, ndigits: int | None = None) → Any¶: Palauttaa luvun number pyöristettynä ndigits desimaalin tarkkuuteen. Jos ndigits jätetään pois, palauttaa lähimmän kokonaisluvun.

class set(iterable: Iterable[Any] = ())¶

Palauttaa uuden set-olion, valinnaisesti iterable-oliosta otetuilla alkioilla.

add(elem: Any) → None¶: Lisää alkion elem joukkoon.

clear() → None¶: Poistaa kaikki alkiot joukosta.

copy() → set¶: Palauttaa joukon pinnallisen kopion.

difference(*others: Iterable[Any]) → set¶: Palauttaa uuden joukon alkioilla, jotka ovat joukossa mutta eivät missään others-olioista. Kukin argumentti voi olla mikä tahansa iteroitava.

difference_update(*others: Iterable[Any]) → None¶: Poistaa joukosta kaikki alkiot, jotka löytyvät jostakin others-oliosta (paikallaan).

discard(elem: Any) → None¶: Poistaa alkion elem joukosta, jos se on läsnä. Toisin kuin remove(), tämä ei nosta virhettä, jos elem puuttuu.

intersection(other: Iterable[Any]) → set¶: Palauttaa uuden joukon alkioilla, jotka ovat yhteisiä joukolle ja other-oliolle. MicroPythonissa hyväksytään vain yksi other-argumentti (CPython hyväksyy useita).

intersection_update(other: Iterable[Any]) → None¶: Päivittää joukon säilyttäen vain ne alkiot, jotka löytyvät myös other-oliosta (paikallaan). MicroPythonissa hyväksytään vain yksi other-argumentti.

isdisjoint(other: Iterable[Any]) → bool¶: Palauttaa True, jos joukolla ei ole yhtään yhteistä alkiota other-olion kanssa.

issubset(other: Iterable[Any]) → bool¶: Palauttaa True, jos jokainen joukon alkio on other-oliossa.

issuperset(other: Iterable[Any]) → bool¶: Palauttaa True, jos jokainen other-olion alkio on joukossa.

pop() → Any¶: Poistaa ja palauttaa mielivaltaisen alkion joukosta. Nostaa KeyError-poikkeuksen, jos joukko on tyhjä.

remove(elem: Any) → None¶: Poistaa alkion elem joukosta. Nostaa KeyError-poikkeuksen, jos elem ei sisälly joukkoon.

symmetric_difference(other: Iterable[Any]) → set¶: Palauttaa uuden joukon alkioilla, jotka ovat joko joukossa tai other-oliossa mutta eivät molemmissa. MicroPythonissa hyväksytään vain yksi other-argumentti.

symmetric_difference_update(other: Iterable[Any]) → None¶: Päivittää joukon säilyttäen vain ne alkiot, jotka löytyvät joko joukosta tai other-oliosta mutta eivät molemmista (paikallaan). MicroPythonissa hyväksytään vain yksi other-argumentti.

union(other: Iterable[Any]) → set¶: Palauttaa uuden joukon joukon ja other-olion alkioilla. MicroPythonissa hyväksytään vain yksi other-argumentti (CPython hyväksyy useita).

update(*others: Iterable[Any]) → None¶: Päivittää joukon lisäten alkiot kaikista others-olioista (paikallaan).

setattr(obj: Any, name: str, value: Any) → None¶: Asettaa olion obj nimetyn attribuutin arvoon value. Funktion getattr() vastinpari.

class slice¶: Sisäänrakennettu slice on se tyyppi, joka slice-olioilla on.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) → list¶: Palauttaa uuden järjestetyn listan iterable-olion alkioista.

staticmethod(func: Callable[..., Any]) → staticmethod¶: Muuntaa metodin staattiseksi metodiksi. Yleensä käytetään koristelijana.

class str(object: Any = '', encoding: str = 'utf-8', errors: str = 'strict')¶

Palauttaa olion object merkkijonoversion. Jos object on bytes-tyyppinen olio, encoding- ja errors-argumentit ohjaavat dekoodausta.

center(width: int) → str¶: Palauttaa merkkijonosta kopion keskitettynä width-pituiseen kenttään, täytettynä välilyönneillä. MicroPythonissa täytemerkkinä käytetään vain välilyöntiä (täytemerkkiargumenttia ei ole), ja alkuperäinen merkkijono palautetaan muuttumattomana, kun width ei ole sen pituutta suurempi.

count(sub: str, start: int = 0, end: int = -1) → int¶: Palauttaa sub-osajonon päällekkäin menemättömien esiintymien lukumäärän viipaleessa [start:end]. Tyhjä sub laskee jokaisen merkkien välisen kohdan.

encode(encoding: str = 'utf-8', errors: str = 'strict') → bytes¶: Palauttaa merkkijonon koodaavan bytes-olion. MicroPython jättää käytännössä argumentit huomiotta ja käyttää UTF-8:aa; errors hyväksytään mutta sen perusteella ei toimita. Vastaa bytes(s, "utf-8").

endswith(suffix: str | tuple, start: int = 0, end: int = -1) → bool¶: Palauttaa True, jos merkkijono päättyy annettuun päätteeseen suffix, joka voi olla yksittäinen merkkijono tai kokeiltavien merkkijonojen monikko. Valinnaiset start ja end rajaavat vertailun viipaleeseen [start:end].

find(sub: str, start: int = 0, end: int = -1) → int¶: Palauttaa pienimmän indeksin merkkijonossa, josta osajono sub löytyy viipaleen [start:end] sisältä, tai -1, jos sitä ei löydy.

format(*args: Any, **kwargs: Any) → str¶: Suorittaa merkkijonon muotoiluoperaation korvaten aaltosulkein {} rajatut korvauskentät arvoilla args- ja kwargs-olioista. Tukee tavanomaista muotoilumäärittelyn minikieltä.

index(sub: str, start: int = 0, end: int = -1) → int¶: Kuten find(), mutta nostaa ValueError-poikkeuksen, kun osajonoa sub ei löydy viipaleesta [start:end].

isalpha() → bool¶: Palauttaa True, jos kaikki merkkijonon merkit ovat aakkosellisia ja merkkijono ei ole tyhjä, muutoin False.

isdigit() → bool¶: Palauttaa True, jos kaikki merkkijonon merkit ovat numeroita ja merkkijono ei ole tyhjä, muutoin False.

islower() → bool¶: Palauttaa True, jos merkkijono sisältää vähintään yhden aakkosellisen merkin ja kaikki tällaiset merkit ovat pieniä kirjaimia, muutoin False.

isspace() → bool¶: Palauttaa True, jos kaikki merkkijonon merkit ovat tyhjätilaa ja merkkijono ei ole tyhjä, muutoin False.

isupper() → bool¶: Palauttaa True, jos merkkijono sisältää vähintään yhden aakkosellisen merkin ja kaikki tällaiset merkit ovat suuria kirjaimia, muutoin False.

join(iterable: Iterable[str]) → str¶: Yhdistää iterable-olion merkkijonot lisäten tämän merkkijonon erottimeksi alkioiden väliin. Alkioiden on oltava merkkijonoja, muutoin nostetaan TypeError-poikkeus.

lower() → str¶: Palauttaa merkkijonosta kopion, jossa kaikki merkit on muunnettu pieniksi kirjaimiksi.

lstrip(chars: str | None = None) → str¶: Palauttaa merkkijonosta kopion, josta on poistettu alkumerkit. Jos chars jätetään pois tai on None, tyhjätila poistetaan; muutoin chars käsitellään poistettavien merkkien joukkona.

partition(sep: str) → tuple¶: Jakaa merkkijonon sep-erottimen ensimmäisestä esiintymästä ja palauttaa 3-monikon (head, sep, tail). Jos sep ei löydy, palauttaa (self, "", ""). Tyhjä sep nostaa ValueError-poikkeuksen.

replace(old: str, new: str, count: int = -1) → str¶: Palauttaa merkkijonosta kopion, jossa kaikki osajonon old esiintymät on korvattu new-arvolla. Jos count annetaan ja se ei ole negatiivinen, korvataan vain count ensimmäistä esiintymää.

rfind(sub: str, start: int = 0, end: int = -1) → int¶: Palauttaa suurimman indeksin merkkijonossa, josta osajono sub löytyy viipaleen [start:end] sisältä, tai -1, jos sitä ei löydy.

rindex(sub: str, start: int = 0, end: int = -1) → int¶: Kuten rfind(), mutta nostaa ValueError-poikkeuksen, kun osajonoa sub ei löydy viipaleesta [start:end].

rpartition(sep: str) → tuple¶: Jakaa merkkijonon sep-erottimen viimeisestä esiintymästä ja palauttaa 3-monikon (head, sep, tail). Jos sep ei löydy, palauttaa ("", "", self). Tyhjä sep nostaa ValueError-poikkeuksen.

rsplit(sep: str | None = None, maxsplit: int = -1) → list¶: Jakaa merkkijonon oikealta osajonojen listaksi käyttäen sep-erotinta erottimena suorittaen enintään maxsplit jakoa. Ilman maxsplit-arvoa (tai negatiivisella) se toimii identtisesti split()-metodin kanssa; MicroPythonissa rsplit(None, n) ei-negatiivisella n-arvolla nostaa NotImplementedError-poikkeuksen.

rstrip(chars: str | None = None) → str¶: Palauttaa merkkijonosta kopion, josta on poistettu loppumerkit. Jos chars jätetään pois tai on None, tyhjätila poistetaan; muutoin chars käsitellään poistettavien merkkien joukkona.

split(sep: str | None = None, maxsplit: int = -1) → list¶: Jakaa merkkijonon osajonojen listaksi käyttäen sep-erotinta erottimena suorittaen enintään maxsplit jakoa. Jos sep jätetään pois tai on None, jaetaan tyhjätilan jaksojen kohdalta ja alkutyhjätila jätetään huomiotta; muutoin tyhjä sep nostaa ValueError-poikkeuksen.

splitlines(keepends: bool = False) → list¶: Palauttaa listan merkkijonon riveistä jakaen kohdista \n, \r ja \r\n. Rivinvaihtoja ei sisällytetä, ellei keepends ole tosi.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool¶: Palauttaa True, jos merkkijono alkaa annetulla etuliitteellä prefix, joka voi olla yksittäinen merkkijono tai kokeiltavien merkkijonojen monikko. Valinnaiset start ja end rajaavat vertailun viipaleeseen [start:end].

strip(chars: str | None = None) → str¶: Palauttaa merkkijonosta kopion, josta on poistettu alku- ja loppumerkit. Jos chars jätetään pois tai on None, tyhjätila poistetaan; muutoin chars käsitellään poistettavien merkkien joukkona.

upper() → str¶: Palauttaa merkkijonosta kopion, jossa kaikki merkit on muunnettu suuriksi kirjaimiksi.

sum(iterable: Iterable[Any], start: Any = 0) → Any¶: Laskee yhteen start-arvon ja iterable-olion alkiot vasemmalta oikealle ja palauttaa summan.

super(type: type | None = None, obj_or_type: Any | None = None) → Any¶: Palauttaa välitysolion, joka delegoi metodikutsut tyypin type kanta- tai sisarluokalle. Hyödyllinen perittyjen, luokassa ylikirjoitettujen metodien käyttämiseen.

class tuple(iterable: Iterable[Any] = ())¶

Rakentaa uuden monikon, valinnaisesti täytettynä iterable-olion alkioilla. Monikot ovat muuttumattomia jonoja.

count(value: Any) → int¶: Palauttaa niiden monikon alkioiden lukumäärän, jotka ovat yhtä suuria kuin value.

index(value: Any, start: int = 0, stop: int = -1) → int¶: Palauttaa ensimmäisen value-arvoa vastaavan alkion indeksin etsien viipaleesta [start:stop]. Nostaa ValueError-poikkeuksen, jos value ei ole läsnä.

type(obj: Any) → type¶: Yhdellä argumentilla palauttaa olion obj tyypin. Palautettu arvo on tyyppiolio.

zip(*iterables: Iterable[Any]) → Iterator[tuple]¶: Palauttaa monikoiden iteraattorin, jossa i:s monikko sisältää i:nnen alkion kustakin argumentti-iteroitavasta. Iterointi pysähtyy, kun lyhin syöteiteroitava on tyhjentynyt.

Poikkeukset¶

exception AssertionError¶: Nostetaan, kun assert-lause epäonnistuu.

exception AttributeError¶: Nostetaan, kun attribuuttiviittaus tai -sijoitus epäonnistuu.

exception Exception¶: Yhteinen kantaluokka kaikille ei-järjestelmästä-poistuville poikkeuksille.

exception ImportError¶: Nostetaan, kun import-lause ei löydä moduulin määritelmää.

exception IndexError¶: Nostetaan, kun jonon alaindeksi on alueen ulkopuolella.

exception KeyboardInterrupt¶

Nostetaan, kun käyttäjä keskeyttää ohjelman suorituksen, yleensä painamalla Ctrl+C REPL:ssä.

Katso myös Pehmeä lukkiutuminen (käynnistymisen epäonnistuminen)-aiheen yhteydessä.

exception KeyError¶: Nostetaan, kun kuvauksen (sanakirjan) avainta ei löydy olemassa olevien avainten joukosta.

exception MemoryError¶: Nostetaan, kun operaatiolta loppuu muisti.

exception NameError¶: Nostetaan, kun paikallista tai globaalia nimeä ei löydy.

exception NotImplementedError¶: Nostetaan, kun kutsutaan abstraktia metodia tai toteuttamatonta ominaisuutta.

exception OSError¶: Nostetaan, kun järjestelmäfunktio palauttaa järjestelmään liittyvän virheen.

exception RuntimeError¶: Nostetaan, kun havaitaan virhe, joka ei kuulu mihinkään muuhun luokkaan.

exception StopIteration¶: Nostetaan funktion next() ja iteraattorin __next__()-metodin toimesta merkiksi siitä, ettei alkioita ole enää jäljellä.

exception SyntaxError¶: Nostetaan, kun jäsennin kohtaa syntaksivirheen.

exception SystemExit¶

Nostetaan funktion sys.exit() toimesta tulkin lopettamisen pyytämiseksi. Toisin kuin useimmat poikkeukset, se ei tuota jäljitystä, kun sitä ei käsitellä.

OpenMV Cam -laitteessa käsittelemätön SystemExit aiheuttaa tällä hetkellä MicroPythonin Pehmeä nollaus-tilan.

exception TypeError¶: Nostetaan, kun operaatio tai funktio sovelletaan sopimattoman tyyppiseen olioon.

exception ValueError¶: Nostetaan, kun sisäänrakennettu operaatio tai funktio saa oikean tyyppisen mutta sopimattoman arvoisen argumentin.

exception ZeroDivisionError¶: Nostetaan, kun jako- tai jakojäännösoperaation toinen argumentti on nolla.

builtins — sisäänrakennetut funktiot ja poikkeukset¶

Funktiot ja tyypit¶

Poikkeukset¶

`builtins` — sisäänrakennetut funktiot ja poikkeukset¶