naming | API > 考察 > { StringReplace() | IncSecond() } | { SecondsBetween() | SecondSpan() } > まぎらわしい
StringReplace()とIncSecond()
C++ BuilderでStringReplace()をいつもReplaceString()と思ってしまう。
IncSecond()という関数があり、こちらは[動詞]+[名詞]の組み合わせ
一方で、StringReplace()は[名詞]+[動詞]の組み合わせ。
本当はReplaceString()という関数名が望ましい。
SecondsBetween()とSecondSpan()
この2つは
- 片方は複数形 > SecondsBetween()
- もう一方は単数形 > SecondSpan()
入力補完があるので何とかなるが、紛らわしい。
また、上記は[名詞]始まり。[動詞]始まりの関数と異なる命名規則。
関数名の考察
自分が実装を進めるものについては上記のようにならないようにルールをきちんとしておくことが望ましい。
APIは特に使い始めると容易に変更できない(ラッパーを作るのも可能だが)ので、きちんとした設計は重要。
Author And Source
この問題について(naming | API > 考察 > { StringReplace() | IncSecond() } | { SecondsBetween() | SecondSpan() } > まぎらわしい), 我々は、より多くの情報をここで見つけました https://qiita.com/7of9/items/873640f7eb4a0f9869d4著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .