GoogleC++StyleGuide.pdf资源-CSDN文库

4星 · 超过85%的资源需积分: 14 27 浏览量 2014-08-11 17:54:43 上传评论 2 收藏 424KB PDF 举报

资源详情

资源评论

Google C++ Style Guide

由 lovelyanimal 精心制作，优化了显示效果。

请到本人博客 http://blog.csdn.net/lovelyanimal 下载最新版本，不需要积分滴。

Revision 3.274

Benjy Weinberger

Craig Silverstein

Gregory Eitzmann

Mark Mentovai

Tashana Landray

Table of Contents

Header

Files

The #define Guard Forward Declarations Inline Functions The -inl.h Files

Function Parameter Ordering Names and Order of Includes

Scoping Namespaces Nested Classes Nonmember, Static Member, and Global Functions

Local Variables Static and Global Variables

Classes Doing Work in Constructors Initialization Explicit Constructors Copy Constructors

Delegating and inheriting constructors Structs vs. Classes Inheritance Multiple Inheritance

Interfaces Operator Overloading Access Control Declaration Order Write Short Functions

Google-

Specific

Magic

Ownership and Smart Pointers cpplint

Other C++

Features

Reference Arguments Rvalue references Function Overloading Default Arguments

Variable-Length Arrays and alloca() Friends Exceptions Run-Time Type Information (RTTI)

Casting Streams Preincrement and Predecrement Use of const Use of constexpr

Integer Types 64-bit Portability Preprocessor Macros 0 and nullptr/NULL sizeof auto

Brace Initialization Lambda expressions Boost C++11

Naming General Naming Rules File Names Type Names Variable Names Constant Names

Function Names Namespace Names Enumerator Names Macro Names

Exceptions to Naming Rules

Comments Comment Style File Comments Class Comments Function Comments Variable Comments

Implementation Comments Punctuation, Spelling and Grammar TODO Comments

Deprecation Comments

Formatting Line Length Non-ASCII Characters Spaces vs. Tabs Function Declarations and Definitions

Function Calls Braced Initializer Lists Conditionals Loops and Switch Statements

Pointer and Reference Expressions Boolean Expressions Return Values

Variable and Array Initialization Preprocessor Directives Class Format

Constructor Initializer Lists Namespace Formatting Horizontal Whitespace

Vertical Whitespace

Exceptions

to the

Rules

Existing Non-conformant Code Windows Code

Important Note

～ Displaying Hidden Details in this Guide

This style guide contains many details that are initially hidden from view. They are marked by the triangle icon, which you

see here on your left. Click it now. You should see "Hooray" appear below.

Hooray! Now you know you can expand points to get more details. Alternatively, there's an "expand all" at the top of this

document.

Background

C++ is the main development language used by many of Google's open-source projects. As every C++ programmer

knows, the language has many powerful features, but this power brings with it complexity, which in turn can make code

more bug-prone and harder to read and maintain.

The goal of this guide is to manage this complexity by describing in detail the dos and don'ts of writing C++ code. These

rules exist to keep the code base manageable while still allowing coders to use C++ language features productively.

Style

, also known as readability, is what we call the conventions that govern our C++ code. The term Style is a bit of a

misnomer, since these conventions cover far more than just source file formatting.

One way in which we keep the code base manageable is by enforcing

consistency

. It is very important that any

programmer be able to look at another's code and quickly understand it. Maintaining a uniform style and following

conventions means that we can more easily use "pattern-matching" to infer what various symbols are and what invariants

are true about them. Creating common, required idioms and patterns makes code much easier to understand. In some

cases there might be good arguments for changing certain style rules, but we nonetheless keep things as they are in

order to preserve consistency.

Another issue this guide addresses is that of C++ feature bloat. C++ is a huge language with many advanced features. In

some cases we constrain, or even ban, use of certain features. We do this to keep code simple and to avoid the various

common errors and problems that these features can cause. This guide lists these features and explains why their use is

restricted.

Open-source projects developed by Google conform to the requirements in this guide.

Note that this guide is not a C++ tutorial: we assume that the reader is familiar with the language.

Header Files

In general, every .cc file should have an associated .h file. There are some common exceptions, such as unittests and

small .cc files containing just a main() function.

Correct use of header files can make a huge difference to the readability, size and performance of your code.

The following rules will guide you through the various pitfalls of using header files.

～ The #define Guard

All header files should have #define guards to prevent multiple inclusion. The format of the symbol name should be

<PROJECT>_<PATH>_<FILE>_H_.

To guarantee uniqueness, they should be based on the full path in a project's source tree. For example, the file

foo/src/bar/baz.h in project foo should have the following guard:

#ifndef FOO_BAR_BAZ_H_

#define FOO_BAR_BAZ_H_

...

#endif // FOO_BAR_BAZ_H_

～ Forward Declarations

You may forward declare ordinary classes in order to avoid unnecessary #includes.

Definition:

A "forward declaration" is a declaration of a class, function, or template without an associated definition. #include lines

can often be replaced with forward declarations of whatever symbols are actually used by the client code.

Pros:

Unnecessary #includes force the compiler to open more files and process more input.

They can also force your code to be recompiled more often, due to changes in the header.

Cons:

It can be difficult to determine the correct form of a forward declaration in the presence of features like templates,

typedefs, default parameters, and using declarations.

It can be difficult to determine whether a forward declaration or a full #include is needed for a given piece of

