1

私はソース コードのコメントの大ファンですが、Ada 標準ライブラリのコメントはせいぜい質素です。ライブラリのインターフェースは言語定義で定義されていると理解していますが、実装はコンパイラの製造元に任されています。マニュアルで見た純粋な関数名、パラメーター、およびその他の定義は、それぞれのサブプログラムが何をするかを正確に説明しておらず、解釈に多くを残しているため、よく疑問に思いました。QT ライブラリのラインに沿ったドキュメントが期待されます。

すべての関数に対して広範なコメントを含むライブラリの定義がないのはなぜですか?

4

2 に答える 2

3

たとえば、ARM セクションA.18.5のAda.Containers.Hashed_Mapsパラグラフ 1 は、通常は「A.18.5 (1)」と呼ばれます。

汎用ライブラリ パッケージ Containers.Hashed_Maps には、次の宣言があります。

したがって、実装者はこれを指示として読んだと思います。

Hashed_Maps の場合、A.18.5 (46)に A.18.4 へのリンクが表示されます。これは、マップの一般的なセマンティクスを説明しています。そしてLength、例えば、（25）にあります。

AdaCoreヘルプの GPS GPL > GNATには、ARM のローカル コピーへのリンクがあります (GPS GPL 2014 は ARM2005 までしかありません)。Debian 版が何をするのかわかりません。

（これがその方法です。それは、それがどのように改善されるかについてあなたの主張を否定するものではありません！）

于 2014-05-29T08:49:52.813 に答える
3

間違った場所でドキュメントを探しているようです。

Ada 標準ライブラリは、標準 ( Ada リファレンス マニュアル) で詳細に説明されており、注釈付き Ada リファレンス マニュアルではさらに詳細に説明されています。

Ada 標準ライブラリの個々の実装のソース ファイルは、標準ライブラリがどのように機能するかを説明するドキュメントではありません。

于 2014-05-30T07:40:24.090 に答える