AStyle 3.1 全部命令行参数中文说明(编程语言代码格式化美化工具)

  • A+
所属分类:未分类

AStyle3.1

一种免费、快速和小型的自动格式化程序
对于C,C+,C+/CLI,目标-C,C#和Java源代码

内容

一般资料

快速启动

使用

备选方案

选项文件

禁用格式化

基本支撑式

支撑式选项

默认支撑样式    Style=Allman    Style=java    Style=KR    Style=Stroustrup    式样=白匠    Style=vtk    Style=Ratliff    风格=gnu    Style=Linux    Style=Horstmann    Style=1 tbs    Style=Google    Style=Mozilla   风格=微微    风格=LISP   

选项卡选项

默认缩进    缩进=空格    缩进=制表符    缩进=强制选项卡    -缩进=强制-制表符-x   

大括号修改选项

附加名称空间    附加类    附加-内联    附件-c    附加-关闭-同时   

缩进选项

缩进类    缩进修饰符    缩进开关    缩进-案例    缩进命名空间    亲子后缩进    缩进-延续    缩进标签    缩进前块    缩进前定义    缩进前    缩进-col1-评论    min-条件缩进    最大-延续-缩进   

填充选项

断块    断块=全部    垫子    PAD-逗号    帕伦    衬垫    先出    帕伦    垫头    帕伦    删除-空行    填空线    对齐指针    对齐参考   

格式化选项

开合支撑    休息    中断单行标头    附加支撑    加一行支撑    拆下支撑    折回式    附件-返回类型    保持单线街区    保持单行语句    转换标签    关闭模板    删除-注释前缀    最大码长    逻辑后断    模式   

目标-C备选方案

衬垫-方法前缀    方法前缀    衬垫式    复位式    衬垫式    Unpad-param-类型    对齐-方法-冒号    垫-方法-冒号   

其他选择   

后缀    后缀=无    递归    干跑    排除    忽略-排除-错误    忽略-排除-错误-x    从错误到标准输出    保存日期    长篇大论    格式化    安静    线尾   

仅命令行

备选方案    工程项目    ASCII    版本    帮助    HTML    HTML=    史丁    stdout=   


一般资料

线端

格式化文件中的行尾将与输入文件相同。如果有混合行结束,最常见的发生将被使用。还有一个选项可以指定或更改行尾。

文件类型

艺术风格将决定文件类型从文件扩展名。扩展名“.java”表示Java文件,“.cs”表示C#文件。其他一切都是C类型文件(C、C+、C+/CLI或Object-C)。如果您使用的是Java或C#的非标准文件扩展名,请使用-mode=选项之一。

通配符与递归

艺术风格可以递归地处理目录。通配符(如“*.cpp”或“*.c?”)都是内部处理的。如果使用shell,它应该将通配符传递给艺术风格,而不是首先解析它们。对于Linux,在文件名包含通配符的路径周围使用双引号。对于Windows,在文件名包含空格的路径周围使用双引号。这,这个,那,那个递归选项中的其他选择节包含有关递归处理的信息。

文件名

格式化文件时,新缩进的文件保留原始文件名。创建原始文件的副本时,.原附加到原始文件名。(这可以通过选项-后缀=设置为不同的字符串,也可以由选项-n或-后缀=None来完全抑制)。因此,在缩进之后SourceFile.cpp缩进文件将命名为SourceFile.cpp,而原始的预缩进文件将重命名为SourceFile.cpp.orig.

国际化

艺术风格已经国际化,以处理任何语言的文件和目录。

它还被翻译成几种语言。要使用的转换由Windows的用户区域设置和其他系统的lang环境变量确定。翻译将自动从这些设置。如果没有翻译,它将默认为英文。有一个“ascii”选项使用英语而不是系统语言。

翻译的源代码位于ASLocalizer.cpp的末尾,以英译对的形式。如果对翻译进行更正,将源作为错误报告发送,它将包含在下一个版本中。

若要添加新语言,请向ASLocalizer.h添加一个新的翻译类。将英译对添加到ASLocalizer.cpp中的构造函数中。更新WinLangCode数组并将语言代码添加到函数setTranslationClass()中。cpp程序包含为获取LCID和语言代码提供网页的注释。将源代码作为bug报告发送,它将包含在下一个版本中。

其他考虑

编程中使用的特殊字符的名称因区域而异。艺术风格所使用的术语,以及其他常见的名称,是:大括号或大括号{}-也称为括号,或花括号。括号或圆括号()-也称为括号、圆括号或软括号。方括号[]-也称为块括号、封闭括号或硬括号。尖括号<>-也称为括号、尖括号、三角形括号、菱形括号、元组或舍瓦。

VisualStudio和其他开发环境都有扩展,这些扩展将使赋值操作符对齐多行。还有一个名为“代码对齐”的扩展,它也将对齐其他项上的代码。带有这些选项和扩展的格式可以与艺术风格一起使用。空间填充将保持和对齐将保持。

艺术风格可以格式化标准类库语句,如OpenGL、wxWidget、Qt和MFC。

嵌入式汇编语言格式正确。这包括扩展程序集和Microsoft特定的汇编程序行和块。

艺术风格可以格式化嵌入式SQL语句。只要使用标准挂起缩进格式,就会保持SQL格式。如果“exec SQL”语句缩进的次数超过以下语句,则SQL将在一列中对齐。

