nDiki : コーディング規約

コーディング規約 - coding standards

プログラムを書く際の約束を定めたもの。

コーディング規約作成時のチェックリスト

  • □ ソースプログラムファイルの charset は定められているか?
  • □ ソースプログラムファイルの改行コードは定められているか?
  • □ ソースプログラムファイル名命名規則は定められているか?
  • インデント幅は定められているか?
  • □ 整形につかう文字は定められているか? (スペース推奨)

スポンサード リンク

2005年7月12日 (火)

ソースコードの整形はスペースで

向かいの2人がプログラムを共同開発している。 一人はインデントに「タブ文字を使用するのが好み」で、もう一人はインデントに「空白文字を使用するのが好み」。 ちょっと合戦してた。

ちなみに自分は空白文字派。

タブストップは空白文字8個毎であれ

ソースコードを閲覧するのに使うのは、メモ帳や more や cat かもしれない。 タブストップは空白文字8個毎を想定しておくべき。

タブストップを変更すると整形が崩れる

タブ文字派より「エディタの設定を変更することで、好みのインデント幅で閲覧・編集できる」と言う意見を聞くことがある。 しかし

  • 字下げにタブ文字と空白文字を併用してあると、タブストップの変更により整形が崩れる(場合がある)。複数行にわたる式などで、タブストップ以外の位置に字下げしたいことはよくある。
  • (自分はほとんど書かないけど)コードの後ろに1行コメントをつける時にタブ文字で位置揃えしておくと、タブストップの変更によりずれる。

インデント幅は大抵 8 じゃない

好みの2で書く。またはコーディング規約にあわせて書く。大概 2 か 4。

最近 8 で書いたことない。

ということで

タブ文字の方がいいというケースがほとんどない。

最近タブ文字を使っているのは Makefile のコマンド行の時ぐらい(って、これはタブ文字じゃないと駄目だからだけれど)。

スポンサード リンク
[ 7月12日全て ]

2011年1月5日 (水)

今日のさえずり: Evernote も Disney フォントの認識は無理

2011年01月05日

  • 09:31 通勤中に My Tracks 動かしてみてる。どれぐらいバッテリ消費するかな。 #Android
  • 09:53 30分強で20%ほど消費してる。 #Xperia
  • 11:34 C++ で自身のメンバ変数/メンバ関数を使う時は明示的に this-> するよね、普通。
  • 11:47 @Naney そういうコーディング規約があるんですね。ちょっとイメージがつかないですが具体的にどんな感じなんでしょうか。
  • 12:31 Xperia だと Google Latitude での位置ずいぶんずれる。履歴見ると GPS の測位精度が上がる前に位置取っちゃうような感じ。 #Android #Xperia
  • 12:36 @random_oracle そういうコーディング規約があるんですね。ちょっとイメージがつかないですが具体的にどんな感じなんでしょうか。
  • 12:38 間違えて自分に @ してた。
  • 12:53 @random_oracle private なメンバ変数/メンバ関数については私も最後に _ をつける派です。でもそれとは別に this->private_func_(); ってしてます。
  • 12:57 自分が C++ で自身のメンバへのアクセスに this-> をつけるのはアクセス対象がメンバであることを明確にするためと、self へメッセージを送っていることを明確にするため。
  • 12:59 Google Latitude も My Tracks みたいに最低精度を設定できるようになると嬉しい。 #Android
  • 13:03 Evernote も Disney フォントの認識は無理。
  • 15:53 ちぎりパンと紅茶花伝 205円。 (@ セブン-イレブン 神田佐久間町店) http://4sq.com/gTP1yO
  • 18:44 あ、また Git にコミットする際に Redmine 用に refs 付けるの忘れてた。
  • 19:16 ミシン見る。 (@ ヨドバシカメラ マルチメディアAkiba (Yodobashi Camera Multimedia Akiba) w/ 9 others) http://4sq.com/h6BDDu
  • 19:32 勘違いでなければヨドバシカメラよりジャスコの方がミシン安かった。
  • 24:46 ScanSnap S1100 注文しちゃった。 http://amzn.to/fpUVLn

image:ASIN:B004COKSSE

[ 1月5日全て ]

2011年2月1日 (火)

今日のさえずり: 昔は例外処理を好んで使っていたが、最近はできるだけ使いたくない派

