uncrustify配置里那些让人眼花缭乱的选项.docx

Uncrustify配置文件里那些让人眼花缭乱的选项作者：欧阳文全日期：2014年1月17日蓝框原来,红框选项起作用后(即设置为true)。= 后面的是默认值通用(general)换行风格# The type of line endings newlines = auto # auto/lf/crlf/cr输入文件的tab 大小# The original size of tabs in the inputinput_tab_size = 8 # number输出尺寸的tab大小# The size of tabs in the output (only used if align_with_tabs=true)output_tab_size = 8 # number# The ASCII value of the string escape char, usually 92 () or 94 (). (Pawn)string_escape_char = 92 # number运行将= 和 =当作模板的一部分# Allow interpreting = and = as part of a template in void f(listlist=val);.# If true (default), assert(x=3) will be broken.# Improvements to template detection may make this option obsolete.tok_split_gte = false # false/true控制如何处理UTF-8 BOM# Control what to do with the UTF-8 BOM (recommend remove)utf8_bom = ignore # ignore/add/remove/force若文件包含值为128到255的非UTF-8字节，则输出为UTF-8# If the file contains bytes with values between 128 and 255, but is not UTF-8, then output as UTF-8utf8_byte = false # false/true强制输出编码为UTF-8# Force the output encoding to UTF-8utf8_force = false # false/true缩进(Indent)每个级别缩进的列数# The number of columns to indent per level.# Usually 2, 3, 4, or 8.indent_columns = 8 # number连续(continuation)缩进,如果非0，则会覆盖( 和 =的连续缩进。# The continuation indent. If non-zero, this overrides the indent of ( and = continuation indents.# For FreeBSD, this is set to 4. Negative value is absolute and not increased for each ( levelindent_continue = 0 # number缩进时如何使用tab# How to use tabs when indenting code# 0=spaces only# 1=indent with tabs to brace level, align with spaces# 2=indent and align with tabs, using spaces when not on a tabstopindent_with_tabs = 1 # number不在花括号级别的注释，用tab缩进到制表符tabstop# Comments that are not a brace level are indented with tabs on a tabstop.# Requires indent_with_tabs=2. If false, will use spaces.indent_cmt_with_tabs = false # false/true是否缩进被划断的string，这样他们就可以line up。这个选项我至今没搞懂啥意思# Whether to indent strings broken by so that they line upindent_align_string = false # false/true用以将远离级别(level)的空格数# Spaces to indent from levelindent_brace = 0 # number花括号是否与语句体缩进到一起# Whether braces are indented to the body levelindent_braces = false # false/true单独的开关，函数、class、struct、namespace、是否禁用缩进函数、class、struct、namespace的花括号# Disabled indenting function braces if indent_braces is trueindent_braces_no_func = false # false/true# Disabled indenting class braces if indent_braces is trueindent_braces_no_class = false # false/true# Disabled indenting struct braces if indent_braces is trueindent_braces_no_struct = false # false/true基于花括号的上层来缩进。例如，上层为if，则缩进3个空格，上层为for，则缩进4个空格# Indent based on the size of the brace parent, i.e. if = 3 spaces, for = 4 spaces, etc.indent_brace_parent = false # false/truenamespace是否缩进 # Whether the namespace body is indentedindent_namespace = false # false/true缩进空格数# The number of spaces to indent a namespace blockindent_namespace_level = 0 # number大于此行数的namespace不被缩进# If the body of the namespace is longer than this number, it wont be indented.# Requires indent_namespace=true. Default=0 (no limit)indent_namespace_limit = 0 # numberextern C、class体是否缩进# Whether the extern C body is indentedindent_extern = false # false/true# Whether the class body is indentedindent_class = false # false/true是否缩进以类、冒号打头的内容# Whether to indent the stuff after a leading class colonindent_class_colon = false # false/true成员初始化虚拟缩进，远离:# Virtual indent from the : for member initializers. Default is 2indent_ctor_init_leading = 2 # number构造函数初始化列表，额外缩进# Additional indenting for constructor initializer listindent_ctor_init = 0 # number将else n if 当作 else if来缩进# False=treat elsenif as else if for indenting purposes# True=indent the if one levelindent_else_if = false # false/true开花括号后的变量声明的缩进数量# Amount to indent variable declarations after a open brace. neg=relative, pos=absoluteindent_var_def_blk = 0 # number缩进连续变量声明而非对齐# Indent continued variable declarations instead of aligning.indent_var_def_cont = false # false/truetrue，强制将函数定义从列1开始缩进false，使用默认行为# True: force indentation of function definition to start in column 1# False: use the default behaviorindent_func_def_force_col1 = false # false/true以1个缩进级别缩进连续的函数调用参数# True: indent continued function call parameters one indent level# False: align parameters under the open parenindent_func_call_param = false # false/true与上相同，不过是用于函数定义、函数原型，类声明下面各种相同，不再赘述# Same as indent_func_call_param, but for function defsindent_func_def_param = false # false/true# Same as indent_func_call_param, but for function protosindent_func_proto_param = false # false/true# Same as indent_func_call_param, but for class declarationsindent_func_class_param = false # false/true# Same as indent_func_call_param, but for class variable constructorsindent_func_ctor_var_param = false # false/true# Same as indent_func_call_param, but for templatesindent_template_param = false # false/true# Double the indent for indent_func_xxx_param optionsindent_func_param_double = false # false/true# Indentation column for standalone const function decl/proto qualifierindent_func_const = 0 # number# Indentation column for standalone throw function decl/proto qualifierindent_func_throw = 0 # number缩进连续的- 或 .的空格数# The number of spaces to indent a continued - or .# Usually set to 0, 1, or indent_columns.indent_member = 0 # number用以缩进代码前的单行注释(/)的空格数# Spaces to indent single line (/) comments on lines before codeindent_sing_line_comments = 0 # number若为true，将会相对地缩进行尾单行注释(/)，而非尝试保持相同绝对列# If set, will indent trailing single line (/) comments relative# to the code instead of trying to keep the same absolute columnindent_relative_single_line_comments = false # false/true用以将case 从 switch缩进开来的空格数，通常为0或indent_columns# Spaces to indent case from switch# Usually 0 or indent_columns.indent_switch_case = 0 # numbercase行偏移的空格数# Spaces to shift the case line, without affecting any other lines# Usually 0.indent_case_shift = 0 # numbercase 下 的缩进空格数# Spaces to indent from case.# By default, the brace will appear under the c in case.# Usually set to 0 or indent_columns.indent_case_brace = 0 # number是否缩进位于首列的注释# Whether to indent comments found in first columnindent_col1_comment = false # false/true如何缩进goto标签# How to indent goto labels# 0 : absolute column where 1 is the leftmost column# =0 : subtract from brace indentindent_label = 1 # number不建议，我就不翻译了# If an open paren is followed by a newline, indent the next line so that it lines up after the open paren (not recommended)indent_paren_nl = false # false/true控制位于1个新行之后的闭圆括号)缩进行为# Controls the indent of a close paren after a newline.# 0: Indent to body level# 1: Align under the open paren# 2: Indent to the brace levelindent_paren_close = 0 # number控制圆括号内,的缩进行为，若为ture，对齐到开圆括号(之下。# Controls the indent of a comma when inside a paren.If TRUE, aligns under the open parenindent_comma_paren = false # false/true控制圆括号内BOOL operator的缩进行为，若为ture，对齐到开圆括号之下。# Controls the indent of a BOOL operator when inside a paren.If TRUE, aligns under the open parenindent_bool_paren = false # false/true若indent_bool_paren 为 true，控制第一个表撒手的缩进，若为ture，对齐第一个表达式到后面的表达式# If indent_bool_paren is true, controls the indent of the first expression. If TRUE, aligns the first expression to the following onesindent_first_bool_expr = false # false/true方括号# If an open square is followed by a newline, indent the next line so that it lines up after the open square (not recommended)indent_square_nl = false # false/true# Dont change the relative indent of ESQL/C EXEC SQL bodiesindent_preserve_sql = false # false/true对齐连续声明到=# Align continued statements at the =. Default=True# If FALSE or the = is followed by a newline, the next line is indent one tab.indent_align_assign = true # false/true空格(Spacing)在算术操作符(+, -, /, *, etc)两边添加或移除空格# Add or remove space around arithmetic operator +, -, /, *, etcsp_arith = ignore # ignore/add/remove/force在赋值操作符(+, -, /, *, etc)两边添加或移除空格# Add or remove space around assignment operator =, +=, etcsp_assign = ignore # ignore/add/remove/forcec+11标准中，添加或移除lambda capture specification中的相关空格# Add or remove space around = in C+11 lambda capture specifications. Overrides sp_assignsp_cpp_lambda_assign = ignore # ignore/add/remove/force# Add or remove space after the capture specification in C+11 lambda.sp_cpp_lambda_paren = ignore # ignore/add/remove/force原型中=两侧的空格# Add or remove space around assignment operator = in a prototypesp_assign_default = ignore # ignore/add/remove/force赋值操作符前或后的空格# Add or remove space before assignment operator =, +=, etc. Overrides sp_assign.sp_before_assign = ignore # ignore/add/remove/force# Add or remove space after assignment operator =, +=, etc. Overrides sp_assign.sp_after_assign = ignore # ignore/add/remove/forceenum内赋值操作符两侧、前、后空格# Add or remove space around assignment = in enumsp_enum_assign = ignore # ignore/add/remove/force# Add or remove space before assignment = in enum. Overrides sp_enum_assign.sp_enum_before_assign = ignore # ignore/add/remove/force# Add or remove space after assignment = in enum. Overrides sp_enum_assign.sp_enum_after_assign = ignore # ignore/add/remove/force预处理器连接操作符#两侧的空格# Add or remove space around preprocessor # concatenation operator. Default=Addsp_pp_concat = add # ignore/add/remove/force预处理器字符化操作符#两侧、前的空格# Add or remove space after preprocessor # stringify operator. Also affects the # charizing operator.sp_pp_stringify = ignore # ignore/add/remove/force# Add or remove space before preprocessor # stringify operator as in #define x(y) L#y.sp_before_pp_stringify = ignore # ignore/add/remove/forceboolean操作符& 和|两侧的、比较操作符r , =, etc两侧的空格# Add or remove space around boolean operators & and |sp_bool = ignore # ignore/add/remove/force# Add or remove space around compare operator , =, etcsp_compare = ignore # ignore/add/remove/force( 与 )内侧# Add or remove space inside ( and )sp_inside_paren = ignore # ignore/add/remove/force嵌套圆括号之间的空格# Add or remove space between nested parenssp_paren_paren = ignore # ignore/add/remove/force是否平衡嵌套圆括号两侧的空格# Whether to balance spaces inside nested parenssp_balance_nested_parens = false # false/true) 与之间的空格# Add or remove space between ) and sp_paren_brace = ignore # ignore/add/remove/force*之前的空格# Add or remove space before pointer star *sp_before_ptr_star = ignore # ignore/add/remove/force其后没跟变量名的*号之前的空格# Add or remove space before pointer star * that isnt followed by a variable name# If set to ignore, sp_before_ptr_star is used instead.sp_before_unnamed_ptr_star = ignore # ignore/add/remove/force*号之间的空格# Add or remove space between pointer stars *sp_between_ptr_star = ignore # ignore/add/remove/force*后若跟了单词，其后的空格# Add or remove space after pointer star *, if followed by a word.sp_after_ptr_star = ignore # ignore/add/remove/force*号和&相关的各种空格，不翻了，累# Add or remove space after a pointer star *, if followed by a func proto/def.sp_after_ptr_star_func = ignore # ignore/add/remove/force# Add or remove space after a pointer star *, if followed by an open paren (function types).sp_ptr_star_paren = ignore # ignore/add/remove/force# Add or remove space before a pointer star *, if followed by a func proto/def.sp_before_ptr_star_func = ignore # ignore/add/remove/force# Add or remove space before a reference sign &sp_before_byref = ignore # ignore/add/remove/force# Add or remove space before a reference sign & that isnt followed by a variable name# If set to ignore, sp_before_byref is used instead.sp_before_unnamed_byref = ignore # ignore/add/remove/force# Add or remove space after reference sign &, if followed by a word.sp_after_byref = ignore # ignore/add/remove/force# Add or remove space after a reference sign &, if followed by a func proto/def.sp_after_byref_func = ignore # ignore/add/remove/force# Add or remove space before a reference sign &, if followed by a func proto/def.sp_before_byref_func = ignore # ignore/add/remove/forcetype和word之间的空格# Add or remove space between type and word. Default=Forcesp_after_type = force # ignore/add/remove/forcetemplate vs template.# Add or remove space in template vs template.尖括号相关的各种空格# If set to ignore, sp_before_angle is used.sp_template_angle = ignore # ignore/add/remove/force# Add or remove space before sp_before_angle = ignore # ignore/add/remove/force# Add or remove space inside sp_inside_angle = ignore # ignore/add/remove/force# Add or remove space after sp_after_angle = ignore # ignore/add/remove/force# Add or remove space between and ( as found in new List();sp_angle_paren = ignore # ignore/add/remove/force# Add or remove space between and a word as in List m;sp_angle_word = ignore # ignore/add/remove/force# Add or remove space between and in (template stuff C+/C# only). Default=Addsp_angle_shift = add # ignore/add/remove/force# Permit removal of the space between in foobar (C+11 only). Default=False# sp_angle_shift cannot remove the space without this option.sp_permit_cpp11_shift = false # false/true( 和 if, for, switch, while之间的空格# Add or remove space before ( of if, for, switch, and whilesp_before_sparen = ignore # ignore/add/remove/forceif 条件式里( 和 )内的空格，以及分别(后的空格)前的空格# Add or remove space inside if-condition ( and )sp_inside_sparen = ignore # ignore/add/remove/force# Add or remove space before if-condition ). Overrides sp_inside_sparen.sp_inside_sparen_close = ignore # ignore/add/remove/force# Add or remove space before if-condition (. Overrides sp_inside_sparen.sp_inside_sparen_open = ignore # ignore/add/remove/force添加或移除if, for, switch, while后面)之后的空格# Add or remove space after ) of if, for, switch, and whilesp_after_sparen = ignore # ignore/add/remove/force添加或移除if, for, switch, while之后) 和 之间的空格# Add or remove space between ) and of if, for, switch, and whilesp_sparen_brace = ignore # ignore/add/remove/force添加或移除if, for ,while之前;之前的空声明的空格# Add or remove space before empty statement ; on if, for and whilesp_special_semi = ignore # ignore/add/remove/force添加或移除;前的空格。# Add or remove space before ;. Default=Removesp_before_semi =