問題タブ [sal]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票する
1 に答える
201 参照

c++ - MSVC SAL 対 C++2a コントラクト

MSVC にはSAL 機能があり、パラメーター、結果などを記述するために使用できます。これはうまく機能し、移植性も優れています。C++2a のコントラクト機能は同じことを行うようです。誰か教えてください。それらの間の違いは?

0 投票する
1 に答える
777 参照

c++ - Doxygen で Microsoft のソース コード注釈言語 (SAL) を使用していますか?

Doxygenを使用して、Microsoft のSource-Code Annotation Language (SAL)を使用する C++ コードを文書化しようとしています。_Success_ただし、Doxygen は などの特定の注釈マクロを正しく解析しません。関数アノテーションの例の場合_Success_、Doxygen はこのマクロを関数ヘッダー/プロトタイプとして誤って解釈します。

関数注釈マーカーを含む次の例を見てください。

上記の例では、Doxygen は_Success_()関数のヘッダー/プロトタイプとして解釈するため、完全に間違ったドキュメントを作成します。関数アノテーションを付けた場合と付けない場合の HTML Doxygen 出力は次のようなります。

関数アノテーションの有無の比較

関数注釈を使用して、Doxygeniは、引数のリストの一部ではないパラメーター変数を文書化したとも言っています。

C:/.../Source.cpp:9: 警告: コマンド @param の引数 'i' が、Success (リターン)の引数リストに見つかりません

メインのDoxygen 構成ファイルに構成設定がありませんか?
それともSALDoxygenは単に互換性がないのでしょうか?