c++ - //! [0] C++ - それは何ですか?

Question

C++ で何//! [0]をしますか? 遅延評価をオフにするなど、言語のデフォルトを変更するものだと思いますが、正確にはわかりません。配列で何か？

Answer 1

もちろんコメントです。それでも、 doxygenにとって特別な意味があります:

\snippet ( block_id )

\includeこのコマンドを使用して完全なファイルをソース コードとして含めることができる場合、このコマンドを使用してソース ファイルの一部のみを引用することができます。

たとえば、ドキュメントに次のコマンドを配置するexample.cppと、 が指すサブディレクトリにあるファイルのスニペットが参照されEXAMPLE_PATHます。

\snippet snippets/example.cpp Adding a resource

ファイル名に続くテキストは、スニペットの一意の識別子です。これは、上記の \snippet コマンドに対応する次の例に示すように、関連するスニペット ファイルで引用符で囲まれたコードを区切るために使用されます。

QImage image(64, 64, QImage::Format_RGB32);
image.fill(qRgb(255, 160, 128));
//! [Adding a resource]
document->addResource(QTextDocument::ImageResource,
    QUrl("mydata://image.png"), QVariant(image));
//! [Adding a resource]
...

ブロック マーカーを含む行は含まれないため、出力は次のようになります。

document->addResource(QTextDocument::ImageResource,
QUrl("mydata://image.png"), QVariant(image));

[block_id]また、マーカーはソース ファイルに正確に 2 回出現する必要があることにも注意してください。

これ0がブロックIDです。

Answer 2

一行コメントです…