编码为UTF-16的Unicode文件,无论是大端还是小端,都将被格式化.文件必须以要识别的字节顺序标记(BOM)开头。编码为UTF-32的文件将被拒绝。有些编译器不支持这些编码。这些文件可以转换为UTF-8编码程序“ICOV”。有Linux和Windows版本可用(Windows版本似乎不适用于所有编码)。VisualStudio可以从“File>AdvancedSaveOptions”菜单中转换文件。还有其他开发环境和文本编辑器(如SCITE)可以将文件转换为UTF-8。

不采用C类型格式(如Python)的多行嵌入式语句通常采用法线格式(C类型格式的块以大括号括起来,语句以分号结尾)。定义函数的宏可能导致下面的代码格式化为法线格式,因为宏缺少定义中的大括号和分号。如果有这些类型的语句的源代码,则使用排除=#中描述的选项。其他选择部分。


快速启动

如果你从来没有使用过艺术风格,有几种方法可以开始。

一种是在没有任何选择的情况下运行它。这将使用默认支撑样式,每个缩进4个空格,没有格式更改。这将打破一行块的大括号,并破坏一行语句。若要更改此选项,请使用以下选项保持单线街区和/或保持单行语句格式化选项部分。

另一种方法是使用支撑式选项部分。选择一个具有大括号格式的样式。如果没有设置缩进选项,则将使用默认的4个空格选项。如上所述,这些选项还会中断一行块和一行语句。

第三个选项是使用“file”文件夹中的选项文件。如果有要复制的编码样式,请输入适当的选项文件。使用选项选项=#若要指定要使用的文件,请执行以下操作。它必须包含文件的路径,包括文件名。

一旦你熟悉了这些选项,你就可以根据你的个人喜好定制格式。


使用

命令行

艺术风格是一个控制台程序,从命令行接收信息。

命令行格式:

方括号[]表示可以输入多个选项或多个文件名。它们实际上并不包括在命令中。有关选项格式,请参阅以下选项部分。

示例以格式化单个文件:

递归格式化C#文件的示例:

文件扩展名

如果用逗号或分号分隔,可以使用多个文件扩展名。如果整个文件路径以双引号括起来,则可能会出现一个可选空格。使用的扩展数没有限制。

使用多个文件扩展名递归格式化C+文件的示例:

重定向

<和>字符可用于将文件重定向到标准输入(Stdin)和标准输出(Stdout)-不要忘记它们!使用此选项,一次只能格式化一个文件。通配符不被识别,没有控制台消息,也没有创建备份。在Windows上,输出始终有Windows行结束。可以使用“stdin=”和“stdout=”选项来代替重定向。

重定向选项示例以格式化单个文件并更改名称:

使用“stdin=”和“stdout=”重定向来格式化单个文件并更改名称的示例:

可以使用重定向选项显示格式化文件,而无需更新:


备选方案

不指定任何选项将导致默认支撑样式,每个缩进4个空格,没有格式更改。

此程序遵循通常的GNU命令行语法。选项可以用两种不同的方式编写。

长期权

这些选项以‘--“,必须一次写一封。
(示例:‘-Style=Allman-缩进=空格=4’)

短期期权

这些选项以单个“-,并且可以连接在一起。
(示例:‘-bps4’与写‘-b-p-S4’相同。)


选项文件

可选的默认选项文件和/或项目选项文件可用于补充或替换命令行选项。他们可以使用计算机的标准编码,UTF-8或UTF-16 Unicode编码.

选项可以用新的行、制表符、逗号或空格分隔。选项文件中的长选项可以在没有前面的“-”的情况下写入。选项文件中以“#”开头的行被认为是行注释。使用-详细选项可以显示格式化中使用的选项文件及其位置。

  1. 这,这个,那,那个命令行选项有优先权。如果默认或项目文件中的命令行选项与选项之间存在冲突,则将使用命令行选项。
  2. 这,这个,那,那个项目选项文件优先于默认选项文件,但不具有命令行选项。项目选项文件应位于正在格式化的项目的顶部目录中。该文件仅由文件名标识。命令行之一工程项目选项必须用于指示文件是可用的,或者必须由环境变量引用。艺术样式按以下顺序查找当前目录中的文件或其父目录之一。
    • 由-project=命令行选项指示的文件名。
    • 名为.astylerc或_astylerc的文件。
    • 如果存在由环境变量Art_Style_project_Options标识的文件名。
    • 可以通过在命令行中指定-project=None来禁用文件或环境变量。
    预计该文件将位于正在格式化的项目的顶部目录中。每次执行时只使用一个文件,并且所有要格式化的文件都假定在同一个项目中。艺术风格将在目录路径中向后搜索以找到项目选项文件。搜索的初始目录路径按以下顺序从以下位置之一获得。
    • 第一SourceFilePath输入命令行。
    • 如果用于重定向,则为“-stdin=”的值。
    • 当前目录if“<”用于重新计算。如果要格式化的文件不在当前目录中,则使用“-stdin=”选项。
  3. 这,这个,那,那个默认选项文件可用于所有项目。该文件由文件路径和文件名标识。命令行之一备选方案必须用于指示文件是可用的,或者必须由环境变量引用它。艺术风格按以下顺序查找文件路径和文件名。
    • 由-Options=命令行选项指示的文件路径。
    • 如果存在环境变量Art_Style_Options指示的文件路径。
    • HOME环境变量指向的目录中名为.astylerc的文件(例如,“$HOME”)。/.(Linux上的astylerc);
    • AppData环境变量指向的目录中名为astylerc的文件(例如“%AppData%”)\在Windows上使用的是astylerc)。
    • 可以通过在命令行中指定-Options=None来禁用文件或环境变量。

