`

コメントについて

 
阅读更多

コメントを書くことはプログラミングの非常に重要な要素です.

コメントはソースコード内に記述してある注釈のようなものです。コメントはソースコードを読む人に「ここはこんな事していますよ」ということを知らせてくれます。コメントはプログラムの実行には全く関係ありません。「じゃあ何で書く必要があるのか?」と思うかも知れません。

コメントは他人のために書くものというイメージがあるかもしれませんが、まずC言語を入門される方は他人にソースコードを読ませるという事は少ないと思います。では、誰のために書くかというと明後日の自分のためです。コードを書いてからある程度時間が経つとコードを書いていたときの記憶が薄れてきます。結果として数ヶ月前の自分が書いたコードは、読み返すときには他人が書いたものとあまり違わなくなってしまっているぐらい記憶がなくなっているときがあります。要所要所にコメントを書く癖をつけておくと過去の自分をほめてあげたくなることがあるでしょう。

他人にソースコードを読んでもらう可能性がある場合にはコメントをふんだんに入れるようにしましょう。その方が親切ですし、仕事ではコメントを書かない人は嫌われてしまうかもしれません。

分享到:
评论

相关推荐

    git-study

    git commitドでンドで,リポジトリのインデックスに追加された変更情报にコメントをつけてコミットできる git pushコマンドで,ローカルのコミットをリモートのリポジトリに反映させることができる

    gacha-ja:ガチャをつくろう

    READMEを読んだら,ソースコードを开きTODOコメントが书かれている箇所をコメントに従って修正して行きますTODOコメントをすべて修正し终わったら, READMEに书かれた実行例に従ってプログラムをコンムをコイルして...

    ddntjv2:在线TRPG平台

    样本推荐环境谷歌浏览器构建和设置要求Node.js(作者环境は12.6.2) CouchDB(初期データは胜手につくられます) BCDice(どこかにあればいい)设置server/constants.js及びserver/dicebot.jsのコメントがついている...

    covid19:兵库県新型コロナウイルスまとめサイト兵库COVID-19概要网站

    兵库県新型コロナウイルスまとめサイト 贡献の仕方 ...追加をご希望の场合はPull Requestを送っていただくか,このにコメントをお愿いします。 ライセンス 本ソフトウェアは, の元提供されています。

    ec-cube:EC-CUBE是日本最受欢迎的电子商务解决方案

    EC-CUBE 3系の保守については, にて开発を行っております。 EC-CUBE 2系の保守については, にて开発を行っております。 インストール EC-CUBE 4.0のインストール方法 开発ドキュメントのの手顺に従ってインスト...

    凸面管理

    クラバトのルール说明(クランメンバー向け)クラバトのルールについての说明です。クランメンバーの方はご确认お愿いします。クラバト进行の说明(より详细な说明)クラバト进行についての详细な说明です。クラバト...

    CastCraft Extension-crx插件

    ライブ配信をするときに、久々にコメントをくれた人と初見の人の判別がつかなくて困ったことはないでしょうか。 CastCraftの『視聴者を覚える』機能を起動しておけば、たとえ自分で記憶していなくても、一度コメント...

    tweetMapping:东日本大震灾発生から24时间以内につぶやかれたジオタグ付きツイートのデジタルアーカイブです

    东日本大震灾ツイートマッピング 东日本大震灾発生から24时间以内につぶやかれたジオタグ付きツイ...にースコードはコメントを参考に改修の上,自由にお使いください。 wt问い合わせはhwtnv(at)iii.u-tokyo.ac.jpまで

    Windows 7 Ultimate DIY 予約限定プレミアムセット特典

    オリジナル Windows 7 テーマ収録 CD について ■本 CD の内容 [ MadobeNanami ] ファイル Windows 7 専用のオリジナルテーマファイルです。使い方は「■オリジナル Windows 7 テーマ のセットアップ方法」をご覧く...

    DF132差分软件

    ) ・アンインストールは実行ファイル並びにアーカイブファイルなどを削除して いただくだけで結構だと思いますが、レジストリにも登録しているので、 レジストリも削除したい方は各自の責任において ...

    sevendayshpc:一周间でなれる!スパコンプログラマ

    标准出力について GDBによるMPIプログラムのムッグ 第二天: スパコンを使うときに知っておきたいこと。ジョブの投げ方など。 はじめに スパコンとは 余谈:BlueGene / Lのメモリエラー スパコンのアカウントの取得...

    azure-dev-docs.ja-jp:azure-dev-docs本地化内容

    ms.openlocfilehash ms.sourcegitcommit ms.translationtype ms.contentlocale ms.lasthandoff ms.locfileid 4...详细についてはをご覧ください。また,追加の收藏询问やコメントがある场合はにお问い合わせください。

    TheSkyBlock:TheSkyBlockのDatapackリポジトリ

    ライセンスについて 0のリポジトリでは,以下のディレクトリを除いてが适用されます。 CC0-1.0许可が适用されないディレクトリ ディレクトリ( ) ディレクトリ( /赤石爱的版权) ディレクトリ( /赤石爱的版权...

    RNHBFav:HBFavのReactNative版本

    ブックマークコメントにフォロワーのコメントまとめが无い クリップBOードのURLからブックマークする机能が无い 公开情报のみ扱う オリジナルの机能は下记です。 URLを入力してブックマークする机能 表记や色味や...

    sample-boot-micro:Spring Cloud + Gradle Multi Project + Java8

    UI侧面の実装サンプルについては / などを利用してください。 ※JavaDocに记をしていますが现状のものは参考実装レベルです。制品水准のコードが含まれているわけではありません。 レイヤリングの考え方 ですがー...

    原始应用日志

    また,文章和同时して,それに关连した絵や写真も投稿することができる,ログインしているユーザーは,其他が投稿した内容についてコメントするまた,ログイしていないユーユーに关しては,投稿,コメント,投稿内容...

    brscan-skey-docker:兄弟MFPのスキャンBOタンをポチっとな

    brscan-skey-docker スキャンした画像をクラウドにアップロードしたい要件でFAX机能...动作について brscan-skeyの动作概要です。 コンテナ起动时の动作(entrypoint.sh) dbusデーモンとavahiデーモンを起动する Zero

    minutes-app-33991

    登录してある会议议事录についしログインすれば谁でもコメントもすることができます。 网址 デプロイ次第记述 テスト用アカウント デプロイ次第记述 利用方法 利用したいユーザーはーはーザーをしてくださー登录をし...

    ZinkeN:TeXを舍てて人権を得たい

    ZinkeN v0.1.5 TeXを舍てて人権を得たいこれはなにTeXの引进に苦しむ人に人権を得て欲しいと思って作った,フロントエンエの技术(主にHTML CSS JS)だけでレポートやドキュメントを书くためのテンプレ。つかいかた...

Global site tag (gtag.js) - Google Analytics