EmsiaetKadosh
185 lines
13 KiB
YAML
185 lines
13 KiB
YAML
|
|
BasedOnStyle: llvm
|
|
# https://clang.llvm.org/docs/ClangFormatStyleOptions.html
|
|
# https://www.cnblogs.com/PaulpauL/p/5929753.html
|
|
|
|
# Comments Macros:
|
|
# WIN = Whatever. If Needed, you can change it as you like.
|
|
# WSO = Whatever. If needed, you can change, but keep same in One code block.
|
|
# BTW = Better This but you can change as you like, Whatever.
|
|
#
|
|
# 在标识后紧跟默认值，再后跟所有可能取值
|
|
|
|
Language: Cpp
|
|
DisableFormat: false # WIN false, true 如果为true，不应用整理
|
|
|
|
AccessModifierOffset: -4 # or 0 public, private, protected的缩进
|
|
AlignAfterOpenBracket: false
|
|
AlignArrayOfStructures: None
|
|
AlignConsecutiveAssignments:
|
|
Enabled: false # WIN false, true
|
|
AcrossEmptyLines: true # WIN true, false 跨过空行一并对齐
|
|
AcrossComments: true # WIN true, false 跨过注释一并对齐
|
|
AlignCompound: false # WIN false, true += -=诸如此类运算符是否对齐
|
|
AlignFunctionPointers: true # WIN true, false 函数指针变量是否对齐
|
|
PadOperators: false # WIN false, true <<= >>=
|
|
AlignConsecutiveBitFields:
|
|
Enabled: false # WIN false, true
|
|
AcrossEmptyLines: true # WIN true, false 跨过空行一并对齐
|
|
AcrossComments: true # WIN true, false 跨过注释一并对齐
|
|
AlignConsecutiveDeclarations:
|
|
Enabled: false # WIN false, true
|
|
AcrossEmptyLines: true # WIN true, false 跨过空行一并对齐
|
|
AcrossComments: true # WIN true, false 跨过注释一并对齐
|
|
AlignConsecutiveMacros: false # WIN false, true
|
|
AlignConsecutiveShortCaseStatements:
|
|
Enabled: false # WIN false, true
|
|
AcrossEmptyLines: true # WIN true, false 跨过空行一并对齐
|
|
AcrossComments: true # WIN true, false 跨过注释一并对齐
|
|
AlignCaseColons: false # WIN false, true 是否对齐case VAL冒号
|
|
AlignEscapedNewlines: DontAlign # WIN false, true 是否对齐反斜杠\
|
|
AlignOperands: DontAlign
|
|
AlignTrailingComments:
|
|
Kind: Leave # BTW: Leave, Always|Never
|
|
OverEmptyLines: 1 # BTW: 1, 最多跨过多少行一并对对齐
|
|
AllowAllArgumentsOnNextLine: true # 如果false，强制把函数参数每个换行
|
|
AllowAllParametersOfDeclarationOnNextLine: true # 如果false，强制把函数形参每个换行
|
|
AllowBreakBeforeNoexceptSpecifier: Always # 是否允许复合noexcept换行 Never|OnlyWithParen
|
|
AllowShortBlocksOnASingleLine: Always # WIN Always, Empty|Never
|
|
AllowShortCaseLabelsOnASingleLine: false # WIN true, false
|
|
AllowShortCompoundRequirementOnASingleLine: true # BTW true, false
|
|
AllowShortEnumsOnASingleLine: true # WIN true, false
|
|
AllowShortFunctionsOnASingleLine: All # WIN All, None|InlineOnly|Empty|Inline
|
|
AllowShortIfStatementsOnASingleLine: AllIfsAndElse # WIN AllIfsAndElse, Never|WithoutElse|OnlyFirstIf
|
|
AllowShortLambdasOnASingleLine: All # BTW All, None|Empty|Inline
|
|
AllowShortLoopsOnASingleLine: true # WIN true, false
|
|
AlwaysBreakBeforeMultilineStrings: false # WIN false, true
|
|
AttributeMacros: [
|
|
'__capability',
|
|
'__output',
|
|
'__unused'
|
|
] # WIN, i dont know what this is.
|
|
BinPackArguments: true # WIN true, false
|
|
BinPackParameters: true # WIN true, false
|
|
BraceWrapping:
|
|
# WIN false, true
|
|
AfterCaseLabel: false
|
|
AfterClass: false
|
|
AfterControlStatement: Never # WIN Never, MultiLine|Always
|
|
AfterEnum: false
|
|
AfterFunction: false
|
|
AfterNamespace: false
|
|
AfterObjCDeclaration: false # Objective-C用，Cpp应该不用
|
|
AfterStruct: false
|
|
AfterUnion: false
|
|
AfterExternBlock: false
|
|
# WIN true, false
|
|
BeforeCatch: true
|
|
BeforeElse: true
|
|
BeforeLambdaBody: false # BTW false, true
|
|
BeforeWhile: true
|
|
# BTW false, true
|
|
IndentBraces: false # 仅当花括号换行时有效
|
|
SplitEmptyFunction: false # 如果为true，空函数右花括号}强制换行
|
|
SplitEmptyRecord: false # 如果为true，空类型class union union...右花括号}强制换行
|
|
SplitEmptyNamespace: false # 如果为true，空namespace右花括号}强制换行
|
|
BracedInitializerIndentWidth: 4 # 如果该项不存在，则使用ContinuationIndentWidth
|
|
BreakAdjacentStringLiterals: false # WIN false, true 是否给连续字面char[]""换行
|
|
BreakAfterAttributes: Leave # WIN Leave, Always|Never 是否对[[]]后换行，尽可能不换行
|
|
BreakAfterJavaFieldAnnotations: false
|
|
# BreakArrays: true 似乎非C++
|
|
BreakBeforeBinaryOperators: All # BTW All, None|NonAssignment
|
|
# BTW Attach,
|
|
# Linux Break function, namespace, class
|
|
# |Mozilla Break enum, function, class, struct, union
|
|
# |Stroustrup Break function, catch, else(?)
|
|
# |Allman Break all
|
|
# |Whitesmiths Break and indent all
|
|
# |GNU Break all, extra indent control statements
|
|
# |WebKit Break function
|
|
# |Custom 根据BraceWrapping指定行为
|
|
BreakBeforeBraces: Attach
|
|
BreakBeforeInlineASMColon: Never # WIN Never, OnlyMultiline|Always
|
|
BreakBeforeTernaryOperators: true # 如果为true，三元运算符需要换行时将运算符置于下一行开头而非上一行末尾
|
|
# WIN AfterColon, 将冒号和逗号至于上一行行尾
|
|
# BeforeColon 将冒号置于下一行开头，逗号置于上一行行尾
|
|
# |BeforeComma 将冒号、逗号都置于下一行开头
|
|
BreakConstructorInitializers: AfterColon
|
|
# BreakFunctionDefinitionParameters: false # 如果true，函数定义中的形参永远换行，好像不能用
|
|
# WIN AfterColon, 将冒号和逗号至于上一行行尾
|
|
# BeforeColon 将冒号置于下一行开头，逗号置于上一行行尾
|
|
# |BeforeComma 将冒号、逗号都置于下一行开头
|
|
# |AfterComma 第一行的冒号不换行，只在所有的逗号后面换行
|
|
BreakInheritanceList: AfterColon
|
|
BreakStringLiterals: false # WIN false, true 如果为true，过长的字符串会被换行
|
|
# BreakTemplateDeclarations: No # WIN No, Leave|MultiLine|Yes，好像不能用
|
|
AlwaysBreakTemplateDeclarations: false
|
|
ColumnLimit: 0 # BTW 0 设置代码宽度，0为忽略。应该会用于判断是否要换行
|
|
# 如果为true，可以在文件头标注 // CommentPragmas: '^ FOOBAR pragma:'
|
|
# 那么以后的诸如// FOOBAR pragma: 开头的注释不会被换行
|
|
CommentPragmas: true
|
|
CompactNamespaces: false # BTW false, true 如果为true，连续的namespace声明会被放在同一行里，除非太长
|
|
# 构造函数参数列表和继承列表的缩进
|
|
ConstructorInitializerIndentWidth: 4 # 4 or 2，尽量与IndentWidth一致
|
|
ContinuationIndentWidth: 2 # 4 or 2，尽量与IndentWidth一致
|
|
Cpp11BracedListStyle: false # 如果为false，花括号里有东西的时候，会在左花括号右侧、右花括号左侧插入空格
|
|
# BTW false, true
|
|
# 如果为true，会检查文件里最常出现的一种&和*的安排方式，然后统一；
|
|
# PointerAlignment指定的选项时备选
|
|
DerivePointerAlignment: false
|
|
# WIN Leave, public protected private后是否要插入空行
|
|
# Never|Always
|
|
# |(仅*After*)LogicalBlock 如果没有指定任何东西的访问权限，那么就不插入空行
|
|
# 根据代码复杂度决定是否要留空行。可以不固定
|
|
EmptyLineAfterAccessModifier: Leave
|
|
EmptyLineBeforeAccessModifier: Leave
|
|
# WIN false, true
|
|
# 在namespace的右花括号后加入注释。
|
|
# 如果namespace短于ShortNamespaceLines规定的值，就不添加
|
|
# 根据需要
|
|
FixNamespaceComments: false
|
|
# BTW Preserve, 中间没有空行的include一起整理
|
|
# Merge 无视空行，全部一起整理
|
|
# |Regroup 按照<>和""重新分组整理
|
|
IncludeBlocks: Preserve
|
|
|
|
|
|
|
|
|
|
|
|
IndentCaseLabels: true
|
|
IndentExternBlock: Indent
|
|
IndentWidth: 2
|
|
InsertNewlineAtEOF: true
|
|
KeepEmptyLinesAtEOF: true
|
|
LineEnding: CRLF
|
|
NamespaceIndentation: All # WIN
|
|
PackConstructorInitializers: NextLine
|
|
PenaltyBreakTemplateDeclaration: 4294967295
|
|
PointerAlignment: Left
|
|
ReferenceAlignment: Left
|
|
ReflowComments: false
|
|
RemoveSemicolon: true # WIN
|
|
RequiresClausePosition: SingleLine
|
|
SeparateDefinitionBlocks: Always
|
|
SortIncludes: Never # BTW: Never，有时候includes必须要按照一定的顺序。
|
|
SortUsingDeclarations: Lexicographic
|
|
SpaceAfterCStyleCast: true
|
|
SpaceAfterTemplateKeyword: false # WSO
|
|
SpaceAroundPointerQualifiers: Before # WSO
|
|
SpacesBeforeTrailingComments: 0 # Better 1; 0 ok, 2+ better not.
|
|
Standard: Latest
|
|
TabWidth: 2 # 4 or 2, WSO
|
|
# UseTab possible values:
|
|
# Never
|
|
# ForIndentation
|
|
# ForContinuationAndIndentation
|
|
# AlignWithSpaces
|
|
# Always
|
|
# 如果使用Tab缩进对齐，整理原理是：
|
|
# 使用Tab符替换空格，缩进一定是4，每TabWidth个空格替换为一个Tab。
|
|
# 也就是说，如果TabWidth是2，那么每次缩进会使用2个Tab。
|
|
# 使用Tab时，请一定把TabWidth设为4。
|
|
UseTab: Always # WIN
|
|
|