默认或项目选项文件示例:


禁用格式化

可以通过在源代码中插入注释标记来禁用格式设置和缩进。

禁用块

可以使用“OFF”和“ON”标记禁用代码块。标记作为注释包含在源文件中。评论可能是C注释(/*.*/)或C+行注释(/)。标记必须包含在单行注释中。如果注释超过一行,则将忽略缩进标记。附加信息可以包含在标签中。

开始标签是“*缩进-关闭*”,结束标记是“*缩进-on*”。它们可以在程序中的任何地方使用,条件是在标记之间部分禁用解析。禁用部分语句可能会导致结束标记后的格式不正确。如果发生这种情况,则展开标记以包括其他代码。

以下是预处理器定义的格式:

禁用线

艺术风格并不总是决定符号的使用是否有一个以上的意义。例如,星号(*)可以是乘法、指针或指针取消引用。“&”和“&”符号是一个类似的问题。

如果一个符号被不正确地填充,手动填充它可能会修复这个问题。如果仍未正确填充,则可能需要禁用格式设置。为了避免使用上面的“禁用块”标记,可以使用单行禁用。

行尾注释标签“*NOPAD*”将禁用“PAD-per”、“对齐-指针”和“对齐-引用”选项。解析不会停止,所有其他格式都将应用于行。标签只适用于一行。

以下内容防止运算符填充更改:


基本支撑式

有三种基本的支撑方式。
附加-支撑被附加到前一个块的最后一行的末尾。(爪哇)。
坏了-牙套是从前一块断的。(奥尔曼)
Linux-除了函数、类或名称空间(K&R、Linux)的开头大括号外,大括号还附加在一起。

其他支撑样式是这些变体。有些将在类、命名空间或其他大括号的位置上使用变体。(Stroustrup,Google,One True Braces,Lisp)其他人将缩进大括号(WhitesSmith、VTK、Banner和GNU)。其他人将使用运行中的大括号,其中以下语句与大括号(Horstmann和Pico)位于同一行(Horstmann和Pico)。

选择一种风格而不是另一种风格有一些技术上的争论。但通常的原因可以归结为个人偏好。有些人喜欢带有垂直空格的破大括号,这使得代码易于阅读。其他类似于附加大括号的代码更紧凑。有时候程序员只是想改变一下。如果可以看到以某种大括号样式格式化的整个文件,则更容易选择首选项。有了艺术风格,您可以轻松地修改源代码,以满足您的喜好。


支撑式选项

大括号样式选项定义要使用的大括号样式。所有选项默认为每缩进4个空格,缩进空格。默认情况下,所有样式都不会缩进名称空间。其他缩进在单独的样式描述中表示。所有选项都将打破一行块的大括号,并将中断一行语句。若要更改此选项,请使用以下选项保持单线街区和/或保持单行语句格式化选项部分。

default brace style
如果没有请求大括号样式,则将使用默认的大括号样式。开式大括号不会更改,关闭大括号将从前一行中断开。这方面有几个例外。

--style=allman / --style=bsd / --style=break / -A1
Allman风格使用破碎的牙套。

--style=java / --style=attach / -A2
Java样式使用附加的大括号。

--style=kr / --style=k&r / --style=k/r / -A3
Kernighan&Ritchie风格使用Linux大括号。从名称空间、类和函数定义中分离开大括号。大括号附加到其他一切,包括数组、结构、枚举和函数中的语句。

使用k&r选项可能会导致问题。这可以通过用引号(例如-type=“k&r”)中的k&r括起来,或者使用一种交替形式-风格=kr或-风格=k/r来解决。

