トップページ

本棚


両手で1000まで数えられますか?:2進法の話
数値 - 危険物取り扱い注意
100 × 200 =32?:変数のオーバーフローの話
パリティビット
小数の扱いについて
ぽいんた
ぽいんた2
ぽいんた3
ジ・オリジン
ジ・オリジン:補足
かっこつける話
かっこつける話2
文字列のこと
タイミングの話
拡張性の話
取り込む話
staticな話

コンパイルの話1
コンパイルの話2:止まらぬビルド
コンパイルの話3:マシン語に落ちるということ1:メモリの話
コンパイルの話4:マシン語に落ちるということ2:最適化
コンパイルの話5:マシン語に落ちるということ3:変数とスタック
コンパイルの話6:コンパイラはそもそも何をやってくれるのか??
リンクの話
プリプロセッサの話

OS、というもの

オブジェクト指向1
オブジェクト指向:2
オブジェクト指向:3

オブジェクト指向:番外 C言語のソースファイルの話
オブジェクト指向:番外 C言語での「再利用性」と「カプセル化」データ構造とアルゴリズム


抽象的な話

寝込んで布団の中で考えたこと
こんなの、常識??
お仕事プログラミング
ソフトでハードなプログラム
プログラムするということ
お勉強
プログラムを学ぶということの補足
C言語:「学問」と「実務」
統合開発環境
C言語ってポータブルですか?
C言語ってポータブルですか?:2
あなたは、どう読みますか?
ああ勘違い
試してガッテン
低級品
質問をするということ
ポカ
「何もしない」 != 「無駄」
エディタの話
もっと手を抜こう

いまどきの、アセンブラ

VisualStudio2005
VisualStudio2005:2

戦争の防ぎ方、に対する私の考え
身近な差別
改革
地球に優しいなんて大嘘
統計で嘘をつく方法

言葉について
言葉について:2

神が死んだということ
善悪の彼岸から、力への意思を目覚めさせるということ

本を読むということ
本を読むということ:2

絵を描く話
地図
地球儀

オカルトのお話
がんだむさん
RPGソフトウェア
記紀神話の不思議



メニュー

※上記の広告は60日以上更新のないWIKIに表示されています。更新することで広告が下部へ移動します。

趣味でやるプログラミングと違って、お仕事にしてしまうといろいろと制限も出てくる。

そのなかで、割と軽視されている(少なくとも今の職場では)のが設計書とコーディング規約。これはホントに環境によると思うんだけど。

というわけで今日はコーディング規約のお話。

お仕事のプログラムに求められるのは、まず第一に仕様書どおりに動くこと。趣味の範囲ならそこまででもかまわないんだろうけど、その次にそのソフトウェア資産を次回新機種に使ったり、機能拡張をしたりとメンテナンスする必要がある。

しかも、最初にコーディングした人がメンテするとは限らない(むしろまれ)。頼りは、設計書とソースコード、およびソース内のコメントだけ。

そのため、設計書の精度とソースコードの可読性というものが非常に重要となる。前に言ったコーディングスタイルの統一も個人レベルだと有効だけれどそれが人によって異なるのではやっぱり読解に時間がかかってしまう。

だから、例えば変数や関数の命名規則を統一したりといった一定のルールを決める。それがコーディング規約。これによって「この変数は何に使ってるの?」っていうのをまあ名前からある程度予測できるようになったり、変数のサイズ(型)によるミスを減らしたり。。あるいはswitch caseには必ずdefaultを入れて、イリーガルなスイッチによるエラーに強くしたり。。


・・・できるはずなんですよ。みんなが守ってくれたら!


グローバル変数に誰でも使いそうな名前付けるのやめてくれよぅ。せめてstaticつけてファイルスコープ内とかならまだしも。。。よそで同じ名前定義されちゃうと、変数の値を保障できないんだけど。こういう不具合って見つけるの大変なんだよぅ。
・・・とか、ね。

得てして、ある程度年季のある(年季しかない)人に限って独自のコーディングスタイルを優先させようとする傾向にあるみたい。あと古い人ほど識別子の名前が長くなるのが嫌みたいでわけわからないくらい短い名前にしたりする。

いや、いいですよ別に。100%不具合でないんならね。ええ。
いいんですよ。これからも永久にあなたがそのソースのメンテしてくれるならね。ええ、ええ。

  -------------------------------------------

ここからは、愚痴。

そういう人に限って、
なんで私よりも10年以上もキャリアあって、そんな詰まらん不具合だすかなあ?領域破壊してこっちのデータ壊すのやめてくださいよぅ(別々の場所で過去3回ほどあった。最初私の部分でお亡くなりになるので疑われたりしたし)。unssignedの変数にマイナスの値とか入れないで。。wtc.

全部、ちゃんと変数に規約どおりに名前つけときゃ用途もサイズもはっきりするわけで。ほんのちょっと、注意してくれたらいいでしょう、と思うんですけどね。

しかも、途中でチームから抜けちゃうし。んで、すでにその人のやった名残はほとんどありません。いろんなところにあるコピペしたと思しき処理をサブ関数にしたり、処理自信が非常に臭かったのをロジック自体変えて修正したり、変数や定数もあらたに切りなおし。。
おいおい、ほとんで新しく作り直してるじゃないか。みたいな。

結局半年以上もいて実績ないじゃんかぁ。。

愚痴終わり。

  -------------------------------------------

おんなじ様な理由で、設計書についてもあるんですけど。。
またまた今日も長くなったのでそれはまたの機会に。




| 新しいページ | 編集 | 差分 | 編集履歴 | ページ名変更 | アップロード | 検索 | ページ一覧 | タグ | RSS | ご利用ガイド | 管理者に問合せ |
@wiki - 無料レンタルウィキサービス | プライバシーポリシー