Hướng dẫn should enum be plural python? - enum có nên là python số nhiều không?
|
Bạn sử dụng số ít hoặc số nhiều để liệt kê? Tôi nghĩ rằng nó có ý nghĩa tốt nhất với số nhiều trong Tuyên bố Show
... Nhưng tôi nghĩ rằng nó có ý nghĩa hơn với số ít khi sử dụng loại, ví dụ: Tôi đã đọc một đề xuất ở đâu đó để sử dụng số ít trong các enum và số nhiều thông thường với cờ, nhưng tôi muốn nghe thêm một số ưu và nhược điểm. 2 Một đề xuất đến từ Hướng dẫn thiết kế .NET Framework, trang 59-60:
Trong khung .NET, hầu hết các enum "bình thường" (ví dụ:
Đúng. Nếu bạn thực hiện trải nghiệm tinh thần khi thực hiện các enum như các lớp, thì thực tế là bạn sẽ sử dụng một tên số ít cho loại sẽ tiết lộ rằng việc sử dụng tên số ít cho các enum như vậy có ý nghĩa. Ví dụ., ... Đối với ai thích số nhiều trong enums, bạn sẽ đặt tên cho Nói chung, tôi coi một định nghĩa enum là một định nghĩa loại, với các giá trị của enum là các giá trị khác nhau mà loại có thể có; Do đó, nó có một tên số ít: Microsoft khuyên bạn nên sử dụng tên số ít để liệt kê trừ khi nó sử dụng thuộc tính 1 Nó chủ quan và không quan trọng bạn sử dụng gì, miễn là bạn nhất quán (cá nhân tôi sử dụng số ít như nó mang theo từ các quy ước SQL của tôi) 3
Câu trả lời
trừu tượngTình trạng của các cuộc thảo luận Động lực Tình trạng của các cuộc thảo luậnĐộng lực Vấn đề phân chia quan trọng giữa Thảo luận thêm vào cuối tháng 4 năm 2013 đã dẫn đến kết luận rằng các thành viên liệt kê nên thuộc loại enum của họ: PEP đã được Guido chấp nhận vào ngày 10 tháng 5 năm 2013 [1]. Động lực[Dựa trên một phần vào động lực được nêu trong PEP 354] Các thuộc tính của một liệt kê rất hữu ích để xác định một tập hợp các giá trị không đổi liên quan, có thể có ý nghĩa ngữ nghĩa. Các ví dụ kinh điển là những ngày trong tuần (Chủ nhật đến thứ bảy) và các lớp đánh giá trường học (‘A, thông qua‘ D, và ‘F,). Các ví dụ khác bao gồm các giá trị trạng thái lỗi và trạng thái trong một quy trình được xác định. Có thể chỉ cần xác định một chuỗi các giá trị của một số loại cơ bản khác, chẳng hạn như Mô -đun và tên loạiChúng tôi đề xuất thêm một mô -đun có tên >>> from enum import Enum Đề xuất ngữ nghĩa cho loại liệt kê mớiTạo ra một enumCác liệt kê được tạo bằng cú pháp lớp, giúp chúng dễ đọc và viết. Một phương pháp tạo thay thế được mô tả trong API chức năng. Để xác định một liệt kê, lớp con >>> from enum import Enum >>> class Color(Enum): ... red = 1 ... green = 2 ... blue = 3 Một lưu ý về danh pháp: Chúng tôi gọi enum Days {Sat, Sun, Mon, Tue, Wed, Thu, Fri};0, etc.)Các thành viên liệt kê có các biểu diễn chuỗi có thể đọc được của con người: Trong khi enum Days {Sat, Sun, Mon, Tue, Wed, Thu, Fri};1 của họ có thêm thông tin:Loại thành viên liệt kê là bảng liệt kê mà nó thuộc về: Enums cũng có một tài sản chỉ chứa tên mặt hàng của họ: Tái liệt trình hỗ trợ lặp lại, theo thứ tự định nghĩa: Các thành viên liệt kê có thể băm, vì vậy chúng có thể được sử dụng trong từ điển và bộ: Truy cập chương trình vào các thành viên liệt kêĐôi khi, nó rất hữu ích để truy cập các thành viên trong các lập trình theo chương trình (nghĩa là các tình huống trong đó Nếu bạn muốn truy cập các thành viên Enum theo tên, hãy sử dụng quyền truy cập mục: Sao chép các thành viên và giá trị enumCó hai thành viên enum có cùng tên là không hợp lệ: Tuy nhiên, hai thành viên ENUM được phép có cùng giá trị. Cho hai thành viên A và B có cùng giá trị (và đầu tiên được xác định), B là bí danh đối với A. Tra cứu giá trị của giá trị của A và B sẽ trả về A. Tra cứu tên B của B cũng sẽ trả về A: Lặp lại các thành viên của một enum không cung cấp các bí danh: Thuộc tính đặc biệt enum Days {Sat, Sun, Mon, Tue, Wed, Thu, Fri};4 là một tên ánh xạ từ điển được đặt hàng cho các thành viên. Nó bao gồm tất cả các tên được xác định trong bảng liệt kê, bao gồm các bí danh:Thuộc tính enum Days {Sat, Sun, Mon, Tue, Wed, Thu, Fri};4 có thể được sử dụng để truy cập chương trình chi tiết cho các thành viên liệt kê. Ví dụ: tìm tất cả các bí danh:So sánhCác thành viên liệt kê được so sánh bằng danh tính: So sánh được đặt hàng giữa các giá trị liệt kê không được hỗ trợ. Enums không phải là số nguyên (nhưng xem intenum bên dưới): So sánh bình đẳng được xác định mặc dù: So sánh với các giá trị không kích thích sẽ luôn so sánh không bằng nhau (một lần nữa, Cho phép các thành viên và thuộc tính của các liệt kêCác ví dụ trên sử dụng số nguyên cho các giá trị liệt kê. Sử dụng số nguyên ngắn và tiện dụng (và được cung cấp theo mặc định bởi API chức năng), nhưng không được thực thi nghiêm ngặt. Trong phần lớn các trường hợp sử dụng, người ta không quan tâm đến giá trị thực tế của một liệt kê là gì. Nhưng nếu giá trị là quan trọng, bảng liệt kê có thể có các giá trị tùy ý. Các bảng liệt kê là các lớp Python, và có thể có các phương pháp và phương pháp đặc biệt như bình thường. Nếu chúng ta có sự liệt kê này: Then: Các quy tắc cho những gì được phép như sau: tất cả các thuộc tính được xác định trong một bảng liệt kê sẽ trở thành thành viên của bảng liệt kê này, ngoại trừ __dunder__ tên và mô tả [9]; Phương pháp là mô tả quá. Bị hạn chế phân lớp các bảng liệt kêPhân lớp một liệt kê chỉ được phép nếu việc liệt kê không xác định bất kỳ thành viên nào. Vì vậy, điều này bị cấm: Nhưng điều này được cho phép: Lý do cho quyết định này được đưa ra bởi Guido trong [6]. Cho phép các phân lớp các enum xác định các thành viên sẽ dẫn đến vi phạm một số bất biến quan trọng của các loại và trường hợp. Mặt khác, thật hợp lý khi cho phép chia sẻ một số hành vi phổ biến giữa một nhóm các liệt kê và phân lớp các bảng điều khiển trống cũng được sử dụng để thực hiện IntenumMột biến thể của Tuy nhiên, họ vẫn có thể được so sánh với Đối với đại đa số mã, Các mối liệt kê có nguồn gốc khácĐiều này cho thấy cách các liệt kê có nguồn gốc tương tự có thể được xác định, ví dụ A >>> from enum import Enum7 trộn trong Một số quy tắc:
NgâmTái lập có thể được ngâm và không được giải thích: Các hạn chế thông thường đối với Pickling áp dụng: Các enum có thể chọn phải được xác định ở cấp cao nhất của một mô -đun, vì việc không bị ràng buộc đòi hỏi chúng phải được nhập từ mô -đun đó. API chức năngLớp Các ngữ nghĩa của API này giống với >>> from enum import Enum >>> class Color(Enum): ... red = 1 ... green = 2 ... blue = 35. Đối số đầu tiên của cuộc gọi đến Đối số thứ hai là nguồn gốc của tên thành viên liệt kê. Nó có thể là một chuỗi các tên được phân tách bằng khoảng trắng, một chuỗi các tên, một chuỗi các bộ 2 với các cặp khóa/giá trị hoặc ánh xạ (ví dụ: từ điển) của các tên thành các giá trị. Hai tùy chọn cuối cùng cho phép gán các giá trị tùy ý cho các bảng điều khiển; Các số nguyên tăng tự động khác bắt đầu với 1. Một lớp mới có nguồn gốc từ >>> from enum import Enum >>> class Color(Enum): ... red = 1 ... green = 2 ... blue = 38 tương đương với: Lý do mặc định đến enum Days {Sat, Sun, Mon, Tue, Wed, Thu, Fri};0 là số bắt đầu chứ không phải Biến thể đề xuấtMột số biến thể đã được đề xuất trong các cuộc thảo luận trong danh sách gửi thư. Ở đây, một số trong những cái phổ biến hơn. flufl.enumKhông phải chỉ định các giá trị cho enumsMichael Foord đã đề xuất (và Tim Delaney đã cung cấp một triển khai bằng chứng về khái niệm) để sử dụng ma thuật Metaclass giúp điều này có thể: Các giá trị thực sự chỉ được gán khi lần đầu tiên nhìn lên. Ưu điểm: Cú pháp Cleaner yêu cầu gõ ít hơn cho một nhiệm vụ rất phổ biến (chỉ liệt kê các tên liệt kê mà không quan tâm đến các giá trị). Nhược điểm: Liên quan đến nhiều phép thuật trong việc thực hiện, điều này làm cho ngay cả định nghĩa của các enum như vậy khi lần đầu tiên nhìn thấy. Bên cạnh đó, rõ ràng là tốt hơn tiềm ẩn. Sử dụng các tên hoặc biểu mẫu đặc biệt để tự động tham gia các giá trị enumMột cách tiếp cận khác để tránh chỉ định các giá trị enum là sử dụng tên hoặc biểu mẫu đặc biệt để tự động gán chúng. Ví dụ: Linh hoạt hơn: Một số biến thể về chủ đề này:
Ưu điểm: Không cần phải nhập thủ công các giá trị. Làm cho nó dễ dàng hơn để thay đổi enum và mở rộng nó, đặc biệt là đối với các liệt kê lớn. Nhược điểm: thực sự dài hơn để gõ trong nhiều trường hợp đơn giản. Đối số của rõ ràng so với ngầm áp dụng ở đây là tốt. Sử dụng trường hợp trong thư viện tiêu chuẩnThư viện tiêu chuẩn Python có nhiều nơi sử dụng các enum sẽ có lợi để thay thế các thành ngữ khác hiện đang được sử dụng để đại diện cho chúng. Các cách sử dụng như vậy có thể được chia thành hai loại: các hằng số đối diện với mã người dùng và hằng số bên trong. Các hằng số đối mặt với mã người dùng như hằng số mô-đun Các hằng số bên trong không được nhìn thấy bởi mã người dùng nhưng được sử dụng bên trong các mô -đun stdlib. Chúng có thể được thực hiện với Ngoài ra, nhìn vào mã của thư viện xoắn, có nhiều trường hợp sử dụng để thay thế các hằng số trạng thái bên trong bằng enums. Điều tương tự cũng có thể nói về rất nhiều mã kết nối mạng (đặc biệt là triển khai các giao thức) và cũng có thể thấy trong các giao thức thử nghiệm được viết với thư viện tulip. Sự nhìn nhậnPEP này ban đầu được đề xuất bao gồm gói Người giới thiệuBản quyềnTài liệu này đã được đặt trong phạm vi công cộng. Nên được đặt tên là số nhiều?Enums trong Java (và có lẽ là enum nói chung) nên là số ít.Suy nghĩ là bạn không chọn nhiều giao thức, mà là một giao thức của các lựa chọn có thể trong danh sách các giá trị.should be singular. The thinking is that you're not selecting multiple Protocols, but rather one Protocol of the possible choices in the list of values.
Enum nên là số ít hay số nhiều?Chi tiết quy tắc.Quy tắc này thực thi tất cả các enum TypeScript là số ít.Một lỗi sẽ xảy ra nếu enum được xác định với một tên số nhiều.This rule enforces all TypeScript enums to be singular. An error will occur if the enum is defined with a pluralized name.
Làm thế nào nên đặt tên cho enum?Enums là các loại, vì vậy chúng nên được đặt tên bằng cách sử dụng các lớp Uppercamelcase.Các giá trị enum là hằng số, vì vậy chúng nên được đặt tên bằng cách sử dụng LowerCamelCase như hằng số hoặc all_caps nếu mã của bạn sử dụng kiểu đặt tên kế thừa đó.using UpperCamelCase like classes. The enum values are constants, so they should be named using lowerCamelCase like constants, or ALL_CAPS if your code uses that legacy naming style.
Có nên Enums được viết hoa Python?Theo quy ước, tên liệt kê bắt đầu bằng một chữ cái viết hoa và là số ít.Mô -đun Enum được sử dụng để tạo các liệt kê trong Python.. The enum module is used for creating enumerations in Python. |
