• 代码规范:换行对齐问题


    今天有同事看了我写的代码,问为何逗号要放在前面,以下列两段代码为列:


    代码段一
    void function(int a
                      , char b
                      , short c
                      , long d
                      , struct* e)
    {
    }
    注:这里的排版有点问题,实际应当是int和char等对齐的。

    代码段二:
    int x = a
           + b
           + c
           + d;


    对一于单行代码过长时,采取换行,这个没有什么可争议的,主要焦点在新的一行从哪开始,通常有两派,一派就是如上述两段代码所示,另一派则采用如下规范:
    void function(int a,
                        char b,
                        short c,
                        long d,
                        struct* e)
    {
    }


    在刚出道的前几年,我采用的是逗号置尾风格,但后来,我一直采用逗号置前的风格,因为我认为这样做更好,为什么会更好了?先提一个问题:换行的目的是什么?我想答案应当是:让代码更清晰,可读性更好,也让书写更不容易犯错误。总结起来有以下几条好处:
    1.代码更清晰(这条不是独特的,因为逗号置尾也一样具备)
    2.逗号有类似于1、2、3的标识作用,如同在写WORD或PPT文档时列出一、二、三、四
    3.有注释的作用,可以将逗号看成注释符,可以更清楚的标明这是一行的开始
    4.可增加代码的观赏性,统一以逗号打头,显得更有美感


    有些时候,简单换行仍可能导致单行过长,这个时候可改变对齐点,我一般如下做:
    void function(
          int a
        , char b,
        , short c,
        , long d,
        , struct* e)
    {
    }


    这样基本可以解决大多数参数列表过长问题,对于表达式过长的问题,采取同样的解决方式。


    我们需要规范,但不应当是死板的规范,最好可让它展现出一点活力,比如对于二目操作符的空格问题,就应当有柔性,而不是不分场合统一前后空一格,如:
    int x = (a + b) / M;
    虽然很规范,但从美观上来说,不协调,如同一个人身材虽棒,但却如水桶,也许下面的做法更好:
    int x = (a+b) / M;
    让a和b更紧凑点,整体上看起来就协调多了。还有一些类似的,比如不要头重脚轻,象:
    if (false)
    {
        int m = x[i];
        int d = foo(m);
        woo(d);
    }
    else
    {
        ++i;
    }
    这个就长了个大脑袋,很多小孩子就是这样,头大大的,颠倒过来成人:
    if (true)
    {
        ++i;
    }
    else
    {
        int m = x[i];
        int d = foo(m);
        woo(d);
    }
    现在就符合我们日常的审美了。细节不一定决定成败,但一定影响品质,电路板就是一个好的见证。开源项目mooon在遵循规范的同时,也一直在努力提升代码的美感。
  • 相关阅读:
    数据库生成说明
    Android 的 SurfaceView 双缓冲应用
    一些and知识 和ui
    weibo11
    android总结
    weibo14
    weibo9
    weibo12
    weibo10
    在线人数的统计
  • 原文地址:https://www.cnblogs.com/aquester/p/9892028.html
Copyright © 2020-2023  润新知