問題タブ [naming-conventions]

これは簡単な質問のように思えますが、スタック オーバーフローの検索や Google で検索しても見つかりません。タイプの後に_t平均が続くとは何ですか? そのような

ハードウェアを密接に扱うことを意図した C コードでよく見かけますが、それらが関連していると思わずにはいられません。

これは、 acts_as_conferenceでBigNerdRanchのCharlesBrianQuinnが行ったプレゼンテーションで最初に議論されたものでした。彼は、プログラミングとRailsの両方に不慣れな多くの人々に、Ruby onRailsBootcampを指導することから学んだことについて話し合っていました。

目立った特定のスライドの1つは、誰かにプログラミングを教えようとしたときに、例としてfooとbarを使用しないという方針に沿ったものでした。彼の推論は非常に単純でした。

どちらがわかりやすいですか？

また

何かを説明するときに何度も起こり、すぐにfooバーのプレースホルダーにジャンプしますが、実際のシナリオを使用して、自分の間違いに気づき、例をよりわかりやすくします。

これは、プログラミングの経験がなく、実際に教えようとしていることを説明する前にfooとbarを説明する必要がある人に教えようとする場合に特に当てはまります。

ただし、経験豊富なプログラマーにfooとbarを使用することは問題ないようですが、個人的には、Charlesと一緒に、これを変更する必要があると思います。

「foo」をすばやくSO検索すると、20ページを超える結果が返され、fooは私が理解できるより多くの方法で使用されています。また、特定の言語に関する質問を読んでいて、その言語をよりよく理解するために読んでいる場合もあります。fooとbarの代わりに該当する変数名を使用すると、問題の理解と解釈がはるかに簡単になります。したがって、経験豊富な開発者にとっては、構造にも少し欠陥があるように思われます。

これは、これまでに蹴られる可能性のある習慣ですか？なぜあなたはfoobarを選ぶのですか、それともfoobarを選ばないのですか？

私は .NET の世界から来て、C++ を書くのは初めてです。ローカル変数と構造体メンバーの命名に関して、どのような命名規則が好まれるのか疑問に思っています。

たとえば、私が継承したレガシー コードには、次のようなものがたくさんあります。

C# のバックグラウンドを持つ私は、ハンガリー語表記の変数を見てショックを受けました (最初に pp プレフィックスを見たとき、笑いが止まりませんでした)。

代わりに、このように変数に名前を付けたいと思います（ただし、最初の文字を大文字にすることが適切な慣例であるかどうかはわかりません。他の方法を見てきました（以下のリンクを参照））。

私の質問: これ (以前の方法) は、C++ で変数に名前を付けるための推奨される方法ですか?

参考文献:

http://geosoft.no/development/cppstyle.html

http://www.syntext.com/books/syntext-cpp-conventions.htm

http://ootips.org/hungarian-notation.html

ありがとう！

ここで簡単な質問です。Objective-C Cocoa アプリケーションで最も意味のあるメソッド名はどれですか?

また：

あるいは：

私が何年にもわたって出会ってきた変数名には、さまざまなスタイルがあります。

命名規則に関する現在のウィキペディアのエントリはかなり軽いです...

名前/説明といくつかの例で識別される、変数の命名規則の簡潔なカタログを見てみたいです。

規約が特定のプラットフォーム コミュニティによって特に支持されている場合、それも注目に値します。

私はこれをコミュニティ wiki に変えているので、それぞれの規則について回答を作成し、必要に応じて編集してください。

ストアドプロシージャに名前を付けるためのさまざまなルールを見てきました。

sproc名の前にusp_を付ける人もいれば、アプリ名の略語を付ける人もいれば、所有者名を付ける人もいます。本当に意味がない限り、SQLServerでsp_を使用しないでください。

proc名を動詞（Get、Add、Save、Remove）で始めるものもあります。他の人はエンティティ名を強調します。

数百のsprocがあるデータベースでは、すでに存在していると思われる場合、スクロールして適切なsprocを見つけるのは非常に難しい場合があります。命名規則により、sprocの検索が容易になります。

命名規則を使用していますか？それを説明し、他の選択肢よりもそれを好む理由を説明してください。

返信の概要：

