码迷,mamicode.com
首页 > Windows程序 > 详细

VS2015--win32工程配置的一些想法之Google Code Style中头文件的顺序

时间:2016-02-18 01:24:48      阅读:269      评论:0      收藏:0      [点我收藏+]

标签:

工程大了,有很多的头文件,也要引用很多的库文件。
从我们学习C++写hello world的那一刻起,就知道要包含一些系统文件。

那么顺序如何呢?
在review的时候,感觉自己写的东西就是一坨屎。

看看Google code style中是如何描述include文件顺序的:

Names and Order of Includes
Use standard order for readability and to avoid hidden dependencies: C library, C++ library, other libraries’ .h, your project’s .h.

All of a project’s header files should be listed as descendants of the project’s source directory without use of UNIX directory shortcuts . (the current directory) or .. (the parent directory). For example, google-awesome-project/src/base/logging.h should be included as

#include "base/logging.h"

In dir/foo.cc or dir/foo_test.cc, whose main purpose is to implement or test the stuff in dir2/foo2.h, order your includes as follows:

dir2/foo2.h (preferred location — see details below).
C system files.
C++ system files.
Other libraries’ .h files.
Your project’s .h files.

The preferred ordering reduces hidden dependencies. We want every header file to be compilable on its own. The easiest way to achieve this is to make sure that every one of them is the first .h file #included in some .cc.

dir/foo.cc and dir2/foo2.h are often in the same directory (e.g. base/basictypes_test.cc and base/basictypes.h), but can be in different directories too.

Within each section it is nice to order the includes alphabetically.

For example, the includes in google-awesome-project/src/foo/internal/fooserver.cc might look like this:

#include "foo/public/fooserver.h"  // Preferred location.

#include <sys/types.h>
#include <unistd.h>

#include <hash_map>
#include <vector>

#include "base/basictypes.h"
#include "base/commandlineflags.h"
#include "foo/public/bar.h"

这用通俗的讲,你写了一个a.h和a.cc,而在.cc文件中需要用到一些通用的东西位于base文件夹下的base.h中。那么在a.cc文件中,你就应该这样的顺序包含:

#include a.h

#include <sys/types.h> 

#include <algorithm>

#include "base/base.h"

VS2015--win32工程配置的一些想法之Google Code Style中头文件的顺序

标签:

原文地址:http://blog.csdn.net/wangshubo1989/article/details/50683276

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!