fix codeblock indent

This commit is contained in:
kenkangxgwe 2017-09-04 21:30:08 -04:00
parent 17cf351991
commit 5a1e9ef3a4

View File

@ -66,17 +66,20 @@
* 前置声明可能会被库的后续更改所破坏。前置声明函数或模板有时会妨碍头文件开发者变动其 API. 例如扩大形参类型,加个自带默认参数的模板形参等等。
* 前置声明来自命名空间 ``std::`` 的 symbol 时,其行为未定义。
* 很难判断什么时候该用前置声明,什么时候该用 ``#include`` 。极端情况下,用前置声明代替 ``includes`` 甚至都会暗暗地改变代码的含义:
.. code-block:: c++
// b.h:
struct B {};
struct D : B {}
// good_user.cc:
#include "b.h"
void f(B*);
void f(void*);
void test(D* x) { f(x); } // calls f(B*)
如果 ``#include````B````D`` 的前置声明替代, ``test()`` 就会调用 ``f(void*)`` .
.. code-block:: c++
// b.h:
struct B {};
struct D : B {}
// good_user.cc:
#include "b.h"
void f(B*);
void f(void*);
void test(D* x) { f(x); } // calls f(B*)
如果 ``#include````B````D`` 的前置声明替代, ``test()`` 就会调用 ``f(void*)`` .
* 前置声明了不少来自头文件的 symbol 时,就会比单单一行的 ``include`` 冗长。
* 仅仅为了能前置声明而重构代码(比如用指针成员代替对象成员)会使代码变得更慢更复杂.
@ -139,7 +142,7 @@
#. 其他库的 ``.h`` 文件
#. 本项目内 ``.h`` 文件
这种优先的顺序排序保证当 ``dir2/foo2.h`` 遗漏某些必要的库时, ``dir/foo.cc````dir/foo_test.cc`` 的构建会立刻中止。因此这一条规则保证维护这些文件的人们首先看到构建中止的消息而不是维护其他包的人们。
这种优先的顺序排序保证当 ``dir2/foo2.h`` 遗漏某些必要的库时, ``dir/foo.cc````dir/foo_test.cc`` 的构建会立刻中止。因此这一条规则保证维护这些文件的人们首先看到构建中止的消息而不是维护其他包的人们。
``dir/foo.cc````dir2/foo2.h`` 通常位于同一目录下 (如 ``base/basictypes_unittest.cc````base/basictypes.h``), 但也可以放在不同目录下.
@ -155,7 +158,7 @@
#include <sys/types.h>
#include <unistd.h>
#include <hash_map>
#include <vector>