このページでは

C++コードのスタイル

Qt Creator は、ClangLibFormatライブラリを使用して、C++コードのフォーマットとインデントを自動的に行います。これは、プロジェクトまたは組織全体のコーディング・スタイルを強制します。

C++ エディターのグローバルなインデント設定を指定するには、Preferences >C++ >Code Style にアクセスしてください。

次の表では、使用可能な環境設定について説明します。

環境設定説明
Formatting mode選択します:
  • Indenting Only コードだけをインデントします。
  • Full Formatting Ctrl+Iキーボード・ショートカットを使用して、インデントの代わりにコードをフォーマットします。
  • Use Built-In Indenter ClangFormatをオフにします。
Ignore files greater than大きなファイルを無視して解析を速くする。解析するファイルの最大サイズを指定します。
Format while typing入力中にフォーマットを適用する。
Format edited code on file saveファイルを保存するときに、編集したコードにフォーマットを適用します。ファイルの保存中にこの設定を一時的に無効にするには、File にアクセスして、Save Without Formatting を選択します。
Use custom settingsすべてのプロジェクトの ClangFormat スタイルをグローバルに変更します。
Custom settings変更する設定を選択し、Copy を選択します。設定に名前を付け、OK を選択します。
ClangFormatClangFormat スタイル・オプションを編集します。ライブ・プレビューでは、設定によってインデントがどのように変わるかを確認できます。無効な値を入力すると、警告メッセージが表示されます。

組み込みインデントの使用

組み込みインデンターのコードスタイル設定

Formatting modeUse Built-In Indenter を選択すると、次の方法を指定できます:

  • TabキーとBackspaceキーの押下を解釈します。
  • インデンターが、最後にセミコロンを必要としない完全なステートメントとして解釈するマクロを追加します。
  • クラス、関数、ブロック、名前空間の内容をインデントする。
  • クラス、名前空間、列挙型、関数、ブロックの中括弧をインデントする。
  • switch文とその内容を制御する。
  • 継続行の整列
  • 型や宣言内のポインタ (*) や参照 (&) を、識別子や型名、左または右のconstvolatile キーワードにバインドする。

コンテンツに対する設定の指定

クラス内の public 文、protected 文、private 文、およびそれらに関連する宣言をインデントできます。

また、関数やブロック内の文や、名前空間内の宣言もインデントできます。

C++環境設定のコード・スタイル・タブにあるコンテンツ・タブ

中括弧の設定の指定

クラス、名前空間、列挙型、関数の宣言やコードブロックをインデントできます。

C++環境設定の「コード・スタイル」タブにある「中括弧」タブ

switch 文の設定の指定

switch文の中で、case文やdefault文、それらに関連する文やブロックをインデントすることができます。

C++環境設定のコード・スタイル・タブにある "switch "タブ

整列の指定

=+= のように、代入後のトークンに継続行を揃えるには、Align after assignments を選択します。General タブで、継続行の整列に関する追加設定を指定できます。

また、条件文にスペースを追加して、次の行と揃わないようにすることもできます。通常、これはif ステートメントにのみ影響します。

C++環境設定のコード・スタイル・タブにあるアライメント・タブ

ポインタと参照の結合

型や宣言のポインタ (*) や参照 (&) を、識別子や型名、左または右のconstvolatile キーワードにバインドするには、Pointers and References タブのチェックボックスを選択します。

*& の文字は、関数へのポインタと配列へのポインタの識別子に自動的にバインドされます。

C++環境設定のコード・スタイル・タブにある「ポインタと参照」タブ

コマンドラインからのClangFormatファイルの作成

ある定義済みのスタイルの設定オプションを持つ.clang-format ファイルをコマンドラインから作成できます。例えば、LLVMスタイルのフォーマット・ファイルを作成するには、次のコマンドを入力します:

clang-format -style=llvm -dump-config > .clang-format

テキストまたはコードのインデント」、「コード・スタイルの指定」、「ビヘイビア」、Qt Quick コード・スタイルの指定」、「Nim」も参照してください

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.