含む・含まないの情報を持つパラメータ名

関数のパラメータがfirst/last、min/maxとかいう名前だった場合、それらの名前にはmaxを含むのか含まないのか、という情報がないので、自然言語で書かれた仕様の説明をきっちり確認する必要があります。
しかし、そういうものはできるだけ、関数のシグニチャを見ただけで、ひと目で動作がわかるようにしたいですね。たとえば、特定範囲の乱数を生成する関数だと、こうなってるといいんじゃないでしょうか。

int randint(int min_inclusive, int max_exclusive);

inclusiveは「含む」、exclusiveは「含まない」という意味です。
パラメータ名が多少長くなってしまいますが、わかりやすくなったと思います。



宣伝: 『プログラミングの魔導書 Vol.3』 予約受付中です。
http://longgate.co.jp/books/grimoire-vol3.html