Đánh dấu các chức năng ghi đè

Question

Có một lệnh tồn tại, như \deprecated, nhưng để đánh dấu các chức năng ghi đè không?

Java có chú thích @override cho các hàm bạn đã ghi đè. Tôi muốn làm tương tự trong C++, để tôi có thể thấy các hàm siêu lớp mà tôi đã ghi đè. Tốt nhất, trang tài liệu cũng nên hiển thị tất cả các hàm thành viên của lớp, được kế thừa, nhưng không được ghi đè rõ ràng với các siêu liên kết đến các hàm siêu lớp.

Tôi biết có cách sao chép tài liệu từ phương thức siêu lớp. Nhưng tôi không muốn sao chép toàn bộ tài liệu. Tôi chỉ muốn biết rằng một chức năng được kế thừa. Hành vi phải tương tự như tùy chọn không được chấp nhận để đánh dấu các chức năng cũ đó bằng một thanh.

Answer 1

Mỗi chức năng bị ghi đè tự động nhận được thông báo đã được triển khai lại. Ví dụ, hàm được ghi đè trong một lớp dẫn xuất nhận được thông báo "Reimplemented from MyBaseClass."

Nó cũng đặt thông báo trong tài liệu của lớp cơ sở. Có đề cập đến "Reimplemented in Test"

Để hiển thị tất cả các chức năng, kể cả các hàm được kế thừa, bạn có thể đặt INLINE_INHERITED_MEMB thành YES. Sau đó Doxygen sao chép tài liệu của mọi hàm thừa kế, nhưng không bị ghi đè vào tài liệu của lớp dẫn xuất.

Ví dụ, khi sử dụng nguồn này:

class TestBase 
{ 
    public: 
     /** 
     * Base class function. 
     */ 
     virtual void function(); 

     /** 
     * Another function. 
     */ 
     virtual void another(); 
}; 

class Test: public TestBase 
{   
    public: 
     /** 
     * Overridden function. 
     */ 
     virtual void function(); 
}; 

Và thiết INLINE_INHERITED_MEMB-YES sẽ cho kết quả trong các tài liệu sau cho lớp Derived: (Với Doxygen 1.7.6)

Thành viên Tài liệu Chức năng

virtual void TestBase::another ( ) [virtual, inherited]
Một chức năng khác.

virtual void Test::function ( ) [virtual]
Có nguồn gốc.
Được thực hiện lại từ TestBase.

Tôi nghĩ rằng đây là những gì bạn đang tìm kiếm.

Answer 2

Kể từ C++ 11 bạn có thể sử dụng override specifier:

class A { 
    virtual void jump() = 0; 
    void talk() {} 
}; 

class B: public A { 
    void jump() const override {...} // Error: B:: jump does Not overrides A:: jump (A::Jump is not const...) 
    void jump() override {...} // OK: B:: jump overrides A:: jump 
    void talk() override {...} // Error: A::talk is not virtual 
}; 

gốc Ví dụ và doc chính thức: http://en.cppreference.com/w/cpp/language/override