Linux:indent 命令
一、概述
功能说明:调整 C 原始代码文件的格式。
语法:indent [参数][源文件] 或 indent [参数][源文件][-o 目标文件]
补充说明: indent 可辨识 C 的原始代码文件,并加以格式化,以方便程序设计师阅读。
参数:
-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 显示版本信息。
二、实例
1.示例一
# indent -kr -i8 main.c
kr选项表示K&R风格,-i8表示缩进8个空格的长度。如果没有指定-nut选项,则每8个缩进空格会自动用一个Tab代替。注意indent命令会直接修改原文件,而不是打印到屏幕上或者输出到另一个文件,这一点和很多UNIX命令不同。
2.示例二
# indent -npro -kr -i8 -ts8 -sob -l80 -ss -bl -bli 0 main.c
参数说明:
-npro或--ignore-profile 不要读取indent的配置文件.indent.pro。
-kr 指定使用Kernighan&Ritchie的格式。
-i8 --indent-level 设置缩排的格数为8。
-ts8 设置tab的长度
-sob或--swallow-optional-blank-lines 删除多余的空白行。
-l80 代码超过80换行
-ss或--space-special-semicolon 若for区段只有一行时,在分号前加上空格。
-ncs或--no-space-after-casts 不要在cast之后空一格。
-bl {分行显示
-bli 0 括号缩进为0