builtins --- các hàm và ngoại lệ dựng sẵn

Tất cả các hàm và ngoại lệ dựng sẵn đều được mô tả ở đây. Chúng cũng có thể truy cập thông qua module builtins.

Hàm và kiểu dữ liệu

abs(x: Any) → Any

Trả về giá trị tuyệt đối của một số. Đối số có thể là số nguyên, số thực, hoặc bất kỳ đối tượng nào có cài đặt __abs__().

all(iterable: Iterable[Any]) → bool

Trả về True nếu tất cả các phần tử của iterable đều là giá trị đúng (hoặc nếu iterable rỗng).

any(iterable: Iterable[Any]) → bool

Trả về True nếu có bất kỳ phần tử nào của iterable là giá trị đúng. Trả về False nếu iterable rỗng.

bin(x: int) → str

Chuyển đổi một số nguyên thành chuỗi nhị phân có tiền tố "0b". Đối số phải là một số nguyên Python hoặc có cài đặt __index__().

class bool(x: Any = False)

Trả về giá trị boolean, tức là một trong hai giá trị True hoặc False. x được chuyển đổi theo quy trình kiểm tra tính đúng sai chuẩn.

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

Chuỗi số nguyên có thể thay đổi trong khoảng 0-255. Cách khởi tạo tuân theo các quy tắc tương tự như bytes: từ một số nguyên (tạo bộ đệm điền 0 với kích thước đó), một iterable của các số nguyên, một chuỗi với encoding, hoặc bất kỳ đối tượng nào hỗ trợ giao thức buffer. Hỗ trợ các phép toán trên chuỗi chuẩn cộng với việc sửa đổi tại chỗ.

classmethod fromhex(string: str) → bytearray

Xây dựng một bytearray từ một chuỗi các cặp chữ số thập lục phân. Khoảng trắng giữa các cặp chữ số bị bỏ qua; một ký tự không phải hex sẽ gây ra ValueError.

append(val: int) → None

Thêm một giá trị đơn lẻ (một số nguyên trong khoảng 0-255) vào cuối bytearray, làm nó tăng thêm một byte.

center(width: int, fillbyte: bytes) → bytes

Trả về một bản sao của nội dung được căn giữa trong một chuỗi có độ dài width, được đệm bằng fillbyte. Không giống CPython, fillbyte là bắt buộc. Dữ liệu được trả về không thay đổi khi width không lớn hơn độ dài hiện tại.

count(sub: bytes, start: int = 0, end: int = -1) → int

Trả về số lần xuất hiện không chồng chéo của sub trong lát cắt [start:end].

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool

Trả về True nếu nội dung kết thúc bằng suffix. Không giống CPython, suffix không thể là một tuple các giá trị.

extend(iterable: Iterable[int]) → None

Thêm tất cả các phần tử từ iterable vào cuối bytearray. Như một phần mở rộng so với CPython, bất kỳ đối tượng nào hỗ trợ giao thức buffer đều có thể được sử dụng.

find(sub: bytes, start: int = 0, end: int = -1) → int

Trả về chỉ số thấp nhất nơi sub được tìm thấy trong lát cắt [start:end], hoặc -1 nếu không tìm thấy.

format(*args: Any, **kwargs: Any) → str

Thực hiện thao tác định dạng chuỗi sử dụng nội dung làm chuỗi định dạng, trả về kết quả đã được định dạng.

hex(sep: str = '') → str

Trả về một chuỗi gồm hai chữ số thập lục phân cho mỗi byte. Nếu tham số tùy chọn sep (một chuỗi dài 1 ký tự) được cung cấp, nó được chèn vào giữa các giá trị byte liên tiếp.

index(sub: bytes, start: int = 0, end: int = -1) → int

Giống như find(), nhưng gây ra ValueError khi sub không được tìm thấy.

isalpha() → bool

Trả về True nếu tất cả các byte đều là ký tự chữ cái ASCII và có ít nhất một byte, ngược lại trả về False.

isdigit() → bool

Trả về True nếu tất cả các byte đều là chữ số thập phân ASCII và có ít nhất một byte, ngược lại trả về False.

islower() → bool

Trả về True nếu tất cả các byte có phân biệt hoa/thường đều là chữ thường và có ít nhất một byte như vậy, ngược lại trả về False.

isspace() → bool

Trả về True nếu tất cả các byte đều là khoảng trắng ASCII và có ít nhất một byte, ngược lại trả về False.

isupper() → bool

Trả về True nếu tất cả các byte có phân biệt hoa/thường đều là chữ hoa và có ít nhất một byte như vậy, ngược lại trả về False.

join(iterable: Iterable[bytes]) → bytes

Trả về một đối tượng bytes là sự nối các phần tử trong iterable, sử dụng nội dung bytearray làm dấu phân cách.

lower() → bytes

Trả về một bản sao của nội dung với tất cả các ký tự chữ hoa ASCII được chuyển thành chữ thường.

lstrip(chars: bytes | None = None) → bytes

Trả về một bản sao với các byte dẫn đầu đã bị xóa. chars chỉ định tập hợp các byte cần xóa; nếu bỏ qua hoặc là None, khoảng trắng ASCII sẽ bị xóa.

partition(sep: bytes) → tuple

