zoukankan      html  css  js  c++  java
  • Linux indent命令详解 code formatter

    我目前使用的格式是

    indent -npro -gnu -i4 -ts4 -sob -l200 -ss -bl -bli 0 -npsl filename

    http://www.gnu.org/software/indent/manual/html_chapter/indent_1.html 

    indent 命令

    用途

    重新格式化一个 C 语言程序。

    语法

    indent InputFile [ OutputFile ] [ -nbad -bad ] [ -nbap -bap ] [ -nbbb -bbb ] [ -nbc -bc ] [ -br -bl] [ -cn] [ -cdn ] [ -ncdb -cdb ] [ -nce -ce] [ -cin ] [ -clin ] [ -dn ] [ -din ] [ -ndj -dj ] [ -nei-ei ] [ -fa ] [ -nfa ] [ -nfc1 -fc1 ] [ -in ] [ -nip -ip ] [ -ln ] [ -lcn ] [ -nlp -lp ] [ -npro] [ -npcs -pcs ] [ -nps -ps ] [ -npsl-psl ] [ -nsc -sc ] [ -nsob -sob ] [ -nslb -slb ] [ -st ] [ -troff ] [ -nv -v ] [ -TType ] ...

    描述

    indent 命令按照随命令输入的标志所指定的格式重新格式化一个 C 程序。

    如果只指定 InputFile 参数,重格式化的文件写回 InputFile 参数并且一个 InputFile 的备份副本被写回当前目录,文件名带 .BAK 后缀。

    如果指定 OutputFile 参数则 indent 命令将执行检查以确保它的名称与 InputFile 参数并不相同。

    要为 indent 命令设置自己的缺省概要文件,在您登录目录或当前目录中创建一个名为 .indent.pro 的文件。在这个文件中,包含想包含的标志,这些标志用空格、制表符或换行符隔开。

    当前目录下 .indent.pro 文件中的标志覆盖那些在您的登录目录下的标志( 除了 -T Type 标志,它是累积的)。如果 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  显示版本信息。

    Indent代码格式化说明
    使用的indent参数 含义
    --blank-lines-after-declarations bad 变量声明后加空行
    --blank-lines-after-procedures bap 函数结束后加空行
    --blank-lines-before-block-comments bbb 块注释前加空行
    --break-before-boolean-operator bbo 较长的行,在逻辑运算符前分行
    --blank-lines-after-commas nbc 变量声明中,逗号分隔的变量不分行
    --braces-after-if-line bl "if"和"{"分做两行
    --brace-indent 0 bli0 "{"不继续缩进
    --braces-after-struct-decl-line bls 定义结构,"struct"和"{"分行
    --comment-indentationn c33 语句后注释开始于行33
    --declaration-comment-columnn cd33 变量声明后注释开始于行33
    --comment-delimiters-on-blank-lines ncdb 不将单行注释变为块注释
    --cuddle-do-while ncdw "do --- while"的"while"和其前面的"}"另起一行
    --cuddle-else nce "else"和其前面的"}"另起一行
    --case-indentation 0 cli0 switch中的case语句所进0个空格
    --else-endif-columnn cp33 #else, #endif后面的注释开始于行33
    --space-after-cast cs 在类型转换后面加空格
    --line-comments-indentation n d0 单行注释(不从1列开始的),不向左缩进
    --break-function-decl-args nbfda 关闭:函数的参数一个一行
    --declaration-indentationn di2 变量声明,变量开始于2行,即不必对齐
    --format-first-column-comments nfc1 不格式化起于第一行的注释
    --format-all-comments nfca 不开启全部格式化注释的开关
    --honour-newlines hnl Prefer to break long lines at the position of newlines in the input.
    --indent-leveln i4 设置缩进多少字符,如果为tab的整数倍,用tab来缩进,否则用空格填充。
    --parameter-indentationn ip5 旧风格的函数定义中参数说明缩进5个空格
    --line-length 75 l75 非注释行最长75
    --continue-at-parentheses lp 续行从上一行出现的括号开始
    --space-after-procedure-calls pcs 函数和"("之间插入一个空格
    --space-after-parentheses nprs 在"("后")"前不插入空格
    --procnames-start-lines psl 将函数名和返回类型放在两行定义
    --space-after-for saf for后面有空格
    --space-after-if sai if后面有空格
    --space-after-while saw while后面有空格
    --start-left-side-of-comments nsc 不在生成的块注释中加*
    --swallow-optional-blank-lines nsob 不去掉可添加的空行
    --space-special-semicolon nss 一行的for或while语句,在";"前不加空。
    --tab-size ts4 一个tab为4个空格(要能整除"-in")
    --use-tabs ut 使用tab来缩进

  • 相关阅读:
    标签的讲解
    属性分类
    LeetCode 003. 无重复字符的最长子串 双指针
    Leetcode 136. 只出现一次的数字 异或性质
    Leetcode 231. 2的幂 数学
    LeetCode 21. 合并两个有序链表
    象棋博弈资源
    acwing 343. 排序 topsort floyd 传播闭包
    Leetcode 945 使数组唯一的最小增量 贪心
    Leetcode 785 判断二分图 BFS 二分染色
  • 原文地址:https://www.cnblogs.com/xuxm2007/p/2234987.html
Copyright © 2011-2022 走看看