Mặc dù mô tả chính xác cú pháp và ngữ nghĩa của ngôn ngữ Python, hướng dẫn tham khảo thư viện này mô tả thư viện chuẩn được phân phối cùng với Python. Nó cũng mô tả một số thành phần tùy chọn thường có trong các bản phân phối Python
Thư viện tiêu chuẩn của Python rất phong phú, cung cấp nhiều loại phương tiện như được chỉ ra trong mục lục dài được liệt kê bên dưới. Thư viện chứa các mô-đun tích hợp [được viết bằng C] cung cấp quyền truy cập vào chức năng hệ thống, chẳng hạn như tệp I/O mà các lập trình viên Python không thể truy cập được, cũng như các mô-đun được viết bằng Python cung cấp các giải pháp được tiêu chuẩn hóa cho nhiều sự cố xảy ra trong . Một số mô-đun này được thiết kế rõ ràng để khuyến khích và nâng cao tính di động của các chương trình Python bằng cách trừu tượng hóa các đặc điểm cụ thể của nền tảng thành các API trung lập với nền tảng
Trình cài đặt Python cho nền tảng Windows thường bao gồm toàn bộ thư viện chuẩn và thường bao gồm nhiều thành phần bổ sung. Đối với các hệ điều hành giống Unix, Python thường được cung cấp dưới dạng một tập hợp các gói, vì vậy có thể cần sử dụng các công cụ đóng gói được cung cấp cùng với hệ điều hành để có được một số hoặc tất cả các thành phần tùy chọn
Ngoài thư viện tiêu chuẩn, còn có một bộ sưu tập đang hoạt động gồm hàng trăm nghìn thành phần [từ các chương trình và mô-đun riêng lẻ đến các gói và toàn bộ khung phát triển ứng dụng], có sẵn từ Chỉ mục gói Python
Trình thông dịch Python có một số hàm và kiểu được tích hợp sẵn luôn sẵn dùng. Chúng được liệt kê ở đây theo thứ tự bảng chữ cái
Chức năng tích hợp sẵn
A
B
C
D
E
F
G
H
I
L
M
N
O
P
R
S
T
V
Z
_
abs[x]Trả về giá trị tuyệt đối của một số. Đối số có thể là một số nguyên, một số dấu chấm động hoặc một đối tượng thực hiện
def any[iterable]: for element in iterable: if element: return True return False05. Nếu đối số là một số phức, độ lớn của nó được trả vềaiter[async_iterable]
Trả lại một cho một. Tương đương với việc gọi
def any[iterable]: for element in iterable: if element: return True return False06
Ghi chú. Unlike , has no 2-argument variant
New in version 3. 10
all[iterable]Return
def any[iterable]: for element in iterable: if element: return True return False09 if all elements of the iterable are true [or if the iterable is empty]. Equivalent to
def all[iterable]: for element in iterable: if not element: return False return Trueawaitable anext[async_iterator]awaitable anext[async_iterator , mặc định]
When awaited, return the next item from the given , or default if given and the iterator is exhausted
This is the async variant of the builtin, and behaves similarly
This calls the method of async_iterator, returning an . Awaiting this returns the next value of the iterator. If default is given, it is returned if the iterator is exhausted, otherwise is raised
New in version 3. 10
any[iterable]Return
def any[iterable]: for element in iterable: if element: return True return False09 if any element of the iterable is true. If the iterable is empty, return
def any[iterable]: for element in iterable: if element: return True return False14. Equivalent to
def any[iterable]: for element in iterable: if element: return True return Falseascii[object]
As , return a string containing a printable representation of an object, but escape the non-ASCII characters in the string returned by using
def any[iterable]: for element in iterable: if element: return True return False17,
def any[iterable]: for element in iterable: if element: return True return False18, or
def any[iterable]: for element in iterable: if element: return True return False19 escapes. This generates a string similar to that returned by in Python 2bin[x]
Convert an integer number to a binary string prefixed with “0b”. The result is a valid Python expression. If x is not a Python object, it has to define an
def any[iterable]: for element in iterable: if element: return True return False22 method that returns an integer. Some examples
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'
If the prefix “0b” is desired or not, you can use either of the following ways
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']
See also for more information
class bool[x=False]Return a Boolean value, i. e. one of
def any[iterable]: for element in iterable: if element: return True return False09 or
def any[iterable]: for element in iterable: if element: return True return False14. x is converted using the standard . Nếu x là sai hoặc bị bỏ qua, điều này trả về
def any[iterable]: for element in iterable: if element: return True return False14; . Lớp này là một lớp con của [xem ]. Nó không thể được phân loại thêm. Các phiên bản duy nhất của nó là
def any[iterable]: for element in iterable: if element: return True return False14 và
def any[iterable]: for element in iterable: if element: return True return False09 [xem phần ]
Đã thay đổi trong phiên bản 3. 7. x hiện là tham số chỉ vị trí.
điểm dừng[*args , **kws]Chức năng này đưa bạn vào trình gỡ lỗi tại trang cuộc gọi. Cụ thể, nó gọi , chuyển thẳng
def any[iterable]: for element in iterable: if element: return True return False33 và
def any[iterable]: for element in iterable: if element: return True return False34. Theo mặc định, các cuộc gọi
def any[iterable]: for element in iterable: if element: return True return False32 không mong đợi đối số. Trong trường hợp này, nó hoàn toàn là một chức năng tiện lợi, do đó bạn không cần phải nhập hoặc nhập nhiều mã một cách rõ ràng để vào trình gỡ lỗi. Tuy nhiên, có thể được đặt thành một số chức năng khác và sẽ tự động gọi chức năng đó, cho phép bạn đưa vào trình gỡ lỗi đã chọn. If is not accessible, this function will raise
Đưa ra một
def any[iterable]: for element in iterable: if element: return True return False42 với đối số
def any[iterable]: for element in iterable: if element: return True return False43
Mới trong phiên bản 3. 7
lớp bytearray[nguồn=b'']lớp bytearray[source , encoding]class bytearray[nguồn , mã hóa , lỗi]Trả về một mảng byte mới. Lớp là một dãy số nguyên có thể thay đổi trong phạm vi 0 >> bin[3] '0b11' >>> bin[-10] '-0b1010' 00 with arguments
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'01 and
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'02. Sự kiện này cũng có thể được nâng lên bằng cách tổng hợp ngầm
Ghi chú
Khi biên dịch một chuỗi có mã nhiều dòng ở chế độ
def any[iterable]: for element in iterable: if element: return True return False82 hoặc
def any[iterable]: for element in iterable: if element: return True return False81, đầu vào phải được kết thúc bằng ít nhất một ký tự xuống dòng. Điều này là để tạo điều kiện phát hiện các báo cáo không đầy đủ và đầy đủ trong mô-đun
Cảnh báo
Có thể làm hỏng trình thông dịch Python với chuỗi đủ lớn/phức tạp khi biên dịch thành đối tượng AST do giới hạn độ sâu ngăn xếp trong trình biên dịch AST của Python
Đã thay đổi trong phiên bản 3. 2. Được phép sử dụng dòng mới của Windows và Mac. Ngoài ra, đầu vào ở chế độ
def any[iterable]: for element in iterable: if element: return True return False80 không phải kết thúc bằng một dòng mới nữa. Đã thêm tham số tối ưu hóa.
Đã thay đổi trong phiên bản 3. 5. Trước đây, đã được nâng lên khi gặp byte rỗng trong nguồn.
Mới trong phiên bản 3. 8. _______11_______08 giờ đây có thể được chuyển vào các cờ để cho phép hỗ trợ cho cấp cao nhất
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'09,
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'10 và
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'11. lớp complex[thực=0 , hình ảnh=0]class phức tạp[chuỗi]
Trả về một số phức với giá trị thực + hình ảnh*1j hoặc chuyển đổi một chuỗi hoặc số thành một số phức. Nếu tham số đầu tiên là một chuỗi, nó sẽ được hiểu là một số phức và hàm phải được gọi mà không có tham số thứ hai. Tham số thứ hai không bao giờ có thể là một chuỗi. Mỗi đối số có thể là bất kỳ loại số nào [kể cả phức tạp]. Nếu hình ảnh bị bỏ qua, nó sẽ mặc định bằng 0 và hàm tạo đóng vai trò chuyển đổi số như và. Nếu cả hai đối số bị bỏ qua, trả về
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'14
Đối với một đối tượng Python chung
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'15,
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'16 ủy quyền cho
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'17. Nếu
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'18 không được xác định thì nó sẽ quay trở lại
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'19. Nếu
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'19 không được xác định thì nó sẽ quay trở lại
def any[iterable]: for element in iterable: if element: return True return False22
Ghi chú
Khi chuyển đổi từ một chuỗi, chuỗi không được chứa khoảng trắng xung quanh toán tử trung tâm
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'22 hoặc
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'23. Ví dụ:
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'24 thì được, nhưng
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'25 tăng
Loại phức tạp được mô tả trong
Đã thay đổi trong phiên bản 3. 6. Cho phép nhóm các chữ số có dấu gạch dưới như trong mã chữ.
Đã thay đổi trong phiên bản 3. 8. Trở về
def any[iterable]: for element in iterable: if element: return True return False22 nếu
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'18 và
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'19 không được xác định. delattr[đối tượng , tên]
Đây là họ hàng của. Các đối số là một đối tượng và một chuỗi. Chuỗi phải là tên của một trong các thuộc tính của đối tượng. Hàm xóa thuộc tính được đặt tên, miễn là đối tượng cho phép. Ví dụ,
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'31 tương đương với
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'32. tên không cần phải là mã định danh Python [xem ]class dict[**kwarg]lớp dict[ánh xạ , **kwarg]class dict[iterable , **kwarg]
Tạo từ điển mới. Đối tượng là lớp từ điển. Xem và để biết tài liệu về lớp học này
Đối với các vùng chứa khác, hãy xem các lớp , và lớp tích hợp cũng như mô-đun
dir[]dir[object]Không có đối số, trả về danh sách tên trong phạm vi cục bộ hiện tại. Với một đối số, cố gắng trả về danh sách các thuộc tính hợp lệ cho đối tượng đó
Nếu đối tượng có một phương thức tên là
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'40, thì phương thức này sẽ được gọi và phải trả về danh sách các thuộc tính. Điều này cho phép các đối tượng triển khai hàm
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'41 hoặc
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'42 tùy chỉnh để tùy chỉnh cách báo cáo các thuộc tính của chúng
Nếu đối tượng không cung cấp
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'40, hàm sẽ cố gắng hết sức để thu thập thông tin từ thuộc tính của đối tượng, nếu được xác định và từ đối tượng loại của nó. Danh sách kết quả không nhất thiết phải đầy đủ và có thể không chính xác khi đối tượng có tùy chỉnh
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'41
Cơ chế mặc định hoạt động khác với các loại đối tượng khác nhau, vì nó cố gắng tạo ra thông tin phù hợp nhất, thay vì thông tin đầy đủ
Nếu đối tượng là một đối tượng mô-đun, danh sách chứa tên của các thuộc tính của mô-đun
Nếu đối tượng là một đối tượng kiểu hoặc lớp, thì danh sách chứa tên của các thuộc tính của nó và đệ quy các thuộc tính của các cơ sở của nó
Mặt khác, danh sách chứa các tên thuộc tính của đối tượng, tên của các thuộc tính của lớp đối tượng và đệ quy các thuộc tính của các lớp cơ sở của lớp đối tượng.
Danh sách kết quả được sắp xếp theo thứ tự bảng chữ cái. Ví dụ
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']
Ghi chú
Do được cung cấp chủ yếu để thuận tiện cho việc sử dụng tại một dấu nhắc tương tác, nên nó cố gắng cung cấp một bộ tên thú vị hơn là cố gắng cung cấp một bộ tên được xác định chặt chẽ hoặc nhất quán và hành vi chi tiết của nó có thể thay đổi qua các bản phát hành. Ví dụ: các thuộc tính siêu lớp không có trong danh sách kết quả khi đối số là một lớp
divmod[a , b]Lấy hai số [không phức tạp] làm đối số và trả về một cặp số bao gồm thương và số dư của chúng khi sử dụng phép chia số nguyên. Với các loại toán hạng hỗn hợp, áp dụng các quy tắc cho toán tử số học nhị phân. Đối với số nguyên, kết quả giống như
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'49. Đối với số dấu phẩy động, kết quả là
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'50, trong đó q thường là
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'51 nhưng có thể nhỏ hơn 1. Trong mọi trường hợp,
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'52 rất gần với a, nếu
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'53 khác không thì nó có cùng dấu với b, và
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'54liệt kê[có thể lặp lại , bắt đầu=0]
Trả về một đối tượng liệt kê. iterable phải là một chuỗi, một hoặc một số đối tượng khác hỗ trợ phép lặp. The method of the iterator returned by returns a tuple containing a count [from start which defaults to 0] and the values obtained from iterating over iterable
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]
Tương đương với
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 1eval[biểu thức , toàn cầu=None , người dân địa phương=Không có]
Các đối số là một chuỗi và toàn cục và cục bộ tùy chọn. Nếu được cung cấp, toàn cầu phải là một từ điển. Nếu được cung cấp, người dân địa phương có thể là bất kỳ đối tượng ánh xạ nào
Đối số biểu thức được phân tích cú pháp và đánh giá dưới dạng biểu thức Python [về mặt kỹ thuật, danh sách điều kiện] bằng cách sử dụng từ điển toàn cục và cục bộ làm không gian tên toàn cầu và cục bộ. Nếu có từ điển toàn cầu và không chứa giá trị cho khóa
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'57, thì một tham chiếu đến từ điển của mô-đun tích hợp sẽ được chèn vào bên dưới khóa đó trước khi biểu thức được phân tích cú pháp. Bằng cách đó, bạn có thể kiểm soát nội trang nào có sẵn cho mã được thực thi bằng cách chèn từ điển
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'57 của riêng bạn vào toàn cầu trước khi chuyển nó tới. Nếu từ điển địa phương bị bỏ qua, nó sẽ mặc định là từ điển toàn cầu. Nếu cả hai từ điển bị bỏ qua, biểu thức được thực thi với toàn cầu và cục bộ trong môi trường được gọi. Lưu ý, eval[] không có quyền truy cập vào [không phải người dân địa phương] trong môi trường kèm theo
Giá trị trả về là kết quả của biểu thức được đánh giá. Lỗi cú pháp được báo cáo là ngoại lệ. Thí dụ
>>> x = 1 >>> eval['x+1'] 2
Hàm này cũng có thể được sử dụng để thực thi các đối tượng mã tùy ý [chẳng hạn như các đối tượng được tạo bởi ]. Trong trường hợp này, hãy chuyển một đối tượng mã thay vì một chuỗi. Nếu đối tượng mã đã được biên dịch với đối số chế độ là
def any[iterable]: for element in iterable: if element: return True return False80, thì giá trị trả về của 'sẽ là
def any[iterable]: for element in iterable: if element: return True return False83
gợi ý. thực thi động của câu lệnh được hỗ trợ bởi chức năng. Các hàm và trả về từ điển cục bộ và cục bộ hiện tại, tương ứng, có thể hữu ích để chuyển qua sử dụng bởi hoặc
Nếu nguồn đã cho là một chuỗi, thì các dấu cách và tab ở đầu và cuối sẽ bị loại bỏ
Xem một hàm có thể đánh giá các chuỗi một cách an toàn với các biểu thức chỉ chứa các ký tự
Tăng một
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'72 với đối tượng mã làm đối số. Các sự kiện biên dịch mã cũng có thể được nâng lênexec[đối tượng , toàn cầu=Không có , người dân địa phương=Không có , / , * , đóng cửa=Không có]
Hàm này hỗ trợ thực thi động mã Python. đối tượng phải là một chuỗi hoặc một đối tượng mã. Nếu đó là một chuỗi, thì chuỗi đó được phân tích thành một tập hợp các câu lệnh Python, sau đó được thực thi [trừ khi xảy ra lỗi cú pháp]. Nếu nó là một đối tượng mã, nó được thực thi đơn giản. Trong mọi trường hợp, mã được thực thi dự kiến sẽ hợp lệ dưới dạng tệp đầu vào [xem phần trong Hướng dẫn tham khảo]. Xin lưu ý rằng các câu lệnh , và không được sử dụng bên ngoài các định nghĩa hàm ngay cả trong ngữ cảnh mã được truyền cho hàm. Giá trị trả về là
def any[iterable]: for element in iterable: if element: return True return False83
Trong mọi trường hợp, nếu các phần tùy chọn bị bỏ qua, mã được thực thi trong phạm vi hiện tại. Nếu chỉ toàn cầu được cung cấp, nó phải là một từ điển [chứ không phải là một lớp con của từ điển], sẽ được sử dụng cho cả biến toàn cục và biến cục bộ. Nếu toàn cầu và cục bộ được cung cấp, chúng được sử dụng cho các biến toàn cầu và cục bộ tương ứng. Nếu được cung cấp, người dân địa phương có thể là bất kỳ đối tượng ánh xạ nào. Hãy nhớ rằng ở cấp độ mô-đun, toàn cầu và cục bộ là cùng một từ điển. Nếu exec lấy hai đối tượng riêng biệt là toàn cầu và cục bộ, mã sẽ được thực thi như thể nó được nhúng trong một định nghĩa lớp
Nếu từ điển toàn cầu không chứa giá trị cho khóa
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'57, tham chiếu đến từ điển của mô-đun tích hợp sẽ được chèn vào bên dưới khóa đó. Bằng cách đó, bạn có thể kiểm soát nội trang nào có sẵn cho mã được thực thi bằng cách chèn từ điển
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'57 của riêng bạn vào toàn cầu trước khi chuyển nó tới
Đối số đóng chỉ định một đóng – một bộ các ô. Nó chỉ hợp lệ khi đối tượng là một đối tượng mã có chứa các biến tự do. Độ dài của bộ dữ liệu phải khớp chính xác với số lượng biến miễn phí được tham chiếu bởi đối tượng mã
Tăng một
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'72 với đối tượng mã làm đối số. Các sự kiện biên dịch mã cũng có thể được nâng lên
Ghi chú
Các hàm dựng sẵn và trả về từ điển cục bộ và cục bộ hiện tại, tương ứng, có thể hữu ích khi chuyển qua để sử dụng làm đối số thứ hai và thứ ba cho
Ghi chú
Các địa phương mặc định hoạt động như được mô tả cho chức năng bên dưới. không nên sửa đổi từ điển địa phương mặc định. Vượt qua một từ điển địa phương rõ ràng nếu bạn cần xem tác động của mã đối với người dân địa phương sau khi hàm trả về
Đã thay đổi trong phiên bản 3. 11. Đã thêm tham số đóng cửa.
bộ lọc[chức năng , iterable]Xây dựng một iterator từ các phần tử iterable mà hàm trả về true. iterable có thể là một chuỗi, một vùng chứa hỗ trợ phép lặp hoặc một trình lặp. Nếu hàm là
def any[iterable]: for element in iterable: if element: return True return False83, thì hàm nhận dạng được giả định, nghĩa là tất cả các phần tử của iterable sai sẽ bị xóa
Lưu ý rằng
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'89 tương đương với biểu thức trình tạo
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'90 nếu chức năng không phải là
def any[iterable]: for element in iterable: if element: return True return False83 và
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'92 nếu chức năng là
def any[iterable]: for element in iterable: if element: return True return False83
Xem hàm bổ sung trả về các phần tử của iterable mà hàm trả về false
lớp float[x=0. 0]Trả về một số dấu phẩy động được tạo từ một số hoặc chuỗi x
Nếu đối số là một chuỗi, thì đối số đó phải chứa số thập phân, tùy chọn đứng trước dấu và được nhúng tùy chọn trong khoảng trắng. Dấu hiệu tùy chọn có thể là
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'95 hoặc
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'96; . Đối số cũng có thể là một chuỗi đại diện cho một NaN [không phải là số] hoặc vô cực dương hoặc âm. Chính xác hơn, đầu vào phải tuân theo quy tắc sản xuất
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'98 trong ngữ pháp sau, sau khi các ký tự khoảng trắng ở đầu và cuối bị xóa
sign ::= "+" | "-" infinity ::= "Infinity" | "inf" nan ::= "nan" digitpart ::=digit
[["_"]digit
]* number ::= [digitpart
] "."digitpart
|digitpart
["."] exponent ::= ["e" | "E"] ["+" | "-"]digitpart
floatnumber ::= number [exponent
] floatvalue ::= [sign
] [floatnumber
|infinity
|nan
]
Ở đây
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'99 là một chữ số thập phân Unicode [ký tự trong danh mục chung Unicode
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']00]. Case is not significant, so, for example, “inf”, “Inf”, “INFINITY”, and “iNfINity” are all acceptable spellings for positive infinity
Mặt khác, nếu đối số là một số nguyên hoặc số dấu phẩy động, thì một số dấu phẩy động có cùng giá trị [trong phạm vi độ chính xác của dấu phẩy động của Python] sẽ được trả về. Nếu đối số nằm ngoài phạm vi của một float Python, một đối số sẽ được nâng lên
For a general Python object
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'15,
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']03 delegates to
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']04. Nếu
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'19 không được xác định thì nó sẽ quay trở lại
def any[iterable]: for element in iterable: if element: return True return False22
Nếu không có đối số nào được đưa ra, thì trả về
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']07
Examples
def any[iterable]: for element in iterable: if element: return True return False0
The float type is described in
Đã thay đổi trong phiên bản 3. 6. Cho phép nhóm các chữ số có dấu gạch dưới như trong mã chữ.
Đã thay đổi trong phiên bản 3. 7. x hiện là tham số chỉ vị trí.
Changed in version 3. 8. Falls back to
def any[iterable]: for element in iterable: if element: return True return False22 if
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'19 is not defined. format[giá trị , format_spec='']
Convert a value to a “formatted” representation, as controlled by format_spec. The interpretation of format_spec will depend on the type of the value argument; however, there is a standard formatting syntax that is used by most built-in types.
The default format_spec is an empty string which usually gives the same effect as calling
A call to
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']11 is translated to
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']12 which bypasses the instance dictionary when searching for the value’s
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']13 method. A exception is raised if the method search reaches and the format_spec is non-empty, or if either the format_spec or the return value are not strings
Changed in version 3. 4.
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']16 raises if format_spec is not an empty string. class đóng băng[có thể lặp lại=set[]]
Return a new object, optionally with elements taken from iterable.
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']18 is a built-in class. See and for documentation about this class
For other containers see the built-in , , , and classes, as well as the module
getattr[đối tượng , tên]getattr[đối tượng , tên , mặc định]Return the value of the named attribute of object. name must be a string. If the string is the name of one of the object’s attributes, the result is the value of that attribute. For example,
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']26 is equivalent to
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']27. If the named attribute does not exist, default is returned if provided, otherwise is raised. name need not be a Python identifier [see ]
Ghi chú
Since happens at compilation time, one must manually mangle a private attribute’s [attributes with two leading underscores] name in order to retrieve it with
globals[]Return the dictionary implementing the current module namespace. For code within functions, this is set when the function is defined and remains the same regardless of where the function is called
hasattr[đối tượng , tên]The arguments are an object and a string. The result is
def any[iterable]: for element in iterable: if element: return True return False09 if the string is the name of one of the object’s attributes,
def any[iterable]: for element in iterable: if element: return True return False14 if not. [This is implemented by calling
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']33 and seeing whether it raises an or not. ]hash[object]
Return the hash value of the object [if it has one]. Hash values are integers. They are used to quickly compare dictionary keys during a dictionary lookup. Numeric values that compare equal have the same hash value [even if they are of different types, as is the case for 1 and 1. 0]
Ghi chú
For objects with custom
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']35 methods, note that truncates the return value based on the bit width of the host machine. See
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']35 for detailshelp[]trợ giúp[yêu cầu]
Invoke the built-in help system. [This function is intended for interactive use. ] If no argument is given, the interactive help system starts on the interpreter console. If the argument is a string, then the string is looked up as the name of a module, function, class, method, keyword, or documentation topic, and a help page is printed on the console. If the argument is any other kind of object, a help page on the object is generated
Note that if a slash[/] appears in the parameter list of a function when invoking , it means that the parameters prior to the slash are positional-only. For more info, see
This function is added to the built-in namespace by the module
Changed in version 3. 4. Changes to and mean that the reported signatures for callables are now more comprehensive and consistent.
hex[x]Convert an integer number to a lowercase hexadecimal string prefixed with “0x”. If x is not a Python object, it has to define an
def any[iterable]: for element in iterable: if element: return True return False22 method that returns an integer. Some examples
def any[iterable]: for element in iterable: if element: return True return False1
If you want to convert an integer number to an uppercase or lower hexadecimal string with prefix or not, you can use either of the following ways
def any[iterable]: for element in iterable: if element: return True return False2
See also for more information
See also for converting a hexadecimal string to an integer using a base of 16
Ghi chú
To obtain a hexadecimal string representation for a float, use the method
id[object]Return the “identity” of an object. This is an integer which is guaranteed to be unique and constant for this object during its lifetime. Two objects with non-overlapping lifetimes may have the same value
CPython implementation detail. This is the address of the object in memory
Raises an
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']48 with argument
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']49input[]đầu vào[nhắc]
If the prompt argument is present, it is written to standard output without a trailing newline. The function then reads a line from input, converts it to a string [stripping a trailing newline], and returns that. When EOF is read, is raised. Example
def any[iterable]: for element in iterable: if element: return True return False3
If the module was loaded, then will use it to provide elaborate line editing and history features
Raises an
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']53 with argument
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']54 before reading input
Raises an
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']55 with the result after successfully reading inputclass int[x=0]lớp int[x , cơ sở=10]
Return an integer object constructed from a number or string x, or return
def any[iterable]: for element in iterable: if element: return True return False92 if no arguments are given. If x defines
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']57,
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']58 returns
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']59. If x defines
def any[iterable]: for element in iterable: if element: return True return False22, it returns
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']61. If x defines
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']62, it returns
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']63. For floating point numbers, this truncates towards zero
If x is not a number or if base is given, then x must be a string, , or instance representing an integer in radix base. Optionally, the string can be preceded by
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'22 or
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'23 [with no space in between], have leading zeros, be surrounded by whitespace, and have single underscores interspersed between digits
A base-n integer string contains digits, each representing a value from 0 to n-1. The values 0–9 can be represented by any Unicode decimal digit. The values 10–35 can be represented by
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']68 to
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']69 [or
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']70 to
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']71]. The default base is 10. The allowed bases are 0 and 2–36. Base-2, -8, and -16 strings can be optionally prefixed with
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']72/
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']73,
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']74/
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']75, or
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']76/
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']77, as with integer literals in code. For base 0, the string is interpreted in a similar way to an , in that the actual base is 2, 8, 10, or 16 as determined by the prefix. Base 0 also disallows leading zeros.
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']78 is not legal, while
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']79 and
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']80 are
The integer type is described in
Changed in version 3. 4. If base is not an instance of and the base object has a method, that method is called to obtain an integer for the base. Previous versions used instead of .
Đã thay đổi trong phiên bản 3. 6. Cho phép nhóm các chữ số có dấu gạch dưới như trong mã chữ.
Đã thay đổi trong phiên bản 3. 7. x hiện là tham số chỉ vị trí.
Changed in version 3. 8. Falls back to
def any[iterable]: for element in iterable: if element: return True return False22 if
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']57 is not defined.
Changed in version 3. 11. Việc ủy quyền cho
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']62 không được chấp nhận.
Đã thay đổi trong phiên bản 3. 11. đầu vào chuỗi và biểu diễn chuỗi có thể bị giới hạn để giúp tránh các cuộc tấn công từ chối dịch vụ. A được nâng lên khi vượt quá giới hạn trong khi chuyển đổi chuỗi x thành chuỗi hoặc khi chuyển đổi chuỗi thành chuỗi sẽ vượt quá giới hạn. xem tài liệu.
isinstance[đối tượng , classinfo]Trả về
def any[iterable]: for element in iterable: if element: return True return False09 nếu đối số đối tượng là một thể hiện của đối số classinfo hoặc của một lớp con [trực tiếp, gián tiếp hoặc ] của nó. Nếu đối tượng không phải là đối tượng của loại đã cho, hàm luôn trả về
def any[iterable]: for element in iterable: if element: return True return False14. Nếu classinfo là một bộ gồm các đối tượng loại [hoặc theo cách đệ quy, các bộ khác như vậy] hoặc một thuộc nhiều loại, hãy trả về
def any[iterable]: for element in iterable: if element: return True return False09 nếu đối tượng là một thể hiện của bất kỳ loại nào. Nếu classinfo không phải là một loại hoặc bộ dữ liệu của các loại và các bộ dữ liệu như vậy, một ngoại lệ sẽ được đưa ra. may not be raised for an invalid type if an earlier check succeeds
Đã thay đổi trong phiên bản 3. 10. classinfo có thể là một.
issubclass[lớp , classinfo]Trả về
def any[iterable]: for element in iterable: if element: return True return False09 nếu lớp là lớp con [trực tiếp, gián tiếp hoặc ] của classinfo. Một lớp được coi là một lớp con của chính nó. classinfo may be a tuple of class objects [or recursively, other such tuples] or a , in which case return
def any[iterable]: for element in iterable: if element: return True return False09 if class is a subclass of any entry in classinfo. In any other case, a exception is raised
Đã thay đổi trong phiên bản 3. 10. classinfo có thể là một.
iter[đối tượng]iter[đối tượng , trọng điểm]Trả lại một đối tượng. The first argument is interpreted very differently depending on the presence of the second argument. Without a second argument, object must be a collection object which supports the protocol [the
class C: @classmethod def f[cls, arg1, arg2]: ...00 method], or it must support the sequence protocol [the
class C: @classmethod def f[cls, arg1, arg2]: ...01 method with integer arguments starting at
def any[iterable]: for element in iterable: if element: return True return False92]. Nếu nó không hỗ trợ một trong hai giao thức đó, nó sẽ được nâng lên. If the second argument, sentinel, is given, then object must be a callable object. The iterator created in this case will call object with no arguments for each call to its method; if the value returned is equal to sentinel, will be raised, otherwise the value will be returned
See also
One useful application of the second form of is to build a block-reader. For example, reading fixed-width blocks from a binary database file until the end of file is reached
def any[iterable]: for element in iterable: if element: return True return False4len[s]
Return the length [the number of items] of an object. The argument may be a sequence [such as a string, bytes, tuple, list, or range] or a collection [such as a dictionary, set, or frozen set]
CPython implementation detail.
class C: @classmethod def f[cls, arg1, arg2]: ...07 raises on lengths larger than , such as class danh sáchlớp danh sách[iterable]
Rather than being a function, is actually a mutable sequence type, as documented in and
locals[]Update and return a dictionary representing the current local symbol table. Free variables are returned by when it is called in function blocks, but not in class blocks. Note that at the module level, and are the same dictionary
Ghi chú
The contents of this dictionary should not be modified; changes may not affect the values of local and free variables used by the interpreter
map[chức năng , có thể lặp lại , *có thể lặp lại]Return an iterator that applies function to every item of iterable, yielding the results. If additional iterables arguments are passed, function must take that many arguments and is applied to the items from all iterables in parallel. With multiple iterables, the iterator stops when the shortest iterable is exhausted. For cases where the function inputs are already arranged into argument tuples, see
max[có thể lặp lại , * , key=Không có]tối đa[có thể lặp lại , * , mặc định , key=Không có]max[arg1 , arg2 , *args , key=Không có]Return the largest item in an iterable or the largest of two or more arguments
If one positional argument is provided, it should be an . The largest item in the iterable is returned. If two or more positional arguments are provided, the largest of the positional arguments is returned
There are two optional keyword-only arguments. The key argument specifies a one-argument ordering function like that used for . The default argument specifies an object to return if the provided iterable is empty. If the iterable is empty and default is not provided, a is raised
If multiple items are maximal, the function returns the first one encountered. This is consistent with other sort-stability preserving tools such as
class C: @classmethod def f[cls, arg1, arg2]: ...18 and
class C: @classmethod def f[cls, arg1, arg2]: ...19
New in version 3. 4. The default keyword-only argument.
Changed in version 3. 8. The key can be
def any[iterable]: for element in iterable: if element: return True return False83. class chế độ xem bộ nhớ[object]
Return a “memory view” object created from the given argument. See for more information
min[có thể lặp lại , * , phím=Không]phút[có thể lặp lại , * , mặc định , phím=Không]min[arg1 , arg2 , *args , key=Không có]Return the smallest item in an iterable or the smallest of two or more arguments
If one positional argument is provided, it should be an . The smallest item in the iterable is returned. If two or more positional arguments are provided, the smallest of the positional arguments is returned
There are two optional keyword-only arguments. The key argument specifies a one-argument ordering function like that used for . The default argument specifies an object to return if the provided iterable is empty. If the iterable is empty and default is not provided, a is raised
If multiple items are minimal, the function returns the first one encountered. This is consistent with other sort-stability preserving tools such as
class C: @classmethod def f[cls, arg1, arg2]: ...23 and
class C: @classmethod def f[cls, arg1, arg2]: ...24
New in version 3. 4. The default keyword-only argument.
Changed in version 3. 8. The key can be
def any[iterable]: for element in iterable: if element: return True return False83. next[iterator]tiếp theo[trình lặp , mặc định]
Retrieve the next item from the by calling its method. If default is given, it is returned if the iterator is exhausted, otherwise is raised
class mục tiêuReturn a new featureless object. is a base for all classes. It has methods that are common to all instances of Python classes. This function does not accept any arguments
Ghi chú
does not have a , so you can’t assign arbitrary attributes to an instance of the class
oct[x]Convert an integer number to an octal string prefixed with “0o”. The result is a valid Python expression. If x is not a Python object, it has to define an
def any[iterable]: for element in iterable: if element: return True return False22 method that returns an integer. For example
def any[iterable]: for element in iterable: if element: return True return False5
If you want to convert an integer number to an octal string either with the prefix “0o” or not, you can use either of the following ways
def any[iterable]: for element in iterable: if element: return True return False6
See also for more information
open[tệp , chế độ='r' , đệm=- 1 , mã hóa=Không có , lỗi=Không có , dòng mới=Không có , closefd=Đúng , người mở=Không có]
Open file and return a corresponding . If the file cannot be opened, an is raised. See for more examples of how to use this function
file is a giving the pathname [absolute or relative to the current working directory] of the file to be opened or an integer file descriptor of the file to be wrapped. [If a file descriptor is given, it is closed when the returned I/O object is closed unless closefd is set to
def any[iterable]: for element in iterable: if element: return True return False14. ]
mode is an optional string that specifies the mode in which the file is opened. It defaults to
class C: @classmethod def f[cls, arg1, arg2]: ...37 which means open for reading in text mode. Other common values are
class C: @classmethod def f[cls, arg1, arg2]: ...38 for writing [truncating the file if it already exists],
class C: @classmethod def f[cls, arg1, arg2]: ...39 for exclusive creation, and
def any[iterable]: for element in iterable: if element: return True return False59 for appending [which on some Unix systems, means that all writes append to the end of the file regardless of the current seek position]. In text mode, if encoding is not specified the encoding used is platform-dependent. is called to get the current locale encoding. [For reading and writing raw bytes use binary mode and leave encoding unspecified. ] The available modes are
Character
Meaning
class C: @classmethod def f[cls, arg1, arg2]: ...37
open for reading [default]
class C: @classmethod def f[cls, arg1, arg2]: ...38
open for writing, truncating the file first
class C: @classmethod def f[cls, arg1, arg2]: ...39
open for exclusive creation, failing if the file already exists
def any[iterable]: for element in iterable: if element: return True return False59
open for writing, appending to the end of file if it exists
class C: @classmethod def f[cls, arg1, arg2]: ...46
binary mode
class C: @classmethod def f[cls, arg1, arg2]: ...47
text mode [default]
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'95
open for updating [reading and writing]
The default mode is
class C: @classmethod def f[cls, arg1, arg2]: ...37 [open for reading text, a synonym of
class C: @classmethod def f[cls, arg1, arg2]: ...50]. Modes
class C: @classmethod def f[cls, arg1, arg2]: ...51 and
class C: @classmethod def f[cls, arg1, arg2]: ...52 open and truncate the file. Modes
class C: @classmethod def f[cls, arg1, arg2]: ...53 and
class C: @classmethod def f[cls, arg1, arg2]: ...54 open the file with no truncation
As mentioned in the , Python distinguishes between binary and text I/O. Files opened in binary mode [including
class C: @classmethod def f[cls, arg1, arg2]: ...46 in the mode argument] return contents as objects without any decoding. In text mode [the default, or when
class C: @classmethod def f[cls, arg1, arg2]: ...47 is included in the mode argument], the contents of the file are returned as , the bytes having been first decoded using a platform-dependent encoding or using the specified encoding if given
Ghi chú
Python doesn’t depend on the underlying operating system’s notion of text files; all the processing is done by Python itself, and is therefore platform-independent
buffering is an optional integer used to set the buffering policy. Pass 0 to switch buffering off [only allowed in binary mode], 1 to select line buffering [only usable in text mode], and an integer > 1 to indicate the size in bytes of a fixed-size chunk buffer. Note that specifying a buffer size this way applies for binary buffered I/O, but
class C: @classmethod def f[cls, arg1, arg2]: ...59 [i. e. , files opened with
class C: @classmethod def f[cls, arg1, arg2]: ...60] would have another buffering. To disable buffering in
class C: @classmethod def f[cls, arg1, arg2]: ...59, consider using the
class C: @classmethod def f[cls, arg1, arg2]: ...62 flag for . When no buffering argument is given, the default buffering policy works as follows
Binary files are buffered in fixed-size chunks; the size of the buffer is chosen using a heuristic trying to determine the underlying device’s “block size” and falling back on . On many systems, the buffer will typically be 4096 or 8192 bytes long
“Interactive” text files [files for which returns
def any[iterable]: for element in iterable: if element: return True return False
09] use line buffering. Other text files use the policy described above for binary files
encoding is the name of the encoding used to decode or encode the file. This should only be used in text mode. The default encoding is platform dependent [whatever returns], but any supported by Python can be used. See the module for the list of supported encodings
errors is an optional string that specifies how encoding and decoding errors are to be handled—this cannot be used in binary mode. A variety of standard error handlers are available [listed under ], though any error handling name that has been registered with is also valid. The standard names include
class C: @classmethod def f[cls, arg1, arg2]: ...
70 to raise a exception if there is an encoding error. The default value ofdef any[iterable]: for element in iterable: if element: return True return False
83 has the same effectclass C: @classmethod def f[cls, arg1, arg2]: ...
73 ignores errors. Note that ignoring encoding errors can lead to data lossclass C: @classmethod def f[cls, arg1, arg2]: ...
74 causes a replacement marker [such asclass C: @classmethod def f[cls, arg1, arg2]: ...
75] to be inserted where there is malformed dataclass C: @classmethod def f[cls, arg1, arg2]: ...
76 will represent any incorrect bytes as low surrogate code units ranging from U+DC80 to U+DCFF. These surrogate code units will then be turned back into the same bytes when theclass C: @classmethod def f[cls, arg1, arg2]: ...
77 error handler is used when writing data. This is useful for processing files in an unknown encodingclass C: @classmethod def f[cls, arg1, arg2]: ...
78 is only supported when writing to a file. Characters not supported by the encoding are replaced with the appropriate XML character referenceclass C: @classmethod def f[cls, arg1, arg2]: ...
79class C: @classmethod def f[cls, arg1, arg2]: ...
80 replaces malformed data by Python’s backslashed escape sequencesclass C: @classmethod def f[cls, arg1, arg2]: ...
81 [also only supported when writing] replaces unsupported characters withclass C: @classmethod def f[cls, arg1, arg2]: ...
82 escape sequences
newline determines how to parse newline characters from the stream. Nó có thể là
def any[iterable]: for element in iterable: if element: return True return False83,
class C: @classmethod def f[cls, arg1, arg2]: ...84,
class C: @classmethod def f[cls, arg1, arg2]: ...85,
class C: @classmethod def f[cls, arg1, arg2]: ...86, và
class C: @classmethod def f[cls, arg1, arg2]: ...87. Nó hoạt động như sau
When reading input from the stream, if newline is
def any[iterable]: for element in iterable: if element: return True return False
83, universal newlines mode is enabled. Lines in the input can end inclass C: @classmethod def f[cls, arg1, arg2]: ...
85,class C: @classmethod def f[cls, arg1, arg2]: ...
86, orclass C: @classmethod def f[cls, arg1, arg2]: ...
87, and these are translated intoclass C: @classmethod def f[cls, arg1, arg2]: ...
85 before being returned to the caller. If it isclass C: @classmethod def f[cls, arg1, arg2]: ...
84, universal newlines mode is enabled, but line endings are returned to the caller untranslated. If it has any of the other legal values, input lines are only terminated by the given string, and the line ending is returned to the caller untranslatedWhen writing output to the stream, if newline is
def any[iterable]: for element in iterable: if element: return True return False
83, anyclass C: @classmethod def f[cls, arg1, arg2]: ...
85 characters written are translated to the system default line separator, . If newline isclass C: @classmethod def f[cls, arg1, arg2]: ...
84 orclass C: @classmethod def f[cls, arg1, arg2]: ...
85, no translation takes place. If newline is any of the other legal values, anyclass C: @classmethod def f[cls, arg1, arg2]: ...
85 characters written are translated to the given string
If closefd is
def any[iterable]: for element in iterable: if element: return True return False14 and a file descriptor rather than a filename was given, the underlying file descriptor will be kept open when the file is closed. If a filename is given closefd must be
def any[iterable]: for element in iterable: if element: return True return False09 [the default]; otherwise, an error will be raised
A custom opener can be used by passing a callable as opener. The underlying file descriptor for the file object is then obtained by calling opener with [file, flags]. opener must return an open file descriptor [passing as opener results in functionality similar to passing
def any[iterable]: for element in iterable: if element: return True return False83]
The newly created file is
The following example uses the parameter of the function to open a file relative to a given directory
def any[iterable]: for element in iterable: if element: return True return False7
The type of returned by the function depends on the mode. When is used to open a file in a text mode [
class C: @classmethod def f[cls, arg1, arg2]: ...38,
class C: @classmethod def f[cls, arg1, arg2]: ...37,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']09,
class C: @classmethod def f[cls, arg1, arg2]: ...50, etc. ], it returns a subclass of [specifically ]. When used to open a file in a binary mode with buffering, the returned class is a subclass of . The exact class varies. in read binary mode, it returns an ; in write binary and append binary modes, it returns an , and in read/write mode, it returns an . When buffering is disabled, the raw stream, a subclass of , , is returned
See also the file handling modules, such as , [where is declared], , , , and
Raises an
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']26 with arguments
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']27,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']28,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']29
The
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']28 and
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']29 arguments may have been modified or inferred from the original call
Changed in version 3. 3
The opener parameter was added
The
class C: @classmethod def f[cls, arg1, arg2]: ...
39 mode was addedused to be raised, it is now an alias of
is now raised if the file opened in exclusive creation mode [
class C: @classmethod def f[cls, arg1, arg2]: ...
39] already exists
Changed in version 3. 4
The file is now non-inheritable
Changed in version 3. 5
If the system call is interrupted and the signal handler does not raise an exception, the function now retries the system call instead of raising an exception [see PEP 475 for the rationale]
The
class C: @classmethod def f[cls, arg1, arg2]: ...
81 error handler was added
Changed in version 3. 6
Support added to accept objects implementing
On Windows, opening a console buffer may return a subclass of other than
Changed in version 3. 11. The
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']42 mode has been removed. ord[c]
Given a string representing one Unicode character, return an integer representing the Unicode code point of that character. For example,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']43 returns the integer
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']44 and
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']45 [Euro sign] returns
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']46. This is the inverse of pow[base , exp , mod=Không có]
Return base to the power exp; if mod is present, return base to the power exp, modulo mod [computed more efficiently than
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']48]. The two-argument form
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']49 is equivalent to using the power operator.
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']50
The arguments must have numeric types. With mixed operand types, the coercion rules for binary arithmetic operators apply. For operands, the result has the same type as the operands [after coercion] unless the second argument is negative; in that case, all arguments are converted to float and a float result is delivered. For example,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']52 returns
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']53, but
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']54 returns
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']55. For a negative base of type or and a non-integral exponent, a complex result is delivered. For example,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']58 returns a value close to
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']59
For operands base and exp, if mod is present, mod must also be of integer type and mod must be nonzero. If mod is present and exp is negative, base must be relatively prime to mod. In that case,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']61 is returned, where inv_base is an inverse to base modulo mod
Here’s an example of computing an inverse for
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']62 modulo
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']44
def any[iterable]: for element in iterable: if element: return True return False8
Changed in version 3. 8. For operands, the three-argument form of
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']65 now allows the second argument to be negative, permitting computation of modular inverses.
Changed in version 3. 8. Allow keyword arguments. Formerly, only positional arguments were supported.
print[*objects , sep=' ' , end='\n' , file=None , flush=False]Print objects to the text stream file, separated by sep and followed by end. sep, end, file, and flush, if present, must be given as keyword arguments
All non-keyword arguments are converted to strings like does and written to the stream, separated by sep and followed by end. Both sep and end must be strings; they can also be
def any[iterable]: for element in iterable: if element: return True return False83, which means to use the default values. If no objects are given, will just write end
The file argument must be an object with a
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']69 method; if it is not present or
def any[iterable]: for element in iterable: if element: return True return False83, will be used. Since printed arguments are converted to text strings, cannot be used with binary mode file objects. For these, use
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']73 instead
Whether the output is buffered is usually determined by file, but if the flush keyword argument is true, the stream is forcibly flushed
Changed in version 3. 3. Added the flush keyword argument.
class property[fget=None , fset=None , fdel=None , doc=Không có]Return a property attribute
fget is a function for getting an attribute value. fset is a function for setting an attribute value. fdel is a function for deleting an attribute value. And doc creates a docstring for the attribute
A typical use is to define a managed attribute
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'15
def any[iterable]: for element in iterable: if element: return True return False9
If c is an instance of C,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']75 will invoke the getter,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']76 will invoke the setter, and
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']77 the deleter
If given, doc will be the docstring of the property attribute. Otherwise, the property will copy fget’s docstring [if it exists]. This makes it possible to create read-only properties easily using as a
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'0
The
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']79 decorator turns the
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']80 method into a “getter” for a read-only attribute with the same name, and it sets the docstring for voltage to “Get the current voltage. ”
A property object has
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']81,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']82, and
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']83 methods usable as decorators that create a copy of the property with the corresponding accessor function set to the decorated function. This is best explained with an example
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'1
This code is exactly equivalent to the first example. Be sure to give the additional functions the same name as the original property [
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'15 in this case. ]
The returned property object also has the attributes
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']85,
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']86, and
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']87 corresponding to the constructor arguments
Changed in version 3. 5. The docstrings of property objects are now writeable.
lớp range[stop]class range[start , stop , step=1]Rather than being a function, is actually an immutable sequence type, as documented in and
repr[object]Return a string containing a printable representation of an object. Đối với nhiều loại, hàm này cố gắng trả về một chuỗi sẽ tạo ra một đối tượng có cùng giá trị khi được chuyển đến; . Một lớp có thể kiểm soát những gì hàm này trả về cho các phiên bản của nó bằng cách xác định phương thức
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']90. Nếu không truy cập được, chức năng này sẽ tăngđảo ngược[seq]
Trả lại một đảo ngược. seq must be an object which has a
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']93 method or supports the sequence protocol [the
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']94 method and the
class C: @classmethod def f[cls, arg1, arg2]: ...01 method with integer arguments starting at
def any[iterable]: for element in iterable: if element: return True return False92]round[number , ndigits=Không có]
Trả về số được làm tròn chính xác đến n chữ số sau dấu thập phân. If ndigits is omitted or is
def any[iterable]: for element in iterable: if element: return True return False83, it returns the nearest integer to its input
For the built-in types supporting , values are rounded to the closest multiple of 10 to the power minus ndigits; if two multiples are equally close, rounding is done toward the even choice [so, for example, both
>>> import struct >>> dir[] # show the names in the module namespace ['__builtins__', '__name__', 'struct'] >>> dir[struct] # show the names in the struct module ['Struct', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__initializing__', '__loader__', '__name__', '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into', 'unpack', 'unpack_from'] >>> class Shape: .. def __dir__[self]: .. return ['area', 'perimeter', 'location'] >>> s = Shape[] >>> dir[s] ['area', 'location', 'perimeter']99 and
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]00 are
def any[iterable]: for element in iterable: if element: return True return False92, and
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]02 is
def any[iterable]: for element in iterable: if element: return True return False96]. Mọi giá trị số nguyên đều hợp lệ cho n chữ số [dương, 0 hoặc âm]. The return value is an integer if ndigits is omitted or
def any[iterable]: for element in iterable: if element: return True return False83. Mặt khác, giá trị trả về có cùng loại với số
Đối với một đối tượng Python chung
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]05,
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]06 ủy quyền cho
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]07
Ghi chú
Hành vi của for float có thể gây ngạc nhiên. ví dụ:
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]09 cho
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]10 thay vì dự kiến là
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]11. This is not a bug. it’s a result of the fact that most decimal fractions can’t be represented exactly as a float. See for more informationclass setclass set[iterable]
Trả về một đối tượng mới, tùy chọn với các phần tử được lấy từ iterable.
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'37 là một lớp tích hợp. See and for documentation about this class
For other containers see the built-in , , , and classes, as well as the module
setattr[object , name , value]This is the counterpart of . Các đối số là một đối tượng, một chuỗi và một giá trị tùy ý. The string may name an existing attribute or a new attribute. The function assigns the value to the attribute, provided the object allows it. For example,
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]21 is equivalent to
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]22
name need not be a Python identifier as defined in unless the object chooses to enforce that, for example in a custom or via . An attribute whose name is not an identifier will not be accessible using the dot notation, but is accessible through etc
Ghi chú
Since happens at compilation time, one must manually mangle a private attribute’s [attributes with two leading underscores] name in order to set it with
lớp slice[stop]class slice[start , stop , step=1]Return a object representing the set of indices specified by
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]27. The start and step arguments default to
def any[iterable]: for element in iterable: if element: return True return False83. Các đối tượng lát cắt có các thuộc tính dữ liệu chỉ đọc
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]29,
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]30 và
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]31 chỉ trả về các giá trị đối số [hoặc giá trị mặc định của chúng]. They have no other explicit functionality; however, they are used by NumPy and other third-party packages. Slice objects are also generated when extended indexing syntax is used. For example.
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]32 or
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]33. Xem phiên bản thay thế trả về một trình vòng lặpđã sắp xếp[có thể lặp lại , / , * , key=None , reverse=False]
Return a new sorted list from the items in iterable
Has two optional arguments which must be specified as keyword arguments
key chỉ định chức năng của một đối số được sử dụng để trích xuất khóa so sánh từ mỗi phần tử trong iterable [ví dụ:
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]35]. The default value is
def any[iterable]: for element in iterable: if element: return True return False83 [compare the elements directly]
đảo ngược là một giá trị boolean. If set to
def any[iterable]: for element in iterable: if element: return True return False09, then the list elements are sorted as if each comparison were reversed
Use to convert an old-style cmp function to a key function
The built-in function is guaranteed to be stable. A sort is stable if it guarantees not to change the relative order of elements that compare equal — this is helpful for sorting in multiple passes [for example, sort by department, then by salary grade]
The sort algorithm uses only
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]40 comparisons between items. While defining an method will suffice for sorting, PEP 8 recommends that all six be implemented. This will help avoid bugs when using the same data with other ordering tools such as that rely on a different underlying method. Implementing all six comparisons also helps avoid confusion for mixed type comparisons which can call reflected the method
For sorting examples and a brief sorting tutorial, see
@staticmethodTransform a method into a static method
A static method does not receive an implicit first argument. To declare a static method, use this idiom
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'2
The
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]44 form is a function – see for details
A static method can be called either on the class [such as
def any[iterable]: for element in iterable: if element: return True return False65] or on an instance [such as
def any[iterable]: for element in iterable: if element: return True return False66]. Moreover, they can be called as regular functions [such as
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]47]
Static methods in Python are similar to those found in Java or C++. Ngoài ra, hãy xem một biến thể hữu ích để tạo các hàm tạo lớp thay thế
Like all decorators, it is also possible to call
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]49 as a regular function and do something with its result. This is needed in some cases where you need a reference to a function from a class body and you want to avoid the automatic transformation to instance method. For these cases, use this idiom
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'3
For more information on static methods, see
Changed in version 3. 10. Các phương thức tĩnh hiện kế thừa các thuộc tính của phương thức [
def any[iterable]: for element in iterable: if element: return True return False69,
def any[iterable]: for element in iterable: if element: return True return False70,
def any[iterable]: for element in iterable: if element: return True return False71,
def any[iterable]: for element in iterable: if element: return True return False72 và
def any[iterable]: for element in iterable: if element: return True return False73], có thuộc tính mới
def any[iterable]: for element in iterable: if element: return True return False74 và hiện có thể gọi được như các hàm thông thường. lớp str[object='']class str[object=b'' , encoding='utf-8' , errors='strict']
Return a version of object. Xem để biết chi tiết
class C: @classmethod def f[cls, arg1, arg2]: ...58 là chuỗi tích hợp. For general information about strings, see sum[iterable , / , bắt đầu=0]
Sums start and the items of an iterable from left to right and returns the total. The iterable’s items are normally numbers, and the start value is not allowed to be a string
For some use cases, there are good alternatives to . Cách ưa thích, nhanh chóng để nối một chuỗi các chuỗi là bằng cách gọi
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]60. To add floating point values with extended precision, see . To concatenate a series of iterables, consider using
Đã thay đổi trong phiên bản 3. 8. The start parameter can be specified as a keyword argument.
class superclass siêu[type , object_or_type=Không có]Return a proxy object that delegates method calls to a parent or sibling class of type. This is useful for accessing inherited methods that have been overridden in a class
The object_or_type determines the to be searched. The search starts from the class right after the type
For example, if of object_or_type is
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]64 and the value of type is
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]65, then searches
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]67
The attribute of the object_or_type lists the method resolution search order used by both and . The attribute is dynamic and can change whenever the inheritance hierarchy is updated
If the second argument is omitted, the super object returned is unbound. If the second argument is an object,
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]71 must be true. If the second argument is a type,
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]72 must be true [this is useful for classmethods]
There are two typical use cases for super. In a class hierarchy with single inheritance, super can be used to refer to parent classes without naming them explicitly, thus making the code more maintainable. This use closely parallels the use of super in other programming languages
The second use case is to support cooperative multiple inheritance in a dynamic execution environment. This use case is unique to Python and is not found in statically compiled languages or languages that only support single inheritance. This makes it possible to implement “diamond diagrams” where multiple base classes implement the same method. Good design dictates that such implementations have the same calling signature in every case [because the order of calls is determined at runtime, because that order adapts to changes in the class hierarchy, and because that order can include sibling classes that are unknown prior to runtime]
For both use cases, a typical superclass call looks like this
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'4
In addition to method lookups, also works for attribute lookups. One possible use case for this is calling in a parent or sibling class
Note that is implemented as part of the binding process for explicit dotted attribute lookups such as
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]75. It does so by implementing its own
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'42 method for searching classes in a predictable order that supports cooperative multiple inheritance. Accordingly, is undefined for implicit lookups using statements or operators such as
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]78
Also note that, aside from the zero argument form, is not limited to use inside methods. The two argument form specifies the arguments exactly and makes the appropriate references. The zero argument form only works inside a class definition, as the compiler fills in the necessary details to correctly retrieve the class being defined, as well as accessing the current instance for ordinary methods
For practical suggestions on how to design cooperative classes using , see guide to using super[]
class tuplelớp tuple[iterable]Rather than being a function, is actually an immutable sequence type, as documented in and
class type[object]class type[name , cơ sở , dict , **kwds]With one argument, return the type of an object. The return value is a type object and generally the same object as returned by
The built-in function is recommended for testing the type of an object, because it takes subclasses into account
With three arguments, return a new type object. This is essentially a dynamic form of the statement. The name string is the class name and becomes the attribute. Bộ cơ sở chứa các lớp cơ sở và trở thành thuộc tính; . The dict dictionary contains attribute and method definitions for the class body; it may be copied or wrapped before becoming the attribute. The following two statements create identical objects
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'5
See also
Keyword arguments provided to the three argument form are passed to the appropriate metaclass machinery [usually ] in the same way that keywords in a class definition [besides metaclass] would
See also
Changed in version 3. 6. Subclasses of which don’t override
>>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list[enumerate[seasons]] [[0, 'Spring'], [1, 'Summer'], [2, 'Fall'], [3, 'Winter']] >>> list[enumerate[seasons, start=1]] [[1, 'Spring'], [2, 'Summer'], [3, 'Fall'], [4, 'Winter']]92 may no longer use the one-argument form to get the type of an object. vars[]vars[object]
Return the attribute for a module, class, instance, or any other object with a attribute
Objects such as modules and instances have an updateable attribute; however, other objects may have write restrictions on their attributes [for example, classes use a to prevent direct dictionary updates]
Without an argument, acts like . Note, the locals dictionary is only useful for reads since updates to the locals dictionary are ignored
Một ngoại lệ được đưa ra nếu một đối tượng được chỉ định nhưng nó không có thuộc tính [ví dụ: nếu lớp của nó xác định thuộc tính]
zip[*iterables , strict=False]Lặp lại song song nhiều lần lặp, tạo ra các bộ dữ liệu với một mục từ mỗi bộ
Thí dụ
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'6
More formally. trả về một bộ lặp của các bộ, trong đó bộ thứ i chứa phần tử thứ i từ mỗi bộ lặp đối số
Một cách khác để nghĩ đến là nó biến hàng thành cột và cột thành hàng. This is similar to transposing a matrix
là lười biếng. Các phần tử sẽ không được xử lý cho đến khi iterable được lặp lại trên, e. g. by a
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 106 loop or by wrapping in a
Một điều cần xem xét là các lần lặp được chuyển đến có thể có độ dài khác nhau; . Python offers three different approaches to dealing with this issue
Theo mặc định, dừng khi hết lần lặp ngắn nhất. Nó sẽ bỏ qua các mục còn lại trong các lần lặp dài hơn, cắt kết quả theo độ dài của lần lặp ngắn nhất
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'
7thường được sử dụng trong trường hợp các lần lặp được giả định là có độ dài bằng nhau. Trong những trường hợp như vậy, bạn nên sử dụng tùy chọn
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 1
11. Its output is the same as regular>>> bin[3] '0b11' >>> bin[-10] '-0b1010'
8Unlike the default behavior, it raises a if one iterable is exhausted before the others
>>> bin[3] '0b11' >>> bin[-10] '-0b1010'
9Without the
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 1
11 argument, any bug that results in iterables of different lengths will be silenced, possibly manifesting as a hard-to-find bug in another part of the programShorter iterables can be padded with a constant value to make all the iterables have the same length. This is done by
Edge cases. Với một đối số có thể lặp lại duy nhất, trả về một trình vòng lặp gồm 1 bộ. With no arguments, it returns an empty iterator
Các mẹo và thủ thuật
Thứ tự đánh giá từ trái sang phải của các lần lặp được đảm bảo. Điều này có thể tạo thành một thành ngữ để phân cụm chuỗi dữ liệu thành các nhóm có độ dài n bằng cách sử dụng
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 1
17. Điều này lặp lại cùng một iteratordef enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 1
18 lần để mỗi bộ dữ liệu đầu ra có kết quả là ____97_______18 lời gọi tới iterator. This has the effect of dividing the input into n-length chunkskết hợp với toán tử
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 1
21 có thể được sử dụng để giải nén danh sách>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']
0
Changed in version 3. 10. Đã thêm đối số
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 122. __import__[name , globals=None , locals=None , fromlist=[] , level=0]
Ghi chú
This is an advanced function that is not needed in everyday Python programming, unlike
Hàm này được gọi bởi câu lệnh. Nó có thể được thay thế [bằng cách nhập mô-đun và gán cho
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 126] để thay đổi ngữ nghĩa của câu lệnh
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 124, nhưng làm như vậy không được khuyến khích vì sử dụng hook nhập khẩu thường đơn giản hơn [xem PEP 302] để đạt được các mục tiêu tương tự và . Direct use of is also discouraged in favor of
Hàm nhập tên mô-đun, có khả năng sử dụng toàn cầu và cục bộ đã cho để xác định cách diễn giải tên trong ngữ cảnh gói. Danh sách từ cung cấp tên của các đối tượng hoặc mô hình con nên được nhập từ mô-đun được cung cấp theo tên. Việc triển khai tiêu chuẩn hoàn toàn không sử dụng đối số cục bộ của nó và chỉ sử dụng toàn cầu của nó để xác định ngữ cảnh gói của câu lệnh
level specifies whether to use absolute or relative imports.
def any[iterable]: for element in iterable: if element: return True return False92 [mặc định] có nghĩa là chỉ thực hiện nhập tuyệt đối. Các giá trị dương cho level cho biết số lượng thư mục mẹ cần tìm kiếm so với thư mục của mô-đun đang gọi [xem PEP 328 để biết chi tiết]
When the name variable is of the form
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 133, normally, the top-level package [the name up till the first dot] is returned, not the module named by name. However, when a non-empty fromlist argument is given, the module named by name is returned
For example, the statement
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 134 results in bytecode resembling the following code
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']1
The statement
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 135 results in this call
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']2
Note how returns the toplevel module here because this is the object that is bound to a name by the statement
On the other hand, the statement
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 138 results in
>>> format[14, '#b'], format[14, 'b'] ['0b1110', '1110'] >>> f'{14:#b}', f'{14:b}' ['0b1110', '1110']3
Here, the
def enumerate[iterable, start=0]: n = start for elem in iterable: yield n, elem n += 139 module is returned from . From this object, the names to import are retrieved and assigned to their respective names
Nếu bạn chỉ muốn nhập một mô-đun [có khả năng nằm trong một gói] theo tên, hãy sử dụng
Changed in version 3. 3. Các giá trị âm cho cấp độ không còn được hỗ trợ [điều này cũng thay đổi giá trị mặc định thành 0].
Changed in version 3. 9. Khi tùy chọn dòng lệnh hoặc đang được sử dụng, biến môi trường sẽ bị bỏ qua.
Footnotes
Note that the parser only accepts the Unix-style end of line convention. If you are reading the code from a file, make sure to use newline conversion mode to convert Windows or Mac-style newlines