ようこそ ゲスト さん、新規登録（無料）して気になる疑問を解決しませんか？
はじめての方へ｜ヘルプ｜FAQ
スポンサーサイト（詳細）

質問
質問者：noname#69958 関数ヘッダ？
困り度：
  • 困っています
 ｛コメントで関数の働きや、引数や戻り値（＝関数の返す値）これらの関数を説明するコメント文を関数ヘッダと読んだりもします。｝
とネットでは書いてあったのですが実際にはどんな感じで書くのかよくわかりません。そしてこれをどこに書けばいのでしょうか？

例としてはこんな感じですか？（多分というか絶対間違ってると思いますが）　関数ヘッダの記述は自由でいいと聞きました。
：関数ヘッダ
関数名　:　main
　　型　　：型の動きを書く　　　
　　引数　　:　引数の動きを書く
　　戻り値　:　0
　　履歴　：名前　　修正内容　日付
質問投稿日時：08/04/17 01:55
質問番号：3953849
この質問に対する回答は締め切られました。
最新から表示｜回答順に表示｜良回答のみ表示

回答

良回答20pt
回答者：asuncion > そしてこれをどこに書けばいのでしょうか？

よくあるのは、当該関数定義の直前でありましょう。

// 関数名　:　hoge
// 　　型　　：型の動きを書く　　　
// 　　引数　　:　引数の動きを書く
// 　　戻り値　:　0
// 　　履歴　：名前　　修正内容　日付
int hoge(int n, char *c)
{
// ここにhoge関数の実体を書く
}
種類：アドバイス
どんな人：一般人
自信：参考意見
回答日時：08/04/17 09:32
回答番号：No.2
この回答へのお礼参考になりました　ありがとうございます。

回答

良回答10pt
回答者：MrBan プロジェクト毎のルールなどがなければ、
自由なフォーマットでかまわないと思いますが、
たとえば

/// @brief メイン関数
/// メイン関数についての説明
/// @param[in] argc 引数の説明
/// @arg 1 引数がない
/// @param[in] argv 引数の説明
/// @retval 0 処理が成功した
/// @retval !0 処理が失敗した

等の形式にしておくと、"Doxygen"というツールで、
後から自動的に関数仕様などのドキュメントが生成できて
便利かと思います。
"Doxygen"や"JavaDoc"について調べてみてください。
種類：アドバイス
どんな人：専門家
自信：参考意見
回答日時：08/04/17 08:27
回答番号：No.1
この回答へのお礼そんなのもあるんですね　知りませんでした
さっそく調べてみます。
 
最新から表示｜回答順に表示｜良回答のみ表示
スポンサーサイト（詳細）
このページのトップへ