--style=stroustrup / -A4
Stroustrup样式使用Linux大括号,其结束头从结束大括号中断开(例如只从函数定义中分离开大括号。开头大括号附加到其他所有内容,包括名称空间、类、数组、结构、枚举和函数中的语句。这种样式经常与“附加-关闭-同时”,标签缩进和缩进的5个空格一起使用。

--style=whitesmith / -A5
白匠风格使用破碎,缩进支撑。对开关块和类块进行缩进,以防止出现带有以下CASE语句和C+类修饰符(公共、私有、受保护)的“挂起缩进”。

--style=vtk / -A15
VTK(可视化工具包)样式使用破碎的缩进大括号,除了类、数组、结构、枚举和函数定义的开头大括号外。开关块缩进以防止出现带有以下情况语句的“挂起缩进”。

--style=ratliff / --style=banner / -A6
拉特利夫风格使用附加,缩进大括号。对开关块和类块进行缩进,以防止出现带有以下CASE语句和C+类修饰符(公共、私有、受保护)的“挂起缩进”。

--style=gnu / -A7
GNUStyle使用破碎的大括号。将额外的缩进添加到块中。在一个函数中只有。整个街区都是缩进的,而不仅仅是支撑。这种样式经常与两个空格缩进一起使用。

--style=linux / --style=knf / -A8
Linux风格使用Linux大括号。从命名空间、类和函数定义中分离开大括号。大括号附加到其他一切,包括数组、结构、枚举和函数中的语句。这,这个,那,那个最小条件缩进是半缩的。如果您想要不同的最小条件缩进,请使用K&R样式。这种风格最好用一个大的缩进。它经常与缩进的8个空格一起使用。

也被称为内核范式(KernelNormalForm,KNF)样式,这是LinuxBSD内核中使用的样式。

--style=horstmann / --style=run-in / -A9
霍斯特曼风格使用破大括号和运行语句。开关缩进以允许运行到打开的开关块.这种样式经常与缩进的3个空格一起使用。

--style=1tbs / --style=otbs / -A10
“One True BraceStyle”使用Linux大括号,并将大括号添加到未带大括号的一行条件语句中。从名称空间、类和函数定义中分离开大括号。大括号附加到其他一切,包括数组、结构、枚举和函数中的语句。

在下面的示例中,大括号已经添加到“返回0;”语句中。该选项-附加-一行-大括号也可以使用这种风格。

--style=google / -A14
Google样式使用附加的大括号和缩进类访问修饰符。有关缩进修饰符格式的示例,请参见缩进修饰符选项。这实际上不是唯一的大括号样式,而是具有无大括号变体的Java样式。这种样式经常与两个空格缩进一起使用。

--style=mozilla / -A16
Mozilla样式使用Linux大括号。从类、结构、枚举和函数定义中分离开大括号。大括号附加到其他一切,包括名称空间、数组和函数中的语句。这种风格经常用于缩进两个空格和-中断-返回类型。

--style=pico / -A11
Pico样式使用破碎的大括号和带有附加结束大括号的运行语句。关闭支撑连接到块中的最后一行。开关缩进以允许运行到打开的开关块.这种风格意味着保持单行块和保持一行语句。如果使用加法大括号,它们将被添加为一行大括号。这种样式经常与两个空格缩进一起使用。

--style=lisp / --style=python / -A12
LISP风格使用附加的开口和关闭大括号。关闭支撑连接到块中的最后一行。这种风格意味着保持一行语句,而不是保持一行块。此样式不支持一行大括号。如果使用加法一行大括号,它们将被添加为多行大括号。


选项卡选项

下面的示例显示空格字符。空格用.(点),制表符由a>(大于)表示。

default indent
如果没有设置缩进选项,则将使用4个空格的默认选项(例如-s)。4-缩进=空格=4).

具有默认值:

--indent=spaces / --indent=spaces=# / -s#
缩进使用#空间每缩进(例如-s)3-缩进=空格=3)#必须在2到20之间。不指定#将导致每个缩进默认4个空格。

带缩进=空格=3

--indent=tab / --indent=tab=# / -t / -t#
缩进使用缩进的制表符和连续行对齐的空格。这可以确保代码正确显示,而不管查看器的选项卡大小如何。将每个缩进作为#空格(例如-t)6/-缩进=tab=6)#必须在2到20之间。如果未设置#,则将缩进视为4个空格。

缩进=制表符:

使用Style=Linux时,缩进=tab=8:

--indent=force-tab / --indent=force-tab=# / -T / -T#
缩进使用全标签人物,如果可能的话。如果连续行不是偶数制表符,则将在末尾添加空格。将每个选项卡视为#空格(例如-T)6/-缩进=武力-塔布=6)#必须在2到20之间。如果未设置#,则将制表符视为4个空格。

缩进=force-选项卡:

--indent=force-tab-x / --indent=force-tab-x=# / -xT / -xT# 
此Force-tab选项允许将制表符长度设置为与缩进长度不同的长度。这可能导致缩进制表符和空格的混合。标签将用于缩进,如果可能的话。如果不能使用制表符缩进,则将使用空格。

此选项设置标签长度。将每个选项卡视为#空格(例如-XT)6/-缩进=武力-标签-x=6。#必须在2到20之间。如果没有设置#,则将制表符视为8个空格。更改缩进长度在默认的4个空格中,还必须使用“intton=force-tab”选项。

缩进=force-tab-x(默认制表符长度为8,默认缩进长度为4):


大括号修改选项

--attach-namespaces / -xn
将大括号附加到命名空间语句。无论使用哪种支撑样式,都会这样做。它还将把大括号附加到CORBA IDL模块语句中。

大括号总是附加到命名空间语句:

--attach-classes / -xc
将大括号附加到类语句。无论使用哪种支撑样式,都会这样做。

大括号总是附在类语句上:

--attach-inlines / -xl
将大括号附加到类和结构内联函数定义。此选项优先于所有样式,但Horstmann和Pico除外(运行样式)。它只对C+文件有效。

所有大括号都附加到类和struct内联方法定义:

--attach-extern-c / -xk
将大括号附加到带括号的“C”语句。无论使用哪种支撑样式,都会这样做。此选项仅对C+文件有效。

作为函数定义一部分的extern“C”语句根据请求的大括号样式格式化。带大括号的“C”语句不受大括号样式的影响,此选项是更改它们的唯一方法。

此选项将大括号附加到带大括号的“C”语句:

