• 第三章:PCL基础3.1


    架构师为了确保在PCL中所有代码风格的一致性,使得其他开发者及用户容易理解源码,PCL开发者制定并遵循着一套严格的编写规范,PCL的开发者都默认此规范。

    3.1PCL推荐的命名规范

    1、文件命名

    1)所有的文件名单词之间应该用下划线隔开,如:unordered_map.cpp

    2)头文件的扩展名为.h

    3)模板类实现文件的扩展名是.hpp

    4)源文件的扩展名是.cpp

    2、目录命名

    所有的目录及其子目录命名应该符合,如果由多个单词组成,其之间用下划线隔开,PCL中各个目录遵循以下规则:

    1)头文件都应该放在源码目录树种的include/下。

    2)模板类实现文件都应放在目录树中的include/impl/下。

    3)源文件都应该放在目录树中的src/下。

    3、include语句

    当文件在同一目录下时include指示语句用双引号,在其他情况下则用尖括号。例如:

    #include<pcl/module_name/file_name.h>

    #include<pcl/module_name/impl/file_name.hpp>

    #include"file_name.cpp"//在同一目录下

    4、宏定义命令

    宏定义中字母都采用大写格式,为头文件所定义的宏最后面还需要加上下划线,并且名称从include下目录开始,例如pcl/filters/bilateral.h对应PCL_FILTERS_BILATERAL_H_。#ifndef和#define定义放在BSD协议后面代码前面,#endif定义一直在文件结尾,并且加上一句注释掉的宏对应头文件的宏定义,例如

    //the BSD license

    #ifndef PCL_MODULE_NAME_IMPL_FILE_NAME_HPP_//为避免重复包含头文件而定义的宏

    #define PCL_MODULE_NAME_IMPL_FILE_NAME_HPP_

    //the code

    #endif  //PCL_MODULE_NAME_IMPL_FILE_NAME_HPP_

    5、命名空间命名

    命名空间多于一个单词的,单词之间应该用下划线连接,例如:

    namespace pcl_io

    {

    ...

    }

    6、类/结构命名

    类名(和其他自定义类型的名称)应该是CamelCased(驼峰命名)命名规范,也就是连写单词组成命名,每个单词首字母大写。但是也有例外,如果类名包含一个缩写,这个缩写应该全部大写,类名和结构名最好是名词组成的名字。例如PFHEstimation代替了EstimatePFH,下面是正确的例子:

    class ExampleClass;

    class PFHEstimation;

    7、函数/成员函数命名

    他们的命名应该采用camelCased,也就是连写单词组成命名,除了首个单词字母小写其他单词首字母大写,他们的参数命名单词之间用下划线隔开,函数和类的成员函数命名最好采用动词,应该确保这些名字能清楚表达函数或成员函数的功能,例如:checkForErrors()而不是errorCheck(),dumpDataToFile()而不是dataFiledump();正确的用法:

    int applyExample(int example_arg);

    8、变量命名

    变量的命名应该单词之间用下划线隔开例如:

    int my_variable;

    1)迭代子变量命名。迭代子变量应该反应出他们迭代的对象,例如:

    std::list<int> pid_list;

    std::list<int>::iterator pid_it;//指示迭代的对象为点的索引

    2)常量命名。常量的名字应该是全大写,例如:

    const static int MY_CONSTANT=1000;

    3)成员变量命名。类的成员变量命名单词之间用下划线隔开并且以下划线结尾,例如:

    int example_int_;//对阅读PCL源码很有帮助,可明显区分成员变量和局部变量

    9)Return语句

    return语句需要在圆括号中设有返回值,即规定return语句必须有返回值,大家知道,return没有返回值也会编译,例如:

    int main()

    {

      return(0);

    }

    3.1.2 PCL推荐的缩进与格式

    在PCL中每个代码块的标准缩进是两个空格,在任何情况下可以用制表符或其他空格间隔的方式进行格式化代码,PCL利用多样化的GNU类型格式。

    1、命名空间缩进格式

    在头文件里,命名空间的内容应该缩进两个空格,例如:

    在一个实现文件里,对每一个类成员函数或函数的命名必须添加命名空间限定,例如:

    void pcl::Foo::bar()

    {

    }

    2、类格式

    一个模板类的模板参数必须与类定义在不同行,如:

    template<typename T>

    class Foo

    {

       ...

    }

    3、函数/类成员函数格式

    每一个函数的返回类型声明必须与函数声明放在不同行,例如:

    void

    bar();

    在函数实现的时候也一样,返回类型必须与函数声明放在不同行,例如:

    或者

    或者

    4、花括号

    它必须成对出现,与上一句代码另起一行定义,必须闭合才组成合理的程序块。

    5、空格格式

    如果在头文件内嵌套应用了命名空间名,需要将其缩进两个空格,如:

    类和结构成员采用两个空格进行缩进,访问权限限定(public、private、protected)与类成员一级,而在其限定下的成员则需要缩进两个空格,如

    6、自动格式化代码

    3.1.3设计结构

    1、类和应用程序接口

    2、参数传递

  • 相关阅读:
    MyEclipse添加XML的xsd文件和dtd文件(自动补全xml节点代码)
    浅析Java中Map与HashMap,Hashtable,HashSet的区别(转载)
    jsp中:jsp声明与jsp脚本<%! int count=0;%> 与<% int count=0;%>
    JSP内置对象详细介绍(上)<转载>
    学习运用json
    win7与win7之间无法访问共享文件的问题解决(转)
    关于工作情绪化的问题
    Hadoop配置学习
    问题汇总
    mysql读写分离
  • 原文地址:https://www.cnblogs.com/gary-guo/p/6579695.html
Copyright © 2020-2023  润新知