タグ

命名規則に関するsibusukeのブックマーク (10)

  • boolean 値を返却するメソッド名、変数名の付け方 - KUSAMAKURA

    boolean 値を返却するメソッド名や、変数名の名前のテンプレを作ってみた。名前に気を付けるだけで、意外と綺麗なコードになるので、参考にして欲しいです。 名前の付け方 is + 形容詞 形容詞の状態であるかを尋ねる. ex) isEnabled has + 過去分詞 動詞の状態となったか(完了、経験、継続)を尋ねる. ex) hasSent can + 動詞原型 動詞の挙動が可能かを尋ねる. ex) canGet 三単現動詞 動詞の状態かを尋ねる.後に続く名詞が明確な場合に利用する. ex) exists 三単現動詞 + 名詞 動詞の状態に名詞があるかを尋ねる. ex) existsError, hasError should + 動詞原型 動詞の挙動を行うべきか尋ねる. ex) shouldCollect, shouldRedirect NOTE: ※基的に Yes を動詞, 形容詞

    boolean 値を返却するメソッド名、変数名の付け方 - KUSAMAKURA
  • 関数名によく使われる英単語(動詞)の意味とニュアンス | PHP Archive

    PHP に限らず、プログラミングで使われる多くの関数名は「動詞+目的語」という命名規則になっていることが多く、「insertPost()」であれば投稿を挿入するという意味が名前から読み取れます。 では投稿を削除する場合は delete でしょうか? それとも remove でしょうか? 関数は基的に英語を使うのが鉄則ですが、似たような意味を持つ単語などが多く厳密な意味の違いがわかりにくいことがあります。 そこで、プログラミングで関数名として一般的に使われている頻出語句をピックアップし、主な用途と細かい意味、ニュアンス、使い分けについて調べてみました。 追加・作成 set

  • プログラミングで変数名や関数名のネーミングに迷ったときに便利なカンニングペーパーまとめ

    僕は、プログラムをする上で変数や関数に良い名前を付けるのはとても重要と考えています。 というのも、良い名前を付ければ、それだけでそのコードがしたいことの説明になり、コメントと同等の働きをすることもあるからです。 自分がちゃんとそれをできているのかはさておき、僕は普段から、できれば読みやすくて分かりやすい名前を付けたいと思っています。他の人も読むコードであれば、できればプログラムでよく使われるような単語を利用して書いた方がより分かりやすいです。 ただ、よい名前を考えるのって、ちょっと面倒くさいんですよね。僕はこれまで、英語の辞書を利用して、考えたりしていたのですが、「何か、プログラムでよく使われる単語をまとめたものはないか?」と探したら、ドンピシャのものがいくつかあったので、それらをまとめて以下で紹介します。 photo by Michael Coté codic codic – デベロッパ

    プログラミングで変数名や関数名のネーミングに迷ったときに便利なカンニングペーパーまとめ
  • time: 時間,時刻

  • ブール値を返すメンバー関数の命名規則

    関数の名前の付け方は人それぞれですが、使う単語が同じなら、関数の名前はほぼ同じものになると思います。例えば、サイズをセットする関数の名前を、「set」と「size」という単語を使って考えると、ほぼ全員が「SetSize」と答えるでしょう。「SizeSet」「SizeToSet」「SizeSetted」「SettingSize」といった名前を考える人は、ほとんどいないと思います。 ところが、真か偽かのブール値を返す関数の名前は、混乱することが多いようです。 ここでは、Java言語で採用されている命名規則と、その解釈の仕方を紹介します。 関数名が混乱する例 ブール値を返す関数では、「Is○○」という名前を良く見かけます。例えば、中身が空っぽかどうか、の判定をする関数には、IsEmptyという名前が良く使われます。MFCのCStringクラスや、JavaのListインターフェースなどにも、IsE

  • 良いネーミングをするために覚えておきたい英語のルール5つ - プログラマー幸福論

    Photo by muraterturk こういった記事って、ネーミング規則や慣習の視点から書かれていることが多いんですけど、この記事では、英文法に視点を置いて、参考になりそうなことをいくつかピックアップしてみたいと思います。 「省略形は使わない」などの規約的なものは、各プロジェクトのルールに従えばいいので、ここでは書きません。あくまで英語という視点から書いているということを、ご理解ください。 Rule 1 : “検索”は名詞 一般的な英語辞書のルールでは「検索」は、動詞ではなく「検索する」が動詞になります。「検索」は、検索することの名称 だと考えられるため、動詞ではなく名詞として扱います。 英語辞書には、日語の品詞ごとに表記のルールがあります。これが理解できていると、和英辞書などで品詞を意識して検索できるようになります。以下に、一般的な英語辞書の表記ルールをまとめてみました。 <各品詞

    良いネーミングをするために覚えておきたい英語のルール5つ - プログラマー幸福論
  • 命名規約 【Okapi Project】

    要約 変数やメソッド、クラスの名前に統一された名前をつけることは非常に大事なことです。初めてそのソースを見た人でも何に使われている変数なのか、どのような処理を行っているクラスやメソッドがあるのかがすぐにわかるようになります。 目次 2.命名規約 2.1.パッケージ名 2.2.ファイル名 2.3.クラス名 2.4.テストクラス名 2.5.例外クラス名 2.6.インターフェース名 2.7.抽象クラス名 2.8.定数(static final) 2.9.メソッド名 2.10.変数名全般 2.11.名前の対称性 2.12.ループカウンタ 2.13.スコープが狭い変数 2.14.大文字と小文字 2.命名規約 命名規約の基準として、各環境での OS がファイル名などに認めない文字列などは利用せず、基的にはアルファベットのみで命名することとし、必要に応じて数字を利用することも認めます。命名においてはロ

  • booleanを返すメソッドの命名規約 - shitstormちゃんぺろぺろブログ

    2013-09-03 booleanを返すメソッドの命名規約 プログラミング 百田夏菜子 世間には well-known なメソッド命名規約というものがあって、boolean を返すメソッドはやれ is で始めろだの has パターンもあるんじゃよだのと言うじゃないですか。だけど、英語が苦手な僕たちには、どういうときに is なのか、はたまた has なのか、そんなことわからないんです。 かといっていつまでも匿名メソッドで逃げ続けるわけにもいかないので、英語が苦手なりにまとめてみました。解釈が誤っている可能性大有りなので、鵜呑みにしたらお前はいつかどこかで恥をかいて死ぬ。 以下の資料を参考にしました。 2.9.4.boolean 変数を返すメソッド boolean 変数を返すメソッドについては、「is + 形容詞」「can + 動詞」「has + 過去分詞」「三単現(三人称単数現在)動

  • 関数・変数名で使えそうな英単語

    「total」は「形容詞、名詞、動詞」があり、「sum」は「名詞と動詞」がある。 色々あるけど…「合計する」って使いたいなら「sum」で、「~の合計」って使いたいなら「total」ってのがしっくりくる。

  • 「よりよいコードを求めて命名について頭をひねる会」のログ

    http://www.zusaar.com/event/438105 アプリケーションを作る英語 の著者の西野さんを交えて、クラス名とかメソッド名とか変数名とか命名で困っている課題を1つ以上持ち寄りみんなで一緒に検討する勉強会をしました。 「アプリケーションを作る英語電子書籍 http://tatsu-zine.com/books/english4app 紙 http://www.amazon.co.jp/gp/product/4844332848/ はじめに:西野さんからちょっとお話 The Art of Readable Code から第2章と第3章 第2章:名前に情報を詰め込むようにする どういう情報をつめこむか。 明確な言葉を選ぶ get は不明確らしい getPage(url) -> FetchPage(url) や DownloadPage(url) 特色のある(color

    「よりよいコードを求めて命名について頭をひねる会」のログ
  • 1