格式化工具indent使用笔记

indent可以格式化C/C++代码,经测试发现,只有Linux格式的文件才能正确格式化,即以LF结尾。

使用格式

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

个人总结

个人使用的

个人使用的:
indent -linux -bad -bap -bl -hnl -nce -cdw -bli0 -cli0 -cbi0 -ncs -lp -l200 -npcs -saf -sai -saw -i4 -nut hello.c -o b.c

-cli 指定switch 缩排格数??
-hnl 多行运算时,按一定格式换行
-bl -nce  for if while 等后的{另起一行 不要将else放到}后,即大括号另起一行
-cdw do{}while中,while与}在同一行。注:似乎和前面的冲突了,不生效(待研究)
-bli0 {不缩进,即对齐for if while 等
-ncs 类型转换不空格。注:只能识别已知类型,自定义的不行(注:发现原有不空格的,变成空格了,待研究)
-lp 过长截取时,对齐,-nlp 反之
-nbc 变量声明中,逗号分隔的变量不分行。最终效果为 int a, b, c;
-bad -bap 声明和实现之间添加空行,不一定符合实际情况。  
-npcs 函数名称后不加空格
-nut -i4  4空格,不使用tab缩进(即tab使用4个空格替换)
-saf -sai -saw for if while 后有一空格

-l200 非注释行,最长256 默认78

待改善的问题:

默认:指针类型的*不在类型后,而在变量前。

扩展知识

indent默认风格为gnu。另有kr、linux、orig(即原始的Berkeley风格)。经测试,linux风格较接近实际使用的。

linux风格默认为:
-nbad -bap -nbc -bbo -hnl -br -brs -c33 -cd33 -ncdb -ce -ci4
-cli0 -d0 -di1 -nfc1 -i8 -ip0 -l80 -lp -npcs -nprs -npsl -sai
-saf -saw -ncs -nsc -sob -nfca -cp33 -ss -ts8 -il1

过程记录

查找某目录下所有源码,转换成linux格式,再格式化。

find ./  -name '*.cpp' -or -name '*.c' -or -name "*.h" | xargs dos2unix 
find ./  -name '*.cpp' -or -name '*.c' -or -name "*.h" | xargs indent -linux -bl -nce -cdw -bli0 -cli0 -cbi0 -ncs -lp -l200 -npcs -saf -sai -saw -i4 -nut 

代码中有int ret=-1时警告:

Warning:old style assignment ambiguity in "=-".  Assuming "= -"

对c++一些语法处理不太好。如for (auto it:dataTable)
对没有分号;结尾的“函数”或宏处理不好,如#pragma pack(1),会自动再缩进。
一些小格式对齐不够人性化:

原为:
    int pre  = 0;
    int next = 0;
变成:
    int pre = 0;
    int next = 0;

建议先用工具格式化,再规范编码,后续以人工为准。

网络资料

参数说明:
-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

参  数:
-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  显示版本信息。

已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 技术工厂 设计师:CSDN官方博客 返回首页