Tách tại lần xuất hiện đầu tiên của sep, trả về (head, sep, tail). Nếu không tìm thấy sep, trả về nội dung theo sau bởi hai đối tượng rỗng.

replace(old: bytes, new: bytes, count: int = -1) → bytes

Trả về một bản sao với tất cả các lần xuất hiện của old được thay thế bằng new. Nếu count được cung cấp, chỉ count lần xuất hiện đầu tiên mới được thay thế.

rfind(sub: bytes, start: int = 0, end: int = -1) → int

Trả về chỉ số cao nhất nơi sub được tìm thấy trong lát cắt [start:end], hoặc -1 nếu không tìm thấy.

rindex(sub: bytes, start: int = 0, end: int = -1) → int

Giống như rfind(), nhưng gây ra ValueError khi sub không được tìm thấy.

rpartition(sep: bytes) → tuple

Tách tại lần xuất hiện cuối cùng của sep, trả về (head, sep, tail). Nếu không tìm thấy sep, trả về hai đối tượng rỗng theo sau bởi nội dung.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list

Tách tại các lần xuất hiện của sep thành một danh sách các phần, thực hiện tối đa maxsplit lần tách tính từ bên phải. Nếu sep là None hoặc bị bỏ qua, tách tại các chuỗi khoảng trắng ASCII.

rstrip(chars: bytes | None = None) → bytes

Trả về một bản sao với các byte cuối bị xóa. chars chỉ định tập hợp các byte cần xóa; nếu bỏ qua hoặc là None, khoảng trắng ASCII sẽ bị xóa.

split(sep: bytes | None = None, maxsplit: int = -1) → list

Tách tại các lần xuất hiện của sep thành một danh sách các phần. Nếu sep là None hoặc bị bỏ qua, tách tại các chuỗi khoảng trắng ASCII và khoảng trắng đầu/cuối bị bỏ qua.

splitlines(keepends: bool = False) → list

Trả về một danh sách các dòng, ngắt tại \n, \r và \r\n. Ký tự xuống dòng bị loại trừ trừ khi keepends là true.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool

Trả về True nếu nội dung bắt đầu bằng prefix. Không giống CPython, prefix không thể là một tuple, và end được chấp nhận nhưng bị bỏ qua.

strip(chars: bytes | None = None) → bytes

Trả về một bản sao với các byte đầu và cuối đã bị xóa. chars chỉ định tập hợp các byte cần xóa; nếu bỏ qua hoặc là None, khoảng trắng ASCII sẽ bị xóa.

upper() → bytes

Trả về một bản sao của nội dung với tất cả các ký tự chữ thường ASCII được chuyển thành chữ hoa.

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

Chuỗi số nguyên bất biến trong khoảng 0-255. Được tạo từ một số nguyên (bộ đệm điền 0), một iterable của các số nguyên, một chuỗi với encoding, hoặc bất kỳ đối tượng nào hỗ trợ giao thức buffer. Ký tự bytes sử dụng cú pháp b'...'.

classmethod fromhex(string: str) → bytes

Xây dựng một đối tượng bytes từ một chuỗi các cặp chữ số thập lục phân. Khoảng trắng giữa các cặp chữ số bị bỏ qua; một ký tự không phải hex sẽ gây ra ValueError.

center(width: int, fillbyte: bytes) → bytes

Trả về một bản sao được căn giữa trong một chuỗi có độ dài width, được đệm bằng fillbyte (một bytes dài 1 ký tự cung cấp byte đệm). Không giống CPython, fillbyte là bắt buộc. Đối tượng gốc được trả về không thay đổi khi width không lớn hơn độ dài của nó.

count(sub: bytes, start: int = 0, end: int = -1) → int

Trả về số lần xuất hiện không chồng chéo của sub trong lát cắt [start:end].

decode(encoding: str = 'utf-8') → str

Trả về một str được giải mã từ bytes. Trong MicroPython, đối số encoding được chấp nhận nhưng thực tế bị bỏ qua (các byte được tái giải thích như UTF-8).

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool

Trả về True nếu các byte kết thúc bằng suffix. Không giống CPython, suffix không thể là một tuple các giá trị để thử.

find(sub: bytes, start: int = 0, end: int = -1) → int

Trả về chỉ số thấp nhất nơi chuỗi con sub được tìm thấy trong lát cắt [start:end], hoặc -1 nếu không tìm thấy.

format(*args: Any, **kwargs: Any) → str

Thực hiện thao tác định dạng chuỗi sử dụng bytes làm chuỗi định dạng, trả về kết quả đã được định dạng.

hex(sep: str = '') → str

Trả về một chuỗi gồm hai chữ số thập lục phân cho mỗi byte. Nếu tham số tùy chọn sep (một chuỗi dài 1 ký tự) được cung cấp, nó được chèn vào giữa các giá trị byte liên tiếp.

index(sub: bytes, start: int = 0, end: int = -1) → int

Giống như find(), nhưng gây ra ValueError khi sub không được tìm thấy.

isalpha() → bool

Trả về True nếu tất cả các byte đều là ký tự chữ cái ASCII và có ít nhất một byte, ngược lại trả về False.

isdigit() → bool

Trả về True nếu tất cả các byte đều là chữ số thập phân ASCII và có ít nhất một byte, ngược lại trả về False.

islower() → bool

