Was macht //! [0]
in C ++? Ich glaube, es ist etwas, das die sprachlichen Vorgaben ändert, wie zum Beispiel faule Bewertungen oder ähnliches, aber ich weiß es nicht genau. Etwas mit Arrays?
Das ist natürlich ein Kommentar. Dennoch hat es eine besondere Bedeutung für doxygen :
%Vor%\ snippet (block_id)
Wenn der Befehl
\include
verwendet werden kann, um eine vollständige Datei als Quellcode einzuschließen, kann dieser Befehl verwendet werden, um nur ein Fragment einer Quelldatei zu zitieren.Beispiel: Wenn Sie den folgenden Befehl in die Dokumentation einfügen, wird auf einen Ausschnitt in der Datei
example.cpp
verwiesen, der sich in einem Unterverzeichnis befindet, auf dasEXAMPLE_PATH
zeigen soll.
%Vor%Der Text nach dem Dateinamen ist der eindeutige Bezeichner für das Snippet. Dies wird verwendet, um den zitierten Code in der relevanten Snippet-Datei zu begrenzen, wie im folgenden Beispiel gezeigt, das dem obigen \ snippet-Befehl entspricht:
%Vor%Beachten Sie, dass die Zeilen, die die Blockmarkierungen enthalten, nicht enthalten sind, daher lautet die Ausgabe:
Beachten Sie auch, dass die
[block_id]
-Marker in der Quelldatei genau zweimal vorkommen sollten.
Hier ist 0
die Block-ID .