但是函数定义是根据请求的大括号样式格式化的:

--attach-closing-while / -xV
将“do-while”语句的结束“while”附加到结束括号上。这优先于大括号样式和断续结束大括号选项。

变成:


缩进选项

--indent-classes / -C
缩进“class”和“struct”块,以便缩进整个块。只有当在结构中的某个地方声明了访问修饰符‘public:’、‘受保护的:’或‘私有:’时,结构块才会缩进。此选项仅对C+文件有效。

变成:

--indent-modifiers / -xG
缩进‘class’和‘struct’访问修饰符,‘public:’,‘受保护的:’和‘私有:’,半缩进。类的其余部分不缩进。此选项仅对C+文件有效。如果与缩进类一起使用,此选项将被忽略。

变成:

--indent-switches / -S
缩进“Switch”块,以便在开关块中缩进‘case X:’语句。整个CASE块都是缩进的。

变成:

--indent-cases / -K
缩进case X:“距离”街区“case X:标题。不包含在块中的case语句不会缩进。

变成:

--indent-namespaces / -N
向命名空间块添加额外的缩进。此选项对Java文件没有影响。它还将缩进CORBA IDL模块语句。

变成:

--indent-after-parens / -xU
缩进,而不是对齐,延行后面的行包含一个开头的PARAN‘(’或一个赋值‘=’)。这包括函数定义和声明以及返回语句。可以使用以下缩进-延续选项修改缩进。此选项可用于显示比例字体的编辑器。

变成:

--indent-continuation=# / -xt#
为一行设置连续缩进,该行以开头的PARAN‘(’或赋值‘=’)结尾。这包括函数定义和声明。它还将修改先前的缩进后Pren选项。对.的价值#指示缩进数。的整数值。0至4。如果未使用此选项,则默认值为1被利用了。

变成(缩进-延续=3):

--indent-labels / -L
向标签中添加额外的缩进,使它们比当前的缩进小一个缩进,而不是被冲到左边(默认)。

变成(带有缩进的“Error:”):

--indent-preproc-block / -xW
缩进预处理器块在大括号级别为零,并立即在命名空间内。对缩进的内容有限制。方法、类、数组等中的块不会缩进。包含大括号或多行定义语句的块不会缩进.如果没有此选项,预处理器块就不会缩进。

变成:

--indent-preproc-define / -w
缩进多行预处理器定义,以反斜杠结尾。应该与-转换-选项卡一起使用,以获得正确的结果。做得很好,但不能在模糊的预处理前定义中执行奇迹。如果没有此选项,预处理语句将保持不变。

变成:

--indent-preproc-cond / -xw
将预处理条件语句缩进到与源代码相同的级别。

变成:

--indent-col1-comments / -Y
缩进C+注释开始于第一列。默认情况下,从第一列开始的C+注释被认为是注释掉的代码,而不是缩进的。此选项将允许注释与代码缩进。

变成:

--min-conditional-indent=# / -m#
设置在由多行生成标头时添加的最小缩进。这个缩进有助于很容易地将头从后面的命令语句中分离出来。对.的价值#指示缩进数是一个最小值。缩进可能更大,以便与上一行的数据对齐。
有效值是:
0-没有最小的缩进。这些行将与上一行的PRAN对齐。
1-缩进至少一个额外的缩进。
2-缩进至少两个额外的缩进。
3-缩进至少半个额外的缩进。这是为了大的凹痕(例如,8)。
默认值是2,两个额外的凹痕。

变成(设置时)--min-conditional-indent=0):

--max-continuation-indent=# / -M#
设置最大值#空格缩进续行。这,这个,那,那个#指示若干列,且不得小于40或大于120。如果未设置值,则默认值为40会被使用。此选项将防止延拓行向右延伸太远。设置更大的值将允许将代码进一步扩展到右边。

变得(具有更大的价值):


填充选项

--break-blocks / -f
在标头块周围填充空行(例如‘if’,‘for’,‘while’.)。

变成:

--break-blocks=all / -F
在标头块周围填充空行(例如‘if’,‘for’,‘while’.)。将关闭头块(例如,“其他”、“捕获”)视为独立块。

变成:

--pad-oper / -p 
在运算符周围插入空格填充。这也会填充逗号。如果可能的话,行注释的任何结尾都将保留在原来的列中。请注意,没有选择卸载。一旦有了垫子,他们就会留下垫子。

变成:

--pad-comma / -xg 
在逗号后面插入空格填充。如果使用垫子,这是不需要的。如果可能的话,行注释的任何结尾都将保留在原来的列中。请注意,没有选择卸载。一旦有了垫子,他们就会留下垫子。

变成:

--pad-paren / -P 
在两个。如果可能的话,行注释的任何结尾都将保留在原来的列中。

变成:

--pad-paren-out / -d 
只有。空的父母是不会被填充的。如果可能的话,行注释的任何结尾都将保留在原来的列中。这可以与取消垫-佩伦下面使用,以消除不必要的空间。

变成:

--pad-first-paren-out / -xd 
第一的系列文章中的帕伦只有。空的父母是不会被填充的。如果可能的话,行注释的任何结尾都将保留在原来的列中。这可以与取消垫-佩伦下面使用,以消除不必要的空间。如果与PAD-PRAN或PAD-PRAN-OUT一起使用,此选项将被忽略.如果与PAD-Pren-in一起使用,结果将是PAD-Pren。