Trả về True nếu tất cả các byte có phân biệt hoa/thường đều là chữ thường và có ít nhất một byte như vậy, ngược lại trả về False.

isspace() → bool

Trả về True nếu tất cả các byte đều là khoảng trắng ASCII và có ít nhất một byte, ngược lại trả về False.

isupper() → bool

Trả về True nếu tất cả các byte có phân biệt hoa/thường đều là chữ hoa và có ít nhất một byte như vậy, ngược lại trả về False.

join(iterable: Iterable[bytes]) → bytes

Trả về một đối tượng bytes là sự nối các phần tử trong iterable, sử dụng bản thân đối tượng bytes làm dấu phân cách.

lower() → bytes

Trả về một bản sao với tất cả các ký tự chữ hoa ASCII được chuyển thành chữ thường.

lstrip(chars: bytes | None = None) → bytes

Trả về một bản sao với các byte dẫn đầu đã bị xóa. chars chỉ định tập hợp các byte cần xóa; nếu bỏ qua hoặc là None, khoảng trắng ASCII sẽ bị xóa.

partition(sep: bytes) → tuple

Tách tại lần xuất hiện đầu tiên của sep, trả về (head, sep, tail). Nếu không tìm thấy sep, trả về bytes theo sau bởi hai đối tượng bytes rỗng.

replace(old: bytes, new: bytes, count: int = -1) → bytes

Trả về một bản sao với tất cả các lần xuất hiện của old được thay thế bằng new. Nếu count được cung cấp, chỉ count lần xuất hiện đầu tiên mới được thay thế.

rfind(sub: bytes, start: int = 0, end: int = -1) → int

Trả về chỉ số cao nhất nơi sub được tìm thấy trong lát cắt [start:end], hoặc -1 nếu không tìm thấy.

rindex(sub: bytes, start: int = 0, end: int = -1) → int

Giống như rfind(), nhưng gây ra ValueError khi sub không được tìm thấy.

rpartition(sep: bytes) → tuple

Tách tại lần xuất hiện cuối cùng của sep, trả về (head, sep, tail). Nếu không tìm thấy sep, trả về hai đối tượng bytes rỗng theo sau bởi bytes.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list

Tách tại các lần xuất hiện của sep thành một danh sách các phần, thực hiện tối đa maxsplit lần tách tính từ bên phải. Nếu sep là None hoặc bị bỏ qua, tách tại các chuỗi khoảng trắng ASCII.

rstrip(chars: bytes | None = None) → bytes

Trả về một bản sao với các byte cuối bị xóa. chars chỉ định tập hợp các byte cần xóa; nếu bỏ qua hoặc là None, khoảng trắng ASCII sẽ bị xóa.

split(sep: bytes | None = None, maxsplit: int = -1) → list

Tách tại các lần xuất hiện của sep thành một danh sách các phần. Nếu sep là None hoặc bị bỏ qua, tách tại các chuỗi khoảng trắng ASCII và khoảng trắng đầu/cuối bị bỏ qua.

splitlines(keepends: bool = False) → list

Trả về một danh sách các dòng, ngắt tại \n, \r và \r\n. Ký tự xuống dòng bị loại trừ trừ khi keepends là true.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool

Trả về True nếu các byte bắt đầu bằng prefix. Không giống CPython, prefix không thể là một tuple, và end được chấp nhận nhưng bị bỏ qua.

strip(chars: bytes | None = None) → bytes

Trả về một bản sao với các byte đầu và cuối đã bị xóa. chars chỉ định tập hợp các byte cần xóa; nếu bỏ qua hoặc là None, khoảng trắng ASCII sẽ bị xóa.

upper() → bytes

Trả về một bản sao với tất cả các ký tự chữ thường ASCII được chuyển thành chữ hoa.

callable(obj: Any) → bool

Trả về True nếu obj có vẻ có thể gọi được, ngược lại trả về False.

chr(i: int) → str

Trả về một chuỗi gồm một ký tự có điểm mã Unicode là số nguyên i.

classmethod(func: Callable[..., Any]) → classmethod

Chuyển đổi một phương thức thành phương thức lớp. Thường được sử dụng như một decorator.

compile(source: str | bytes, filename: str, mode: str) → Any

Biên dịch source thành một đối tượng code có thể được thực thi bởi exec() hoặc eval(). mode là một trong "exec", "eval" hoặc "single".

class complex(real: float | str = 0, imag: float = 0)

Tạo một số phức từ phần thực và phần ảo, hoặc từ một chuỗi.

delattr(obj, name: str) → None

Đối số name phải là một chuỗi, và hàm này xóa thuộc tính có tên đó khỏi đối tượng được cung cấp bởi obj.

class dict(*args, **kwargs)

Tạo một từ điển mới. Tương đương với dict của CPython.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) → dict

Tạo một từ điển mới với các khóa lấy từ iterable, mỗi khóa được ánh xạ tới value (mặc định là None). Được gọi trên kiểu dữ liệu, ví dụ dict.fromkeys(...).

clear() → None

Xóa tất cả các phần tử khỏi từ điển, để nó trống. Gây ra TypeError nếu từ điển là cố định (chỉ đọc).

copy() → dict

Trả về một bản sao nông của từ điển. Đối tượng trả về có cùng kiểu với bản gốc (dict hoặc OrderedDict) nhưng không cố định.