2011年02月01日

  • 08:05 明日 9:15 で病院予約した。花粉症もらいにいく。
  • 09:31 Wi-Fi に対応したspモードメールアップデート中。 #Xperia
  • 09:37 完了。Wi-Fi 設定はあ・と・で。 #Xperia
  • 09:59 GPS での測位、今日は東にだいぶずれてるな。端末の問題? #Xperia
  • 10:05 あ、良くなってきた。
  • 10:45 プリンタ保守のエンジニアから電話修理難航中でまだしばらくかかりそうとのこと。いったいどんな不具合だったんだろう。
  • 11:59 Google アカウント1つ潰した。
  • 12:07 弁当 350円。 (@ 向日葵 和泉町店・カレー食堂) http://4sq.com/eLgExR
  • 12:18 「40前後で『ガールズトーク』と言うのはいかがなものか」ってにいったら、いいんだって言われた。「セックス・アンド・ザ・シティ」が何たらとか説明された。ということでアリらしいです。
  • 13:32 REGZA Phone T-01C 買った同僚に K-9 Mail 薦めた。 #Android
  • 13:33 Google アカウントもう1つ潰した。
  • 17:07 spモードメール、バックグラウンドで送信できるようになったんだ。これは大きな進歩。 #Android
  • 18:52 コーディング規約内の心得に「サンプルを鵜呑みにしない」と書いてあるのだが、その後コーディング規約内にサンプルが出てくるので心がザワザワする。
  • 19:01 昔は例外処理を好んで使っていたが、最近はできるだけ使いたくない派。
  • 19:09 @wtnabe 開発が進むにつれて、どんな例外が throw されてくるかが次第に自明で無くなってくるから。
  • 19:16 @gnue 開発が進むにつれて、どんな例外が throw されてくるかが次第に自明で無くなってくるから。
  • 19:21 Joel Spolsky の「間違ったコードは間違って見えるようにする」に例外処理について書かれているけど、だいたいその主張に近い。
  • 19:24 Google C++スタイルガイドも C++ の例外を使わない派。
  • 19:27 More Joel on Software に収録されてる。 http://amzn.to/eARt3t RT @Naney: Joel Spolsky の「間違ったコードは間違って見えるようにする」に例外処理について書かれているけど、だいたいその主張に近い。More Joel on Software
  • 19:36 呼び出し先を全部辿らないとどんな時に何が throw されてくるかわからないし、ここで throw するようにすると全ての呼び出し元できちんと catch されるのかも全部辿らないといけない。
  • 19:42 ドキュメンテーションコメントにおいてメソッドが何を throw するかってのも最初は書いてみるけど破綻するよね。
  • 20:18 K-9 MailGmail からプッシュするフォルダを INBOX フォルダから重要フォルダに変えてみた。優先トレイがきちんと学習してくれれば、ちょっとしたニュースレターとかでの通知が減るはず。 #Android
  • 20:20 INBOX の同期間隔は長めに変更。 #Android
  • 21:52 spモードパスワードって何だ。
  • 21:53 わかった。あれだ。
  • 22:03 Wi-Fi 接続でのspモードメールの送受信を確認。 #Xperia
  • 22:24 先週の水曜日に爪が折れていて皆が困っていた(と思われる) LAN コネクタを直したんだけれども、誰も「いいね!」って言ってきません。計算機管理チームとはそういうものです。
  • 24:25 X-Face 懐かしい。Sylpheed だと今でもちゃんと表示されるんだ。
[ 2月1日全て ]

2013年3月29日 (金)

今日のさえずり: トンファーだったら持ってた

2013年03月29日

  • 09:25 ThinkPad バッグに入らなかったので、風呂敷通勤。
  • 09:44 @sseze 無理に入れようとしたけど入らなかったし、バッグにカッターで穴を開ける勇気が無かった。
  • 10:27 バッグの買い替えサイクル10年なので次にバッグ買うの9年後だしノート PC の方が寿命が短いので、ノート PC に合わせてバッグ買うよりもバッグに合わせてノート PC 買う。
  • 13:36 なんか新しい ThinkPad 欲しいなと思ったけど、そうするとやっぱり X だし、そうするとやっぱり15万円ぐらいになっちゃうのだなあ。
  • 13:38 ThinkPad 以外のノート PC、選択肢ないものか。
  • 13:57 処理系別課題がまとまってる。 / “Twitter時代の文字の数え方 | inquisitor” http://t.co/oIuXcNUJMM
  • 15:08 Xperia GX SO-05D ビルド番号 7.0.D.1.137 へアップデート中。今は非 root なのでサクッと。
  • 16:35 git merge --strategy ours の説明を読んだけれど、こんなの一生使いたくない。
  • 18:03 「今週の進み具合はどう?」のやつ最近とどこおっててゴメンナサイ。
  • 18:46 会社出て向かう。 #perlcasual
  • 18:56 到着! #perlcasual (@ NHN Japan 株式会社 渋谷オフィス) http://t.co/3Ky36YBQcW
  • 19:12 うちのチームも20%ルールやりたい(というと月曜日にきっとメンバから何か言われる)。 #perlcasual
  • 19:24 自社のサーバとか使わないで普通にさくらとか使ったりしてるんだ。 #perlcasual
  • 19:28 やっぱり他社サーバ使ってるの気になりますよね。 #perlcasual
  • 19:38 業務でも裏側のツール類はモチベーション意識して開発できるようにした方が良いね。 #perlcasual
  • 19:54 ainame 氏見当らない。 #perlcasual
  • 19:55 AC 欲しい……。 #perlcasual
  • 20:00 Emacs の画面見るだけでなごむ。 #perlcasual
  • 20:04 sl #perlcasual
  • 21:26 Perl の会なのに Perl の話が多くてびっくりした!!! #perlcasual
  • 23:21 「飼育係からの挑戦状~春編~」って。
  • 23:52 トンファーだったら持ってた。晩年バッグ掛けか何かになってた気がする。
  • 23:57Perl における一般的なコーディング規約について - tokuhirom's blog.” http://t.co/1GEXau9eem
[ 3月29日全て ]

About Me

Naney Naney (なにい)です。株式会社ミクシィでマネージャー・PO をしています。

nDiki1999年1月に始めたコンピュータ日誌を前身とする NaneyWeb 日記(兼パーソナルナレッジベース)です。ちょっとしたノートは nNote にあります。

※内容は個人的見解であり所属組織とは関係ありません。

月別インデックス
Process Time: 0.068609s / load averages: 0.38, 0.39, 0.35
nDiki by WATANABE Yoshimasa (Naney, Google profile)
Powered by DiKicker