.clang-format 7.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. #
  2. # clang-format configuration file. Intended for clang-format >= 4.
  3. #
  4. # For more information, see:
  5. #
  6. # https://clang.llvm.org/docs/ClangFormat.html
  7. # https://clang.llvm.org/docs/ClangFormatStyleOptions.html
  8. #
  9. # 语言: None, Cpp, Java, JavaScript, ObjC, Proto, TableGen, TextProto
  10. Language: Cpp
  11. BasedOnStyle: Google
  12. # 访问说明符(public、private等)的偏移
  13. AccessModifierOffset: -4
  14. # 开括号(开圆括号、开尖括号、开方括号)后的对齐: Align, DontAlign, AlwaysBreak(总是在开括号后换行)
  15. AlignAfterOpenBracket: Align
  16. # 连续赋值时,对齐所有等号
  17. AlignConsecutiveAssignments: AcrossEmptyLinesAndComments
  18. # 连续声明时,对齐所有声明的变量名
  19. AlignConsecutiveDeclarations: AcrossEmptyLinesAndComments
  20. # 水平对齐二元和三元表达式的操作数
  21. AlignOperands: AlignAfterOperator
  22. # 对齐连续的尾随的注释
  23. AlignTrailingComments: true
  24. # 允许函数声明的所有参数在放在下一行
  25. AllowAllParametersOfDeclarationOnNextLine: false
  26. # 允许短的块放在同一行
  27. AllowShortBlocksOnASingleLine: Never
  28. # 允许短的case标签放在同一行
  29. AllowShortCaseLabelsOnASingleLine: false
  30. # 允许短的函数放在同一行: None, InlineOnly(定义在类中), Empty(空函数), Inline(定义在类中,空函数), All
  31. AllowShortFunctionsOnASingleLine: Empty
  32. # 允许短的if语句保持在同一行
  33. AllowShortIfStatementsOnASingleLine: false
  34. # 允许短的循环保持在同一行
  35. AllowShortLoopsOnASingleLine: false
  36. # 总是在定义返回类型后换行(deprecated)
  37. AlwaysBreakAfterDefinitionReturnType: None
  38. # 总是在返回类型后换行: None, All, TopLevel(顶级函数,不包括在类中的函数),
  39. # AllDefinitions(所有的定义,不包括声明), TopLevelDefinitions(所有的顶级函数的定义)
  40. AlwaysBreakAfterReturnType: None
  41. # 总是在多行string字面量前换行
  42. AlwaysBreakBeforeMultilineStrings: false
  43. # 总是在template声明后换行
  44. AlwaysBreakTemplateDeclarations: Yes
  45. # false表示函数实参要么都在同一行,要么都各自一行
  46. BinPackArguments: true
  47. # false表示所有形参要么都在同一行,要么都各自一行
  48. BinPackParameters: true
  49. # 大括号换行,只有当BreakBeforeBraces设置为Custom时才有效
  50. BraceWrapping:
  51. # class定义后面
  52. AfterClass: false
  53. # 控制语句后面
  54. AfterControlStatement: Never
  55. # enum定义后面
  56. AfterEnum: false
  57. # 函数定义后面
  58. AfterFunction: true
  59. # 命名空间定义后面
  60. AfterNamespace: false
  61. # ObjC定义后面
  62. AfterObjCDeclaration: false
  63. # struct定义后面
  64. AfterStruct: false
  65. # union定义后面
  66. AfterUnion: false
  67. # catch之前
  68. BeforeCatch: false
  69. # else之前
  70. BeforeElse: false
  71. # 缩进大括号
  72. IndentBraces: false
  73. # 在二元运算符前换行: None(在操作符后换行), NonAssignment(在非赋值的操作符前换行), All(在操作符前换行)
  74. BreakBeforeBinaryOperators: NonAssignment
  75. # 在大括号前换行: Attach(始终将大括号附加到周围的上下文), Linux(除函数、命名空间和类定义,与Attach类似),
  76. # Mozilla(除枚举、函数、记录定义,与Attach类似), Stroustrup(除函数定义、catch、else,与Attach类似),
  77. # Allman(总是在大括号前换行), GNU(总是在大括号前换行,并对于控制语句的大括号增加额外的缩进), WebKit(在函数前换行), Custom
  78. # 注:这里认为语句块也属于函数
  79. BreakBeforeBraces: Custom
  80. # 在三元运算符前换行
  81. BreakBeforeTernaryOperators: true
  82. # 在构造函数的初始化列表的逗号前换行
  83. BreakConstructorInitializersBeforeComma: true
  84. # 每行字符的限制,0表示没有限制
  85. ColumnLimit: 100
  86. # 描述具有特殊意义的注释的正则表达式,它不应该被分割为多行或以其它方式改变
  87. CommentPragmas: '^ IWYU pragma:'
  88. # 构造函数的初始化列表要么都在同一行,要么都各自一行
  89. ConstructorInitializerAllOnOneLineOrOnePerLine: false
  90. # 构造函数的初始化列表的缩进宽度
  91. ConstructorInitializerIndentWidth: 4
  92. # 延续的行的缩进宽度
  93. ContinuationIndentWidth: 4
  94. # 去除C++11的列表初始化的大括号{后和}前的空格
  95. Cpp11BracedListStyle: false
  96. # 继承最常用的指针和引用的对齐方式
  97. DerivePointerAlignment: false
  98. # 关闭格式化
  99. DisableFormat: false
  100. # 自动检测函数的调用和定义是否被格式为每行一个参数(Experimental)
  101. ExperimentalAutoDetectBinPacking: false
  102. # 需要被解读为foreach循环而不是函数调用的宏
  103. ForEachMacros: [ foreach, Q_FOREACH, BOOST_FOREACH ]
  104. # 对#include进行排序,匹配了某正则表达式的#include拥有对应的优先级,匹配不到的则默认优先级为INT_MAX(优先级越小排序越靠前),
  105. # 可以定义负数优先级从而保证某些#include永远在最前面
  106. IncludeCategories:
  107. - Regex: '^"(llvm|llvm-c|clang|clang-c)/'
  108. Priority: 2
  109. - Regex: '^(<|"(gtest|isl|json)/)'
  110. Priority: 3
  111. - Regex: '.*'
  112. Priority: 1
  113. # 缩进case标签
  114. IndentCaseLabels: true
  115. # 缩进宽度
  116. IndentWidth: 4
  117. # 函数返回类型换行时,缩进函数声明或函数定义的函数名
  118. IndentWrappedFunctionNames: false
  119. # 保留在块开始处的空行
  120. KeepEmptyLinesAtTheStartOfBlocks: false
  121. # 开始一个块的宏的正则表达式
  122. MacroBlockBegin: ''
  123. # 结束一个块的宏的正则表达式
  124. MacroBlockEnd: ''
  125. # 连续空行的最大数量
  126. MaxEmptyLinesToKeep: 1
  127. # 命名空间的缩进: None, Inner(缩进嵌套的命名空间中的内容), All
  128. NamespaceIndentation: All
  129. # 使用ObjC块时缩进宽度
  130. ObjCBlockIndentWidth: 4
  131. # 在ObjC的@property后添加一个空格
  132. ObjCSpaceAfterProperty: false
  133. # 在ObjC的protocol列表前添加一个空格
  134. ObjCSpaceBeforeProtocolList: true
  135. # 在call(后对函数调用换行的penalty
  136. PenaltyBreakBeforeFirstCallParameter: 19
  137. # 在一个注释中引入换行的penalty
  138. PenaltyBreakComment: 300
  139. # 第一次在<<前换行的penalty
  140. PenaltyBreakFirstLessLess: 120
  141. # 在一个字符串字面量中引入换行的penalty
  142. PenaltyBreakString: 1000
  143. # 对于每个在行字符数限制之外的字符的penalty
  144. PenaltyExcessCharacter: 1000000
  145. # 将函数的返回类型放到它自己的行的penalty
  146. PenaltyReturnTypeOnItsOwnLine: 60
  147. # 指针和引用的对齐: Left, Right, Middle
  148. PointerAlignment: Left
  149. # 允许重新排版注释
  150. ReflowComments: true
  151. # 允许排序#include
  152. SortIncludes: Never
  153. # 在C风格类型转换后添加空格
  154. SpaceAfterCStyleCast: false
  155. # 在赋值运算符之前添加空格
  156. SpaceBeforeAssignmentOperators: true
  157. # 开圆括号之前添加一个空格: Never, ControlStatements, Always
  158. SpaceBeforeParens: Never
  159. # 在空的圆括号中添加空格
  160. SpaceInEmptyParentheses: false
  161. # 在尾随的评论前添加的空格数(只适用于//)
  162. SpacesBeforeTrailingComments: 1
  163. # 在尖括号的<后和>前添加空格
  164. SpacesInAngles: false
  165. # 在容器(ObjC和JavaScript的数组和字典等)字面量中添加空格
  166. SpacesInContainerLiterals: false
  167. # 在C风格类型转换的括号中添加空格
  168. SpacesInCStyleCastParentheses: false
  169. # 在圆括号的(后和)前添加空格
  170. SpacesInParentheses: false
  171. # 在方括号的[后和]前添加空格,lamda表达式和未指明大小的数组的声明不受影响
  172. SpacesInSquareBrackets: false
  173. # 标准: Cpp03, Cpp11, Auto
  174. Standard: c++11
  175. # tab宽度
  176. TabWidth: 4
  177. # 使用tab字符: Never, ForIndentation, ForContinuationAndIndentation, Always
  178. UseTab: Always