diff --git a/.clang-format b/.clang-format index 58f5dab..5b37407 100644 --- a/.clang-format +++ b/.clang-format @@ -5,77 +5,26 @@ DisableFormat: false # 语言: None, Cpp, Java, JavaScript, ObjC, Proto, TableGen, TextProto Language: Cpp -BasedOnStyle: WebKit - # 标准: Cpp03, Cpp11, Auto Standard: Cpp11 +BasedOnStyle: WebKit + +# 每行字符的限制,0表示没有限制 +ColumnLimit: 160 + # tab宽度 TabWidth: 4 # 使用tab字符: Never, ForIndentation, ForContinuationAndIndentation, Always UseTab: Never -# 每行字符的限制,0表示没有限制 -ColumnLimit: 160 - -# 访问说明符(public、private等)的偏移 -AccessModifierOffset: -4 - # 开括号(开圆括号、开尖括号、开方括号)后的对齐: Align, DontAlign, AlwaysBreak(总是在开括号后换行) AlignAfterOpenBracket: AlwaysBreak -# 连续赋值时,对齐所有等号 -AlignConsecutiveAssignments: false - -# 连续声明时,对齐所有声明的变量名 -AlignConsecutiveDeclarations: true - # 左对齐逃脱换行(使用反斜杠换行)的反斜杠 AlignEscapedNewlines: Right -# 水平对齐二元和三元表达式的操作数 -AlignOperands: true - -# 对齐连续的尾随的注释 -AlignTrailingComments: true - -# 允许函数声明的所有参数在放在下一行 -AllowAllParametersOfDeclarationOnNextLine: false - -# 允许短的块放在同一行 -AllowShortBlocksOnASingleLine: true - -# 允许短的case标签放在同一行 -AllowShortCaseLabelsOnASingleLine: false - -# 允许短的函数放在同一行: None, InlineOnly(定义在类中), Empty(空函数), Inline(定义在类中,空函数), All -AllowShortFunctionsOnASingleLine: None - -# 允许短的if语句保持在同一行 -AllowShortIfStatementsOnASingleLine: false - -# 允许短的循环保持在同一行 -AllowShortLoopsOnASingleLine: false - -# 总是在定义返回类型后换行(deprecated) -AlwaysBreakAfterDefinitionReturnType: None - -# 总是在返回类型后换行: None, All, TopLevel(顶级函数,不包括在类中的函数), -# AllDefinitions(所有的定义,不包括声明), TopLevelDefinitions(所有的顶级函数的定义) -AlwaysBreakAfterReturnType: None - -# 总是在多行string字面量前换行 -AlwaysBreakBeforeMultilineStrings: false - -# 总是在template声明后换行 -AlwaysBreakTemplateDeclarations: true - -# false表示函数实参要么都在同一行,要么都各自一行 -BinPackArguments: false - -# false表示所有形参要么都在同一行,要么都各自一行 -BinPackParameters: false # 在大括号前换行: Attach(始终将大括号附加到周围的上下文), Linux(除函数、命名空间和类定义,与Attach类似), # Mozilla(除枚举、函数、记录定义,与Attach类似), Stroustrup(除函数定义、catch、else,与Attach类似), @@ -109,70 +58,42 @@ BraceWrapping: # 缩进大括号 IndentBraces: false -# SplitEmptyFunction: true - -# SplitEmptyRecord: true - -# SplitEmptyNamespace: true - -# 在二元运算符前换行: None(在操作符后换行), NonAssignment(在非赋值的操作符前换行), All(在操作符前换行) -BreakBeforeBinaryOperators: All - + # 继承列表的逗号前换行 BreakBeforeInheritanceComma: true # 继承列表换行 #BreakInheritanceList: BeforeColon -# 在三元运算符前换行 -BreakBeforeTernaryOperators: true - # 在构造函数的初始化列表的逗号前换行 BreakConstructorInitializersBeforeComma: true # 初始化列表前换行 BreakConstructorInitializers: BeforeComma -# Java注解后换行 -BreakAfterJavaFieldAnnotations: true - -BreakStringLiterals: true +# 总是在template声明后换行 +AlwaysBreakTemplateDeclarations: true # 描述具有特殊意义的注释的正则表达式,它不应该被分割为多行或以其它方式改变 CommentPragmas: '^ IWYU pragma:' -# 紧凑 命名空间 -CompactNamespaces: false - -# 构造函数的初始化列表要么都在同一行,要么都各自一行 -ConstructorInitializerAllOnOneLineOrOnePerLine: false - -# 构造函数的初始化列表的缩进宽度 -ConstructorInitializerIndentWidth: 4 - -# 延续的行的缩进宽度 -ContinuationIndentWidth: 4 - -# 去除C++11的列表初始化的大括号{后和}前的空格 -Cpp11BracedListStyle: false - -# 继承最常用的指针和引用的对齐方式 -DerivePointerAlignment: false - -# 自动检测函数的调用和定义是否被格式为每行一个参数(Experimental) -ExperimentalAutoDetectBinPacking: false - # 固定命名空间注释 FixNamespaceComments: true +# 对齐连续的尾随的注释 +AlignTrailingComments: true + +# 允许短的函数放在同一行: None, InlineOnly(定义在类中), Empty(空函数), Inline(定义在类中,空函数), All +AllowShortFunctionsOnASingleLine: Empty + # 需要被解读为foreach循环而不是函数调用的宏 ForEachMacros: - foreach - Q_FOREACH - BOOST_FOREACH -IncludeBlocks: Preserve +IncludeBlocks: Preserve # 对#include进行排序,匹配了某正则表达式的#include拥有对应的优先级,匹配不到的则默认优先级为INT_MAX(优先级越小排序越靠前), # 可以定义负数优先级从而保证某些#include永远在最前面 IncludeCategories: @@ -185,123 +106,4 @@ IncludeCategories: - Regex: '.*' Priority: 1 -IncludeIsMainRegex: '(Test)?$' - -# 缩进case标签 -IndentCaseLabels: true - -IndentPPDirectives: None - -# 缩进宽度 -IndentWidth: 4 - -# 函数返回类型换行时,缩进函数声明或函数定义的函数名 -IndentWrappedFunctionNames: true - -JavaScriptQuotes: Leave - -JavaScriptWrapImports: true -# KeepLineBreaksForNonEmptyLines: false - -# 保留在块开始处的空行 -KeepEmptyLinesAtTheStartOfBlocks: true - -# 开始一个块的宏的正则表达式 -MacroBlockBegin: '' - -# 结束一个块的宏的正则表达式 -MacroBlockEnd: '' - -# 连续空行的最大数量 -MaxEmptyLinesToKeep: 1 - -# 命名空间的缩进: None, Inner(缩进嵌套的命名空间中的内容), All -NamespaceIndentation: All - -#ObjCBinPackProtocolList: Auto - -# 使用ObjC块时缩进宽度 -ObjCBlockIndentWidth: 4 - -# 在ObjC的@property后添加一个空格 -ObjCSpaceAfterProperty: true - -# 在ObjC的protocol列表前添加一个空格 -ObjCSpaceBeforeProtocolList: true - -PenaltyBreakAssignment: 2 - -PenaltyBreakBeforeFirstCallParameter: 19 - -# 在一个注释中引入换行的penalty -PenaltyBreakComment: 300 - -# 第一次在<<前换行的penalty -PenaltyBreakFirstLessLess: 120 - -# 在一个字符串字面量中引入换行的penalty -PenaltyBreakString: 1000 - -#PenaltyBreakTemplateDeclaration: 10 - -# 对于每个在行字符数限制之外的字符的penalty -PenaltyExcessCharacter: 1000000 - -# 将函数的返回类型放到它自己的行的penalty -PenaltyReturnTypeOnItsOwnLine: 60 - -# 指针和引用的对齐: Left, Right, Middle -PointerAlignment: Right - -#RawStringFormats: -# - Delimiter: pb -# Language: TextProto -# BasedOnStyle: google - -# 允许重新排版注释 -ReflowComments: false - -# 允许排序#include -SortIncludes: true - -SortUsingDeclarations: true - -# 在C风格类型转换后添加空格 -SpaceAfterCStyleCast: false - -# 模板关键字后面添加空格 -SpaceAfterTemplateKeyword: true - -# 在赋值运算符之前添加空格 -SpaceBeforeAssignmentOperators: true - -# 开圆括号之前添加一个空格: Never, ControlStatements, Always -#SpaceBeforeCpp11BracedList: false -#SpaceBeforeCtorInitializerColon: true -#SpaceBeforeInheritanceColon: true -SpaceBeforeParens: ControlStatements -#SpaceBeforeRangeBasedForLoopColon: true - -# 在空的圆括号中添加空格 -SpaceInEmptyParentheses: false - -# 在尾随的评论前添加的空格数(只适用于//) -SpacesBeforeTrailingComments: 1 - -# 在尖括号的<后和>前添加空格 -SpacesInAngles: false - -# 在容器(ObjC和JavaScript的数组和字典等)字面量中添加空格 -SpacesInContainerLiterals: true - -# 在C风格类型转换的括号中添加空格 -SpacesInCStyleCastParentheses: false - -# 在圆括号的(后和)前添加空格 -SpacesInParentheses: false - -# 在方括号的[后和]前添加空格,lamda表达式和未指明大小的数组的声明不受影响 -SpacesInSquareBrackets: false - - ... diff --git a/.clang-format-all b/.clang-format-all new file mode 100644 index 0000000..58f5dab --- /dev/null +++ b/.clang-format-all @@ -0,0 +1,307 @@ +--- +# 关闭格式化 +DisableFormat: false + +# 语言: None, Cpp, Java, JavaScript, ObjC, Proto, TableGen, TextProto +Language: Cpp + +BasedOnStyle: WebKit + +# 标准: Cpp03, Cpp11, Auto +Standard: Cpp11 + +# tab宽度 +TabWidth: 4 + +# 使用tab字符: Never, ForIndentation, ForContinuationAndIndentation, Always +UseTab: Never + +# 每行字符的限制,0表示没有限制 +ColumnLimit: 160 + +# 访问说明符(public、private等)的偏移 +AccessModifierOffset: -4 + +# 开括号(开圆括号、开尖括号、开方括号)后的对齐: Align, DontAlign, AlwaysBreak(总是在开括号后换行) +AlignAfterOpenBracket: AlwaysBreak + +# 连续赋值时,对齐所有等号 +AlignConsecutiveAssignments: false + +# 连续声明时,对齐所有声明的变量名 +AlignConsecutiveDeclarations: true + +# 左对齐逃脱换行(使用反斜杠换行)的反斜杠 +AlignEscapedNewlines: Right + +# 水平对齐二元和三元表达式的操作数 +AlignOperands: true + +# 对齐连续的尾随的注释 +AlignTrailingComments: true + +# 允许函数声明的所有参数在放在下一行 +AllowAllParametersOfDeclarationOnNextLine: false + +# 允许短的块放在同一行 +AllowShortBlocksOnASingleLine: true + +# 允许短的case标签放在同一行 +AllowShortCaseLabelsOnASingleLine: false + +# 允许短的函数放在同一行: None, InlineOnly(定义在类中), Empty(空函数), Inline(定义在类中,空函数), All +AllowShortFunctionsOnASingleLine: None + +# 允许短的if语句保持在同一行 +AllowShortIfStatementsOnASingleLine: false + +# 允许短的循环保持在同一行 +AllowShortLoopsOnASingleLine: false + +# 总是在定义返回类型后换行(deprecated) +AlwaysBreakAfterDefinitionReturnType: None + +# 总是在返回类型后换行: None, All, TopLevel(顶级函数,不包括在类中的函数), +# AllDefinitions(所有的定义,不包括声明), TopLevelDefinitions(所有的顶级函数的定义) +AlwaysBreakAfterReturnType: None + +# 总是在多行string字面量前换行 +AlwaysBreakBeforeMultilineStrings: false + +# 总是在template声明后换行 +AlwaysBreakTemplateDeclarations: true + +# false表示函数实参要么都在同一行,要么都各自一行 +BinPackArguments: false + +# false表示所有形参要么都在同一行,要么都各自一行 +BinPackParameters: false + +# 在大括号前换行: Attach(始终将大括号附加到周围的上下文), Linux(除函数、命名空间和类定义,与Attach类似), +# Mozilla(除枚举、函数、记录定义,与Attach类似), Stroustrup(除函数定义、catch、else,与Attach类似), +# Allman(总是在大括号前换行), GNU(总是在大括号前换行,并对于控制语句的大括号增加额外的缩进), WebKit(在函数前换行), Custom +# 注:这里认为语句块也属于函数 +BreakBeforeBraces: Custom +# 大括号换行,只有当BreakBeforeBraces设置为Custom时才有效 +BraceWrapping: + # class定义后面 + AfterClass: true + # 控制语句后面 + AfterControlStatement: true + # enum定义后面 + AfterEnum: true + # 函数定义后面 + AfterFunction: true + # 命名空间定义后面 + AfterNamespace: true + # ObjC定义后面 + AfterObjCDeclaration: true + # struct定义后面 + AfterStruct: true + # union定义后面 + AfterUnion: true + # extern 定义后面 + AfterExternBlock: true + # catch之前 + BeforeCatch: true + # else 之前 + BeforeElse: true + # 缩进大括号 + IndentBraces: false + +# SplitEmptyFunction: true + +# SplitEmptyRecord: true + +# SplitEmptyNamespace: true + +# 在二元运算符前换行: None(在操作符后换行), NonAssignment(在非赋值的操作符前换行), All(在操作符前换行) +BreakBeforeBinaryOperators: All + +# 继承列表的逗号前换行 +BreakBeforeInheritanceComma: true + +# 继承列表换行 +#BreakInheritanceList: BeforeColon + +# 在三元运算符前换行 +BreakBeforeTernaryOperators: true + +# 在构造函数的初始化列表的逗号前换行 +BreakConstructorInitializersBeforeComma: true + +# 初始化列表前换行 +BreakConstructorInitializers: BeforeComma + +# Java注解后换行 +BreakAfterJavaFieldAnnotations: true + +BreakStringLiterals: true + +# 描述具有特殊意义的注释的正则表达式,它不应该被分割为多行或以其它方式改变 +CommentPragmas: '^ IWYU pragma:' + +# 紧凑 命名空间 +CompactNamespaces: false + +# 构造函数的初始化列表要么都在同一行,要么都各自一行 +ConstructorInitializerAllOnOneLineOrOnePerLine: false + +# 构造函数的初始化列表的缩进宽度 +ConstructorInitializerIndentWidth: 4 + +# 延续的行的缩进宽度 +ContinuationIndentWidth: 4 + +# 去除C++11的列表初始化的大括号{后和}前的空格 +Cpp11BracedListStyle: false + +# 继承最常用的指针和引用的对齐方式 +DerivePointerAlignment: false + +# 自动检测函数的调用和定义是否被格式为每行一个参数(Experimental) +ExperimentalAutoDetectBinPacking: false + +# 固定命名空间注释 +FixNamespaceComments: true + +# 需要被解读为foreach循环而不是函数调用的宏 +ForEachMacros: + - foreach + - Q_FOREACH + - BOOST_FOREACH + +IncludeBlocks: Preserve + +# 对#include进行排序,匹配了某正则表达式的#include拥有对应的优先级,匹配不到的则默认优先级为INT_MAX(优先级越小排序越靠前), +# 可以定义负数优先级从而保证某些#include永远在最前面 +IncludeCategories: + - Regex: '^"(llvm|llvm-c|clang|clang-c)/' + Priority: 2 + - Regex: '^(<|"(gtest|gmock|isl|json)/)' + Priority: 3 + - Regex: 'stdafx\.' + Priority: 1 + - Regex: '.*' + Priority: 1 + +IncludeIsMainRegex: '(Test)?$' + +# 缩进case标签 +IndentCaseLabels: true + +IndentPPDirectives: None + +# 缩进宽度 +IndentWidth: 4 + +# 函数返回类型换行时,缩进函数声明或函数定义的函数名 +IndentWrappedFunctionNames: true + +JavaScriptQuotes: Leave + +JavaScriptWrapImports: true +# KeepLineBreaksForNonEmptyLines: false + +# 保留在块开始处的空行 +KeepEmptyLinesAtTheStartOfBlocks: true + +# 开始一个块的宏的正则表达式 +MacroBlockBegin: '' + +# 结束一个块的宏的正则表达式 +MacroBlockEnd: '' + +# 连续空行的最大数量 +MaxEmptyLinesToKeep: 1 + +# 命名空间的缩进: None, Inner(缩进嵌套的命名空间中的内容), All +NamespaceIndentation: All + +#ObjCBinPackProtocolList: Auto + +# 使用ObjC块时缩进宽度 +ObjCBlockIndentWidth: 4 + +# 在ObjC的@property后添加一个空格 +ObjCSpaceAfterProperty: true + +# 在ObjC的protocol列表前添加一个空格 +ObjCSpaceBeforeProtocolList: true + +PenaltyBreakAssignment: 2 + +PenaltyBreakBeforeFirstCallParameter: 19 + +# 在一个注释中引入换行的penalty +PenaltyBreakComment: 300 + +# 第一次在<<前换行的penalty +PenaltyBreakFirstLessLess: 120 + +# 在一个字符串字面量中引入换行的penalty +PenaltyBreakString: 1000 + +#PenaltyBreakTemplateDeclaration: 10 + +# 对于每个在行字符数限制之外的字符的penalty +PenaltyExcessCharacter: 1000000 + +# 将函数的返回类型放到它自己的行的penalty +PenaltyReturnTypeOnItsOwnLine: 60 + +# 指针和引用的对齐: Left, Right, Middle +PointerAlignment: Right + +#RawStringFormats: +# - Delimiter: pb +# Language: TextProto +# BasedOnStyle: google + +# 允许重新排版注释 +ReflowComments: false + +# 允许排序#include +SortIncludes: true + +SortUsingDeclarations: true + +# 在C风格类型转换后添加空格 +SpaceAfterCStyleCast: false + +# 模板关键字后面添加空格 +SpaceAfterTemplateKeyword: true + +# 在赋值运算符之前添加空格 +SpaceBeforeAssignmentOperators: true + +# 开圆括号之前添加一个空格: Never, ControlStatements, Always +#SpaceBeforeCpp11BracedList: false +#SpaceBeforeCtorInitializerColon: true +#SpaceBeforeInheritanceColon: true +SpaceBeforeParens: ControlStatements +#SpaceBeforeRangeBasedForLoopColon: true + +# 在空的圆括号中添加空格 +SpaceInEmptyParentheses: false + +# 在尾随的评论前添加的空格数(只适用于//) +SpacesBeforeTrailingComments: 1 + +# 在尖括号的<后和>前添加空格 +SpacesInAngles: false + +# 在容器(ObjC和JavaScript的数组和字典等)字面量中添加空格 +SpacesInContainerLiterals: true + +# 在C风格类型转换的括号中添加空格 +SpacesInCStyleCastParentheses: false + +# 在圆括号的(后和)前添加空格 +SpacesInParentheses: false + +# 在方括号的[后和]前添加空格,lamda表达式和未指明大小的数组的声明不受影响 +SpacesInSquareBrackets: false + + +...