Prog/formatter/clang-format の履歴(No.3)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• Prog/formatter/clang-format へ行く。
  • 1 (2020-07-22 (水) 06:43:35)
  • 2 (2020-07-22 (水) 07:19:04)
  • 3 (2020-07-22 (水) 22:06:35)
  • 4 (2020-07-23 (木) 05:36:22)
  • 5 (2020-08-09 (日) 06:13:53)

---

目次†

書式オプション（抜粋）†

• clang-format で使用される書式設定ファイル .clang-format に記述するオプションについて記載する。

Language:†

AccessModifierOffset:†

AlignAfterOpenBracket:†

AlignConsecutiveAssignments:†

• 連続する行の代入式を = で整列するか否か
  • true : 整列する

       int32_t var_1           = 12;
       std::string var_2       = "foo";
       const char* const var_3 = "bar";

• false : 整列しない

     int32_t var_1 = 12;
     std::string var_2 = "foo";
     const char* const var_3 = "bar";

AlignConsecutiveDeclarations:†

• 連続する行の宣言の変数名を整列させるか否か
  • true : 整列する

       int32_t           var_11 = 12;
       std::string       var_2 = "foo";
       const char* const var_3 = "bar";

• false : 整列しない

     int32_t var_11 = 12;
     std::string var_2 = "foo";
     const char* const var_3 = "bar";

AlignEscapedNewlinesLeft:†

• エスケープされた改行の位置を調整する
  • true : 可能な限り左に寄せる

    #define LOG_PREFIX \
        "[DEBUG]"      \
        "[MODULE_A]"   \
        "[MOD_SUB_2]"

• false : column limit に配置する

  // ColumnLimit: 80 の場合
  #define LOG_PREFIX                                                             \
      "[DEBUG]"                                                                  \
      "[MODULE_A]"                                                               \
      "[MOD_SUB_2]"

AlignOperands:†

AlignTrailingComments:†

AllowAllParametersOfDeclarationOnNextLine:†

AllowShortBlocksOnASingleLine:†

• 短いブレース文を単一の行に押し込むか否か
• true : 単一行に押し込む

      if (arg > 10) { var_11 += arg; }

• false : 単一行に押し込まない

      if (arg > 10) {
          var_11 += arg;
      }

• 但し、以下のような構造体初期化文には効力がない模様

      st_aaa aaa = {
          0,
      };

AllowShortCaseLabelsOnASingleLine:†

AllowShortFunctionsOnASingleLine:†

AllowShortIfStatementsOnASingleLine:†

AllowShortLoopsOnASingleLine:†

AlwaysBreakAfterDefinitionReturnType:†

AlwaysBreakAfterReturnType:†

AlwaysBreakBeforeMultilineStrings:†

AlwaysBreakTemplateDeclarations:†

BinPackArguments:†

BinPackParameters:†

BraceWrapping:†

AfterClass:†

AfterControlStatement:†

AfterEnum:†

AfterFunction:†

AfterNamespace:†

AfterObjCDeclaration:†

AfterStruct:†

AfterUnion:†

BeforeCatch:†

BeforeElse:†

IndentBraces:†

BreakBeforeBinaryOperators:†

BreakBeforeBraces:†

• 波括弧 { } の改行の設定
• Attach
  • 波括弧は常に周囲のコンテキストにくっつける。

    enum HOGE_EN {
        EN_AAA,
        EN_ABC,
        EN_ZZZ,
    };
    
    struct st_aaa {
        int aaa[2];
        uint64_t ax;
    };
    
    void func(int arg) {
        // ...
        if (arg == 0) {
            // ...
        } else {
            // ...
        }
        return;
    }

• Linux
  • Attach に似るが、関数や名前空間、クラス定義の前は改行する。

    enum HOGE_EN {
        EN_AAA,
        EN_ABC,
        EN_ZZZ,
    };
    
    struct st_aaa {
        int aaa[2];
        uint64_t ax;
    };
    
    void func(int arg)
    {
        // ...
        if (arg == 0) {
            // ...
        } else {
            // ...
        }
        return;
    }