get(key: Any, default: Any = None) → Any

Trả về giá trị cho key nếu nó có trong từ điển, ngược lại trả về default (mặc định là None, vì vậy hàm này không bao giờ gây ra KeyError). Từ điển không bị sửa đổi.

items() → Any

Trả về một đối tượng view động trên các cặp (key, value) phản ánh các thay đổi tiếp theo của từ điển và hỗ trợ lặp, len(), toán tử in và các toán tử so sánh tập hợp.

keys() → Any

Trả về một đối tượng view động trên các khóa phản ánh các thay đổi tiếp theo của từ điển và hỗ trợ lặp, len(), toán tử in và các toán tử so sánh tập hợp.

pop(key: Any, default: Any = None) → Any

Xóa key khỏi từ điển và trả về giá trị của nó. Nếu key không có, trả về default nếu đã được cung cấp; ngược lại gây ra KeyError. Gây ra TypeError nếu từ điển là cố định.

popitem() → tuple

Xóa và trả về một cặp (key, value) tùy ý dưới dạng tuple 2 phần tử. Đối với dict thông thường, cặp được chọn không được chỉ định; đối với OrderedDict, cặp được chèn cuối cùng sẽ bị xóa (LIFO). Gây ra KeyError nếu từ điển rỗng, hoặc TypeError nếu nó cố định.

setdefault(key: Any, default: Any = None) → Any

Nếu key có trong từ điển, trả về giá trị của nó. Ngược lại, chèn key với giá trị default (mặc định là None) và trả về giá trị đó. Gây ra TypeError nếu từ điển là cố định.

update(*args: Any, **kwargs: Any) → None

Cập nhật từ điển tại chỗ. Chấp nhận tối đa một đối số vị trí: có thể là một từ điển khác, hoặc một iterable gồm các cặp (key, value) hai phần tử (mỗi cặp phải cho ra đúng hai phần tử, ngược lại ValueError sẽ được gây ra). Các đối số từ khóa sau đó được thêm vào dưới dạng các mục có khóa chuỗi. Các khóa hiện có sẽ bị ghi đè. Gây ra TypeError nếu từ điển là cố định.

values() → Any

Trả về một đối tượng view động trên các giá trị phản ánh các thay đổi tiếp theo của từ điển và hỗ trợ lặp và len().

__getitem__(key: Any) → Any

Trả về self[key]. Thực thi toán tử chỉ số d[key]; gây ra KeyError nếu key không có.

__setitem__(key: Any, value: Any) → None

Đặt self[key] thành value. Thực thi d[key] = value.

__delitem__(key: Any) → None

Xóa self[key]. Thực thi del d[key]; gây ra KeyError nếu key không có.

dir(obj: Any = None) → list

Không có đối số, trả về danh sách các tên trong phạm vi cục bộ hiện tại. Với một đối số, trả về danh sách các thuộc tính hợp lệ cho đối tượng đó.

divmod(a: Any, b: Any) → tuple

Trả về cặp (a // b, a % b) dưới dạng tuple, cho hai số (không phức).

enumerate(iterable: Iterable[Any], start: int = 0) → Iterator[tuple]

Trả về một đối tượng enumerate tạo ra các cặp (index, value) từ iterable, với chỉ số bắt đầu từ start.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) → Any

Đánh giá một biểu thức Python được cung cấp dưới dạng chuỗi (hoặc đối tượng code đã được biên dịch) và trả về kết quả.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) → None

Thực thi động code Python được cung cấp dưới dạng chuỗi hoặc đối tượng code đã được biên dịch.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) → Iterator[Any]

Xây dựng một iterator từ những phần tử của iterable mà function trả về true. Nếu function là None, hàm đồng nhất được giả định.

class float(x: str | bytes | int | float = 0.0)

Trả về một số thực dấu chấm động được xây dựng từ một số hoặc chuỗi x.

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

Trả về một đối tượng frozenset mới, tùy chọn với các phần tử lấy từ iterable. frozenset là biến thể bất biến, có thể băm của set.

copy() → frozenset

Trả về một bản sao nông của frozenset.

difference(*others: Iterable[Any]) → frozenset

Trả về một frozenset mới với các phần tử từ frozenset không có trong bất kỳ others nào. Mỗi đối số có thể là bất kỳ iterable nào.

intersection(other: Iterable[Any]) → frozenset

Trả về một frozenset mới với các phần tử chung cho frozenset và other. Trong MicroPython, chỉ một đối số other đơn lẻ được chấp nhận (CPython chấp nhận nhiều hơn).

isdisjoint(other: Iterable[Any]) → bool

Trả về True nếu frozenset không có phần tử nào chung với other.

issubset(other: Iterable[Any]) → bool

Trả về True nếu mỗi phần tử của frozenset đều có trong other.

issuperset(other: Iterable[Any]) → bool

Trả về True nếu mỗi phần tử của other đều có trong frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset

Trả về một frozenset mới với các phần tử trong frozenset hoặc other nhưng không có trong cả hai. Trong MicroPython, chỉ một đối số other đơn lẻ được chấp nhận.

union(other: Iterable[Any]) → frozenset

Trả về một frozenset mới với các phần tử từ frozenset và other. Trong MicroPython, chỉ một đối số other đơn lẻ được chấp nhận (CPython chấp nhận nhiều hơn).

getattr(obj: Any, name: str, default: Any = None) → Any

Trả về giá trị của thuộc tính có tên của obj. Nếu thuộc tính không tồn tại, default được trả về nếu được cung cấp, ngược lại AttributeError sẽ được gây ra.

globals() → dict

Trả về một từ điển biểu thị bảng ký hiệu toàn cục của module hiện tại.

hasattr(obj: Any, name: str) → bool

Trả về True nếu obj có thuộc tính với name đã cho, ngược lại trả về False.

hash(obj: Any) → int

Trả về giá trị băm của obj (nếu nó có). Giá trị băm là các số nguyên được sử dụng để so sánh nhanh các khóa từ điển trong quá trình tra cứu từ điển.

hex(x: int) → str

Chuyển đổi một số nguyên thành chuỗi thập lục phân viết thường có tiền tố "0x".

id(obj: Any) → int

Trả về danh tính của một đối tượng. Đây là một số nguyên được đảm bảo là duy nhất và không đổi cho đối tượng này trong suốt vòng đời của nó.

input(prompt: str = '') → str

Đọc một dòng từ đầu vào chuẩn và trả về nó như một chuỗi (không có ký tự xuống dòng ở cuối). Nếu prompt được cung cấp, nó được ghi vào đầu ra chuẩn mà không có ký tự xuống dòng ở cuối trước tiên.

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

classmethod from_bytes(bytes: bytes, byteorder: str) → int

Trong MicroPython, tham số byteorder phải là vị trí (điều này tương thích với CPython).

to_bytes(size: int, byteorder: str) → bytes

Trong MicroPython, tham số byteorder phải là vị trí (điều này tương thích với CPython).

Ghi chú

Kwarg tùy chọn signed từ CPython không được hỗ trợ. MicroPython hiện tại chuyển đổi các số nguyên âm như có dấu, và số dương như không dấu. (Chi tiết.)

isinstance(obj: Any, classinfo: type | tuple) → bool

Trả về True nếu obj là một thể hiện của classinfo hoặc bất kỳ lớp con nào của nó. classinfo có thể là một lớp hoặc một tuple các lớp.

issubclass(cls: type, classinfo: type | tuple) → bool

Trả về True nếu cls là một lớp con (trực tiếp, gián tiếp, hoặc ảo) của classinfo.

iter(obj: Any, sentinel: Any = None) → Iterator[Any]

Trả về một đối tượng iterator. Với một đối số, obj phải hỗ trợ giao thức lặp. Với hai đối số, obj phải có thể gọi được và việc lặp dừng khi nó trả về sentinel.

len(obj: Any) → int

Trả về số lượng phần tử trong một container.

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

Xây dựng một danh sách mới, tùy chọn được điền từ các phần tử trong iterable.

append(object: Any) → None

Thêm object vào cuối danh sách.

clear() → None

Xóa tất cả các phần tử khỏi danh sách, để nó trống.

copy() → list

Trả về một bản sao nông của danh sách.

count(value: Any) → int

Trả về số lượng phần tử trong danh sách bằng value.

extend(iterable: Iterable[Any]) → None

Thêm tất cả các phần tử từ iterable vào cuối danh sách. Nếu iterable chính là một danh sách, các phần tử của nó được sao chép trực tiếp; ngược lại nó sẽ được lặp qua.

index(value: Any, start: int = 0, stop: int = -1) → int

Trả về chỉ số của phần tử đầu tiên bằng value, tìm kiếm trong lát cắt [start:stop]. Gây ra ValueError nếu value không có.

insert(index: int, object: Any) → None

Chèn object trước vị trí index. Một index âm được giải thích tương đối so với cuối danh sách, và chỉ số được giới hạn trong phạm vi hợp lệ (vì vậy các giá trị vượt quá cả hai đầu sẽ chèn vào đầu hoặc cuối).

pop(index: int = -1) → Any

Xóa và trả về phần tử tại index (phần tử cuối cùng theo mặc định). Gây ra IndexError nếu danh sách rỗng hoặc index nằm ngoài phạm vi.

remove(value: Any) → None

Xóa phần tử đầu tiên bằng value. Gây ra ValueError nếu value không có.

reverse() → None

Đảo ngược các phần tử của danh sách tại chỗ.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) → None

Sắp xếp các phần tử của danh sách tại chỗ. key và reverse chỉ là từ khóa. key, nếu được cung cấp, là một hàm áp dụng cho mỗi phần tử để tạo ra giá trị so sánh; reverse sắp xếp theo thứ tự giảm dần.

Ghi chú

Không giống CPython, thuật toán sắp xếp danh sách trong MicroPython không ổn định.

locals() → dict

Trả về một từ điển biểu thị bảng ký hiệu cục bộ hiện tại.

map(function: Callable[..., Any], *iterables: Iterable[Any]) → Iterator[Any]

Trả về một iterator áp dụng function cho mỗi phần tử của iterables, tạo ra các kết quả.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any

Với một đối số iterable đơn lẻ, trả về phần tử lớn nhất của nó. Với hai hoặc nhiều đối số hơn, trả về đối số lớn nhất.

class memoryview(obj: Any)

