Quy ước đặt tên cho các loại mẫu?

Question

Theo truyền thống, tên của các kiểu mẫu chỉ là một lá thư chữ hoa duy nhất:

template<class A, class B, class C> 
class Foo {}; 

Nhưng tôi ngần ngại để làm điều này vì nó không mô tả và cứng do đó để đọc. Vì vậy, sẽ không một cái gì đó như thế này là tốt hơn:

template<class AtomT, class BioT, class ChemT> 
class Foo {}; 

Tôi cũng có xu hướng nghĩ rằng sau đây sẽ không phải là một ý tưởng tồi:

template<class ATOM, class BIO, class CHEM> 
class Foo {}; 

Nó làm cho họ nổi bật (và cũng có thể, đó là thượng chữ cái một lần nữa). Ý kiến ​​của bạn là gì?

Answer 1

Đối với C++ templates Tôi có một vài mẫu

Nếu có chỉ là một tham số mẫu duy nhất, tôi đặt tên cho nó T (hoặc U, V cho các mẫu lồng nhau).

Khi có nhiều tham số và việc sử dụng không hiển thị ngay lập tức thì tôi sử dụng tên mô tả được đặt trước bằng T. Ví dụ: TKey, TValue, TIdentifiier, v.v ... Điều này làm cho các tham số trở nên dễ dàng trong suốt quá trình sử dụng mẫu .

Tôi sẽ tránh tất cả phiên bản chữ hoa. Hầu hết mọi người sử dụng tất cả các định danh chữ hoa trong C/C++ để biểu diễn một định nghĩa macro. Lặp lại mẫu đó cho một tham số mẫu có khả năng gây nhầm lẫn cho mọi người xuống đường.

Answer 2

Nói chung, cách truyền thống là sử dụng T nếu chỉ có một loại tham số. Nếu có nhiều hơn, hãy sử dụng T làm tiền tố, ví dụ: TAtom. Tiền tố "T" giúp ngay lập tức thấy thông số loại của nó. Sử dụng TAtom cho một tham số kiểu đơn cũng hợp lệ.

Answer 3

Nếu tôi có lớp học với một tham số kiểu tôi đang sử dụng tên T. Ngoài ra nó có nghĩa là tất cả operartion trong lớp này đang làm việc với T.

Nếu tôi có vài thông số tôi đặt tên như trong AtomT explamle của bạn , BioT ...
Nếu thông số mẫu không phải là loại đối tượng mà chúng tôi đang làm việc trong clas ví dụ chiến lược, comaparator hoặc functor, tôi đang sử dụng tên mà không có T ví dụ ThreadStrategy, So sánh.

Đôi khi để tránh các kiểu trộn, tôi đang tạo typedef trong lớp:
typedef T value_type;

-
Boost quy ước đặt tên (http://www.boost.org/development/requirements.html#Naming_consistency) nói về mẫu thông số tiếp theo:
tên tham số Template bắt đầu với một ký tự hoa.

Answer 4

Bạn không nên sử dụng quy ước đặt tên đặc biệt cho mẫu, chỉ cần sử dụng cùng quy ước như đối với bất kỳ quy ước nào khác của loại đó (như đối với các lớp hoặc biến). Nó không nên quan trọng trong mã cho dù bạn đang làm việc với các kiểu mẫu/giá trị hoặc các giá trị bình thường.

Answer 5

Tôi cố gắng tuân theo khái niệm mà nhà cung cấp trình biên dịch của tôi sử dụng: nó không quá ngắn và không quá dài dòng. Và giúp tôi đọc các thông báo lỗi tôi nhận được với các mẫu chuẩn. (Đó là một lý do khác khiến tôi chuyển từ const T& sang T const&).Một cái gì đó như:

template <class Ty, class Container> 
class my_algo { ... 

nơi trình biên dịch của tôi thường sẽ sử dụng:

template <class _Ty, class _Container> 
class std_algo { ... 

Answer 6

tôi sử dụng ước tname cho mẫu tham số và NameT cho tham số mẫu được lưu trữ.

template <typename TFirst, typename TSecond> 
class Templated 
{ 
    typedef TFirst FirstT; 
    typedef TSecond SecondT; 
} 

typedef Templated<int, std::string> MyTemplated; 
... 
const MyTemplated::FirstT size; 

Answer 7

Tôi làm theo những quy ước chung giống nhau đặt tên typenames mẫu tham số như tôi làm theo cách đặt tên lớp & cấu trúc, mà là để tận dụng các chữ cái đầu tiên hoặc mỗi từ, như vậy:

class MyGizmo 
{ 
}; 

struct Thingy 
{ 
}; 

class TPSReport 
{ 
}; 


template<class ValType> ... 

template<typename Number> ... 

Answer 8

Tại cửa hàng của chúng tôi , chúng tôi sử dụng ký hiệu HungF ## ngarian. Đối số mẫu chỉ là các đối số như tất cả các đối số khác, ngoại trừ chúng không phải là một const, cũng không phải là một biến, mà là một kiểu.

template< typename at_Container, typename at_Functor > 
at_Functor& foreach(const at_Container& ac_Cont, at_Functor& av_Func) { 
    return std::foreach(ac_Cont.begin(), ac_Cont.end(), av_Func); 
} 

Tiền tố mô tả loại, trong khi tên có nghĩa là để nói điều gì đó trong vai trò đối số phát trong ngữ cảnh của hàm được xác định.