質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

88.82%

「〜を用いて○する」というメソッドを命名するとき、どちらの命名がいいでしょうか?

受付中

回答 2

投稿 編集

  • 評価
  • クリップ 0
  • VIEW 429
退会済みユーザー

退会済みユーザー

質問の経緯

「カラムidでWHEREしたmy_tableテーブルのレコードを取得するメソッド」を作成しました。

サンプルは手慣れているPHP(FuelPHP)で書いてます。
やってることは上で説明してる通り、WHEREを使った単純なSELECTクエリを叩いて結果を返しているだけです。

class MyTable {
    public function fetchWithId($id) {
        // $idでWHEREしたレコードを取得
        return DB::query('select * from my_table where id = :id')->bind('id', $id)->execute();
    }
}

このときのメソッド名を、
「IDを用いてレコードを取得する」という意味を込め、fetchWithIdとしました。

質問

その後レビューで「こういう場合ではwithよりbyではないか」
という意見をもらったため、改めてwithとbyの違いについてググってみたところ、

あるページによると、2語は以下の用法で区別されるらしいのです。

by    抽象的手段(動作・行為、方法・手法、運搬・交通・通信)
with    具体的手段(道具,物質・物体,材料)

これを見る限り、IDは物理的な概念ではないので個人的にはbyかな?と考えています。

ここで、
withとbyどちらがいいのか、はたまた全く違う命名が適切なのか教えてほしいです。よろしくおねがいします!

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 過去に投稿した質問と同じ内容の質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

質問への追記・修正、ベストアンサー選択の依頼

  • 退会済みユーザー

    2019/11/08 00:03

    複数のユーザーから「問題・課題が含まれていない質問」という意見がありました
    teratailでは、漠然とした興味から票を募るような質問や、意見の主張をすることを目的とした投稿は推奨していません。
    「編集」ボタンから編集を行い、質問の意図や解決したい課題を明確に記述していただくと回答が得られやすくなります。

回答 2

+2

今回のご質問のケースでは、with で違和感ありません。
逆に by の方が違和感あります。
by は動作をイメージし、 with は項目とか値とかいう名詞のイメージで捉えました。

私は普段Javaを扱うことが多いのでその土俵で考えると、オブジェクト指向的には、ID 自体をクラスとして表現するのが本来良いのだろうと考えています。(大抵IDはString や long で代替してしまいますのでその場合は selectWithId のような感じにせざるを得ませんが・・・)

public fooDto selectWith(XxxId id) {
    ... 
}


こうすると、メソッドシグニチャ全体の表現力で説明できた形にしやすそうです。

== 補足 ==

もし会社やプロジェクトで標準化があればそれに従うのは当然のことです。
属しているコミュニティー(組織など)での慣例があればそれに従う方が良いのは他の回答者の方が言及されている通りでしょう。
一貫性を保って同じように単語を使うことがとても大事です。

投稿

編集

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

+2

byでいいんじゃないですか?javascriptでもgetElementByIdというものがあるぐらいなので
レビューでbyを提案されたならあなたのいる環境ではbyが浸透している可能性が高いのでbyでいいと思います
ひとりで開発するなら好きな方にすれば良いし、みんなで開発するならみんなが感覚的に理解しやすい方を使えばいいです

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 88.82%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる

関連した質問

同じタグがついた質問を見る