变成:

--pad-paren-in / -D 
在PARAN周围插入空格填充只有。如果可能的话,行注释的任何结尾都将保留在原来的列中。这可以与取消垫-佩伦下面使用,以消除不必要的空间。

变成:

--pad-header / -H 
在标题之间插入空格(例如‘if’,‘for’,‘while’.)和下面的帕伦。如果可能的话,行注释的任何结尾都将保留在原来的列中。这可以与unpad-P轮一起使用,以消除不需要的空间。

变成:

--unpad-paren / -U 
去除额外的空间填充周围的父母在内部和外部。如果可能的话,行注释的任何结尾都将保留在原来的列中。此选项可与上面的PRAN填充选项PAD-PRAN,PAD-PRAN-OUT,PAD-PRAN-in和PAD-Header结合使用。只有未被其他选项请求的填充将被删除。

例如,如果一个源在内部和外部都填充了Parens,那么您只想要内部。您需要使用unpad-PARAN来移除外部填充,使用pad-Pen-以保留内部填充。仅使用PAD-Pain-in>不会移除外部填充。

变为(不请求填充选项):

--delete-empty-lines / -xe
删除函数或方法中的空行。函数或方法之外的空行不被删除。如果与断块或断块=ALL一起使用,它将删除所有行,但由断块选项添加的行除外。

变成:

--fill-empty-lines / -E
用上一行的空白填充空行。

--align-pointer=type   / -k1
--align-pointer=middle / -k2
--align-pointer=name   / -k3 

将指针或引用运算符(*、&或^)附加到变量类型(左)或变量名(右),或将其置于类型和名称(中间)之间。如果可能,类型和名称之间的间距将保持不变。此选项用于C/C+、C+/CLI和C#文件。若要单独格式化引用,请使用以下对齐引用选项。

变成(使用对齐-指针=类型):

变成(使用对齐指针=中间):

变成(使用对齐指针=名称):

--align-reference=none   / -W0
--align-reference=type   / -W1
--align-reference=middle / -W2
--align-reference=name   / -W3 

此选项将对齐与指针分离的引用。此选项不会更改指针。如果指针和引用要对齐,请使用前面的对齐指针选项.选项对齐-引用=无将不会更改引用对齐。其他选项与对齐指针相同。此选项用于C/C+、C+/CLI和C#文件。

变成(使用对齐-引用=类型):

变成(使用对齐引用=中间):

变成(使用对齐-引用=名称):


格式化选项

--break-closing-braces / -y
当与-Style=java,-Style=kr,-Style=Stroustrup,-Style=Linux,或-Style=1tbs一起使用时,这会打断关闭标头(例如,‘Other’,‘catch’,.)在紧邻关闭大括号之前。关闭标题大括号总是与其他样式分开。

变成(一个破碎的“其他人”):

--break-elseifs / -e
将“Else if”标题组合成单独的行。如果使用了“保持单行语句”,则此选项没有任何效果,“否则如果”语句将保持原样。

如果不使用此选项,则“否则如果”标题组合将放在单行上。

变成:

--break-one-line-headers / -xb 
打断一行标题(例如“if”、“while”、“Other”、.)来自同一行的语句。如果语句以大括号括起来,则将根据所请求的大括号样式对大括号进行格式化。

如果请求保持单行语句,则多语句行不会中断。如果请求保留一行块并将标头封装在块中,则不会破坏一行块。

变成:

--add-braces / -j 
在未加大括号的一行条件语句中添加大括号(例如‘if’,‘for’,‘while’.)。语句必须在一行上。支撑将根据所要求的支撑样式添加。如果没有要求样式,支撑将被附加。

如果请求保留一行语句,大括号将不会添加到多语句行中。如果请求保持一行块,则不会将大括号添加到一行块中。如果与加法一行大括号一起使用,结果将是一行大括号.

变成:

--add-one-line-braces / -J 
在取消大括号的一行条件语句中添加一行大括号(例如“if”、“for”、“while”.)。语句必须在一行上。该选项意味着-保持单行-块,不会破坏一行块。

变成:

--remove-braces / -xj
从条件语句中删除大括号(例如‘if’,‘for’,‘while’.)。语句必须是单行上的单个语句。如果-加大括号或-加一行-大括号也被使用,结果将是添加大括号。大括号不会从“一个真正的支撑样式”中移除,-Style=1tbs。

变成:

--break-return-type      / -xB
--break-return-type-decl / -xD
从函数名中断开返回类型。这两个选项用于函数定义(-xB)和函数声明或签名(-xD)。如果与-附加-返回类型一起使用,则结果将破坏返回类型。此选项对目标C函数没有影响。

变成:

--attach-return-type      / -xf
--attach-return-type-decl / -xh
将返回类型附加到函数名。这两个选项用于函数定义(-xf)和函数声明或签名(-xh)。它们的目的是撤销-中断-返回类型的选项。如果与-中断-返回类型一起使用,则结果将破坏返回类型。此选项对目标C函数没有影响。

变成:

--keep-one-line-blocks / -O 
不要打破单线封锁。

保持不变。

