Murga

個人的に言いたいコト・主張・気持ち。

コード

単一行コメント記号の直後にスペースを付けないのは「コメントアウトされたコード」を示す

プログラミングにおいて、単一行コメントを書く時は、言語に応じて記号文字は違えど、 # コメントです (Python など) // コメントです (Java など) こんな風に、# や // の記号の直後にスペースを置いて書くことがほとんどだろう。汚いコードを書く人達は、…

自分がコードを書く時に気を付けていること

ふと思い立って、自分がコードを書く時に気を付けていること・心がけていることを振り返ってみた。 大きなくくりでいうと、こんなところ。 読みやすいこと (インデントや名前など、表面的なところ) 改修しやすいこと (ある意味での「読みやすい」こと) 冪等…

文字列リテラルを表すのにシングルクォートとダブルクォートどっちを使うか問題、私見

プログラミングにおいて、文字列リテラルを表すときにシングルクォートを使ったり、ダブルクォートを使ったりするが、両者をどう使い分けるかについての私見をまとめる。 シングル・ダブルで機能が異なる場合 (Bash・Perl・PHP など) Bash をはじめとするい…

省略時に適用されるデフォルト値を明示的にコーディングすべきか

記述を省略した時に、何らかのデフォルト値が適用されるプログラムに対して、 「デフォルト値が自動設定されるなら、いちいち分かりきったことは書かなくていいべ」 と考えるか、 「自動設定されるデフォルト値でろうと、その値が設定されて欲しいのであれば…

1文字間違えることの重さ

正確に伝わる! わかりやすい文書の書き方作者: 石黒圭出版社/メーカー: 日本経済新聞出版社発売日: 2012/12/13メディア: 単行本(ソフトカバー)この商品を含むブログを見る 設計書を書いているのに、項目名の表記を勝手に省略したり、コロンやカンマなどの…

ソースコードの汚さは「諦めた回数」に比例する

プログラマーのためのソースコードを読む技術作者: 高木信尚出版社/メーカー: 技術評論社発売日: 2010/06/11メディア: 単行本(ソフトカバー)購入: 2人 クリック: 151回この商品を含むブログ (14件) を見る 良いコード・悪いコードに対する知見がない初心者…

ソロエルノスキーとか1行 if 文でもカッコは付けるとか

コーディングを支える技術 ~成り立ちから学ぶプログラミング作法 (WEB+DB PRESS plus)作者: 西尾泰和出版社/メーカー: 技術評論社発売日: 2013/04/24メディア: 単行本(ソフトカバー)この商品を含むブログ (36件) を見る プロジェクトで JSBeautify を導入…

if else 構文のインデントとコメントの書き方

プログラミング言語にほとんど必ず登場する「if・else 構文」のコーディングスタイルに関して話してみる。自分が想定する言語は Java メインな感じ。 1行 if の時にブレースを省略するか カッコをつけたコードはカッコわるいのか論争:プログラマで、生きて…

コードとコメントを横に並べて表示させたい

コードの中にコメントを書くと、その性質上どうしても縦に長くなる。簡潔にコメントを書けていればコードの文脈の中でコメントがスラスラ入ってきて分かりやすいのだが、コメント (日本語) の質は人によりけり。 IDE によっては、コメントブロックを折りたた…

「綺麗なコード」にはそれほど価値がない

認めたくなかったが、どうやらそうみたいだ。 結局のところ、客は「綺麗なコード」ではなく、「要望どおりに動いているシステム」が欲しいのであって、それがコピペ駆動開発だろうがインデントがなかろうが、クラス名にキャメルケースとスネークケースが混じ…