--style=ansi -s4 --pad-oper -S -N -L -m0 --add-brackets -M40 --suffix=none --convert-tabs %{CurrentDocument:FilePath}

--pad-oper就是操作符的两边都要加空格

Astyle编程语言格式化工具的中文说明

Artistic Style 1.23

Maintained by: Jim Pattee

Original Author: Tal Davidson

Usage : astyle [options] Source1.cpp Source2.cpp [...]

astyle [options] < Original > Beautified

When indenting a specific file, the resulting indented file RETAINS the

original file-name. The original pre-indented file is renamed, with a

suffix of ".orig" added to the original filename.

Wildcards (* and ?) may be used in the filename.

A 'recursive' option can process directories recursively.

可以用通配符指定要处理的文件,用-r递归处理子目录

By default, astyle is set up to indent C/C++/C#/Java files, with 4 spaces

per indent, a maximal indentation of 40 spaces inside continuous statements,

and NO formatting.

Option's Format:

Long options (starting with '--') must be written one at a time.

Short options (starting with '-') may be appended together.

Thus, -bps4 is the same as -b -p -s4.

风格:

--style=allman OR --style=bsd OR -A1

allman风格

Allman style formatting/indenting.

Broken brackets.

--style=java OR -A2

java风格

Java style formatting/indenting.

Attached brackets.

--style=k&r OR --style=k/r OR -A3

k&r风格

Kernighan & Ritchie style formatting/indenting.

Linux brackets.

--style=stroustrup OR -A4

stroustrup风格

Stroustrup style formatting/indenting.

Stroustrup brackets.

--style=whitesmith OR -A5

whitesmith风格

Whitesmith style formatting/indenting.

Broken, indented brackets.

Indented class blocks and switch blocks.

--style=banner OR -A6

banner风格

Banner style formatting/indenting.

Attached, indented brackets.

Indented class blocks and switch blocks.

--style=gnu OR -A7

gnu风格

GNU style formatting/indenting.

Broken brackets, indented blocks, indent is 2 spaces.

--style=linux OR -A8

linux风格

GNU style formatting/indenting.

Linux brackets, indent is 8 spaces.

Tab and Bracket Options:

tab选项:

默认tab是4个空格.

--indent=spaces=# OR -s#

默认行缩进为4个空格,可以将#替换为缩进量

--indent=tab OR --indent=tab=# OR -t OR -t#

行缩进用tab,默认tab长度与4个空格相等

--indent=force-tab=# OR -T#

优先采用空格缩进

大括号选项:

If no brackets option is set,

the brackets will not be changed.

--brackets=break OR -b

大括号与前一块隔开为两行

Break brackets from pre-block code (i.e. ANSI C/C++ style).

--brackets=attach OR -a

大括号前一个与上一行在同一行

Attach brackets to pre-block code (i.e. Java/K&R style).

--brackets=linux OR -l

定义块 和 函数块中的大括号都被处理

Break definition-block brackets and attach command-block

brackets.

--brackets=stroustrup OR -u

只处理函数中的大括号

Attach all brackets except function definition brackets.

Indentation options:

--indent-classes OR -C

缩进类定义中的public private protected标签.

Indent 'class' blocks, so that the inner 'public:',

'protected:' and 'private: headers are indented in

relation to the class block.

--indent-switches OR -S

缩进switch中的case块,case和switch不在同一列

Indent 'switch' blocks, so that the inner 'case XXX:'

headers are indented in relation to the switch block.

--indent-cases OR -K

缩进case下面的语句

Indent case blocks from the 'case XXX:' headers.

Case statements not enclosed in blocks are NOT indented.

--indent-blocks OR -G

给块添加缩进,包括大括号

Add extra indentation entire blocks (including brackets).

--indent-brackets OR -B

给大括号添加缩进

Add extra indentation to '{' and '}' block brackets.

--indent-namespaces OR -N

缩进命名空间定义行

Indent the contents of namespace blocks.

--indent-labels OR -L

标签缩进

Indent labels so that they appear one indent less than

the current indentation level, rather than being

flushed completely to the left (which is the default).

--indent-preprocessor OR -w

多行宏定义缩进

Indent multi-line #define statements.

--max-instatement-indent=# OR -M#

跨行缩进,比如函数定义中的参数处在多行,那么参数缩进到同一列

Indent a maximal # spaces in a continuous statement,

relative to the previous line.

--min-conditional-indent=# OR -m#

Indent a minimal # spaces in a continuous conditional

belonging to a conditional header.

Formatting options:

--break-blocks OR -f

空行分隔没有关系的块,类,标签(不包括函数块)

Insert empty lines around unrelated blocks, labels, classes, ...

--break-blocks=all OR -F

空行分隔无关系的块,包括else catch等

Like --break-blocks, except also insert empty lines

around closing headers (e.g. 'else', 'catch', ...).

--break-closing-brackets OR -y

else catch左边的大括号与else catch分隔

Break brackets before closing headers (e.g. 'else', 'catch', ...).

Use with --brackets=attach, --brackets=linux,

or --brackets=stroustrup.

--break-elseifs OR -e

else if()分隔为两行

Break 'else if()' statements into two different lines.

--delete-empty-lines OR -x

删除多余空行

Delete empty lines within a function or method.

It will NOT delete lines added by the break-blocks options.

--pad-oper OR -p

操作符两端插入一个空格

Insert space paddings around operators.

--pad-paren OR -P

括号内外都插入空格

Insert space padding around parenthesis on both the outside

and the inside.

--pad-paren-out OR -d

括号外部插入空格

Insert space padding around parenthesis on the outside only.

--pad-paren-in OR -D

括号外部插入空格

Insert space padding around parenthesis on the inside only.

--unpad-paren OR -U

移除括号两端多余空格

Remove unnecessary space padding around parenthesis. This

can be used in combination with the 'pad' options above.

--keep-one-line-statements OR -o

一行中的多个申明不分隔 int x;int y;int z不被分为3行

Don't break lines containing multiple statements into

multiple single-statement lines.

--keep-one-line-blocks OR -O

大括号中的单行语句不被拆分

Don't break blocks residing completely on one line.

--convert-tabs OR -c

tab转换为空格

Convert tabs to the appropriate number of spaces.

--fill-empty-lines OR -E

块间空行的换行符前插入一个空格

Fill empty lines with the white space of their

previous lines.

--mode=c

处理c文件

Indent a C or C++ source file (this is the default).

--mode=java

处理jave文件

Indent a Java source file.

--mode=cs

处理c#文件

Indent a C# source file.

Other options:

--suffix=####

指定备份文件的后缀

Append the suffix #### instead of '.orig' to original filename.

--suffix=none OR -n

不备份文件

Do not retain a backup of the original file.

--options=####

指定从####文件读取选项信息

Specify an options file #### to read and use.

--options=none

禁止从文件读取选项信息

Disable the default options file.

Only the command-line parameters will be used.

--recursive OR -r OR -R

递归处理子目录

Process subdirectories recursively.

--exclude=####

排除不处理的文件夹

Specify a file or directory #### to be excluded from processing.

--errors-to-stdout OR -X

Print errors and help information to standard-output rather than

to standard-error.

--preserve-date OR -Z

不修改时间

The date and time modified will not be changed in the formatted file.

--verbose OR -v

输出详细处理信息

Verbose mode. Extra informational messages will be displayed.

--formatted OR -Q

输出信息中只包括被修改的文件信息

Formatted display mode. Display only the files that have been formatted.

--quiet OR -q

忽略所有错误

Quiet mode. Suppress all output except error messages.

--version OR -V

输出astyle版本

Print version number.

--help OR -h OR -?

帮助信息

Print this help message.

Default options file:

Artistic Style looks for a default options file in the

following order:

1. The contents of the ARTISTIC_STYLE_OPTIONS environment

variable if it exists.

从ARTISTIC_STYLE_OPTIONS环境变量读取选项

2. The file called .astylerc in the directory pointed to by the

HOME environment variable ( i.e. $HOME/.astylerc ).

从/home文件夹中的.astylerc文件读取选项

3. The file called astylerc in the directory pointed to by the

USERPROFILE environment variable ( i.e. %USERPROFILE%\astylerc ).

从USERPROFILE下的astylerc文件读取选项信息

If a default options file is found, the options in this file

will be parsed BEFORE the command-line options.

Long options within the default option file may be written without

the preliminary '--'.

--options的用法:

我的在source insight中的设置为 AStyle.exe --options=D:\TOOLS\AStyle\astyle.cfg %f

astyle.cfg内容为:

-s4 -SKFxpUcnlaC

井号表示是注释

-s4 行缩进用4个空格

-S switch 与case不同列,case缩进

-K 缩进case下面的语句

-F 空行分隔无关块

-x 删除多余空行

-p 操作符两端出入空格

-U 移除括号两端多余空格

-c tab转空格

-n 不做备份

-l 处理定义和函数中的大括号

-a 大括号保留在上一行