--keep-one-line-statements / -o 
不要中断驻留在一行上的复杂语句和多个语句。

保持不变。

--convert-tabs / -c
将制表符转换为行的非缩进部分中的空格。插入的空格数将保持选项卡的间距。使用每个选项卡上空格的当前设置。如果在每个选项卡上更改空格时使用了“转换-制表符”,则可能不会产生预期的结果。标签在引号中不被替换。

--close-templates / -xy
关闭模板定义的结尾尖括号之间的空白。C+11标准现在允许关闭结束尖括号。在进行更改之前,请确保编译器支持这一点。

变成:

--remove-comment-prefix / -xp
删除开始行的多行注释中前面的“*”。尾随的“*”,如果存在,也会被移除。少于一个缩进的文本缩进一个缩进。大于一个缩进的文本不会更改。开始一行但没有前面的“*”的多行注释缩进一个缩进以保持一致性。这可以稍微修改注释掉的代码块的缩进。包含所有“*”的行保持不变。从注释Close‘*/’中删除额外的间距。

变成:

--max-code-length=#   / -xC# 
--break-after-logical / -xL

如果代码超过#人物有效值为50特鲁200。没有逻辑条件的行会在一个逻辑条件下(\、&、.)、逗号、PARAN、分号或空格中断。

有些代码不会中断,例如注释、引号和数组。如果与保持单行块或加一行支撑一起使用,这些块将不会被破坏。如果与保留单行语句一起使用,则如果该行超过最大长度,则语句将以分号中断。如果在最大代码长度内没有可用的断点,则行将在最大代码长度之后的第一个可用断点处中断。

默认情况下,逻辑条件将放在新行的第一位。选择逻辑后断将导致逻辑条件放在上一行的最后。如果没有最大代码长度,则此选项没有任何效果。

变成:

变成(逻辑后中断):

--mode=c
--mode=cs
--mode=java
缩进C类型、C#或Java文件。C类型文件为C、C+、C+/CLI和目标-C。该选项通常是根据每个文件的文件扩展名设置的。可以用此条目覆盖设置。它将用于所有文件,无论文件扩展名。它允许格式化程序识别特定于语言的语法,如C+类、模板和关键字。


目标-C备选方案

这些选项仅对目标C文件有效。除非被下列选项覆盖,否则标准的PARAN填充选项仍将应用于Object-C方法前缀和返回类型。

由于目标C有时需要较长的缩进,因此可能需要增加“max-延续-缩进”选项。如果你没有得到你想要的帕伦和方括号对齐,试着增加这个值。该选项在“缩进选项”部分中进行了描述。

--pad-method-prefix / -xQ
插入空间填充“-”或“+”目标-C方法前缀。这将正好增加一个空格。任何额外的空间都将被删除。

变成:

--unpad-method-prefix / -xR
移除所有空格“-”或“+”目标-C方法前缀。如果与PAD-Method前缀一起使用,此选项将被忽略。此选项优先于PAD Pren外部选项。

变成:

--pad-return-type / -xq
插入空间填充目标-C返回类型。这将正好增加一个空格。任何额外的空间都将被删除。

变成:

--unpad-return-type / -xr
移除所有空格目标-C返回类型。如果与PAD返回类型一起使用,此选项将被忽略。此选项优先于PAD Pren外部选项。

变成:

--pad-param-type / -xS
在Object-C参数类型周围插入空格填充。这将正好增加一个空格。任何额外的空间都将被删除。这优先于PAD方法冒号选项,并且总是在方法冒号之后造成空格填充。

变成:

--unpad-param-type / -xs
移除目标-C参数类型周围的所有空格填充。此选项优先于PAD Pren外部选项。方法冒号选项优先于开口帕伦。关闭的帕伦将永远被解开。

变成(用未填充的方法冒号):

变成(后面用填充方法冒号):

--align-method-colon / -xM
对齐Object-C方法声明和方法调用中的冒号。如果未声明此选项,则方法定义将一致缩进,方法调用将与第一个关键字对齐。

变成(没有声明选项):

变成(使用对齐-方法-冒号):

--pad-method-colon=none   / -xP0
--pad-method-colon=all    / -xP1
--pad-method-colon=after  / -xP2
--pad-method-colon=before / -xP3 

在Object-C方法调用中,在冒号之前或之后添加或删除空格填充。这些选项将正好填补一个空间。任何额外的空间都将被删除。方法冒号后的空格填充可以被PAD-param-类型覆盖。

使用PAD-方法-冒号=无:

使用PAD-方法-冒号=ALL:

用PAD-方法-冒号=后:

使用PAD-方法-冒号=前面:


其他选择

这些是命令行可用的非格式设置选项。它们也可以包含在选项文件中。

--suffix=####
将后缀#而不是“.orig”追加到原始文件名(例如-后缀=.BAK。如果这是一个文件扩展名,则点‘。必须包括在内。否则,后缀将追加到当前文件扩展名。

--suffix=none / -n
不要保留原始文件的备份。原始文件在格式化后被清除。

