諏訪通信ネットワーク　- Ｃ言語の常識ルール

スポンサードリンク

for Windows Xp Vista 7 10 Keyboard IE カーナビを... ダイアグスキャナー徒歩メーター燃費ティーチャーサンプリングメーターみるＣＡＮＣＡＮメッセンジャーＣＡＮレコーダーＣＡＮレーベル VB6の長所と短所なぜVB6を使うのか VB6のトラブル集1 VB6のトラブル集2 UWPのトラブル集1 Ｃ言語のコメント作法Ｃ言語の常識ルールクルマ整備技術サイト

		Ｃ言語の常識ルール 2021.7.23 Ｃ言語の入門書等では記載がありませんが、世の中の常識として通用しているルールがいくつかあるので紹介します。もちろん世の中のすべての分野やグループのルールを知った訳ではないので、特定の分野や集団では非常識な部分があるかもしれません。１．{}の使い方　条件式「 {　」は条件式の後ろに書きます。判定後の制御文は、条件式の後ろから有効になるためです。「 }　」は条件式の先頭文字と同じ列に記載します。ネストで再び{}が使われる場合は、インデントで一段下げた同じ列に記載します。「 }　」の最後には、必ず「 ;　」を付けます。駄目な例は、難読化という意味では非常に有効的で、もはや何がしたいのか分かりません。〇良い例 × 駄目な例（良い例と同じ処理内容です。コンパイルは通ります）２．条件式は、必ず比較演算子で判定する条件式は、左辺と右辺を持つ比較演算子で判定しなければいけません。「==」、「<=」、「>=」、「<」、「>」、「!=」のいずれかを使用しなければいけません。条件の組み合わせは、論理演算子の「&&」、「\|\|」を使用します。コードレビュー等での可読性やテストのしやすさの観点で、このような制限があります。〇良い例 × 駄目な例（良い例とほぼ同じ処理結果となります。コンパイルは通ります）３．１行１処理処理は１行つず分けて記述します。コードレビュー等での可読性やデバッグ等のしやすさの観点で、このような制限があります。Excel関数でsumif等を駆使してプログラミングを始めた人だと、駄目な例ように書きたがる人がまれにいるそうです。例外として、条件式で論理演算子の「かつ、&&」や「または、\|\|」等を持つ場合は、１行で収まる範囲であれば１行で書いてもかまいません。〇良い例 × 駄目な例（良い例と同じ処理結果となります。コンパイルは通ります）〇例外で良い例４．条件式内で代入演算子を使用してはいけない。変数への代入は、条件式の前で行わなければいけません。条件式で行うと、それがバグなのかどうか判断が付きにくくなるためです。〇良い例 × 駄目な例（良い例と同じ処理結果となります。コンパイルは通ります）５．GOTO は使用禁止 GOTOを多用されると訳が分からなくなるため、一切禁止です。「Ｃ言語 GOTO」でgoogle検索すると、ダメな理由が色々説明されています。スパゲティコードと呼ばれるものです。他の理由として、古いBASIC言語では IF （条件） GOTO（行）が基本であり、当時に苦労した人たちがBASIC言語の象徴であるGOTOを嫌ったという側面もあります。〇良い例　（GOTO文を使用しない） × 駄目な例（GOTO文を多用、上記と同じ処理内容です）６．return文は、関数の最後に１回だけ return文は、関数の末尾に１回だけ呼び出すようにします。 if文の中などにいくつもreturn文があると、スパゲティコードになってしまうためです。グローバル変数を基本的に使用してはいけない理由と同じです。関数の入口と出口は、１つでなければいけません。入り口は関数の引数、出口はreturn文です。〇良い例　 × 駄目な例（上記と同じ処理内容です）以下の例だと、戻り値とsend_err_msg()関数との関係が不明瞭のため、コードレビュー等における仕様との一致性の判断や問題発見が難しくなります。７．１つの関数につき〇〇行までは、あくまでも目安こんな意味不明のサブ関数がありました。すぐ上の記述の１ヶ所からしか呼び出されません。上司「Ａ君、なぜこの処理をサブ関数で切り離したのかな？」Ａ君「１つの関数につき、１００行までというコーディングルールがあります。」上司「そうだね。」Ａ君「１０１行になってしまったため、３行をサブ関数で切り分けました。」上司「・・・。（絶句）」関数は、機能単位で分けて管理されるべきです。ソフトウェア業務において各関数は、element ID、機能 ID などが通しで振られて、IDで図書館の本のように分類管理されます。機能単位で分ける理由は、業務プロセスにおけるコーディングの元となる仕様書の仕様が、機能単位で書かれるためです。 C言語のstdlib.h、math.h 等の基本的な関数もすべて機能単位で呼び出せるようになっています。サブ関数も、同じように機能として意味を持たせ、小さな機能単位で呼び出せるようにしなければいけません。機能として最大行数に収まらない場合は、行数制限を無視して１つの関数内に記述します。管理上の理由から、機能として関数を分けることの妥当性がない場合は、分けてはいけません。行数制限に厳格に従って強引にサブ関数を作成すると、生産性に反する難読化にもなってしまいます。色んな関数に処理が飛び飛びになってしまうと、コードレビュー等でウォーターホール的な流れとして全体を掴んでレビューしにくくなり、問題抽出率の低下を招きます。

スポンサードリンク

ご利用条件