gnu indent 美化C程序代码

2009年3月18日 06:07

参考: http://www.worldhello.net/doc/program_rules/indent.html

google搜索就能找到gnu indent.

The `indent' program can be used to make code easier to read. It can also convert from one style of writing C to another.

 

参照GNU，Kernighan & Ritchie，Berkeley风格，制定了自己风格：

  1. indent命令参数：

    -bad -bap -bbb -bbo -nbc -bl -bli0 -bls -c33 -cd33 -ncdb -ncdw -nce -cli0 -cp33 -cs -d0 -nbfda -di2 -nfc1 -nfca -hnl -ip5 -l75 -lp -pcs -nprs -psl -saf -sai -saw -nsc -nsob -nss -i4 -ts4 -ut

  2. indent配置文件

    如上参数可写入用户目录下的文件：".indent.pro"，作为运行indent的确省参数。

  3. indent配置说明

    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来缩进

效果:

刚用 indent 美化了根据《C语言接口与实现》中异常一章编写的例子:

预处理之后:

 

int main()
{
 char *buf;

 do { volatile int Except_flag; Except_Frame Except_frame; Except_frame.prev = Except_stack; Except_stack = &Except_frame; Except_flag = _setjmp (Except_frame.env); if(Except_flag == Except_entered) {
  buf = allocate(512);
    if(Except_flag == Except_entered) Except_stack = Except_stack->prev; } else if (Except_frame.exception == &(Allocate_Failed)) { Except_flag = Except_handled;
  fprintf(stderr, "Couldn't allocate the buffer.\n");
 if(Except_flag == Except_entered) Except_stack = Except_stack->prev; } else if (Except_frame.exception == &(Allocate_Success)) { Except_flag = Except_handled;
  fprintf(stderr, "Can allocate the buffer.\n");
 if(Except_flag == Except_entered) Except_stack = Except_stack->prev; } { if(Except_flag == Except_entered) Except_flag = Except_finalized;
  fprintf(stderr, "FINALLY SCOPE.\n");
 if(Except_flag == Except_entered) Except_stack = Except_stack->prev; } if(Except_flag == Except_raised) Except_raise(Except_frame.exception, Except_frame.file, Except_frame.line); } while(0);
}

经 indent 处理后:

 

int
main ()
{
        char *buf;

        do
        {
                volatile int Except_flag;
                Except_Frame Except_frame;

                Except_frame.prev = Except_stack;
                Except_stack = &Except_frame;
                Except_flag = _setjmp (Except_frame.env);
                if (Except_flag == Except_entered)
                {
                        buf = allocate (512);
                        if (Except_flag == Except_entered)
                                Except_stack = Except_stack->prev;
                }
                else if (Except_frame.exception == &(Allocate_Failed))
                {
                        Except_flag = Except_handled;
                        fprintf (stderr, "Couldn't allocate the buffer.\n");
                        if (Except_flag == Except_entered)
                                Except_stack = Except_stack->prev;
                }
                else if (Except_frame.exception == &(Allocate_Success))
                {
                        Except_flag = Except_handled;
                        fprintf (stderr, "Can allocate the buffer.\n");
                        if (Except_flag == Except_entered)
                                Except_stack = Except_stack->prev;
                }
                {
                        if (Except_flag == Except_entered)
                                Except_flag = Except_finalized;
                        fprintf (stderr, "FINALLY SCOPE.\n");
                        if (Except_flag == Except_entered)
                                Except_stack = Except_stack->prev;
                }
                if (Except_flag == Except_raised)
                        Except_raise (Except_frame.exception, Except_frame.file,
                                                  Except_frame.line);
        }
        while (0);
}

 

哇...好好的工具(*^__^*) 嘻嘻……

 

 

Tags: gnu indent
Posted in Unix-C Programming | 0 Comments