クラス名・変数名に迷ったら書き込むスレ。Part28 [無断転載禁止]©2ch.net
■ このスレッドは過去ログ倉庫に格納されています
クラス名、変数名のつけ方に悩んだら書き込むスレです。
命名規則や設計の善し悪しについて議論するのは基本的に禁止。
前スレ
クラス名・変数名に迷ったら書き込むスレ。Part27
http://echo.2ch.net/test/read.cgi/tech/1476572490/ >>114
もしそれが避けられないならEnum的なもので
decimalかpercentを引数として渡すようにするかな
atk_increase.rate(:persent)
でも表示用に数字をフォーマットする処理は
別途書いてるんだろうから二度手間だと思うわ 設計の話はNGって水を差すいつもの人が出てこない時は
その人自身がそれをやってる時だったりするのかなw
まあ俺ならRatioクラスを作るね。 命名がうまくできないのは設計がうまくいってない結果の場合もかなりあるのに
それを無視して設計の話はNGで命名だけってのは意味がないよね >>118
一般論としてはそう思うけど今回は微妙だね
まあ、どっちにしろこんな過疎スレでくだらないことに目くじら立てる奴の方が
確実にどうかしてるけどねw だからそういう奴のためのスレがあるっつってんだろ。
どうぞ正論に同意されている方々でやってください。無能なんですか?
設計・命名スレ
http://echo.2ch.net/test/read.cgi/tech/1477368563/
設計から喧々諤々されたい殿方は別スレがございますので、そちらをご利用ください。 >>115
質問者の現実のコードを想像できてないだろう。
そんな状態で、設計を非難し改めさせようとはおこがましいとは思わんかね? 仕方ない事だけどNormalizedってよく使うのに長すぎ
どっか偉い団体が頻出単語は標準的な省略形を定めてくれればいいのに ファイルの拡張子ごとに処理するクラスがあるんですが、そのクラスの静的メソッドとして、
処理できる拡張子かどうかを判定する静的メソッドを追加したいのですが
その名前をお願いします。 「処理する」の内容とあと言語のクラスメソッドの文法に依るけど、例えば
Class.canHandle(".xxx") >>127
なるほど。処理するの内容が何気に重要でしたね。すみません。
言語はC#で、アーカイブファイルを開くクラスですね。zipとか、それが拡張子ごとにある感じです。
そうすると「開く」??かなぁ・・? CanHandle、いいと思うけどな
あとはIsKnown(Extension)とか
静的メソッドだと
if (Hoge.CanHandle(ext))
...
else if (Hage.CanHandle(ext))
...
else if (Foo.CanHandle(ext))
...
ってなるのは必定で何だか泥臭いなとは思うけど、そこはスレ的に突っ込んじゃダメかね >>129
クラスクラスのインスタンスからクラスメソッド呼べないような言語あるの?
結局、サポートするコンテントタイプのリストを返すメソッドが欲しくなると思うけど オレなら、単純にisAcceptかなぁー
関係ないけど、静的関数を足すよりfactoryのクラス作って静的なインスタンス返すほうがいいとおもうんだ。
ステートフルパターンな感じに。。。 ありがとうございます。
Handle,Acceptのどちらかにしようと思います。 5chの板のスレ一覧のクラス(例えばThreadList)と各スレのクラス(Thread)があって、
・スレ一覧を更新するメソッド(各スレのログはダウンロードしない)
・スレッドを差分ダウンロードして新着レスを得る(最新状態に更新する)メソッド
にそれぞれ何という名前を付けますか?どっちもupdate()にしてるんですけど、同じ名前なのにやってることがだいぶ違ってなんかいまいちに感じます その専ブラがどのプラットホーム向けでいつリリースされるのかのほうが気になる。 >>134
updateはユーザーから見た動作であって実際のオブジェクトの動作はdownloadじゃないのかな?
知らんけど
と言う訳で
Download
DownloadUpdatedOnly ⇔ DownloadFull >>134
後者はrefreshとかどうか
ブラウザでページ更新して最新を取得するっていうときによく使われてる気がする >>136-137
参考になりました、ありがとうございます
ペーペーなので他にもユーザ目線の命名が多そう…見直します
>>135
すみませんただの練習用なんです><5chブラウザ腐るほどあるだろうし… get とfetchってどう使い分けたら良いですか? >>139
ググれ。
英語がらみでいっぱい見つかるから。 fetchなんて仰々しい言葉プログラミングではあんまり使わないと思うw ただ取るんじゃなくて「行って取ってくる」のが fetch だとググって知った。
ワンコがフリスビーとってくわえて戻ってくる感じ。
FreeBSD だと wget のかわりに fetch っていうコマンドを使うし
プログラミングではDBとのやりとりの時に使うことがあるね。
どうやって使い分けるのかっていうとうーん・・・ まあ、比較的高価だったり重かったり間に通信が入ったりする処理であることを
意識させる必要がある時ぐらいかね。
CPUがコアの外側のメモリから命令を拾ってくるのをフェッチっていうのも
そういうニュアンスなんだろうたぶん あるDLLをロードしたとき、そのDLL内部で使う情報を色々初期設定するために
InitializeDllって関数を作ったとき、それに対する終了処理としてつかう関数名は、
FinalizeDll?TerminationDll?どっちの名前を採用しますか?
もしくはもっと別の名前? >>145
finalizeに一票。
terminateは、後始末というよりも、本当に終了させる感が強すぎない? >>145
どっちでもいいでしょw
どぢらでも意味は分かるし誤解のしようもない。
ついでに変なサフィックスもいらない
Initialize/Finalizeで十分では?
名前異空間が使えなくてバッティングを避ける目的ならHOGE_Initialize
みたいにプリフィクスでやるのが普通じゃない? 補足しますと、元々DLLがロード・アンロードされるときに呼ばれるDllMainに渡される引数
DLL_PROCESS_ATTACHとDLL_PROCESS_DETACHで初期化処理終了処理を
突っ込んでたんですが、調子に乗って色々やり過ぎて不具合起こしたので
改めて明示的にEXE側から呼び出す初期化終了関数を作ったのでした。
(MSDNにも注意点として書かれれた)
そこで名称に疑問符が。
>>146
同感なのですが、後々DLLのアンロード時(アプリ終了時)に実行することを考えると
terminateもアリなのか?と思ってしまいました。
>>147
Initializeのイメージと被る感じがします・・・
>>148
まあどっちでもいいかもですがw
サフィックスはもうちょっとちゃんと考えますね。
finalizeで行こうと思います。
皆さんありがとうございました。 >>149
>後々DLLのアンロード時(アプリ終了時)に実行することを考えると
それは使う側の都合じゃね?
>>146でいいと思うよ goodsとかnewsと言った単数にしない単語をモデル名に使いたいとき、皆様はどのようになさるのでしょうか。productやarticle, postと言った別の単語で置き換えるのでしょうか。
置き換えると意味的に微妙に違和感が出るケースでしたので質問させていただきました。
参考
goodsが使われるケースがないか探している中で、ZOZOTOWNのAPIがgoodsを使っているのを見つけました。モデル名はどうしているのでしょうね...。 >>151
面白そうだからググってみたけど、その手の単語ってそうは多くないみたいね
http://www1.odn.ne.jp/xenom/gohou.box/gohou1.html
それを集約するオブジェクトがあって複数形が使えた方が都合がいいなら複数形がある別の可算名詞に
置き換える、そうじゃなきゃそのまま使う
まあ、柔軟に対応でいいんじゃないでしょうか >>152
どうもありがとうございます。柔軟に対応します。 ☆ 日本の、改憲を行いましょう。現在、衆議員と参議院の
両院で、改憲議員が3分の2を超えております。
『憲法改正国民投票法』、でググってみてください。国会の発議は
すでに可能です。平和は勝ち取るものです。お願い致します。☆☆ 指定したプロセスのメモリ使用量を表示する場合名前は何にしますか?
具体的にはタスクマネージャのプロセスタブにあるメモリ (プライベート ワーキング セット)の値をX秒毎に取得してその値を表示するプログラムです
SurveillanceProcessMemory?
CheckProcessMemory?
ViewProcessMemory?
WatchProcessMemory?
etc・・・ 何の名前?
表示を更新するUIのメソッド名?
それともアプリ自体の名前? その時点の情報表示 ViewProcessMemory
情報を監視(垂れ流し表示) WatchProcessMemory
なイメージ
checkは抽象的でよく分からない 見ることではなく、見せるものであれば、「Show」とか。 Monitorじゃねって混乱させたり、
Memoryの中見るんじゃなくて使用量見るんならMemoryUsageとかMemoryUseだよねとつっこんでみたり。 そもそもexeの名前なんだから
俺のメモリー.exe
とかでいいだろ 先頭が数字で半ば固有名詞扱いになってるものを識別子にしたい場合のお約束ってなんかある?
3D Y/C分離とか3次元ノイズリダクションとか
セットアップレベルの0IREとか7.5IREとかを読みやすさを損なわずに列挙体メンバにしたい 月並みなことしか言えんけど...
■ 先頭が数字の名前の対処法
(1) 先頭にアンダーバーか適当なプリフィクスを付ける
_3DYCSeparation
m3DNoiseReduction
(2) アラビア数字の代わりに英単語で
ThreeDimensionsYcSepartion
■ 小数点
電気屋は小数点をSI接頭辞やRで置き換えるんだった気が...
_7R5Ire
4.7kΩ = _4k7Ohm
自分は小数点をpで置き換えたことがある
_7p5Ire 公開する名前をアンダーバー始まりにするのは認めないぞ。
絶対の絶対だ。 誘導されて来ました
ネット上のAPIを叩いて、情報を取ってくるメソッドの名前って
どんな感じにつけたらいい?
例えば、どこかのサーバーにアクセスして天気予報データをJSONで
取ってくるケースだと、どういう名前にしたらいいか教えてください 天気予報といえばこのURLだしフォーマットもJSON以外ありえないという前提なら、
FetchWeatherでいいだろ。
もっと大げさに指定したいならFetchWeatherDataFromUrlInJsonとか。 >>165-166
やっぱこういうのは fetch >>139-144 がしっくりくるね >>166
>>167
ニュアンス的にはfetchがあってそう
サンキュー つか、メソッド名はクラス設計とも関係してて、
主語のクラス名も明確にしてくれないとどのメソッド名(動詞)が一番しっくりくるか変わるし。
俺は、例えば、天気予報情報を提供するREST API経由のXXXサービスがあるとすると、
クラスとしてXXXWeatherClientクラスみたいの用意して、
メソッド名にGetWeatherInfoでGetで十分だわ。
クラス名がどこから取得するか物語ってる事になるし。ローカルキャッシュされたものを取得するなら
適当に、LocalCacheWeatherClientとか。
だから、俺はこんな設計に大抵するからGetで十分だな。 抽象化してもしなくてもいいが、例えば
interface IWeatherClient
GetWeatherInfoAsync():
用意して、
class XXXWeatherClient : IWeatheerClient
class YYYWeatherClient : IWeatherClient
class LocalCacheWeatherClient : IWeatherClient
だから、クラス名の方がどっから取ってくるか物語るのでメソッド名は汎用的・抽象的なGetで十分かな。
こういう設計する場合は。 API呼ぶの1か所だけだし、抽象化もいらねぇしとかなら
class WeatherUtillity
static FetchWeatherInfoAsync
でstaticメソッドあたりにしてこれなら名前はFetchでいいかなとは思うけど。 getの話はさんざんされてるけど、言語の慣用によっては、
属性のゲッター的軽い処理と見誤られることがあるので注意すべき。 まぁ、長々書いたけど、
Twitter APIとかDropbox APIとかいろんなREST APIのラッパーライブラリ
を見ると、Fetchを使ってるのはほぼ見ないかな。ほとんどGetだと思う。 まあ、混在がない(FetchXxxだけでGetXxxがない)かつ、
全部をGetXxxにしてもそれが何を意味するか文脈的に自明なら全部Getでも問題ないねたぶん
でもpublicなメソッドは全部FetchXxxでも非publicなGetXxxメソッドが
存在するような場合は、使う人は良くても書いたり保守するのは混乱するかもね そんなん気にしてるのおまえらだけやぞw
しかも他人は絶対使わんやんおまえらのコードw REST APIの仕様であれば、Getばかりなのはそういうものなので、あたりまえ。
今回の質問者にふさわしいとは限らない。
プログラム全体と天気予報情報の関係によるだろ。
ほかのところはふつうにプロパティ参照みたいになってるのに、天気予報情報だけがサーバーに取得しにいくとかなら、それだけを特別にfetchと名付けるのは妥当。
つーか、質問者はもうfetchがいいって言ってるんだっつーの。w weather.api() か weatherAPI() だな ついでに型名とか軽量単位あたりも接頭辞で表すようにしてみるか fetch()、sketch()、oneTouch()メソッドを持つHentaiクラス 文字型としてはchar32_tのみ、文字列型としてはUTF-8 stringを使う体系の名前
なんか格好いいのないですか >>184
回答じゃなくてすまんが、
それ、文字列中の文字を一つずつ処理したいときどうすんの? >>185
文字列をコードポイント単位で切り出して処理します StringUTF8_CharUCS4
かっこよくはないけど、字面のわかりやすさ重視で。
ほかのところ(Enum型名とか)でだいたいわかるのであれば、String_Char.UTF8_UCS4とかでも。 体系って言ってるんだからクラス名とかじゃないんでしょ
そもそもクラス名なら、内部でどういう符号化してるかなんて普通はどうでもいいはずw >>188 >>190
アバウトでごめん
例えばD言語のforeachだとUTF-8が入ったchar[]をdchar(char32_t)単位でループできるんだけど
そういうルールに従っていることを示せる、名前空間やプレフィクス等に使える名前みたいな…… ずばりUCSにしてしまおうかとも考えましたがUnicode一般と区別がつかないですし
>>189で提案していただいたUTF_UCSみたいなのは"UTF"がそもそもそういう意味なので
格好悪いなあ、と 振る舞わせたいことが決まってるならForeachableStrとか?
>>190も言ってるように「何で実装されてるか」を名前にするのはあんまり筋がよくない気がする >>193
クラス名ではなく、イテレート検索置換set/mapその他文字列関数やそれを用いる処理群に付ける名前で
既存のchar/string、wchar_t/wstring等のペアと区別するためのもの、と思っていただければ 正直そっちの世界よく知らんけど、単純に文字・文字列の順でそれぞれを
表すプリフィクスをくっつけちゃうとか。つまり、Uu8 >>195
簡潔で良いですね。格好は……悩んでても仕方ないのでそうします
ありがとうございます 多重起動できる数を制限するのはなんて言う?
1つしか許さない場合もあれば2つまでは可能な場合もある
LimitMultiBoot、RestrictMultiBoot、他 そもそも数なら数ってわかる名前にしろよw
基本がアカンのに凝るとこ間違っとるでw >>199
多重起動できる数を制限するのに
Instancesで違和感無い?
>>200
間違ってない例お願い >>198
クラスなの?メソッドなの?変数なの?
そういう情報なしに命名なんかできるか。 >>201
実行ファイルを起動してできるプロセス = Instance
だったらMaxProcessesでもよさそうだけど、それだとまるで別のバイナリも含めた
実行可能なプロセスの数のような感じになっちゃう
そもそも質問文が曖昧に感じるけど、
プログラムが起動を許す自分の実体の最大値を表す数ならMaxInstancesでいいと思う >>202
多重起動できる数を制限する変数っておかしくない?
変数が何かするわけでもないし
>>203
プロセスもInstanceなんだありがとう
MaxInstancesだと「数」が格納されてそう
改めて言うと
自プロセスが多重起動できる数を「制限する」関数だから
動詞からはじめたい >>204
制限する個数を入れておく変数なら十分あり得るだろ
ていうか、MaxHogeっていうのはそういう変数や定数の名前にしかならんよ >>204
じゃあLimitInstanceCountとか?
だけど、
if (getCurrentInstanceCount() >= MaxInstances) プログラム終了;
の方が分かりやすいと思うけどw >>205
変数を訊きたいなら「多重起動できる数はなんて言う?」になるのでは?
> 多重起動できる数を制限するのはなんて言う?
既に元の質問でこうなんだから変数はありえないとわかるし
そもそも例も動詞から始まってるんだから関数だとわかると思ったけど
それとも動詞から始まる変数もありなん? >>206
あぁごめん
そっちも変数だと思ってたのね
かみ合わないなと思ったらそういう事か
Limitにするよありがとう invokeの意味はcallに近いからメソッドの呼び出しには相応しいけどプロセス起動には違和感ある
bootだとOSが起動しそう
start、launchあたりでいいんじゃないかな
プロセスであることに特段の意識を向けないならrunもイイと思う callというより、summonだよ。
すごいやつを召喚する感じ。
commandの起動にはinvokeが一番ぴったりだよ。 ■ このスレッドは過去ログ倉庫に格納されています