C++ のコードスタイル支援

コードフォーマットルールの管理と適用

コードスタイルの重要な側面は、コードのフォーマット方法、つまり、空白、タブ、改行を使用してコード要素を配置する方法、インデントにタブを使用するかどうかと方法、長い行を折り返すかどうかと方法などです。オン。

ReSharper コードフォーマットルールの広範なセットには、デフォルトの Visual Studio フォーマットオプションと多数のベストプラクティスを考慮したデフォルト構成があります。フォーマットルールのすべての詳細を構成し、コードにルールを適用できます。これらのルールは、ReSharper がコード補完およびコード生成機能を備えた新しいコードを生成し、コードテンプレートを適用し、リファクタリングを実行するときに適用されます。フォーマットルールは、現在の選択、現在のファイル、ソリューション全体までのより広い範囲の既存のコードにも適用できます。

ReSharper は、共有設定のメカニズムを使用してフォーマット設定を保存します。コード編集 | C++ | スタイルのフォーマットグループのオプションページでフォーマットルールを設定できます。また、EditorConfig および Clang 形式ファイルにフォーマット設定を保存して共有することもできます。

個々のフォーマット設定を微調整する別の方法は、既存のコードサンプルからフォーマットルールを学習することです。これは、選択したブロック、現在のファイル、ファイルのセット、1 つ以上のプロジェクト、ソリューション全体です。ReSharper は、選択したサンプルを分析し、現在の設定とは異なるフォーマットルールを一覧表示します。その後、検出されたルールを確認し、必要に応じて変更し、目的の設定レイヤーまたは .editorconfig または .clang-format 形式の構成ファイルに保存できます。

詳細は、既存のコードから書式ルールを学ぶを参照してください。

ネーミングスタイル

ReSharper は、コード内のシンボルの希望する命名スタイルを定義、制御、適用できます。一連のルールがあり、各ルールは一連の制約を持つ特定の識別子を対象としています。各ルールには、複合語、アンダースコア、サフィックス、プレフィックスなどの大文字化を定義する 1 つ以上の関連スタイルを含めることができます。

これらのルールは、ReSharper がコード補完およびコード生成機能を使用して新しいコードを生成し、コードテンプレートを適用し、リファクタリングを実行するときに考慮されます。ReSharper は、命名規則の違反を検出して修正するのにも役立ちます。必要に応じて、命名規則の自動チェックを構成または無効にできます。

ReSharper オプション Alt+R, O のコード編集 | C++ | ネーミングスタイルページで、ルールセットを定義済みの命名スタイルスキーム (STL、Google、LLVM、CamelCase、Microsoft) のいずれかにリセットできます。これらのスキームをそのまま使用することも、定義済みのスキームに基づいて独自のルールセットを構成することもできます。

UE4 プロジェクトで作業するの場合、ReSharper は、構成できない Unreal Engine コーディング標準(英語)に対応する命名ルールセットを自動的に適用します。つまり、UE4 プロジェクトで作業しているときは、ReSharper オプション Alt+R, O のコード編集 | C++ | ネーミングスタイルページで構成されたルールは無視されます。Unreal Engine コーディング標準の代わりに、構成済みのルールセットを引き続き使用したい場合は、対応するインスペクションを無効にすることができます。

cv 修飾子の配置

ReSharper を使用すると、cv-qualifiers を生成コードに配置できます。ReSharper オプションのコード編集 | C++ | コードスタイルページでは、型指定子の前後に cv 修飾子を置くかどうか、および const および volatile 修飾子の順序を指定できます。

ディレクティブスタイルを含める

ReSharper オプションのコード編集 | C++ | コードスタイルページでは、生成コードの include ディレクティブでパス区切り文字としてスラッシュを使用するかバックスラッシュを使用するかを指定できます。ヘッダーファイルで前方宣言を生成するかどうかを指定することもできます。

インクルードのソート

ReSharper では、#include ディレクティブをソートし、既存のグループを再配置し、空白行で区切られた新しいグループを作成できます。

キャレットが #include ディレクティブ上にある場合、#include ディレクティブを並べ替えるサブメニューには 3 つのコンテキストアクションがあります。

#include ディレクティブを並べ替える
#include ディレクティブの並べ替えと再グループ化	このアクションは、すべての #include グループを 1 つにマージしてから、それをソートし、構成された設定に従って新しいグループに分割します。
各 #include グループを個別に並べ替える	このアクションは、各グループ内の #include ディレクティブを個別にソートし、既存のグループ化を変更しません。
現在の #include グループのみを並べ替える	このアクションは、キャレットがオンになっているグループをソートします。

ReSharper オプション Alt+R, O のコード編集 | C++ | #include の順序ページで順序付けルールを設定できます。

ReSharper は、.clang-format ファイルからのソート設定のインポートをサポートしています。ReSharper オプション Alt+R, O のコード編集 | 一般的なフォーマッタスタイルページで .clang-format スタイルのコードスタイルフォームを読み取るがチェックされている場合、.clang-format ファイルの IncludeBlocks、IncludeCategories、IncludeIsMainRegex、SortIncludes 設定が、clang 形式と同じ方法で #include ディレクティブのソートに使用されます。

インクルードの並べ替えは、コードのクリーンアップでも適用できます。

デフォルトのポインタ初期化子のスタイル

0、nullptr、NULL を、ポインター初期化子の優先初期化子として指定できます（例: const char *foo = nullptr）。ReSharper オプションのコード編集 | C++ | コードスタイルページで設定を変更できます。

ファイルヘッダースタイル

コピーライト表示やその他の識別メッセージにファイルヘッダーを使用するのが一般的です。ReSharper を使用すると、デフォルトのヘッダーテキストを構成し、それをソースファイルに自動的に挿入したり、それを使用して既存のファイルヘッダーを置き換えたりすることができます。

ReSharper オプションまたは .editorconfig ファイル内 でファイルヘッダースタイルを構成し、それをファイルテンプレートで作成された新しいファイルに追加し、コードクリーンアップを使用して既存のファイルにファイルヘッダーを挿入または置換できます。

異なるチームメンバーが作成および編集したファイルが同じヘッダースタイルを持つようにするには、ファイルヘッダー設定をチームと共有します。