• 誰もが命名の一貫性を主張しているようです。つまり、どの特定の命名規則を使用するよりも、すべての人が同じ命名規則を使用することがより重要である可能性があります。
• プレフィックス：多くの人がusp_または同様のもの（ただし、まれにsp_）を使用しますが、他の多くの人はデータベースまたはアプリ名を使用します。賢いDBAの1つは、gen、rpt、tskを使用して、一般的なCRUDsprocをレポートやタスクに使用されるものと区別しています。
• 動詞+名詞は、名詞+動詞よりも少し人気があるようです。動詞にSQLキーワード（Select、Insert、Update、Delete）を使用する人もいれば、GetやAddなどの非SQL動詞（またはその省略形）を使用する人もいます。1つまたは複数のレコードが取得されているかどうかを示すために、単数形と複数形の名詞を区別するものもあります。
• 必要に応じて、最後に追加のフレーズが提案されます。GetCustomerById、GetCustomerBySaleDate。
• 名前セグメントの間にアンダースコアを使用する人もいれば、アンダースコアを避ける人もいます。app_Get_CustomerとappGetCustomer-読みやすさの問題だと思います。
• sprocの大規模なコレクションは、OracleパッケージまたはManagement Studio（SQL Server）ソリューションとプロジェクト、またはSQLServerスキーマに分離できます。
• 不可解な略語は避ける必要があります。

私がした答えを選ぶ理由：非常に多くの良い反応があります。皆さん、ありがとうございました！ご覧のとおり、1つだけを選択するのは非常に困難です。私が選んだものは私に共鳴しました。私は彼が説明しているのと同じ道をたどりました-動詞+名詞を使おうとすると、顧客に適用されるすべてのsprocを見つけることができません。

既存のsprocを見つけたり、存在するかどうかを判断したりできることは非常に重要です。誰かが誤って別の名前で重複したsprocを作成すると、深刻な問題が発生する可能性があります。

私は通常、数百のsprocを含む非常に大きなアプリで作業しているため、最も見つけやすい命名方法を好みます。小さいアプリの場合、メソッド名の一般的なコーディング規則に従っているため、動詞+名詞を推奨する場合があります。

彼はまた、あまり役に立たないusp_の代わりにアプリ名を接頭辞として付けることを提唱しています。何人かの人が指摘したように、データベースに複数のアプリのsprocが含まれている場合があります。したがって、アプリ名をプレフィックスとして付けると、sprocを分離し、DBAなどがsprocを使用するアプリを判別するのに役立ちます。

また

個人的には、最新の IDE では、ALL_CAPS が奇妙に見えるため、camelCase を使用する必要があると思います。どう思いますか？

私は正式なコンピューティングのバックグラウンドを持たない Web 開発者です。ここ数年コードを書いていますが、新しいクラス / 関数 / 変数を作成する必要があるたびに、名前を決めるだけで約 2 分を費やしています。次に、それを入力する方法。

たとえば、一連の数値を合計する関数を作成するとします。と呼べばいいのか

私はこれを行う正しい方法があることを知っています、そして良い決定的な情報源へのリンクは私が尋ねるすべてです:D

c# コーディング標準 / ベスト プラクティスの複製としてクローズ

私は最近、PGP を使用して別の内部システムからのファイル出力を自動的に暗号化し、サードパーティ アプリケーションによって消費される外部ターゲット サーバー ディレクトリに sftp するアプリケーションをロールしました。プロセス全体のトラブルシューティングを約 1 週間試みましたが、今朝までメールでサードパーティから応答がありませんでした....

「<em>ファイルの名前が間違っているため、システムはあなたがファイルを送信したとは見なしませんでした。小文字にするべき大文字の「T」がありました。」</p>

Ok。ため息をついた後 (他の誰もそのディレクトリにアクセスできず、同様の方法で名前が付けられた他のファイルがないため)、「<strong>パスワード以外のユーザー入力の大文字と小文字の区別をアプリケーションが尊重する必要があるのはいつですか?」と考え始めました。ここで、「fileName」と「FileName」に意図的に別の意味を持たせたいときを考えようと頭をよぎっています。

ここでは、アプリケーション内変数の命名規則について話しているわけではありません。私は実際、大文字と小文字を区別する言語に非常に賛成です。

どの Delphi コーディング標準ドキュメントに従っていますか?

私たちの会社は、コードの読みやすさ、レビューのしやすさ、および保守のしやすさを改善するために、いくつかのより良いコーディング標準を導入することを検討しています。CodeGear の「Object Pascal スタイル ガイド」に出くわしましたが、かなり長い間触れられておらず、多くの人が部分的な改善や追加を行っていると思います。公開されているいくつかのバリエーションやその他のドキュメントに出くわしました。以下にリストします。

NB: 私はスタイル戦争を始めたくありません。あなたが従う基準とその理由を知りたいだけです。

ありがとう。