タグ付けされた質問 「naming」

チームやコミュニティ全体で最も受け入れられやすい形式で、最小限の文字数で意味と説明を与えます。

4
Java抽象クラスの命名
例: Ajaxアクションの抽象クラスを作成します。異なるAjaxアクションはすべてこのクラスを拡張します。 問題: クラスにAjaxActionまたはAbstractAjaxActionという名前を付けますか? サブクラスを作成するとき、名前を付けますか? アクション AjaxAction 彼らに彼らが何であるかという名前をつけてください 私は「公式の」大会が何であるかを見つけることができませんでした。サブクラスで"Abstract"プレフィックスまたは必要な命名規則が必要ないようです。(とにかくそれは合うかもしれません。) 公式大会はありますか?リンクしてくれませんか?そして、この問題についてのあなたの意見は何ですか?
9 java  naming 

3
副作用がある関数の命名規則?[閉まっている]
休業。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善してみませんか?この投稿を編集して、事実と引用で回答できるように質問を更新してください。 3年前休業。 彼らの言語には、状態を変化させる関数の名前が感嘆符で終わらなければならない慣習があると誰かが言うのを聞いた 私はもっ​​と機能的なコードを書こうとしているのですが、副作用ステータスに従って関数を何とかマークするアイデアが好きです。つまり、なし、内向きの副作用、外向きの副作用(私は正しいfp用語を知らないですが、望む)。 自分の命名スキームを思いつくのは簡単ですが、そのようなスキームや慣習がホームベイクする前にすでに存在しているかどうか疑問に思っていました。 編集:すべての回答に感謝します。それはまさに私が求めていたものであり、それらはすべて本当に有用であることがわかりました。おそらく、古いJavaScriptをリファクタリングしているので、静的に型付けされた言語では、副作用のあるコードとないコードの違いを強制できるかもしれないが、自分で付けた命名規則に頼らなければならないでしょう。 edit2:これを主にオピニオンベースとして閉じるmodについては、私は同意しなければなりません。私は、もしあれば、どのような慣習が一般的に使用されているのかを尋ねていました-これは誰かの定義によると、意見ではなく事実の問題です!

3
名詞が単数と複数の両方であるときに配列またはリストに名前を付ける方法は?[閉まっている]
休業。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善してみませんか?この投稿を編集して、事実と引用で回答できるように質問を更新してください。 4年前休業。 一般の変数は、単数形で命名されCar car;、配列やplurasを持つリスト:List<Car> cars;またはCar[] cars;しかし、何のような名詞についてfishやmedia、既に複数ありますか*? *クラスを呼び出すために、すでにバトルに敗れましたMedium。
9 naming 

5
個人のライブラリにどのように名前を付けますか?[閉まっている]
休業。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善してみませんか?この投稿を編集して、事実と引用で回答できるように質問を更新してください。 5年前休業。 私は物事に名前を付けるのがかなり苦手です。 私が一般的に思いつくことができる唯一の名前は「ヘルパー」です。たとえば、パスを操作するための支援関数を含むヘッダーファイルがある場合、それを「ヘルパー」ディレクトリ内に置き、「path-helper.hpp」などの名前を付ける傾向があります。 明らかに、それは悪い命名規則です。:) 自分のヘッダーとライブラリを常に参照するために使用できるフォルダー(および名前空間)に一貫した名前付けスキームを設定したいのですが、入力や覚えやすい名前(などboost)を見つけるのに問題があります...それらの一部を「ヘルパー」や「stdext」などと呼ぶことになってしまいますが、これは素晴らしいアイデアではありません。 覚えやすくタイプしやすく、一般的ではないライブラリの名前をどのようにして見つけますか(「ヘルパー」、「std」、「stdext」など)。 これを行う方法についての提案はありますか?

