builtins --- ฟังก์ชันและข้อยกเว้นในตัว¶
ฟังก์ชันและข้อยกเว้นในตัวทั้งหมดได้อธิบายไว้ที่นี่ นอกจากนี้ยังสามารถเข้าถึงได้ผ่านโมดูล builtins
ฟังก์ชันและประเภทข้อมูล¶
- abs(x: Any) Any¶
คืนค่าสัมบูรณ์ของตัวเลข อาร์กิวเมนต์อาจเป็นจำนวนเต็ม ทศนิยม หรืออ็อบเจกต์ใดก็ตามที่ใช้งาน
__abs__()
- all(iterable: Iterable[Any]) bool¶
คืนค่า
Trueหากสมาชิกทุกตัวใน iterable มีค่าเป็นจริง (หรือหาก iterable ว่างเปล่า)
- any(iterable: Iterable[Any]) bool¶
คืนค่า
Trueหากสมาชิกใดๆ ใน iterable มีค่าเป็นจริง คืนค่าFalseหาก iterable ว่างเปล่า
- bin(x: int) str¶
แปลงจำนวนเต็มเป็นสตริงไบนารีที่มีคำนำหน้า
"0b"อาร์กิวเมนต์ต้องเป็นจำนวนเต็ม Python หรือใช้งาน__index__()
- class bool(x: Any = False)¶
คืนค่าบูลีน นั่นคือ
TrueหรือFalseอย่างใดอย่างหนึ่ง x จะถูกแปลงโดยใช้กระบวนการทดสอบค่าความจริงมาตรฐาน
- class bytearray(source: int | str | Iterable[int] | bytes = b'', encoding: str = 'utf-8', errors: str = 'strict')¶
ลำดับที่แก้ไขได้ของจำนวนเต็มในช่วง 0-255 การสร้างใช้กฎเดียวกับ
bytes: จากจำนวนเต็ม (สร้างบัฟเฟอร์ที่เติมด้วยศูนย์ตามขนาดนั้น) iterable ของ int, สตริงพร้อมencodingหรืออ็อบเจกต์ที่รองรับโปรโตคอลบัฟเฟอร์ รองรับการดำเนินการลำดับมาตรฐานพร้อมการแก้ไขในตำแหน่ง- classmethod fromhex(string: str) bytearray¶
สร้าง
bytearrayจากสตริงของคู่ตัวเลขฐานสิบหก การเว้นวรรคระหว่างคู่ตัวเลขจะถูกข้ามไป อักขระที่ไม่ใช่เลขฐานสิบหกจะทำให้เกิดValueError
- append(val: int) None¶
ผนวกค่าเดียว (จำนวนเต็มในช่วง 0-255) ไปยังท้าย bytearray โดยขยายขนาดขึ้นหนึ่งไบต์
- center(width: int, fillbyte: bytes) bytes¶
คืนค่าสำเนาของเนื้อหาที่จัดให้อยู่ตรงกลางในลำดับยาว width โดยเติมด้วย fillbyte ต่างจาก CPython ตรงที่ fillbyte เป็นสิ่งจำเป็น ข้อมูลจะถูกคืนไม่เปลี่ยนแปลงเมื่อ width ไม่มากกว่าความยาวปัจจุบัน
- count(sub: bytes, start: int = 0, end: int = -1) int¶
คืนค่าจำนวนครั้งที่พบ sub โดยไม่ทับซ้อนกันในช่วง
[start:end]
- endswith(suffix: bytes, start: int = 0, end: int = -1) bool¶
คืนค่า
Trueหากเนื้อหาลงท้ายด้วย suffix ต่างจาก CPython ตรงที่ suffix ไม่สามารถเป็น tuple ของค่าได้
- extend(iterable: Iterable[int]) None¶
ผนวกรายการทั้งหมดจาก iterable ไปยังท้าย bytearray ในฐานะส่วนขยายของ CPython สามารถใช้อ็อบเจกต์ใดก็ตามที่รองรับโปรโตคอลบัฟเฟอร์
- find(sub: bytes, start: int = 0, end: int = -1) int¶
คืนค่าดัชนีต่ำสุดที่พบ sub ในช่วง
[start:end]หรือ-1หากไม่พบ
- format(*args: Any, **kwargs: Any) str¶
ดำเนินการจัดรูปแบบสตริงโดยใช้เนื้อหาเป็นสตริงรูปแบบ และคืนค่าผลลัพธ์ที่จัดรูปแบบแล้ว
- hex(sep: str = '') str¶
คืนค่าสตริงของตัวเลขฐานสิบหกสองหลักสำหรับแต่ละไบต์ หาก sep ที่ไม่บังคับ (สตริงความยาว 1) ถูกระบุ จะถูกแทรกระหว่างค่าไบต์ที่ติดกัน
- index(sub: bytes, start: int = 0, end: int = -1) int¶
คล้ายกับ
find()แต่ทำให้เกิดValueErrorเมื่อไม่พบ sub
- isalpha() bool¶
คืนค่า
Trueหากไบต์ทั้งหมดเป็นอักขระ ASCII ที่เป็นตัวอักษรและมีอย่างน้อยหนึ่งไบต์ ไม่เช่นนั้นคืนค่าFalse
- isdigit() bool¶
คืนค่า
Trueหากไบต์ทั้งหมดเป็นตัวเลขทศนิยม ASCII และมีอย่างน้อยหนึ่งไบต์ ไม่เช่นนั้นคืนค่าFalse
- islower() bool¶
คืนค่า
Trueหากไบต์ที่มีตัวพิมพ์ทั้งหมดเป็นตัวพิมพ์เล็กและมีไบต์ที่มีตัวพิมพ์อย่างน้อยหนึ่งตัว ไม่เช่นนั้นคืนค่าFalse
- isspace() bool¶
คืนค่า
Trueหากไบต์ทั้งหมดเป็นช่องว่าง ASCII และมีอย่างน้อยหนึ่งไบต์ ไม่เช่นนั้นคืนค่าFalse
- isupper() bool¶
คืนค่า
Trueหากไบต์ที่มีตัวพิมพ์ทั้งหมดเป็นตัวพิมพ์ใหญ่และมีไบต์ที่มีตัวพิมพ์อย่างน้อยหนึ่งตัว ไม่เช่นนั้นคืนค่าFalse
- join(iterable: Iterable[bytes]) bytes¶
คืนค่าอ็อบเจกต์ bytes ซึ่งเป็นการต่อกันของรายการใน iterable โดยใช้เนื้อหา bytearray เป็นตัวคั่น
- lstrip(chars: bytes | None = None) bytes¶
คืนค่าสำเนาที่ลบไบต์นำหน้าออก chars ระบุชุดของไบต์ที่จะลบ หากละเว้นหรือเป็น
Noneจะลบช่องว่าง ASCII
- partition(sep: bytes) tuple¶
แบ่งที่การพบ sep ครั้งแรก คืนค่า
(head, sep, tail)หากไม่พบ sep จะคืนค่าเนื้อหาตามด้วยอ็อบเจกต์ว่างสองรายการ
- replace(old: bytes, new: bytes, count: int = -1) bytes¶
คืนค่าสำเนาที่แทนที่การพบ old ทั้งหมดด้วย new หาก count ถูกระบุ จะแทนที่เฉพาะ count ครั้งแรก
- rfind(sub: bytes, start: int = 0, end: int = -1) int¶
คืนค่าดัชนีสูงสุดที่พบ sub ในช่วง
[start:end]หรือ-1หากไม่พบ
- rindex(sub: bytes, start: int = 0, end: int = -1) int¶
คล้ายกับ
rfind()แต่ทำให้เกิดValueErrorเมื่อไม่พบ sub
- rpartition(sep: bytes) tuple¶
แบ่งที่การพบ sep ครั้งสุดท้าย คืนค่า
(head, sep, tail)หากไม่พบ sep จะคืนค่าอ็อบเจกต์ว่างสองรายการตามด้วยเนื้อหา
- rsplit(sep: bytes | None = None, maxsplit: int = -1) list¶
แบ่งที่การพบ sep เป็นรายการของส่วน โดยแบ่งไม่เกิน maxsplit ครั้งนับจากทางขวา หาก sep เป็น
Noneหรือละเว้น จะแบ่งที่ช่องว่าง ASCII
- rstrip(chars: bytes | None = None) bytes¶
คืนค่าสำเนาที่ลบไบต์ท้ายออก chars ระบุชุดของไบต์ที่จะลบ หากละเว้นหรือเป็น
Noneจะลบช่องว่าง ASCII
- split(sep: bytes | None = None, maxsplit: int = -1) list¶
แบ่งที่การพบ sep เป็นรายการของส่วน หาก sep เป็น
Noneหรือละเว้น จะแบ่งที่ช่องว่าง ASCII และช่องว่างนำหน้า/ท้ายจะถูกละเว้น
- splitlines(keepends: bool = False) list¶
คืนค่ารายการของบรรทัด โดยแบ่งที่
\n,\rและ\r\nจุดสิ้นสุดของบรรทัดจะไม่รวมอยู่ยกเว้น keepends เป็นจริง
- startswith(prefix: bytes, start: int = 0, end: int = -1) bool¶
คืนค่า
Trueหากเนื้อหาเริ่มต้นด้วย prefix ต่างจาก CPython ตรงที่ prefix ไม่สามารถเป็น tuple และ end ยอมรับแต่จะถูกละเว้น
- class bytes(source: int | str | Iterable[int] = b'', encoding: str = 'utf-8', errors: str = 'strict')¶
ลำดับที่ไม่สามารถแก้ไขได้ของจำนวนเต็มในช่วง 0-255 สร้างจากจำนวนเต็ม (บัฟเฟอร์ที่เติมด้วยศูนย์) iterable ของ int, สตริงพร้อม
encodingหรืออ็อบเจกต์ที่รองรับโปรโตคอลบัฟเฟอร์ ตัวอักษรไบต์ใช้ไวยากรณ์b'...'- classmethod fromhex(string: str) bytes¶
สร้างอ็อบเจกต์
bytesจากสตริงของคู่ตัวเลขฐานสิบหก การเว้นวรรคระหว่างคู่ตัวเลขจะถูกข้ามไป อักขระที่ไม่ใช่เลขฐานสิบหกจะทำให้เกิดValueError
- center(width: int, fillbyte: bytes) bytes¶
คืนค่าสำเนาที่จัดให้อยู่ตรงกลางในลำดับยาว width โดยเติมด้วย fillbyte (bytes ความยาว 1 ที่ให้ไบต์เติม) ต่างจาก CPython ตรงที่ fillbyte เป็นสิ่งจำเป็น อ็อบเจกต์เดิมจะถูกคืนไม่เปลี่ยนแปลงเมื่อ width ไม่มากกว่าความยาวของมัน
- count(sub: bytes, start: int = 0, end: int = -1) int¶
คืนค่าจำนวนครั้งที่พบ sub โดยไม่ทับซ้อนกันในช่วง
[start:end]
- decode(encoding: str = 'utf-8') str¶
คืนค่า
strที่ถอดรหัสจาก bytes ใน MicroPython อาร์กิวเมนต์ encoding จะยอมรับแต่ไม่มีผล (bytes จะถูกตีความใหม่เป็น UTF-8)
- endswith(suffix: bytes, start: int = 0, end: int = -1) bool¶
คืนค่า
Trueหาก bytes ลงท้ายด้วย suffix ต่างจาก CPython ตรงที่ suffix ไม่สามารถเป็น tuple ของค่าที่จะลอง
- find(sub: bytes, start: int = 0, end: int = -1) int¶
คืนค่าดัชนีต่ำสุดที่พบลำดับย่อย sub ในช่วง
[start:end]หรือ-1หากไม่พบ
- format(*args: Any, **kwargs: Any) str¶
ดำเนินการจัดรูปแบบสตริงโดยใช้ bytes เป็นสตริงรูปแบบ และคืนค่าผลลัพธ์ที่จัดรูปแบบแล้ว
- hex(sep: str = '') str¶
คืนค่าสตริงของตัวเลขฐานสิบหกสองหลักสำหรับแต่ละไบต์ หาก sep ที่ไม่บังคับ (สตริงความยาว 1) ถูกระบุ จะถูกแทรกระหว่างค่าไบต์ที่ติดกัน
- index(sub: bytes, start: int = 0, end: int = -1) int¶
คล้ายกับ
find()แต่ทำให้เกิดValueErrorเมื่อไม่พบ sub
- isalpha() bool¶
คืนค่า
Trueหากไบต์ทั้งหมดเป็นอักขระ ASCII ที่เป็นตัวอักษรและมีอย่างน้อยหนึ่งไบต์ ไม่เช่นนั้นคืนค่าFalse
- isdigit() bool¶
คืนค่า
Trueหากไบต์ทั้งหมดเป็นตัวเลขทศนิยม ASCII และมีอย่างน้อยหนึ่งไบต์ ไม่เช่นนั้นคืนค่าFalse
- islower() bool¶
คืนค่า
Trueหากไบต์ที่มีตัวพิมพ์ทั้งหมดเป็นตัวพิมพ์เล็กและมีไบต์ที่มีตัวพิมพ์อย่างน้อยหนึ่งตัว ไม่เช่นนั้นคืนค่าFalse
- isspace() bool¶
คืนค่า
Trueหากไบต์ทั้งหมดเป็นช่องว่าง ASCII และมีอย่างน้อยหนึ่งไบต์ ไม่เช่นนั้นคืนค่าFalse
- isupper() bool¶
คืนค่า
Trueหากไบต์ที่มีตัวพิมพ์ทั้งหมดเป็นตัวพิมพ์ใหญ่และมีไบต์ที่มีตัวพิมพ์อย่างน้อยหนึ่งตัว ไม่เช่นนั้นคืนค่าFalse
- join(iterable: Iterable[bytes]) bytes¶
คืนค่าอ็อบเจกต์ bytes ซึ่งเป็นการต่อกันของรายการใน iterable โดยใช้อ็อบเจกต์ bytes เองเป็นตัวคั่น
- lstrip(chars: bytes | None = None) bytes¶
คืนค่าสำเนาที่ลบไบต์นำหน้าออก chars ระบุชุดของไบต์ที่จะลบ หากละเว้นหรือเป็น
Noneจะลบช่องว่าง ASCII
- partition(sep: bytes) tuple¶
แบ่งที่การพบ sep ครั้งแรก คืนค่า
(head, sep, tail)หากไม่พบ sep จะคืนค่า bytes ตามด้วยอ็อบเจกต์ bytes ว่างสองรายการ
- replace(old: bytes, new: bytes, count: int = -1) bytes¶
คืนค่าสำเนาที่แทนที่การพบ old ทั้งหมดด้วย new หาก count ถูกระบุ จะแทนที่เฉพาะ count ครั้งแรก
- rfind(sub: bytes, start: int = 0, end: int = -1) int¶
คืนค่าดัชนีสูงสุดที่พบ sub ในช่วง
[start:end]หรือ-1หากไม่พบ
- rindex(sub: bytes, start: int = 0, end: int = -1) int¶
คล้ายกับ
rfind()แต่ทำให้เกิดValueErrorเมื่อไม่พบ sub
- rpartition(sep: bytes) tuple¶
แบ่งที่การพบ sep ครั้งสุดท้าย คืนค่า
(head, sep, tail)หากไม่พบ sep จะคืนค่าอ็อบเจกต์ bytes ว่างสองรายการตามด้วย bytes
- rsplit(sep: bytes | None = None, maxsplit: int = -1) list¶
แบ่งที่การพบ sep เป็นรายการของส่วน โดยแบ่งไม่เกิน maxsplit ครั้งนับจากทางขวา หาก sep เป็น
Noneหรือละเว้น จะแบ่งที่ช่องว่าง ASCII
- rstrip(chars: bytes | None = None) bytes¶
คืนค่าสำเนาที่ลบไบต์ท้ายออก chars ระบุชุดของไบต์ที่จะลบ หากละเว้นหรือเป็น
Noneจะลบช่องว่าง ASCII
- split(sep: bytes | None = None, maxsplit: int = -1) list¶
แบ่งที่การพบ sep เป็นรายการของส่วน หาก sep เป็น
Noneหรือละเว้น จะแบ่งที่ช่องว่าง ASCII และช่องว่างนำหน้า/ท้ายจะถูกละเว้น
- splitlines(keepends: bool = False) list¶
คืนค่ารายการของบรรทัด โดยแบ่งที่
\n,\rและ\r\nจุดสิ้นสุดของบรรทัดจะไม่รวมอยู่ยกเว้น keepends เป็นจริง
- startswith(prefix: bytes, start: int = 0, end: int = -1) bool¶
คืนค่า
Trueหาก bytes เริ่มต้นด้วย prefix ต่างจาก CPython ตรงที่ prefix ไม่สามารถเป็น tuple และ end ยอมรับแต่จะถูกละเว้น
- classmethod(func: Callable[..., Any]) classmethod¶
แปลงเมธอดให้เป็น class method โดยทั่วไปใช้เป็น decorator
- compile(source: str | bytes, filename: str, mode: str) Any¶
คอมไพล์ source เป็นอ็อบเจกต์โค้ดที่สามารถรันโดย
exec()หรือeval()mode เป็นหนึ่งใน"exec","eval"หรือ"single"
- class complex(real: float | str = 0, imag: float = 0)¶
สร้างจำนวนเชิงซ้อนจากส่วนจริงและส่วนจินตภาพ หรือจากสตริง
- delattr(obj, name: str) None¶
อาร์กิวเมนต์ name ควรเป็นสตริง และฟังก์ชันนี้จะลบแอตทริบิวต์ที่ระบุชื่อออกจากอ็อบเจกต์ที่กำหนดโดย obj
- class dict(*args, **kwargs)¶
สร้างพจนานุกรมใหม่ เทียบเท่ากับ
dictของ CPython- classmethod fromkeys(iterable: Iterable[Any], value: Any = None) dict¶
สร้างพจนานุกรมใหม่ที่มีคีย์มาจาก iterable โดยแต่ละอันแมปไปยัง value (ค่าเริ่มต้นเป็น
None) เรียกบนประเภท เช่นdict.fromkeys(...)
- clear() None¶
ลบรายการทั้งหมดออกจากพจนานุกรม ทำให้ว่างเปล่า ทำให้เกิด
TypeErrorหากพจนานุกรมถูกกำหนดตาย (อ่านอย่างเดียว)
- copy() dict¶
คืนค่าสำเนาตื้นของพจนานุกรม อ็อบเจกต์ที่คืนค่ามีประเภทเดียวกับต้นฉบับ (
dictหรือOrderedDict) แต่ไม่ถูกกำหนดตาย
- get(key: Any, default: Any = None) Any¶
คืนค่าค่าสำหรับ key หากอยู่ในพจนานุกรม ไม่เช่นนั้นคืนค่า default (ซึ่งเป็น
Noneโดยค่าเริ่มต้น ดังนั้นจะไม่ทำให้เกิดKeyError) พจนานุกรมไม่ถูกแก้ไข
- items() Any¶
คืนค่าอ็อบเจกต์มุมมองแบบไดนามิกของคู่
(key, value)ที่สะท้อนการเปลี่ยนแปลงในภายหลังของพจนานุกรม และรองรับการวนซ้ำlen()ตัวดำเนินการinและตัวดำเนินการเปรียบเทียบเซต
- keys() Any¶
คืนค่าอ็อบเจกต์มุมมองแบบไดนามิกของคีย์ที่สะท้อนการเปลี่ยนแปลงในภายหลังของพจนานุกรม และรองรับการวนซ้ำ
len()ตัวดำเนินการinและตัวดำเนินการเปรียบเทียบเซต
- pop(key: Any, default: Any = None) Any¶
ลบ key ออกจากพจนานุกรมและคืนค่าของมัน หาก key ไม่มีอยู่ จะคืนค่า default หากระบุไว้ ไม่เช่นนั้นจะทำให้เกิด
KeyErrorทำให้เกิดTypeErrorหากพจนานุกรมถูกกำหนดตาย
- popitem() tuple¶
ลบและคืนค่าคู่
(key, value)ที่ไม่แน่นอนเป็น tuple 2 ตัว สำหรับdictธรรมดา คู่ที่เลือกจะไม่ระบุ สำหรับOrderedDictคู่ที่แทรกล่าสุดจะถูกลบ (LIFO) ทำให้เกิดKeyErrorหากพจนานุกรมว่างเปล่า หรือTypeErrorหากถูกกำหนดตาย
- setdefault(key: Any, default: Any = None) Any¶
หาก key อยู่ในพจนานุกรม จะคืนค่าของมัน ไม่เช่นนั้นจะแทรก key พร้อมค่า default (ค่าเริ่มต้นเป็น
None) และคืนค่านั้น ทำให้เกิดTypeErrorหากพจนานุกรมถูกกำหนดตาย
- update(*args: Any, **kwargs: Any) None¶
อัปเดตพจนานุกรมในตำแหน่ง ยอมรับอาร์กิวเมนต์ตำแหน่งไม่เกินหนึ่งตัว: ทั้งพจนานุกรมอื่น หรือ iterable ของคู่
(key, value)สองอิลิเมนต์ (แต่ละรายการต้องให้สองรายการพอดีหรือValueErrorจะถูกทำให้เกิด) อาร์กิวเมนต์คีย์เวิร์ดจะถูกเพิ่มเป็นรายการที่มีคีย์เป็นสตริง คีย์ที่มีอยู่จะถูกเขียนทับ ทำให้เกิดTypeErrorหากพจนานุกรมถูกกำหนดตาย
- values() Any¶
คืนค่าอ็อบเจกต์มุมมองแบบไดนามิกของค่าที่สะท้อนการเปลี่ยนแปลงในภายหลังของพจนานุกรม และรองรับการวนซ้ำและ
len()
- dir(obj: Any = None) list¶
ไม่มีอาร์กิวเมนต์ คืนค่ารายการชื่อในขอบเขตท้องถิ่นปัจจุบัน มีอาร์กิวเมนต์ จะคืนค่ารายการแอตทริบิวต์ที่ถูกต้องสำหรับอ็อบเจกต์นั้น
- divmod(a: Any, b: Any) tuple¶
คืนค่าคู่
(a // b, a % b)เป็น tuple สำหรับตัวเลขสอง (ที่ไม่ซับซ้อน) ตัว
- enumerate(iterable: Iterable[Any], start: int = 0) Iterator[tuple]¶
คืนค่าอ็อบเจกต์ enumerate ที่ให้คู่
(index, value)จาก iterable โดยดัชนีเริ่มต้นที่ start
- eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) Any¶
ประเมินนิพจน์ Python ที่กำหนดเป็นสตริง (หรืออ็อบเจกต์โค้ดที่คอมไพล์แล้ว) และคืนค่าผลลัพธ์
- exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) None¶
รันโค้ด Python แบบไดนามิกที่กำหนดเป็นสตริงหรืออ็อบเจกต์โค้ดที่คอมไพล์แล้ว
- filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) Iterator[Any]¶
สร้าง iterator จากสมาชิกของ iterable ที่ function คืนค่าจริง หาก function เป็น
Noneจะถือว่าใช้ฟังก์ชันตัวตน
- class frozenset(iterable: Iterable[Any] = ())¶
คืนค่าอ็อบเจกต์ frozenset ใหม่ อาจเลือกมีสมาชิกจาก iterable
frozensetเป็นตัวแปรsetที่ไม่สามารถแก้ไขได้และ hashable- difference(*others: Iterable[Any]) frozenset¶
คืนค่า frozenset ใหม่ที่มีสมาชิกจาก frozenset ที่ไม่อยู่ใน others อาร์กิวเมนต์แต่ละตัวอาจเป็น iterable ใดก็ได้
- intersection(other: Iterable[Any]) frozenset¶
คืนค่า frozenset ใหม่ที่มีสมาชิกร่วมกับ frozenset และ other ใน MicroPython ยอมรับเฉพาะอาร์กิวเมนต์ other เดียว (CPython ยอมรับหลายตัว)
- getattr(obj: Any, name: str, default: Any = None) Any¶
คืนค่าค่าของแอตทริบิวต์ที่ระบุชื่อของ obj หากแอตทริบิวต์ไม่มีอยู่ default จะถูกคืนค่าหากระบุไว้ ไม่เช่นนั้น
AttributeErrorจะถูกทำให้เกิด
- hasattr(obj: Any, name: str) bool¶
คืนค่า
Trueหาก obj มีแอตทริบิวต์ที่ชื่อ name ไม่เช่นนั้นคืนค่าFalse
- hash(obj: Any) int¶
คืนค่าแฮชของ obj (หากมี) ค่าแฮชเป็นจำนวนเต็มที่ใช้เปรียบเทียบคีย์พจนานุกรมได้อย่างรวดเร็วระหว่างการค้นหา
- id(obj: Any) int¶
คืนค่าเอกลักษณ์ของอ็อบเจกต์ ซึ่งเป็นจำนวนเต็มที่รับประกันว่าไม่ซ้ำกันและคงที่สำหรับอ็อบเจกต์นี้ตลอดอายุการใช้งาน
- input(prompt: str = '') str¶
อ่านบรรทัดจากอินพุตมาตรฐานและคืนค่าเป็นสตริง (โดยไม่มีขึ้นบรรทัดใหม่ต่อท้าย) หาก prompt ถูกระบุ จะถูกเขียนไปยังเอาต์พุตมาตรฐานโดยไม่มีขึ้นบรรทัดใหม่ต่อท้ายก่อน
- class int(x: str | bytes | int | float = 0, base: int = 10)¶
- isinstance(obj: Any, classinfo: type | tuple) bool¶
คืนค่า
Trueหาก obj เป็นอินสแตนซ์ของ classinfo หรือคลาสย่อยใดๆ ของมัน classinfo อาจเป็นคลาสหรือ tuple ของคลาส
- issubclass(cls: type, classinfo: type | tuple) bool¶
คืนค่า
Trueหาก cls เป็นคลาสย่อย (โดยตรง โดยอ้อม หรือเสมือน) ของ classinfo
- iter(obj: Any, sentinel: Any = None) Iterator[Any]¶
คืนค่าอ็อบเจกต์ iterator ด้วยอาร์กิวเมนต์หนึ่งตัว obj ต้องรองรับโปรโตคอลการวนซ้ำ ด้วยสองอาร์กิวเมนต์ obj ต้องเรียกได้และการวนซ้ำจะหยุดเมื่อคืนค่า sentinel
- class list(iterable: Iterable[Any] = ())¶
สร้างรายการใหม่ อาจเลือกนำมาจากรายการใน iterable
- extend(iterable: Iterable[Any]) None¶
ผนวกรายการทั้งหมดจาก iterable ไปยังท้ายของรายการ หาก iterable เป็นรายการเอง รายการของมันจะถูกคัดลอกโดยตรง ไม่เช่นนั้นจะถูกวนซ้ำ
- index(value: Any, start: int = 0, stop: int = -1) int¶
คืนค่าดัชนีของสมาชิกแรกที่เท่ากับ value โดยค้นหาในช่วง
[start:stop]ทำให้เกิดValueErrorหาก value ไม่มีอยู่
- insert(index: int, object: Any) None¶
แทรก object ก่อนตำแหน่ง index ดัชนีลบจะถูกตีความเทียบกับท้ายของรายการ และดัชนีจะถูกจำกัดให้อยู่ในช่วงที่ถูกต้อง (ดังนั้นค่าที่เกินทั้งสองด้านจะแทรกที่ต้นหรือท้าย)
- pop(index: int = -1) Any¶
ลบและคืนค่ารายการที่ index (รายการสุดท้ายโดยค่าเริ่มต้น) ทำให้เกิด
IndexErrorหากรายการว่างเปล่าหรือ index อยู่นอกช่วง
- remove(value: Any) None¶
ลบสมาชิกแรกที่เท่ากับ value ทำให้เกิด
ValueErrorหาก value ไม่มีอยู่
- sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) None¶
เรียงลำดับรายการในตำแหน่ง key และ reverse เป็น keyword-only key หากระบุ เป็นฟังก์ชันที่ใช้กับแต่ละสมาชิกเพื่อสร้างค่าเปรียบเทียบ reverse เรียงลำดับจากมากไปน้อย
Note
ต่างจาก CPython ตรงที่การเรียงลำดับรายการของ MicroPython ไม่ เสถียร
- map(function: Callable[..., Any], *iterables: Iterable[Any]) Iterator[Any]¶
คืนค่า iterator ที่ใช้ function กับทุกรายการของ iterables โดยให้ผลลัพธ์
- max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) Any¶
ด้วยอาร์กิวเมนต์ iterable เดียว คืนค่ารายการที่ใหญ่ที่สุด ด้วยสองอาร์กิวเมนต์ขึ้นไป คืนค่าอาร์กิวเมนต์ที่ใหญ่ที่สุด
- class memoryview(obj: Any)¶
สร้าง memoryview ที่อ้างอิง obj ซึ่งต้องรองรับโปรโตคอลบัฟเฟอร์ (เช่น
bytes,bytearray,array.array) รองรับการเข้าถึงและการแบ่งส่วนหน่วยความจำพื้นฐานโดยไม่ต้องคัดลอก การแบ่งส่วน memoryview จะคืนค่า memoryview อีกตัวแทนที่จะเป็นสำเนา
- min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) Any¶
ด้วยอาร์กิวเมนต์ iterable เดียว คืนค่ารายการที่เล็กที่สุด ด้วยสองอาร์กิวเมนต์ขึ้นไป คืนค่าอาร์กิวเมนต์ที่เล็กที่สุด
- next(iterator: Iterator[Any], default: Any = None) Any¶
ดึงรายการถัดไปจาก iterator หาก default ถูกระบุและ iterator หมด default จะถูกคืนค่าแทนที่จะทำให้เกิด
StopIteration
- class object¶
คืนค่าอ็อบเจกต์ใหม่ที่ไม่มีลักษณะเฉพาะ
objectเป็นคลาสฐานสำหรับทุกคลาส
- open(file: str, mode: str = 'r', **kwargs) Any¶
เปิด file และคืนค่าอ็อบเจกต์ไฟล์ที่สอดคล้องกัน mode ค่าเริ่มต้นเป็น
"r"สำหรับการอ่านข้อความ
- pow(base: Any, exp: Any, mod: Any | None = None) Any¶
คืนค่า base ยกกำลัง exp หาก mod ถูกระบุ จะคืนค่า
base ** exp % mod(คำนวณได้อย่างมีประสิทธิภาพมากกว่าแบบชัดเจน)
- print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) None¶
พิมพ์ objects ไปยังสตรีมข้อความ file โดยแยกด้วย sep และต่อท้ายด้วย 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¶
คืนค่าแอตทริบิวต์ property โดยทั่วไปใช้เป็น decorator เพื่อกำหนดแอตทริบิวต์ที่จัดการบนคลาส
- range(*args: int) range¶
คืนค่าลำดับที่ไม่สามารถแก้ไขได้ของจำนวนเต็ม เรียกเป็น
range(stop),range(start, stop)หรือrange(start, stop, step)
- reversed(seq: Any) Iterator[Any]¶
คืนค่า reverse iterator สำหรับค่าของลำดับที่กำหนด
- round(number: Any, ndigits: int | None = None) Any¶
คืนค่า number ที่ปัดเศษเป็นทศนิยม ndigits ตำแหน่ง หาก ndigits ถูกละเว้น จะคืนค่าจำนวนเต็มที่ใกล้เคียงที่สุด
- class set(iterable: Iterable[Any] = ())¶
คืนค่าอ็อบเจกต์ set ใหม่ อาจเลือกมีสมาชิกจาก iterable
- difference(*others: Iterable[Any]) set¶
คืนค่า set ใหม่ที่มีสมาชิกจากเซตที่ไม่อยู่ใน others อาร์กิวเมนต์แต่ละตัวอาจเป็น iterable ใดก็ได้
- discard(elem: Any) None¶
ลบสมาชิก elem ออกจากเซตหากมีอยู่ ต่างจาก
remove()ตรงที่จะไม่ทำให้เกิดข้อผิดพลาดหาก elem ไม่มีอยู่
- intersection(other: Iterable[Any]) set¶
คืนค่า set ใหม่ที่มีสมาชิกร่วมกับเซตและ other ใน MicroPython ยอมรับเฉพาะอาร์กิวเมนต์ other เดียว (CPython ยอมรับหลายตัว)
- intersection_update(other: Iterable[Any]) None¶
อัปเดตเซต โดยเก็บเฉพาะสมาชิกที่พบใน other ด้วย (ในตำแหน่ง) ใน MicroPython ยอมรับเฉพาะอาร์กิวเมนต์ other เดียว
- symmetric_difference(other: Iterable[Any]) set¶
คืนค่า set ใหม่ที่มีสมาชิกในเซตหรือ other แต่ไม่ทั้งสอง ใน MicroPython ยอมรับเฉพาะอาร์กิวเมนต์ other เดียว
- symmetric_difference_update(other: Iterable[Any]) None¶
อัปเดตเซต โดยเก็บเฉพาะสมาชิกที่พบในเซตหรือ other แต่ไม่ทั้งสอง (ในตำแหน่ง) ใน MicroPython ยอมรับเฉพาะอาร์กิวเมนต์ other เดียว
- setattr(obj: Any, name: str, value: Any) None¶
กำหนดแอตทริบิวต์ที่ระบุชื่อบน obj เป็น value เป็นคู่ตรงข้ามของ
getattr()
- class slice¶
slice builtin เป็นประเภทที่อ็อบเจกต์ slice มี
- sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) list¶
คืนค่ารายการที่เรียงลำดับใหม่จากรายการใน iterable
- staticmethod(func: Callable[..., Any]) staticmethod¶
แปลงเมธอดให้เป็น static method โดยทั่วไปใช้เป็น decorator
- class str(object: Any = '', encoding: str = 'utf-8', errors: str = 'strict')¶
คืนค่าเวอร์ชันสตริงของ object หาก object เป็นอ็อบเจกต์ที่คล้าย bytes อาร์กิวเมนต์ encoding และ errors จะควบคุมการถอดรหัส
- center(width: int) str¶
คืนค่าสำเนาของสตริงที่จัดให้อยู่ตรงกลางในฟิลด์ยาว width โดยเติมด้วยช่องว่าง ใน MicroPython ใช้เฉพาะช่องว่างเป็นอักขระเติม (ไม่มีอาร์กิวเมนต์อักขระเติม) และสตริงเดิมจะถูกคืนไม่เปลี่ยนแปลงเมื่อ width ไม่มากกว่าความยาวของมัน
- count(sub: str, start: int = 0, end: int = -1) int¶
คืนค่าจำนวนครั้งที่พบ sub โดยไม่ทับซ้อนกันในช่วง
[start:end]sub ว่างเปล่านับแต่ละช่องว่างระหว่างอักขระ
- encode(encoding: str = 'utf-8', errors: str = 'strict') bytes¶
คืนค่าอ็อบเจกต์
bytesที่เข้ารหัสสตริง MicroPython ละเว้นอาร์กิวเมนต์และใช้ UTF-8 errors ยอมรับแต่ไม่ดำเนินการ เทียบเท่ากับbytes(s, "utf-8")
- endswith(suffix: str | tuple, start: int = 0, end: int = -1) bool¶
คืนค่า
Trueหากสตริงลงท้ายด้วย suffix ที่กำหนด ซึ่งอาจเป็นสตริงเดียวหรือ tuple ของสตริงที่จะลอง start และ end ที่เลือกได้จะจำกัดการเปรียบเทียบให้อยู่ในช่วง[start:end]
- find(sub: str, start: int = 0, end: int = -1) int¶
คืนค่าดัชนีต่ำสุดในสตริงที่พบ sub ในช่วง
[start:end]หรือ-1หากไม่พบ
- format(*args: Any, **kwargs: Any) str¶
ดำเนินการจัดรูปแบบสตริงโดยแทนที่ฟิลด์ที่ล้อมด้วยวงเล็บปีกกา
{}ด้วยค่าจาก args และ kwargs รองรับภาษา mini-language สำหรับการระบุรูปแบบมาตรฐาน
- index(sub: str, start: int = 0, end: int = -1) int¶
คล้ายกับ
find()แต่ทำให้เกิดValueErrorเมื่อไม่พบ sub ในช่วง[start:end]
- isalpha() bool¶
คืนค่า
Trueหากอักขระทั้งหมดในสตริงเป็นตัวอักษรและสตริงไม่ว่างเปล่า ไม่เช่นนั้นคืนค่าFalse
- isdigit() bool¶
คืนค่า
Trueหากอักขระทั้งหมดในสตริงเป็นตัวเลขและสตริงไม่ว่างเปล่า ไม่เช่นนั้นคืนค่าFalse
- islower() bool¶
คืนค่า
Trueหากสตริงมีอักขระตัวอักษรอย่างน้อยหนึ่งตัวและอักขระดังกล่าวทั้งหมดเป็นตัวพิมพ์เล็ก ไม่เช่นนั้นคืนค่าFalse
- isspace() bool¶
คืนค่า
Trueหากอักขระทั้งหมดในสตริงเป็นช่องว่างและสตริงไม่ว่างเปล่า ไม่เช่นนั้นคืนค่าFalse
- isupper() bool¶
คืนค่า
Trueหากสตริงมีอักขระตัวอักษรอย่างน้อยหนึ่งตัวและอักขระดังกล่าวทั้งหมดเป็นตัวพิมพ์ใหญ่ ไม่เช่นนั้นคืนค่าFalse
- join(iterable: Iterable[str]) str¶
ต่อกันสตริงใน iterable โดยแทรกสตริงนี้เป็นตัวคั่นระหว่างสมาชิก รายการต้องเป็นสตริง ไม่เช่นนั้น
TypeErrorจะถูกทำให้เกิด
- lstrip(chars: str | None = None) str¶
คืนค่าสำเนาของสตริงที่ลบอักขระนำหน้าออก หาก chars ถูกละเว้นหรือเป็น
Noneช่องว่างจะถูกลบ ไม่เช่นนั้น chars จะถูกถือว่าเป็นชุดอักขระที่จะลบ
- partition(sep: str) tuple¶
แบ่งสตริงที่การพบ sep ครั้งแรกและคืนค่า tuple 3 ตัว
(head, sep, tail)หากไม่พบ sep จะคืนค่า(self, "", "")sep ว่างเปล่าจะทำให้เกิดValueError
- replace(old: str, new: str, count: int = -1) str¶
คืนค่าสำเนาของสตริงที่แทนที่การพบ old ทั้งหมดด้วย new หาก count ถูกระบุและไม่เป็นลบ จะแทนที่เฉพาะ count ครั้งแรก
- rfind(sub: str, start: int = 0, end: int = -1) int¶
คืนค่าดัชนีสูงสุดในสตริงที่พบ sub ในช่วง
[start:end]หรือ-1หากไม่พบ
- rindex(sub: str, start: int = 0, end: int = -1) int¶
คล้ายกับ
rfind()แต่ทำให้เกิดValueErrorเมื่อไม่พบ sub ในช่วง[start:end]
- rpartition(sep: str) tuple¶
แบ่งสตริงที่การพบ sep ครั้งสุดท้ายและคืนค่า tuple 3 ตัว
(head, sep, tail)หากไม่พบ sep จะคืนค่า("", "", self)sep ว่างเปล่าจะทำให้เกิดValueError
- rsplit(sep: str | None = None, maxsplit: int = -1) list¶
แบ่งสตริงจากทางขวาเป็นรายการของสตริงย่อยโดยใช้ sep เป็นตัวแบ่ง โดยแบ่งไม่เกิน maxsplit ครั้ง หากไม่มี maxsplit (หรือเป็นลบ) จะทำงานเหมือนกับ
split()ใน MicroPythonrsplit(None, n)ที่มี n ไม่เป็นลบจะทำให้เกิดNotImplementedError
- rstrip(chars: str | None = None) str¶
คืนค่าสำเนาของสตริงที่ลบอักขระท้ายออก หาก chars ถูกละเว้นหรือเป็น
Noneช่องว่างจะถูกลบ ไม่เช่นนั้น chars จะถูกถือว่าเป็นชุดอักขระที่จะลบ
- split(sep: str | None = None, maxsplit: int = -1) list¶
แบ่งสตริงเป็นรายการของสตริงย่อยโดยใช้ sep เป็นตัวแบ่ง โดยแบ่งไม่เกิน maxsplit ครั้ง หาก sep ถูกละเว้นหรือเป็น
Noneจะแบ่งที่ช่องว่างโดยละเว้นช่องว่างนำหน้า ไม่เช่นนั้น sep ว่างเปล่าจะทำให้เกิดValueError
- splitlines(keepends: bool = False) list¶
คืนค่ารายการของบรรทัดในสตริง โดยแบ่งที่
\n,\rและ\r\nจุดสิ้นสุดของบรรทัดจะไม่รวมอยู่ยกเว้น keepends เป็นจริง
- startswith(prefix: str | tuple, start: int = 0, end: int = -1) bool¶
คืนค่า
Trueหากสตริงเริ่มต้นด้วย prefix ที่กำหนด ซึ่งอาจเป็นสตริงเดียวหรือ tuple ของสตริงที่จะลอง start และ end ที่เลือกได้จะจำกัดการเปรียบเทียบให้อยู่ในช่วง[start:end]
- sum(iterable: Iterable[Any], start: Any = 0) Any¶
บวก start กับรายการใน iterable จากซ้ายไปขวา และคืนค่าผลรวม
- super(type: type | None = None, obj_or_type: Any | None = None) Any¶
คืนค่าอ็อบเจกต์ proxy ที่มอบหมายการเรียกเมธอดให้กับคลาสแม่หรือคลาสพี่น้องของ type มีประโยชน์สำหรับการเข้าถึงเมธอดที่สืบทอดซึ่งถูกแทนที่ในคลาส
ข้อยกเว้น¶
- exception AssertionError¶
ทำให้เกิดขึ้นเมื่อคำสั่ง
assertล้มเหลว
- exception AttributeError¶
ทำให้เกิดขึ้นเมื่อการอ้างอิงแอตทริบิวต์หรือการกำหนดค่าล้มเหลว
- exception Exception¶
คลาสฐานทั่วไปสำหรับข้อยกเว้นที่ไม่ได้ทำให้ระบบออกทั้งหมด
- exception ImportError¶
ทำให้เกิดขึ้นเมื่อคำสั่ง
importไม่สามารถหาคำนิยามโมดูลได้
- exception IndexError¶
ทำให้เกิดขึ้นเมื่อตัวห้อยลำดับอยู่นอกช่วง
- exception KeyboardInterrupt¶
ทำให้เกิดขึ้นเมื่อผู้ใช้หยุดการรันโปรแกรม โดยทั่วไปกด
Ctrl+Cบน REPLดูเพิ่มเติมในบริบทของ Soft Bricking (การบูตล้มเหลว)
- exception KeyError¶
ทำให้เกิดขึ้นเมื่อไม่พบคีย์การแมป (พจนานุกรม) ในชุดคีย์ที่มีอยู่
- exception MemoryError¶
ทำให้เกิดขึ้นเมื่อการดำเนินการหน่วยความจำหมด
- exception NameError¶
ทำให้เกิดขึ้นเมื่อไม่พบชื่อท้องถิ่นหรือส่วนกลาง
- exception NotImplementedError¶
ทำให้เกิดขึ้นเมื่อเมธอด abstract หรือฟีเจอร์ที่ยังไม่ได้ใช้งานถูกเรียก
- exception OSError¶
ทำให้เกิดขึ้นเมื่อฟังก์ชันระบบคืนค่าข้อผิดพลาดที่เกี่ยวข้องกับระบบ
- exception RuntimeError¶
ทำให้เกิดขึ้นเมื่อตรวจพบข้อผิดพลาดที่ไม่อยู่ในหมวดหมู่อื่นๆ
- exception StopIteration¶
ทำให้เกิดขึ้นโดย
next()และเมธอด__next__()ของ iterator เพื่อแจ้งว่าไม่มีรายการเพิ่มเติม
- exception SyntaxError¶
ทำให้เกิดขึ้นเมื่อ parser พบข้อผิดพลาดทางไวยากรณ์
- exception SystemExit¶
ทำให้เกิดขึ้นโดย
sys.exit()เพื่อร้องขอการสิ้นสุด interpreter ต่างจากข้อยกเว้นส่วนใหญ่ จะไม่สร้าง traceback เมื่อไม่ถูกจับบน OpenMV Cam
SystemExitที่ไม่ได้จัดการจะทำให้เกิด รีเซ็ตแบบซอฟต์ ของ MicroPython ในปัจจุบัน
- exception TypeError¶
ทำให้เกิดขึ้นเมื่อการดำเนินการหรือฟังก์ชันถูกใช้กับอ็อบเจกต์ที่มีประเภทไม่เหมาะสม
- exception ValueError¶
ทำให้เกิดขึ้นเมื่อการดำเนินการหรือฟังก์ชัน builtin ได้รับอาร์กิวเมนต์ที่มีประเภทถูกต้องแต่มีค่าไม่เหมาะสม
- exception ZeroDivisionError¶
ทำให้เกิดขึ้นเมื่ออาร์กิวเมนต์ที่สองของการหารหรือการดำเนินการโมดูโลเป็นศูนย์