# 基本信息 [TOC] ## 行尾结束符号 格式化后文件中的行尾结束符号与输入源文件相同。如果有混合多种的行尾结束符，则使用最频繁出现的结束符号。当然还有一个设置选项可以指定或更改行尾结束符号。 ## 文件格式 Artistic Style将从文件扩展名确定文件类型。扩展名“.java”表示Java文件，和“.cs”表示一个c#文件。其他的都是C类型文件(C、c++、c++ /CLI或Objective-C)。如果您正在为Java或c#使用非标准的文件扩展名，请使用 **--mode=** 选项之一。 ## 通配符和递归 Artistic Style可以递归地处理目录。通配符(如"*.cpp" or "*.c??")在内部处理。如果使用shell，则应该将通配符传递给Artistic Style，而不是先解析它们。对于Linux，在文件名包含通配符的路径首尾使用双引号括起来。对于Windows，在文件名包含空格的路径首尾使用双引号括起来。其他选项部分中的递归选项包含关于递归处理的信息。 ## 文件名 在格式化文件时，新排版的文件保留原来的文件名。创建原始文件的副本时，在原始文件名后面附加一个 *.orig* 。(可以通过选项 **--suffix=** 将其设置为其他的字符串，也可以通过选项 **-n** 或 **--suffix=none** 将其禁用附加后缀名)。因此，在排版 *SourceFile.cpp* 之后。新排版的文件将命名为 *SourceFile.cpp* 。而原来的源文件将被重命名为 *SourceFile.cpp.orig* 。 ## 国际化 Artistic Style 已经国际化，可以处理任何语言的文件和目录。 Artistic Style 也被翻译成好几种语言。用户可以切换 Windows 的用户区域设置和其他系统的LANG环境变量决定使用哪种语音。切换语言将从这些设置中自动完成。如果没有翻译可用，它将默认为英语。使用英语而不是系统语言有一个“ascii”选项。 翻译的源代码在 *ASLocalizer.cpp* 的末尾。如果您对翻译进行了修改，请将源代码作为缺陷报告发送，它将包含在下一个版本中。 要添加新语言，请向 *ASLocalizer.h* 添加一个新的翻译类。将英文翻译添加到 *ASLocalizer.cpp* 中的构造函数中。更新 WinLangCode 数组并将语言代码添加到函数 *setTranslationClass()* 中 *ASLocalizer.cpp* 程序代码包含用于获取 LCIDs（区域设置标识符） 和语言代码的 WEB 页面的注释。请将源代码作为缺陷报告发送，它将包含在下一个版本中。 ## 注意事项 编程中使用的特殊字符的名称因区域而异。Artistic Style 使用的术语，其次是其他常见的名称： * 大括号或花括号{}：也称为大括号，或花括弧。 * 圆括号()：也称为圆括号、圆括弧或软括号。 * 方括号[]：也称为方括号、方括弧或硬方括号。 * 角方括号< > ：也称为尖方括号、三角方括号、菱形方括号、元组。 Visual Studio 还有其他开发语言环境都扩展了代码的对齐方式。 Artistic Style 可以格式化标准类库语句，如：Open GL、wxWidgets、Qt和MFC。 Artistic Style 可以格式化 SQL 语句。维护 SQL 语句使用标准的格式化方式即可。 编码为 UTF 16 的 Unicode 文件(无论大端还是小端)都将被格式化。文件必须以字节顺序标记(BOM)开头才能被识别。编码为 UTF 32 的文件将被拒绝格式化，因为有些编译器不支持这些编码，这些文件可以通过程序“iconv”转换为utf8编码。有 Linux 和 Windows 版本可用(Windows版本似乎不适用于所有编码)。Visual Studio 可以从“文件>高级保存选项”菜单中转换文件。还有其他开发环境和文本编辑器，比如SciTE，可以将文件转换为utf8。、 多行且不是c类型格式(如Python)的嵌入语句通常会出现错误的格式化(c类型的格式包含用大括号括起来的块和以分号结尾的语句)。定义函数的宏可能会导致以下代码被错误格式化，因为宏缺少定义中的大括号和分号。如果您有这些语句类型的源代码，请使用在其他选项部分中描述的 **exclude=####** 选项排除它们。