エンジニア英語

関数名の英語:命名に使う動詞と使い分け

簡単な答え

関数名の英語は「動詞+目的語」が基本で、getUser、calculateTotal、sendEmailのように、何をするかを動詞で始めます。Googleのスタイルガイドもメソッド名は動詞か動詞句が一般的としています。似た動詞のget・fetch・load、create・add・insertは意味が少しずつ違うので使い分けます。Devlingoで学べます。

更新日 2 分で読めますGambit Studio

インストールなしで使う →ブラウザで無料、登録不要

GoogleのJavaのスタイルガイドは、メソッド名を lowerCamelCase で書き、sendMessage や stop のように動詞か動詞句にするのが一般的だとしています(Google Java Style Guide)。

関数名でよく使う動詞の一覧

動詞意味例
get取得する(手元にあるものをすぐ返す)getUserName()
fetch外部(APIなど)から取ってくるfetchOrders()
loadファイルや保存先から読み込むloadConfig()
find探す(見つからないこともある)findUserByEmail()
create新しく作るcreateInvoice()
add既存の集まりに加えるaddItem()
insert位置を指定して挿入する・DBに入れるinsertRow()
update更新するupdateProfile()
delete / remove削除する/集まりから取り除くdeleteAccount(), removeTag()
save保存するsaveDraft()
calculate / compute計算するcalculateTax()
convert / to変換するconvertToJpy(), toString()
parse文字列を解析して構造にするparseDate()
format表示用に整形するformatPrice()
validate入力が正しいか検証するvalidateEmail()
check条件を確かめるcheckStock()
handleイベントや例外を処理するhandleClick()
send送るsendNotification()
init / setup初期化するinitDatabase()
reset / clear初期状態に戻す/空にするresetForm()

迷いやすい動詞の使い分け

グループ違い
get / fetch / loadget はすぐ返る取得、fetch はネットワーク越しの取得、load はファイルや保存先からの読み込みに使われることが多い
create / add / insertcreate は新しく作る、add は集まりに加える、insert は位置を決めて差し込む
delete / removedelete は存在ごと消す、remove は集まりから外す(物自体は残ることもある)
check / validate / verifycheck は条件を確かめる全般、validate は形式や値が正しいか、verify は本物か・合っているかを照合する

真偽値を返す関数の名前

true か false を返す関数は、変数と同じく質問の形にします:isEmpty()、hasAccess()、canDelete()、shouldShowBanner()、exists()。「check」で始めると、何を返すのか(真偽値なのか、例外を投げるのか)が分かりにくくなります。

変数名の単語は変数名の英語一覧にまとめています。

Devlingoで開発現場の英語を1日10フレーズ

Gambit StudioのDevlingo(English for Devs)は、開発者のための英語フレーズアプリです。デイリースタンドアップ、コードレビュー、Slack、プルリクエスト、バグ報告、面接など12カテゴリに3,600以上のフレーズを収録し、1日10個ずつ、使う場面と発音ガイド、例文つきで学べます。ホーム画面ウィジェットには今日のフレーズが表示されます。画面表示は英語などで、日本語には対応していません。

出典

  1. Google Java Style Guide「5.2 Rules by identifier type」

よくある質問

よく聞かれる質問に、出典つきで答えます。

関数名は動詞で始めるべき?
一般的にはそうです。Googleのスタイルガイドも、メソッド名は動詞か動詞句が一般的としています(Google Java Style Guide)。
getとfetchの違いは?
get は手元のデータをすぐ返す取得、fetch はAPIなど外部から取ってくる取得に使われることが多いです。
真偽値を返す関数の名前は?
isEmpty、hasAccess、canDelete、shouldRetry のように、is・has・can・should で始めます。
関数名に使える英語が分からないときは?
まず上の一覧の定番の動詞から選び、それでも迷うときは同じ処理をしているOSSのコードの命名を調べます。

続けて読む

同じアプリのガイドをもっと。手順と出典つき。

Devlingo無料 · iOS 17.0+
インストールなしで使う入手