「分かりそう」で「分からない」でも「分かった」気になれるIT用語辞典

順番に見ていきましょう。
まずは予備知識として「ソースコード」について説明します。
「そんなの説明されなくても知ってるよ！」な人は適当に読み飛ばしてください。

ソースコードは「人間語で書いたプログラムの元ネタ」です。



プログラムを作って動かすまでの一般的な流れは

１．人間語でプログラムの元ネタを書く
２．元ネタを人間語から機械語に翻訳する
３．翻訳された指示に従って、コンピュータさんが お仕事する

です。



コンピュータさんは人間語が分かりません。



人間様はコンピュータさんの言葉が分かりません。



プログラムは人間様が作るものです。
そこで最初は人間様が分かる言葉でプログラムを作ります。
コンピュータさんに対する「あれをやれ」「これをやれ」な命令を人間語で書くのです。



次に人間語で書いたプログラムの元ネタをコンピュータさんが分かる言葉に翻訳します。
実際に お仕事をするのは、コンピュータさんですからね。
コンピュータさんが分かる言葉に変換する必要があるのです。



コンピュータさんが分かる言葉に翻訳したので、コンピュータさんは命令の内容を理解できます。
指示に従って、お仕事をしてくれるでしょう。



かなり簡略化した説明ですけどね。
これがプログラムを作るときの流れです。

この話で登場した

人間語で書いたプログラムの元ネタ

を「ソースコード」と言います。



以上を踏まえて、本題に入ります。

ソースコードの書き方には、特に決まりは ありません。
コンピュータさんが「あぁ、これは命令だな」と正しく認識できる形であれば、どう書いても良いのです。

ただし！

それは趣味でプログラムを作っている人の場合です。
お仕事でプログラムを作るときは、いろいろなことを考慮する必要があります。
例えば

・他の人が見ても分かりやすく
・後から変更するのが楽なように
・できるだけ同じような書き方で

などですね。
どこに どれだけ こだわるかは お仕事現場次第ですが、後のことを考えないで「取りあえず動けば良い」で作ると、へぼプログラマ呼ばわりされることに なりかねません。

その「取りあえず動けば良い」の際たるもので

本来なら別のところに分けて書いておいた方が良いであろう値や処理を、直接ソースコードの中に べた書きする

のが「オンコーディング」です。

例えば、そうですね。
以下のような処理が あったとしましょう。

関数 金額計算（商品単価, 個数）{
　消費税率 = 0.1

　金額 = 商品単価×個数 ＋ 商品単価×個数×消費税率

　return 金額
}

商品単価と個数を渡すと税込の金額が返ってくる処理です。
この処理は以下のように書くこともできます。

関数 金額計算（商品単価, 個数）{

　金額 = 商品単価×個数 ＋ 商品単価×個数×0.1

　return 金額
}

消費税率の「0.1」を直接 処理の中に入れ込んじゃう形式です。

この2つの処理において、後者の「0.1」を直接 処理の中に入れ込んじゃう形式がオンコーディングです。
例えば「消費税率をオンコーディングしてんのかよ！クソなコードだな！」と言ったりしますよ。

何故オンコーディングがクソ扱いされることが多いかですが

・パッと見たときに分かりにくいから
・後から変更するのが大変だから

です。

今回の例は数行でしたけどね。
実際には、もっと たくさんの処理が書いてあるはずです。
そんな中、ひょっこり「0.1」という数字が出てきました。
「何じゃ？こりゃ」と なりませんか？

前後の処理を見れば「消費税率かな？」と予想できるかもしれません。
とはいえ、その数字が何を意味するか探さなくてはいけないのは事実です。
ちょっと面倒くさいです。
これが「パッと見たときに分かりにくいから」の理由です。

次に「後から変更するのが大変だから」の理由です。
消費税率が変わって10％だったのが15％になりました。
オンコーディングされていると、該当する場所を すべて変更しなくては いけません。
今回の例では1回しか使っていませんが、実際には何回も出てくるはずです。
それを一から全部変更しなくては いけません。
見落としがないように気を付ける必要があります。
ちょっと面倒くさいです。
これが「後から変更するのが大変だから」の理由です。

できるだけオンコーディングは避けるようにしてください。
その方が優秀なプログラマっぽい気分になれます。

ちなみに、処理の中に直接 埋め込んだ値は「マジックナンバー」と呼ばれます。
何の意味があるか分からないけど とりあえず動くために必要な値だからでしょうかね。
マジックなナンバーなのです。
余裕があれば、併せて覚えてあげてください。