1

100% よく知らない API を使用するコードを作成または管理しているとします。

特定の呼び出しターゲットのドキュメントを読むかどうか、また読むのにどれくらいの時間を費やすかをどのように決定しますか? 読まないってどうやって決めるの?

(HTML ドキュメントを開くか、ソース コードを調べるか、IDE のホバー メカニズムを使用して、それを読むことができると仮定しましょう)。

4

1 に答える 1

2

理想的には、すべてを読む必要がありますが、それが苦痛であることはわかっています. これらのケースで私が通常行うことは(フリーランサーとして働いていたときに多くのことを行いました)、いくつかの要因の重み付けであり、結果に応じてドキュメントを読みます.

ドキュメントを読むべきではないことを教えてくれる要因:

  • 関数が何をするかは、名前から簡単に推測できます。
  • 私が管理しているコードとは関係ありません。たとえば、一部のコードがファイルを削除する方法をチェックしており、明らかに UI の更新を行う関数があります。あなたは今のところそれを気にしません。
  • デバッグの場合: 関数は、目前のタスクにとって意味のある方法でプログラムの状態を変更しませんでした。以前と同様に、ファイル システム エラーで停止しているために削除コードをデバッグしている場合は、SetOverlayIcon が何をするかを知りたくありません。
  • API は、既に知っている API の単なる特殊なケースであり、特殊なケースとは何か、および特殊な引数 (存在する場合) が何をするかを推測できます。たとえば、WriteToFile(string filename) と WriteToFile(string filename, boolean overwrite) があるとします。

もちろん、すべてはコンテキストに依存するため、それらのルールにも例外があります。

于 2008-10-02T00:21:14.793 に答える