编写 hpp文件注意事项

原文地址 http://blog.csdn.net/liuzhanchen1987/article/details/7270005 

hpp,其实质就是将.cpp的实现代码混入.h头文件当中,定义与实现都包含在同一文件,则该类的调用者只需要include该hpp文件即可,无需再将cpp加入到project中进行编译。而实现代码将直接编译到调用者的obj文件中,不再生成单独的obj,采用hpp将大幅度减少调用 project中的cpp文件数与编译次数,也不用再发布烦人的lib与dll,因此非常适合用来编写公用的开源库。

    hpp的优点不少,但是编写中有以下几点要注意:

1、是Header   Plus   Plus 的简写。

2、与*.h类似,hpp是C++程序头文件 。

3、VCL专用的头文件,已预编译。

4、是一般模板类的头文件。

5、一般来说,*.h里面只有声明,没有实现,而*.hpp里声明实现都有,后者可以减少.cpp的数量。

6、*.h里面可以有using   namespace   std,而*.hpp里则无。

   
    7、不可包含全局对象和全局函数。
    由于hpp本质上是作为.h被调用者include,所以当hpp文件中存在全局对象或者全局函数,而该hpp被多个调用者include时,将在链接时导致符号重定义错误。要避免这种情况,需要去除全局对象,将全局函数封装为类的静态方法。
 
    8、类之间不可循环调用。
    在.h和.cpp的场景中,当两个类或者多个类之间有循环调用关系时,只要预先在头文件做被调用类的声明即可,如下:
    class B;
    class A{
    public:
         void someMethod(B b);
    };
    class B{
    public :
         void someMethod(A a);
    };
    在hpp场景中,由于定义与实现都已经存在于一个文件,调用者必需明确知道被调用者的所有定义,而不能等到cpp中去编译。因此hpp中必须整理类之间调用关系,不可产生循环调用。同理,对于当两个类A和B分别定义在各自的hpp文件中,形如以下的循环调用也将导致编译错误:
    //a.hpp
    #include "b.hpp"
    class A{
    public :
        void someMethod(B b);
    };
 
    //b.hpp
    #include "a.hpp"
    class B{
    public :
        void someMethod(A a);
    };
 
    9、不可使用静态成员。
    静态成员的使用限制在于如果类含有静态成员,则在hpp中必需加入静态成员初始化代码,当该hpp被多个文档include时,将产生符号重定义错误。唯一的例外是const static整型成员,因为在vs2003中,该类型允许在定义时初始化,如:
    class A{
    public:
       const static int intValue = 123;
    };
    由于静态成员的使用是很常见的场景,无法强制清除,因此可以考虑以下几种方式(以下示例均为同一类中方法)
    1.类中仅有一个静态成员时,且仅有一个调用者时,可以通过局域静态变量模拟
    //方法模拟获取静态成员
    someType getMember()
    {
       static someType value(xxx);//作用域内静态变量
       return value;
    }
    2.类中有多个方法需要调用静态成员,而且可能存在多个静态成员时,可以将每个静态成员封装一个模拟方法,供其他方法调用。
 
    someType getMemberA()
    {
       static someType value(xxx);//作用域内静态变量
       return value;
    }
    someType getMemberB()
    {
       static someType value(xxx);//作用域内静态变量
       return value;
    }
   void accessMemberA()
    {
       someType member = getMemberA();//获取静态成员
    };
    //获取两个静态成员
    void accessStaticMember()
    {
       someType a  = getMemberA();//获取静态成员
       someType b = getMemberB();
    };
 
    3.第二种方法对于大部分情况是通用的,但是当所需的静态成员过多时,编写封装方法的工作量将非常巨大,在此种情况下,建议使用Singleton模式,将被调用类定义成普通类,然后使用Singleton将其变为全局唯一的对象进行调用。
    如原h+cpp下的定义如下:
    class A{
    public :
        type getMember(){
           return member;
        }
        static type member;//静态成员
    }
 
    采用singleton方式,实现代码可能如下(singleton实现请自行查阅相关文档)
    //实际实现类
    class Aprovider{
    public :
        type getMember(){
           return member;
        }
        type member;//变为普通成员
    }
 
    //提供给调用者的接口类
    class A{
    public :
        type getMember(){
           return Singleton<AProvider >::getInstance()->getMember();
        }
    }

头文件里是函数的声明,不是具体实现。真正的实现文件,都是编译过的文件。我们只能调用,没法看源代码,(编译过)
为什么要编译呢?为了保密和利益啊,不公开源代码,所以搞个头文件和实现文件。

先看代码://输入x,输出x的平方。
--------------------------------------------------------
//a.hpp

class A
{
  public:
        int square(int x);
};
---------------------------------------------------------

//a.cpp

#include <stdio.h>
#include "a.hpp"


int A::square(int x)
{
   return x*x;
}
-----------------------------------------------------------------

//main.cpp

#include <stdio.h>
#include "a.hpp"


int main()
{
   int i;
   A a;
   printf( "请输入数值x :" );
   scanf("%d",&i);
   printf("调用square()函数输出x的平方:%d\n",a.square(i));

   return 0;
}

----------------------------------------------------------------------------------
我是这样自圆其说的:

      当main函数,(预编译时)预编译器遇到#include “a.hpp”了。它就到a.hpp文件看一眼,发现是个class声明,它明白了。
接着往下走流程。(预编译,编译……),到链接的时候 链接器把main.cpp和a.cpp一起链接。
      链接器为什么知道是a.cpp而不是其他文件呢?因为a.cpp里面有#include “a.hpp”啊,它就把a.hpp的内容和a.cpp的#include “a.hpp”替换,然后把a.cpp里的内容和main.cpp的#include“a.hpp”替换,就这么OK了。
一看便知:
             a.hpp(声明文件)
                       |
                 #include “a.hpp”
             /                 \
     main.cpp          a.cpp(实现文件)
他们是通过#include “a.hpp”联系在一起的。
更简单大胆的自圆其说:
a.cpp的内容 + a.hpp的内容,然后和main.cpp的内容加在一起,编译就ok了。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值