2
大文字と小文字の区別が異なる複数の言語を操作するときはどうしますか?
Djangoを使用してwebappを作成しています。変数の命名に関するPythonの規則はlowercase_with_underscoresですが、JavaScriptの規則はcamelCaseです。さらに、多くの人がCSS識別子に小文字のハイフンを使用するのを見てきました。 他の2つが他を推奨している場合でも、必要に応じて3つすべての命名規則を使用するか、1つを選んでそれを使用することをお勧めしますか?前後に切り替えることは大きな問題ではありませんが、それでも精神的なオーバーヘッドになる可能性があります。

7
不変を暗示するために過去形(受動音声)を使用しますか?(例:Array.TransposedとArray.Transpose)
[注:以下は、FxCopルールの引用など、構文と規則が少しC#で重いです。これは私の背景ですが、この説明の意図は言語に依存せず、使用されるコード例は一般に疑似コード。—マイク] クラスは一般に、オブジェクトインスタンスが実際的な場所では不変であり、クラスメンバーの呼び出し結果にはできる限り副作用がないように設計する必要があることに、私たちは全員同意するでしょう。 ただし、歴史的な命名規則では、「GetSomething」、「DoSomehing」などのアクティブな音声を使用する傾向があり、クラスメンバーが実行するアクションが明確に示されているため、これは適切です。 ただし、メンバーが過去形で名前が付けられると、参照されるオブジェクトに影響を与えることなく値が返されることを暗示することで、時々(または場合によっては)メリットが得られると考え始めています。 たとえば、配列を転置するメソッドの場合、現在の命名スタイルではおそらく 'Array.Transpose'と呼ばれますが、このメンバーが参照されたオブジェクトを転置せずに新しい配列を返す場合、それを 'Array.Transposed'と呼ぶと思います'はより正確になり、プログラマにわかりやすくなります。 'Array.Transpose()'メソッドを使用する場合、誤って次のようなコードを使用しようとする可能性があります。 Array myArray = new Array(); myArray.Transpose(); ただし、「Transpose」メソッドが参照オブジェクトに影響を与えずに新しい配列を返す場合、このコードは何もしません。つまり、「myArray」は静かに転置されません。(「転置」がプロパティである場合、コンパイラは上記が正当ではないことをキャッチするでしょうが、FxCopガイドラインでは、変換を実行するメンバーはメソッドである必要があると述べています。) しかし、メソッドが過去形で 'Array.Transposed'と名付けられている場合、次の構文が必要であることはユーザーには明らかでしょう。 Array myArray = new Array(); Array transposedArray = myArray.Transposed(); このカテゴリに当てはまると思う他の名前は、「サイズ変更」対「サイズ変更」、「シフト」対「シフト」などの名前のメンバーです。現在の時制は、参照オブジェクトに影響を与えるメンバーに使用されますが、過去形は、参照されるオブジェクトに影響を与えずに新しい値を返すメンバーに使用されます。 現在より一般的な別のアプローチは、各名前の前に「Get」または「To」を付けることですが、過去形に変更すると意味が効果的に伝わり、不要な重みが追加されると思います。 これはここの他のプログラマにとって意味がありますか、それともこの過去形のアイデアは、それを読むときにあまりにぎこちないように聞こえますか? 編集: 以下の素晴らしい議論、私は皆に感謝します。以下に、あなたのコメントとこれに対する私自身の修正された考え方に基づいて要約したいいくつかのポイントを以下に示します。 「流暢な」構文を連鎖させるメソッド 以下の説明に基づいて、参照されるオブジェクトの内部状態に影響を与えるメンバーまたは影響を与えないメンバーを明確にするために、可変クラスで使用する場合、過去形の使用はおそらく価値があります。 ただし、不変クラスの場合、これはケースの大部分になるはずです(希望するでしょう)、過去形を使用すると、構文が不必要に扱いにくくなる可能性があると思います。 たとえば、メソッドチェーンによって作成されるような「流暢な構文」では、過去形を使用するとコードが読みにくくなります。たとえば、C#を介してLINQを使用する場合、一般的なメソッドチェーンは次のようになります。 dataSource.Sort().Take(10).Select(x => x.ToString); 過去形に変更すると、これは扱いにくくなります。 dataSource.Sorted().Taken(10).Selected(x => x.ToString); ちなみに、LINQ式は常にソースに影響を与えずに新しい列挙を作成するため、dataSource.Sorted()は実際にはdataSource.Sort()よりも意味が明確です。ただし、このパラダイムを使用するときはこれを十分に認識しているため、過去形の使用は冗長であり、それを読み取る「流暢さ」が本当の意味で不便になります。 プロパティとメソッドの使用 以下で取り上げられた重要な問題は、「取得」メソッドと読み取り専用プロパティの使用に関するFxCopガイドラインに関係しています。例:FxCopルールCA1024。 そのFxCopルールでは明示的に言及されていませんが、ToXXXXXX()メソッドは変換メソッドであるため、「To」メソッドの使用はこの根拠にも適用されるようです。また、ToArray()の場合、メソッドは変換メソッドであり、配列を返すメソッドでもあります。 ブールプロパティの過去形の使用 一部の人は、過去形がブール値を暗示する可能性があることを示唆しました。たとえば、「成功」または「接続」プロパティ。ブールのプロパティとフィールドに「Is」、「Has」、または「Are」の使用を強調する以下のレトルトは正しいと思います。過去形もこの点で役立ちますが、「Is」接頭辞を使用する場合ほどではありません。ブール値のプロパティとフィールドに過去形を使用してもかまいませんが、役立ちますが、名前の前に「Is」、「Has」、または「Are」を付けることがさらに重要だと思います。 全体的な結論は? Tranpose()とTransposed()の問題については、 …
8 naming 

9
チェックイン前に開発者が実行するテストスイートを何と呼びますか?[閉まっている]
休業。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善してみませんか?この投稿を編集して、事実と引用で回答できるように質問を更新してください。 4年前休業。 私は、既存のプロジェクトに自動テストを追加するプロジェクトに取り組んでいます。中央コンポーネントから始めて、開発者環境ではありますが、コードモジュールレベルでの単体テストと、コンポーネント全体で実行されるテストの両方をセットアップします。このテストスイートは、コードチェックインの前に合格する必要があり、各開発ブランチの継続的インテグレーションシステムによって実行されることを意図しています。 これは何と呼ぶべきでしょうか?現在、これを「開発ユニットテスト」と呼んでいますが、ユニットテスト以上のものが含まれているため、私の知識の面では、それは完全に適切ではないと述べています。そして、私たちのビジョンは、このスイートが時間とともに成長し、完全な製品受け入れテストを含めることです。 ここに何か入力はありますか?それとも、名前についての議論をやめて、テストを書くべきでしょうか? 更新 みなさん、良い議論をありがとう!私が結論を下しているのは、実際には「共通の」定義は存在しないということだと思います。各プロジェクト/チームには、テクノロジー(Java、C#、Rubyなど)に応じて、そのプロジェクトに最も意味のある名前が付けられますおよび使用中の方法論(古い学校の滝、スクラム、XPなど)。

6
PHPクラスにはどのような命名規則を使用していますか?[閉まっている]
休業。この質問には、より焦点を当てる必要があります。現在、回答を受け付けていません。 この質問を改善してみませんか?質問を更新して、この投稿を編集するだけで1つの問題に焦点を当てます。 4年前休業。 ClassNamesとmemberNamesを慣例として使用するのは本当に好きですが、クラスを含むファイルにどのように名前を付けるかわかりません。 クラスとまったく同じ名前のファイルでクラスを定義するのが好きです。しかし、phpファイルをすべて小文字にすることも好きです。だから私は対立しています。 私はと呼ばれるクラスを持っている場合はProductGroupその中で定義されるべきProductGroup.php、productgroup.phpまたはproduct_group.php? 私は正しい答えがないことを知っているので、私は最も一般的なもの、またはどちらを使用するかについてのあなたの意見を探しています。どちらを使用しますか?
8 php  naming 
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.