# 使用方法
[TOC]
## 命令行
Artistic Style 是一个控制台程序，从命令行接收信息。
```
# 命令行格式：
astyle [OPTIONS] SourceFilePath1 SourceFilePath2 SourceFilePath3 [ . . . ]
```
方括号[]表示可以输入多个选项或多个文件名。方括号实际上并不包含在命令中。有关选项格式，请参阅下面的[选项部分]()。
```
# 格式化单个文件的例子：
astyle --style=allman /home/project/foo.cpp
# 格式化所有 C# 源文件的例子：
astyle --style=allman --recursive /home/project/*.cs
```
## 文件扩展
如果用逗号或分号分隔，可以使用多个文件扩展名。如果整个文件路径都用双引号括起来，则可以使用空格字符。使用的扩展数量没有限制。
```
# 使用匹配扩展名格式化所有 C++ 源文件的例子：
astyle --style=allman --recursive /home/project/*.cpp,*.h
```
## 重定向
<和>字符可用于将文件重定向到标准输入(stdin)和标准输出(stdout) ——不要忘记这个功能!这个选项，一次只能格式化一个文件。无法识别通配符，没有控制台消息，也没有创建备份。在Windows上，输出总是有Windows行结束符。可以使用“ **stdin=** ”和“ **stdout=** ”选项代替重定向。
```
# 重定向单个文件的例子：
astyle --style=allman < OriginalSourceFile > BeautifiedSourceFile
# 使用 "stdin=" 和"stdout=" 重定向单个文件的例子：
astyle --style=allman --stdin=OriginalSourceFile --stdout=BeautifiedSourceFile
```
```
# 重定向选项可用于显示格式化的文件而无需更新：
astyle --style=allman < OriginalSourceFile | less
```
