(免責事項:ジェーンからこのブログページの参考書https://www.jianshu.com/p/c1b6cf190e0b 以下の私の理解とコード仕様の提案を共有するために私のプログラミングの経験と組み合わせて読んでいます)
まず、前述の
ツールとしてのコードは、コンピュータプログラマーと通信するために、その重要性は自明であるが、長い道のりオフプログラムでは、自己プログラミングされていることは不可能である、グループの協力が不可欠です。そのため、コードの仕様は、このようにそれはあなたが非標準を記述する場合は、醜いの視覚的な感覚を与える、非常に重要であり、その後、あなたのパートナーは、あなたが書いたコードを変更することは困難であろう、あるいは協力することを拒否。そのため、必要な知識を習得する初心者のためのコードとして例示解析コードの仕様のためのC ++、に一例として、このブログの最も基本的なコードの規格です。
第二に、ケーススタディ
1.スペースと空白行を十分に活用
①スペースと空白行の適切な使用は、コンパクトなコードのシリーズは圧力を与えるのではなく、人々に安らぎを与えます。
関数名の後にスペースを残し、またはパラメータは、明白なことを表してはいけません
以下のような:int型FUN1(int型x)は//書き込み勧告
int型Fun2(int型x)は//書き込みをお勧めしません。
②if後、他の裁判官やリサイクルをキーワードに話をしながら、ためには、キーワードを強調するために、「(」スペース左括弧を残す必要があります。
如:IF(I = 0)
③スペースへの変数の定義の後にコンマ。文のセミコロンはスペースが続くことにします。
以下のような:
用(i = 0 ; iは< 5 ; iは++ ) int型、B。
④代入演算子、比較演算子、算術演算子、論理演算子、ビットフィールド演算子、例えば、 "="、 "+ ="、 "> ="、 "<="、 "+"、 "*" として、 "など%「」&&「」<<「」^」は、スペースの前と後に追加する必要があります。
如: a = b; a += 10;
⑤機能を実装する場合、機能は、空行と2つの異なる機能を区別を容易にする機能の間に追加されるべきです。
以下のような:
無効 FUN1(int型x)は { // 何かを行う } 無効 Fun2(ダブルY) { // 何かを行います }
PS:スペースも良いコード仕様の過度の使用、不適切ななどの適切な使用、のための:(I = 0をint型;私は<10; iが++)は非常に空のスペースが、そのような感情を悪用できます。
2.なお、コードの各行の内容
一つのことを行うためのコードを1行ではなく、すべての機能が1行のステートメントに圧縮されます。
以下のような:
INT のmain() { int型 NUM; ダブル COUNT; 一方(NUM <= 100)NUM ++; 戻り 0 ; // 不正なコード仕様 } int型のmain() { int型NUM; ダブルCOUNT; 一方(NUM <= 100 ) { NUM ++ ; } リターン 0 ; }
3.変数、関数名は命名規則
①変数、関数、ファイル、英語の単語やフレーズを最大限に活用を命名、ピンインを使用していない、または無意味ABCなど、英語の単語や略語を再生することができますでは、プロンプトのコメントが存在しない状態でリーダーに選ば再生することができます効果。
②クラスと関数名を分離することができ、通常の可変領域は大文字で始まります。
個人的な好みの使用の命名規則:二重のこぶの命名法:
二重こぶ命名法名、変数は、組成物は複数の単語によって行われている場合ならば、最初の単語は小文字で始まり、第二、三、四個の先頭文字大文字の単語...... N. たとえば、次のように、このような変数名などmyFirstWordは、別の後にラクダのピーク、美しいだけではないように見えるが、また、フレーズによってという名前の変数をハイライトという名前の競合の可能性を減らします。
4.タイムリーなコメントを追加
時々、コードを読むことは、コードがコメントの隣でない場合、その意味を理解することは困難であり、かつ、ラインの自分の思い出を作るコードの一部を使用するだけでなく、理解する上で読者の側面だけでなく、コメントを追加することが適切で、プログラマを考え続けることはありません。
これは、各関数名の後に関数の機能を説明するコメントを追加することを提案し、それは読者が循環を理解するように、メイン関数の各サイクルにコメントを追加するのが最善だということをお勧めします。
これらは、これらの仕様、美しく、実用的な書き込みコードを覚えておくことも出来ることを期待して参考書のレビューと勧告を読むために私のブログです。