--recursive / -r / -R
对于命令行中的每个目录,递归地处理所有子目录。使用递归选项时,文件名语句应该包含通配符。Linux用户应该将文件路径和名称放在双引号中,这样shell就不会解析通配符(例如“$HOME/src/*.cpp”)。如果路径或名称包含空格,Windows用户应将文件路径和名称放在双引号中。

--dry-run
在不更改文件的情况下执行试运行。报告将照常输出。

--exclude=####
指定要排除在处理之外的文件或子目录#。

从文件路径的末尾排除匹配。“模板”的排除选项将排除所有名为“模板”的目录。“CPP/Template”的排除选项将排除所有“CPP/Template”目录。您可以在目录树中向后进行,以只排除所需的目录。

可以同样的方式排除特定的文件。“default.cpp”的排除选项将排除名为“default.cpp”的所有文件。“python/default.cpp”的排除选项将排除包含在“python”子目录中的所有名为“default.cpp”的文件。您可以在目录树中向后进行,以仅排除所需的文件。

不允许通配符。可能有不止一个排除语句。文件路径和名称可以放在双引号中(例如

--ignore-exclude-errors / -i
如果“exit=#”选项中有错误,允许继续处理。
此选项允许在单个选项文件中输入多个项目的“排除”选项。此选项可以放置在与“排除”相同的选项文件中。它将显示不匹配的排除。下面的选项将不会显示不匹配的排除。

--ignore-exclude-errors-x / -xi
如果“exit=#”选项中有错误,允许继续处理。
此选项允许在单个选项文件中输入多个项目的“排除”选项。此选项可以放置在与“排除”相同的选项文件中。它不会显示不匹配的排除。前面的选项将显示不匹配的排除。

--errors-to-stdout / -X
打印错误到标准输出,而不是标准错误。
对于没有单独输出到标准错误(如Windows 95中)的系统/shell,此选项应该是有用的。

--preserve-date / -Z
保留原始文件的修改日期和时间。修改的时间将更改几微秒,以强制修改后的文件进行编译。如果重定向用于重命名输入文件,则此选项无效。

--verbose / -v
详细显示模式显示可选信息,如发布号、日期、选项文件位置和统计数据。

--formatted / -Q
格式化文件显示模式。只显示已格式化的文件。不要显示未更改的文件。

--quiet / -q
安静显示模式。取消除错误消息外的所有输出。

--lineend=windows / -z1
--lineend=linux   / -z2
--lineend=macold  / -z3 

强制使用指定的行结束样式。有效的选项是windows(CRLF)、Linux(LF)和macold(CR)。MacOldStyle是MacOS 9和更早版本的格式。MacOS和OSX使用Linux风格。如果没有使用这些选项之一,则将从输入文件自动确定行尾。

什么时候重定向在Windows上使用,输出将始终有Windows行结束。此选项将被忽略。


仅命令行

这些选项仅适用于命令行。它们在选项文件中不可用。

--options=####
--options=none
指定要读取和使用的选项文件#。它必须包含文件路径和文件名。这将允许将文件名更改为astylerc或.astylerc。

“None”选项将禁用默认选项文件(如果存在的话)。只使用命令行参数。

更多信息见选项文件部分。

--project
--project=####
--project=none 
指定要使用的项目选项文件。选项文件应该具有默认名称.astylerc或_astylerc,并且应该位于正在格式化的项目的顶部目录中。

指定要使用的项目选项文件#。它必须只包含没有目录路径的文件名。这将允许将项目文件名从.astylerc或_astylerc改为.astylerc或_astylerc。它应该位于正在格式化的项目的顶部目录中。

“无”选项将禁用项目选项文件(如果存在的话)。在这种情况下,将不使用项目选项文件。

更多信息见选项文件部分。

--ascii / -I
显示的输出将仅为ASCII字符。文本将以英语显示,数字将不格式化。短期期权必须是单独的,不能与其他选项连在一起。

--version / -V
打印版本号并退出。短期期权必须是单独的,不能与其他选项连在一起。

--help / -h / -?
打印一条帮助信息并退出。短期期权必须是单独的,不能与其他选项连在一起。

--html / -!
在默认浏览器中打开HTML帮助文件“astyle.html”并退出。短期期权必须是单独的,不能与其他选项连在一起。这些文档必须安装在标准安装路径(/usr/share/doc/astyle/html for Linux或%ProgramFiles%\AStyle\docforWindows)中。如果安装到不同的路径,请使用html=#。

--html=####
在默认浏览器中使用文件路径#打开HTML帮助文件,然后退出。可以指定“astyle.Help”以外的HTML文件。路径可以包括目录路径和文件名,或者仅包含文件名(例如html=install.html)。如果只使用文件名,则假定它位于标准安装路径(/usr/share/doc/astyle/html用于Linux或%ProgramFiles%\AStyle\docforWindows)。在这两种情况下,文件名都必须包括html扩展名。包含空格的文件路径必须用引号括起来。

在Linux上,使用安装包“xdg-utils”中的脚本“xdg-open”打开HTML文件。这应该默认安装在大多数发行版上。

任何HTML文件都可以通过此选项打开。您可能需要的文件是astyle.html(默认值)、install.html和index.html。

--stdin=####
使用文件路径#作为单个文件格式的输入打开文件。这是对重定向的替代。不要将它与“<”重定向一起使用。

--stdout=####
使用文件路径#作为单个文件格式的输出打开文件。这是对重定向的替代。不要将此与“>”重定向一起使用。


weinxin
我的微信
这是我的微信扫一扫

发表评论

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: