Contrassegna le funzioni sovrascritte

Question

Esiste un comando, come \deprecated, ma per contrassegnare le funzioni sovrascritte?

Java ha un'annotazione @override per le funzioni sovrascritte. Mi piacerebbe fare lo stesso in C++, in modo da poter vedere le funzioni della superclasse che ho sovrascritto. Nella migliore delle ipotesi, la pagina della documentazione dovrebbe mostrare tutte le funzioni dei membri della classe, che sono ereditate, ma non esplicitamente sovrascritte con i collegamenti ipertestuali alle funzioni della superclasse.

So che esiste un modo per copiare la documentazione dal metodo superclasse. Ma non voglio che l'intero documento venga copiato. Voglio solo sapere, che una funzione è ereditata. Il comportamento dovrebbe essere simile all'opzione deprecata per contrassegnare quelle vecchie funzioni con una barra.

Answer 1

Ogni funzione ignorata riceve automaticamente un avviso che è stato reimplementato. Ad esempio, la funzione sostituita in una classe derivata ottiene l'avviso "Reimplementato da MyBaseClass."

Mette anche un avviso nella documentazione della classe base. C'è menzioni "Reimplemented in Test"

Per mostrare tutte le funzioni, incluse le funzioni ereditate, è possibile impostare INLINE_INHERITED_MEMB su YES. Quindi Doxygen copia la documentazione di ogni funzione ereditata, ma non sovrascritta, nella documentazione della classe derivata.

Ad esempio, quando si utilizza questa fonte:

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

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

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

e impostando INLINE_INHERITED_MEMB-YES effettuerà la seguente documentazione per la classe Derived: (con Doxygen 1.7.6)

Stati Funzione Documentazione

virtual void TestBase::another ( ) [virtual, inherited]
Un'altra funzione.

virtual void Test::function ( ) [virtual]
Derivato.
Reimplementato da TestBase.

Penso che questo sia quello che stai cercando.

Answer 2

Dal C++ 11 è possibile utilizzare il di override identificatore:

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 
}; 

originale Esempio e doc ufficiale: http://en.cppreference.com/w/cpp/language/override