code, particularly when implicit conversion operations are involved. In extreme cases, replacing an #include with a

forward declaration can silently change the meaning of code.

Forward declaring multiple symbols from a header can be more verbose than simply #includeing the header.

Forward declarations of functions and templates can prevent the header owners from making otherwise-compatible

changes to their APIs; for example, widening a parameter type, or adding a template parameter with a default

value.

Forward declaring symbols from namespace std:: usually yields undefined behavior.

Structuring code to enable forward declarations (e.g. using pointer members instead of object members) can make

the code slower and more complex.

The practical efficiency benefits of forward declarations are unproven.

Decision:

When using a function declared in a header file, always #include that header.

When using a class template, prefer to #include its header file.

When using an ordinary class, relying on a forward declaration is OK, but be wary of situations where a forward

declaration may be insufficient or incorrect; when in doubt, just #include the appropriate header.

Do not replace data members with pointers just to avoid an #include.

Always #include the file that actually provides the declarations/definitions you need; do not rely on the symbol being

brought in transitively via headers not directly included. One exception is that myfile.cc may rely on #includes and

forward declarations from its corresponding header file myfile.h.

～ Inline Functions

Define functions inline only when they are small, say, 10 lines or less.

Definition:

You can declare functions in a way that allows the compiler to expand them inline rather than calling them through the

usual function call mechanism.

Pros:

Inlining a function can generate more efficient object code, as long as the inlined function is small. Feel free to inline

accessors and mutators, and other short, performance-critical functions.

Cons:

Overuse of inlining can actually make programs slower. Depending on a function's size, inlining it can cause the code size

to increase or decrease. Inlining a very small accessor function will usually decrease code size while inlining a very large

function can dramatically increase code size. On modern processors smaller code usually runs faster due to better use of

the instruction cache.

Decision:

A decent rule of thumb is to not inline a function if it is more than 10 lines long. Beware of destructors, which are often

longer than they appear because of implicit member- and base-destructor calls!

Another useful rule of thumb: it's typically not cost effective to inline functions with loops or switch statements (unless, in

the common case, the loop or switch statement is never executed).

It is important to know that functions are not always inlined even if they are declared as such; for example, virtual and

recursive functions are not normally inlined. Usually recursive functions should not be inline. The main reason for making

a virtual function inline is to place its definition in the class, either for convenience or to document its behavior, e.g., for

accessors and mutators.

～ The -inl.h Files

You may use file names with a -inl.h suffix to define complex inline functions when needed.

The definition of an inline function needs to be in a header file, so that the compiler has the definition available for

inlining at the call sites. However, implementation code properly belongs in .cc files, and we do not like to have much

actual code in .h files unless there is a readability or performance advantage.

If an inline function definition is short, with very little, if any, logic in it, you should put the code in your .h file. For

example, accessors and mutators should certainly be inside a class definition. More complex inline functions may also be

put in a .h file for the convenience of the implementer and callers, though if this makes the .h file too unwieldy you can

instead put that code in a separate -inl.h file. This separates the implementation from the class definition, while still

allowing the implementation to be included where necessary.

Another use of -inl.h files is for definitions of function templates. This can be used to keep your template definitions

easy to read.

Do not forget that a -inl.h file requires a #define guard just like any other header file.

～ Function Parameter Ordering

When defining a function, parameter order is: inputs, then outputs.

Parameters to C/C++ functions are either input to the function, output from the function, or both. Input parameters are

usually values or const references, while output and input/output parameters will be non-const pointers. When ordering

function parameters, put all input-only parameters before any output parameters. In particular, do not add new

parameters to the end of the function just because they are new; place new input-only parameters before the output

parameters.

This is not a hard-and-fast rule. Parameters that are both input and output (often classes/structs) muddy the waters, and,

as always, consistency with related functions may require you to bend the rule.

～ 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"

剩余54页未读，继续阅读

评论收藏

内容反馈

ACzhang

2018-07-15

还没看，得好好看！

Google C++ Style Guide.pdf

评论1

最新资源

Google C++ Style Guide.pdf

评论1

最新资源

相关推荐

Google C++ Style Guide (中文版).pdf

Google C++ Style Guide （中文+英文）

Google C++Style Guide 高清书签版

Google C++ Style Guide.rar

Google C++ Style Guide.pdf_编程规范_style_C++_

Google C++ Style Guide中文.pdf

Google C++ Style Guide.zip

Google C++ Style Guide中文PDF

Google C++ Style Guide 20160305.pdf

Google C++ Style Guide(Google C++编程规范）高清PDF

Google C++ Style Guide

Google C++ Style Guide中文版

Google C++ Style Guide中英文版.rar

Google C++ Style Guide_英文版.pdf

C++ Style Guide.pdf

Google C++ Style Guide译文.pdf

Google_C++_Style_Guide_谷歌_C++编码风格指南.docx

google-styleguide.pdf

谷歌C++规范 Google C++ Style Guide PDF

win10环境下vscode运行opencv(C++)(解压即用)-1号包

虹软3.0人脸识别客户端（追踪，活体检测，人脸特征存储，人脸识别，人脸注册，人脸匹配）可离线断网部署 5000个免费key/年

c++入门，核心，提高讲义笔记

仿照Visionmaster，用C++、Qt编写的视觉软件

C++STL库常用库函数总结

c++小游戏 c++小游戏

mingw-w64-install.exe

C/C++中文帮助文档