• Mozilla
  • Attach と似るが、 enum、関数定義などの前には改行する。

    enum HOGE_EN
    {
        EN_AAA,
        EN_ABC,
        EN_ZZZ,
    };
    
    struct st_aaa
    {
        int aaa[2];
        uint64_t ax;
    };
    
    void func(int arg)
    {
        // ...
        if (arg == 0) {
            // ...
        } else {
            // ...
        }
        return;
    }

• Stroustrup
  • Attach と似るが、catch, else などの前は改行する。

    enum HOGE_EN {
        EN_AAA,
        EN_ABC,
        EN_ZZZ,
    };
    
    struct st_aaa {
        int aaa[2];
        uint64_t ax;
    };
    
    void func(int arg)
    {
        // ...
        if (arg == 0) {
            // ...
        }
        else {
            // ...
        }
        return;
    }

• Allman
  • 波括弧の前は全て改行する。

    enum HOGE_EN
    {
        EN_AAA,
        EN_ABC,
        EN_ZZZ,
    };
    
    struct st_aaa
    {
        int aaa[2];
        uint64_t ax;
    };
    
    void func(int arg)
    {
        // ...
        if (arg == 0)
        {
            // ...
        }
        else
        {
            // ...
        }
        return;
    }

• GNU
  • 波括弧の前は全て改行するし、新たにインデントを加える。但し、クラス定義や関数定義などの場合は除く。

    enum HOGE_EN
    {
        EN_AAA,
        EN_ABC,
        EN_ZZZ,
    };
    
    struct st_aaa
    {
        int aaa[2];
        uint64_t ax;
    };
    
    void func(int arg)
    {
        // ...
        if (arg == 0)
            {
                // ...
            }
        else
            {
                // ...
            }
        return;
    }

BreakBeforeTernaryOperators:†

BreakConstructorInitializersBeforeComma:†

• コンストラクタの変数初期化のコンマの前で改行し、コンマとコロンを整列させるかどうか
• true

• false

ColumnLimit:†

• 行の長さの上限値。
• 0 に設定した場合は、上限なしとなる。

CommentPragmas:†

ConstructorInitializerAllOnOneLineOrOnePerLine:†

ConstructorInitializerIndentWidth:†

ContinuationIndentWidth:†

Cpp11BracedListStyle:†

DerivePointerAlignment:†

DisableFormat:†

ExperimentalAutoDetectBinPacking:†

ForEachMacros:†

IncludeCategories:†

-†

Priority:†

-†

Priority:†

-†

Priority:†

IndentCaseLabels:†

IndentWidth:†

IndentWrappedFunctionNames:†

KeepEmptyLinesAtTheStartOfBlocks:†

MacroBlockBegin:†

MacroBlockEnd:†

MaxEmptyLinesToKeep:†

NamespaceIndentation:†

ObjCBlockIndentWidth:†

ObjCSpaceAfterProperty:†

ObjCSpaceBeforeProtocolList:†

PenaltyBreakBeforeFirstCallParameter:†

PenaltyBreakComment:†

PenaltyBreakFirstLessLess:†

PenaltyBreakString:†

PenaltyExcessCharacter:†

PenaltyReturnTypeOnItsOwnLine:†

PointerAlignment:†

ReflowComments:†

SortIncludes:†

SpaceAfterCStyleCast:†

SpaceBeforeAssignmentOperators:†

SpaceBeforeParens:†

SpaceInEmptyParentheses:†

SpacesBeforeTrailingComments:†

SpacesInAngles:†

SpacesInContainerLiterals:†

SpacesInCStyleCastParentheses:†

SpacesInParentheses:†

SpacesInSquareBrackets:†

Standard:†

TabWidth:†

UseTab:†

参考リンク†

• ClangFormat — Algo13 2016.12.17 ドキュメント
• clang-format を イイ感じに設定する - def yasuharu519(self):