Tạo một memoryview tham chiếu obj, đối tượng phải hỗ trợ giao thức buffer (ví dụ bytes, bytearray, array.array). Cho phép truy cập không sao chép và cắt lát bộ nhớ bên dưới; cắt lát một memoryview trả về một memoryview khác thay vì một bản sao.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any

Với một đối số iterable đơn lẻ, trả về phần tử nhỏ nhất của nó. Với hai hoặc nhiều đối số hơn, trả về đối số nhỏ nhất.

next(iterator: Iterator[Any], default: Any = None) → Any

Lấy phần tử tiếp theo từ iterator. Nếu default được cung cấp và iterator đã cạn kiệt, default được trả về thay vì gây ra StopIteration.

class object

Trả về một đối tượng không có tính năng mới. object là lớp cơ sở cho tất cả các lớp.

oct(x: int) → str

Chuyển đổi một số nguyên thành chuỗi bát phân có tiền tố "0o".

open(file: str, mode: str = 'r', **kwargs) → Any

Mở file và trả về đối tượng file tương ứng. mode mặc định là "r" để đọc văn bản.

ord(c: str) → int

Trả về điểm mã Unicode của một chuỗi một ký tự c dưới dạng số nguyên.

pow(base: Any, exp: Any, mod: Any | None = None) → Any

Trả về base lũy thừa exp. Nếu mod được cung cấp, trả về base ** exp % mod (được tính hiệu quả hơn so với dạng tường minh).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) → None

In objects ra luồng văn bản file, được phân cách bằng sep và theo sau bởi 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

Trả về một thuộc tính property. Thường được sử dụng như một decorator để định nghĩa các thuộc tính được quản lý trên một lớp.

range(*args: int) → range

Trả về một chuỗi bất biến các số nguyên. Được gọi là range(stop), range(start, stop) hoặc range(start, stop, step).

repr(obj: Any) → str

Trả về một chuỗi chứa biểu diễn có thể in được của obj.

reversed(seq: Any) → Iterator[Any]

Trả về một iterator đảo ngược trên các giá trị của chuỗi đã cho.

round(number: Any, ndigits: int | None = None) → Any

Trả về number được làm tròn đến ndigits chữ số thập phân. Nếu ndigits bị bỏ qua, trả về số nguyên gần nhất.

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

Trả về một đối tượng set mới, tùy chọn với các phần tử lấy từ iterable.

add(elem: Any) → None

Thêm phần tử elem vào set.

clear() → None

Xóa tất cả các phần tử khỏi set.

copy() → set

Trả về một bản sao nông của set.

difference(*others: Iterable[Any]) → set

Trả về một set mới với các phần tử từ set không có trong bất kỳ others nào. Mỗi đối số có thể là bất kỳ iterable nào.

difference_update(*others: Iterable[Any]) → None

Xóa khỏi set tất cả các phần tử được tìm thấy trong bất kỳ others nào (tại chỗ).

discard(elem: Any) → None

Xóa phần tử elem khỏi set nếu nó có. Không giống remove(), hàm này không gây ra lỗi nếu elem vắng mặt.

intersection(other: Iterable[Any]) → set

Trả về một set mới với các phần tử chung cho set và other. Trong MicroPython, chỉ một đối số other đơn lẻ được chấp nhận (CPython chấp nhận nhiều hơn).

intersection_update(other: Iterable[Any]) → None

Cập nhật set, chỉ giữ lại các phần tử cũng được tìm thấy trong other (tại chỗ). Trong MicroPython, chỉ một đối số other đơn lẻ được chấp nhận.

isdisjoint(other: Iterable[Any]) → bool

Trả về True nếu set không có phần tử nào chung với other.

issubset(other: Iterable[Any]) → bool

Trả về True nếu mỗi phần tử của set đều có trong other.

issuperset(other: Iterable[Any]) → bool

Trả về True nếu mỗi phần tử của other đều có trong set.

pop() → Any

Xóa và trả về một phần tử tùy ý từ set. Gây ra KeyError nếu set rỗng.

remove(elem: Any) → None

Xóa phần tử elem khỏi set. Gây ra KeyError nếu elem không có trong set.

symmetric_difference(other: Iterable[Any]) → set

Trả về một set mới với các phần tử trong set hoặc other nhưng không có trong cả hai. Trong MicroPython, chỉ một đối số other đơn lẻ được chấp nhận.

symmetric_difference_update(other: Iterable[Any]) → None

Cập nhật set, chỉ giữ lại các phần tử được tìm thấy trong set hoặc other nhưng không có trong cả hai (tại chỗ). Trong MicroPython, chỉ một đối số other đơn lẻ được chấp nhận.

union(other: Iterable[Any]) → set

Trả về một set mới với các phần tử từ set và other. Trong MicroPython, chỉ một đối số other đơn lẻ được chấp nhận (CPython chấp nhận nhiều hơn).

update(*others: Iterable[Any]) → None

Cập nhật set, thêm các phần tử từ tất cả others (tại chỗ).

setattr(obj: Any, name: str, value: Any) → None

Đặt thuộc tính có tên trên obj thành value. Phép toán ngược lại của getattr().

class slice

Kiểu dựng sẵn slice là kiểu mà các đối tượng slice có.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) → list

Trả về một danh sách đã sắp xếp mới từ các phần tử trong iterable.

staticmethod(func: Callable[..., Any]) → staticmethod

Chuyển đổi một phương thức thành phương thức tĩnh. Thường được sử dụng như một decorator.

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

Trả về phiên bản chuỗi của object. Nếu object là một đối tượng giống bytes, các đối số encoding và errors điều khiển việc giải mã.

center(width: int) → str

Trả về một bản sao của chuỗi được căn giữa trong một trường có độ dài width, được đệm bằng dấu cách. Trong MicroPython, chỉ dấu cách được sử dụng làm ký tự điền (không có đối số ký tự điền), và chuỗi gốc được trả về không thay đổi khi width không lớn hơn độ dài của nó.

count(sub: str, start: int = 0, end: int = -1) → int

Trả về số lần xuất hiện không chồng chéo của sub trong lát cắt [start:end]. Một sub rỗng đếm mỗi khoảng trống giữa các ký tự.

encode(encoding: str = 'utf-8', errors: str = 'strict') → bytes

Trả về một đối tượng bytes mã hóa chuỗi. MicroPython thực tế bỏ qua các đối số và sử dụng UTF-8; errors được chấp nhận nhưng không được áp dụng. Tương đương với bytes(s, "utf-8").

endswith(suffix: str | tuple, start: int = 0, end: int = -1) → bool

Trả về True nếu chuỗi kết thúc bằng suffix đã cho, có thể là một chuỗi đơn hoặc một tuple các chuỗi để thử. Các tham số tùy chọn start và end giới hạn việc so sánh vào lát cắt [start:end].

find(sub: str, start: int = 0, end: int = -1) → int

Trả về chỉ số thấp nhất trong chuỗi nơi chuỗi con sub được tìm thấy trong lát cắt [start:end], hoặc -1 nếu không tìm thấy.

format(*args: Any, **kwargs: Any) → str

Thực hiện thao tác định dạng chuỗi, thay thế các trường thay thế được phân tách bởi dấu ngoặc nhọn {} bằng các giá trị từ args và kwargs. Hỗ trợ ngôn ngữ mini đặc tả định dạng chuẩn.

index(sub: str, start: int = 0, end: int = -1) → int

Giống như find(), nhưng gây ra ValueError khi chuỗi con sub không được tìm thấy trong lát cắt [start:end].

isalpha() → bool

Trả về True nếu tất cả các ký tự trong chuỗi là chữ cái và chuỗi không rỗng, ngược lại trả về False.

isdigit() → bool

Trả về True nếu tất cả các ký tự trong chuỗi là chữ số và chuỗi không rỗng, ngược lại trả về False.

islower() → bool

Trả về True nếu chuỗi chứa ít nhất một ký tự chữ cái và tất cả các ký tự như vậy đều là chữ thường, ngược lại trả về False.

isspace() → bool

Trả về True nếu tất cả các ký tự trong chuỗi là khoảng trắng và chuỗi không rỗng, ngược lại trả về False.

isupper() → bool

Trả về True nếu chuỗi chứa ít nhất một ký tự chữ cái và tất cả các ký tự như vậy đều là chữ hoa, ngược lại trả về False.

join(iterable: Iterable[str]) → str

Nối các chuỗi trong iterable, chèn chuỗi này làm dấu phân cách giữa các phần tử. Các phần tử phải là chuỗi, ngược lại TypeError sẽ được gây ra.

lower() → str

Trả về một bản sao của chuỗi với tất cả các ký tự được chuyển thành chữ thường.

lstrip(chars: str | None = None) → str

Trả về một bản sao của chuỗi với các ký tự đầu được xóa. Nếu chars bị bỏ qua hoặc là None, khoảng trắng sẽ bị xóa; ngược lại chars được xử lý như một tập hợp các ký tự cần xóa.

partition(sep: str) → tuple

Tách chuỗi tại lần xuất hiện đầu tiên của sep và trả về một tuple 3 phần tử (head, sep, tail). Nếu không tìm thấy sep, trả về (self, "", ""). Một sep rỗng gây ra ValueError.

replace(old: str, new: str, count: int = -1) → str

Trả về một bản sao của chuỗi với tất cả các lần xuất hiện của chuỗi con old được thay thế bằng new. Nếu count được cung cấp và không âm, chỉ count lần xuất hiện đầu tiên mới được thay thế.

rfind(sub: str, start: int = 0, end: int = -1) → int

Trả về chỉ số cao nhất trong chuỗi nơi chuỗi con sub được tìm thấy trong lát cắt [start:end], hoặc -1 nếu không tìm thấy.

rindex(sub: str, start: int = 0, end: int = -1) → int

Giống như rfind(), nhưng gây ra ValueError khi chuỗi con sub không được tìm thấy trong lát cắt [start:end].

rpartition(sep: str) → tuple

Tách chuỗi tại lần xuất hiện cuối cùng của sep và trả về một tuple 3 phần tử (head, sep, tail). Nếu không tìm thấy sep, trả về ("", "", self). Một sep rỗng gây ra ValueError.

rsplit(sep: str | None = None, maxsplit: int = -1) → list

Tách chuỗi từ bên phải thành một danh sách các chuỗi con sử dụng sep làm dấu phân cách, thực hiện tối đa maxsplit lần tách. Không có maxsplit (hoặc giá trị âm) thì nó hoạt động giống hệt split(); trong MicroPython, rsplit(None, n) với n không âm gây ra NotImplementedError.

rstrip(chars: str | None = None) → str

Trả về một bản sao của chuỗi với các ký tự cuối được xóa. Nếu chars bị bỏ qua hoặc là None, khoảng trắng sẽ bị xóa; ngược lại chars được xử lý như một tập hợp các ký tự cần xóa.

split(sep: str | None = None, maxsplit: int = -1) → list

Tách chuỗi thành một danh sách các chuỗi con sử dụng sep làm dấu phân cách, thực hiện tối đa maxsplit lần tách. Nếu sep bị bỏ qua hoặc là None, tách tại các chuỗi khoảng trắng với khoảng trắng đầu được bỏ qua; ngược lại một sep rỗng gây ra ValueError.

splitlines(keepends: bool = False) → list

Trả về một danh sách các dòng trong chuỗi, ngắt tại \n, \r và \r\n. Ký tự xuống dòng không được bao gồm trừ khi keepends là true.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool

Trả về True nếu chuỗi bắt đầu bằng prefix đã cho, có thể là một chuỗi đơn hoặc một tuple các chuỗi để thử. Các tham số tùy chọn start và end giới hạn việc so sánh vào lát cắt [start:end].

strip(chars: str | None = None) → str

Trả về một bản sao của chuỗi với các ký tự đầu và cuối được xóa. Nếu chars bị bỏ qua hoặc là None, khoảng trắng sẽ bị xóa; ngược lại chars được xử lý như một tập hợp các ký tự cần xóa.

upper() → str

Trả về một bản sao của chuỗi với tất cả các ký tự được chuyển thành chữ hoa.

sum(iterable: Iterable[Any], start: Any = 0) → Any

Tính tổng start và các phần tử của iterable từ trái sang phải, và trả về tổng.

super(type: type | None = None, obj_or_type: Any | None = None) → Any

Trả về một đối tượng proxy ủy quyền các lời gọi phương thức cho lớp cha hoặc lớp anh em của type. Hữu ích để truy cập các phương thức kế thừa đã bị ghi đè trong một lớp.

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

Xây dựng một tuple mới, tùy chọn được điền từ các phần tử trong iterable. Tuple là các chuỗi bất biến.

count(value: Any) → int

Trả về số lượng phần tử trong tuple bằng value.

index(value: Any, start: int = 0, stop: int = -1) → int

Trả về chỉ số của phần tử đầu tiên bằng value, tìm kiếm trong lát cắt [start:stop]. Gây ra ValueError nếu value không có.

type(obj: Any) → type

Với một đối số, trả về kiểu của obj. Giá trị trả về là một đối tượng kiểu.

zip(*iterables: Iterable[Any]) → Iterator[tuple]

Trả về một iterator của các tuple, trong đó tuple thứ i chứa phần tử thứ i từ mỗi iterable đối số. Quá trình lặp dừng khi iterable đầu vào ngắn nhất đã cạn kiệt.

Ngoại lệ

exception AssertionError

Được gây ra khi một câu lệnh assert thất bại.

exception AttributeError

Được gây ra khi một tham chiếu hoặc phép gán thuộc tính thất bại.

exception Exception

Lớp cơ sở chung cho tất cả các ngoại lệ không thoát hệ thống.

exception ImportError

Được gây ra khi câu lệnh import không tìm thấy định nghĩa module.

exception IndexError

Được gây ra khi chỉ số trên một chuỗi nằm ngoài phạm vi.

exception KeyboardInterrupt

Được gây ra khi người dùng ngắt quá trình thực thi chương trình, thường bằng cách nhấn Ctrl+C trên REPL.

Xem thêm trong ngữ cảnh của Soft Bricking (không thể khởi động).

exception KeyError

Được gây ra khi một khóa ánh xạ (từ điển) không được tìm thấy trong tập hợp các khóa hiện có.

exception MemoryError

Được gây ra khi một thao tác hết bộ nhớ.

exception NameError

Được gây ra khi một tên cục bộ hoặc toàn cục không được tìm thấy.

exception NotImplementedError

Được gây ra khi một phương thức trừu tượng hoặc tính năng chưa được triển khai được gọi.

exception OSError

Được gây ra khi một hàm hệ thống trả về lỗi liên quan đến hệ thống.

exception RuntimeError

Được gây ra khi phát hiện một lỗi không thuộc bất kỳ danh mục nào khác.

exception StopIteration

Được gây ra bởi next() và phương thức __next__() của iterator để báo hiệu rằng không còn phần tử nào nữa.

exception SyntaxError

Được gây ra khi trình phân tích cú pháp gặp lỗi cú pháp.

exception SystemExit

Được gây ra bởi sys.exit() để yêu cầu kết thúc trình thông dịch. Không giống hầu hết các ngoại lệ, nó không tạo ra traceback khi không được bắt.

Trên OpenMV Cam, một SystemExit không được xử lý hiện tại gây ra Đặt lại mềm của MicroPython.

exception TypeError

Được gây ra khi một thao tác hoặc hàm được áp dụng cho một đối tượng có kiểu không phù hợp.

exception ValueError

Được gây ra khi một thao tác hoặc hàm dựng sẵn nhận một đối số có kiểu đúng nhưng giá trị không phù hợp.

exception ZeroDivisionError

Được gây ra khi đối số thứ hai của phép chia hoặc phép modulo là zero.