作用

indent 可识别 C 的原代码文件，并加以格式化，以方便程序设阅读。

语法

indent [参数][源文件]
indent [参数][源文件][-o 目标文件]

参数

• -bad或--blank-lines-after-declarations 　在声明区段或加上空白行。

• -bap或--blank-lines-after-procedures 　在程序或加上空白行。

• -bbb或--blank-lines-after-block-comments 　在注释区段后加上空白行。

• -bc或--blank-lines-after-commas 　在声明区段中，若出现逗号即换行。

• -bl或--braces-after-if-line 　if(或是else,for等等)与后面执行区段的"{"不同行，且"}"自成一行。

• -bli<缩排格数>或--brace-indent<缩排格数> 　设置{ }缩排的格数。

• -br或--braces-on-if-line 　if(或是else,for等等)与后面执行跛段的"{"不同行，且"}"自成一行。

• -bs或--blank-before-sizeof 　在sizeof之后空一格。

• -c<栏数>或--comment-indentation<栏数> 　将注释置于程序码右侧指定的栏位。

• -cd<栏数>或--declaration-comment-column<栏数> 　将注释置于声明右侧指定的栏位。

• -cdb或--comment-delimiters-on-blank-lines 　注释符号自成一行。

• -ce或--cuddle-else 　将else置于"}"(if执行区段的结尾)之后。

• -ci<缩排格数>或--continuation-indentation<缩排格数> 　叙述过长而换行时，指定换行后缩排的格数。

• -cli<缩排格数>或--case-indentation-<缩排格数> 　使用case时，switch缩排的格数。

• -cp<栏数>或-else-endif-column<栏数> 　将注释置于else与elseif叙述右侧定的栏位。

• -cs或--space-after-cast 　在cast之后空一格。

• -d<缩排格数>或-line-comments-indentation<缩排格数> 　针对不是放在程序码右侧的注释，设置其缩排格数。

• -di<栏数>或--declaration-indentation<栏数> 　将声明区段的变量置于指定的栏位。

• -fc1或--format-first-column-comments 　针对放在每行最前端的注释，设置其格式。

• -fca或--format-all-comments 　设置所有注释的格式。

• -gnu或--gnu-style 　指定使用GNU的格式，此为预设值。

• -i<格数>或--indent-level<格数> 　设置缩排的格数。

• -ip<格数>或--parameter-indentation<格数> 　设置参数的缩排格数。

• -kr或--k-and-r-style 　指定使用Kernighan&Ritchie的格式。

• -lp或--continue-at-parentheses 　叙述过长而换行，且叙述中包含了括弧时，将括弧中的每行起始栏位内容垂直对其排列。

• -nbad或--no-blank-lines-after-declarations 　在声明区段后不要加上空白行。

• -nbap或--no-blank-lines-after-procedures 　在程序后不要加上空白行。

• -nbbb或--no-blank-lines-after-block-comments 　在注释区段后不要加上空白行。

• -nbc或--no-blank-lines-after-commas 　在声明区段中，即使出现逗号，仍旧不要换行。

• -ncdb或--no-comment-delimiters-on-blank-lines 　注释符号不要自成一行。

• -nce或--dont-cuddle-else 　不要将else置于"}"之后。

• -ncs或--no-space-after-casts 　不要在cast之后空一格。

• -nfc1或--dont-format-first-column-comments 　不要格式化放在每行最前端的注释。

• -nfca或--dont-format-comments 　不要格式化任何的注释。

• -nip或--no-parameter-indentation 　参数不要缩排。

• -nlp或--dont-line-up-parentheses 　叙述过长而换行，且叙述中包含了括弧时，不用将括弧中的每行起始栏位垂直对其排列。

• -npcs或--no-space-after-function-call-names 　在调用的函数名称之后，不要加上空格。

• -npro或--ignore-profile 　不要读取indent的配置文件.indent.pro。

• -npsl或--dont-break-procedure-type 　程序类型与程序名称放在同一行。

• -nsc或--dont-star-comments 　注解左侧不要加上星号(*)。

• -nsob或--leave-optional-semicolon 　不用处理多余的空白行。

• -nss或--dont-space-special-semicolon 　若for或while区段仅有一行时，在分号前不加上空格。

• -nv或--no-verbosity 　不显示详细的信息。

• -orig或--original 　使用Berkeley的格式。

• -pcs或--space-after-procedure-calls 　在调用的函数名称与"{"之间加上空格。

• -psl或--procnames-start-lines 　程序类型置于程序名称的前一行。

• -sc或--start-left-side-of-comments 　在每行注释左侧加上星号(*)。

• -sob或--swallow-optional-blank-lines 　删除多余的空白行。

• -ss或--space-special-semicolon 　若for或swile区段今有一行时，在分号前加上空格。

• -st或--standard-output 　将结果显示在标准输出设备。

• -T 　数据类型名称缩排。

• -ts<格数>或--tab-size<格数> 　设置tab的长度。

• -v或--verbose 　执行时显示详细的信息。

• -version 　显示版本信息。

indent 代码格式化说明：

示例

该示例展示怎样使用 index 命令对 c 源码进行格式化，命令如下：

hxstrive@hxstrive:~$ cat test.c
#include <stdio.h>
#include <ctype.h>

int main() {
char c1 = 'A';
char c2 = ' ';
printf("isalnum(c1) = %d\n", isalnum(c1));
printf("isalnum(c2) = %d\n", isalnum(c2));
return 0;
}

hxstrive@hxstrive:~$ indent test.c

hxstrive@hxstrive:~$ cat test.c
#include <stdio.h>
#include <ctype.h>

int
main ()
{
  char c1 = 'A';
  char c2 = ' ';
  printf ("isalnum(c1) = %d\n", isalnum (c1));
  printf ("isalnum(c2) = %d\n", isalnum (c2));
  return 0;
}

可以看到，格式化后的代码更加易读。