diff --git a/google-cpp-styleguide/others.rst b/google-cpp-styleguide/others.rst index a1b0538..c9d0239 100644 --- a/google-cpp-styleguide/others.rst +++ b/google-cpp-styleguide/others.rst @@ -1,43 +1,7 @@ 6. 其他 C++ 特性 ---------------------------- -6.1. 引用参数 -~~~~~~~~~~~~~~~~~~~~~~ - -.. tip:: - - 所有按引用传递的参数必须加上 ``const``. - -定义: - - 在 C 语言中, 如果函数需要修改变量的值, 参数必须为指针, 如 ``int foo(int *pval)``. 在 C++ 中, 函数还可以声明引用参数: ``int foo(int &val)``. - -优点: - - 定义引用参数防止出现 ``(*pval)++`` 这样丑陋的代码. 像拷贝构造函数这样的应用也是必需的. 而且更明确, 不接受 ``NULL`` 指针. - -缺点: - - 容易引起误解, 因为引用在语法上是值变量却拥有指针的语义. - -结论: - - 函数参数列表中, 所有引用参数都必须是 ``const``: - - .. code-block:: c++ - - void Foo(const string &in, string *out); - - 事实上这在 Google Code 是一个硬性约定: 输入参数是值参或 ``const`` 引用, 输出参数为指针. 输入参数可以是 ``const`` 指针, 但决不能是非 ``const`` 的引用参数，除非用于交换，比如 ``swap()``. - - 有时候，在输入形参中用 ``const T*`` 指针比 ``const T&`` 更明智。比如： - - * 您会传 null 指针。 - * 函数要把指针或对地址的引用赋值给输入形参。 - - 总之大多时候输入形参往往是 ``const T&``. 若用 ``const T*`` 说明输入另有处理。所以若您要用 ``const T*``, 则应有理有据，否则会害得读者误解。 - -6.2. 右值引用 +6.1. 右值引用 ~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -68,7 +32,7 @@ .. _function-overloading: -6.3. 函数重载 +6.2. 函数重载 ~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -99,7 +63,7 @@ 如果您打算重载一个函数, 可以试试改在函数名里加上参数信息。例如，用 ``AppendString()`` 和 ``AppendInt()`` 等， 而不是一口气重载多个 ``Append()``. -6.4. 缺省参数 +6.3. 缺省参数 ~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -132,7 +96,7 @@ const AlphaNum &c = gEmptyAlphaNum, const AlphaNum &d = gEmptyAlphaNum); -6.5. 变长数组和 alloca() +6.4. 变长数组和 alloca() ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -151,7 +115,7 @@ 改用更安全的分配器（allocator），就像 ``std::vector`` 或 ``std::unique_ptr``. -6.6. 友元 +6.5. 友元 ~~~~~~~~~~~~~~~~ .. tip:: @@ -164,7 +128,7 @@ .. _exceptions: -6.7. 异常 +6.6. 异常 ~~~~~~~~~~~~~~~~ .. tip:: @@ -209,7 +173,7 @@ .. _RTTI: -6.8. 运行时类型识别 +6.7. 运行时类型识别 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ TODO @@ -270,7 +234,7 @@ 不要去手工实现一个类似 RTTI 的方案. 反对 RTTI 的理由同样适用于这些方案, 比如带类型标签的类继承体系. 而且, 这些方案会掩盖你的真实意图. -6.9. 类型转换 +6.8. 类型转换 ~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -301,7 +265,7 @@ .. _streams: -6.10. 流 +6.9. 流 ~~~~~~~~~~~~~~ .. tip:: @@ -354,7 +318,7 @@ 每一种方式都是各有利弊, "没有最好, 只有更适合". 简单性原则告诫我们必须从中选择其一, 最后大多数决定采用 ``printf + read/write``. -6.11. 前置自增和自减 +6.10. 前置自增和自减 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -377,7 +341,7 @@ 对简单数值 (非对象), 两种都无所谓. 对迭代器和模板类型, 使用前置自增 (自减). -6.12. ``const`` 用法 +6.11. ``const`` 用法 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -414,7 +378,7 @@ 这是说, 我们提倡但不强制 ``const`` 在前. 但要保持代码的一致性! (Yang.Y 注: 也就是不要在一些地方把 ``const`` 写在类型前面, 在其他地方又写在后面, 确定一种写法, 然后保持一致.) -6.13. ``constexpr`` 用法 +6.12. ``constexpr`` 用法 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -437,7 +401,7 @@ 靠 constexpr 特性，方才实现了 C++ 在接口上打造真正常量机制的可能。好好用 constexpr 来定义真・常量以及支持常量的函数。避免复杂的函数定义，以使其能够与constexpr一起使用。 千万别痴心妄想地想靠 constexpr 来强制代码「内联」。 -6.14. 整型 +6.13. 整型 ~~~~~~~~~~~~~~~~~~ .. tip:: @@ -482,7 +446,7 @@ 因此, 使用断言来指出变量为非负数, 而不是使用无符号型! -6.15. 64 位下的可移植性 +6.14. 64 位下的可移植性 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -544,7 +508,7 @@ .. _preprocessor-macros: -6.16. 预处理宏 +6.15. 预处理宏 ~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -565,7 +529,7 @@ - 不要试图使用展开后会导致 C++ 构造不稳定的宏, 不然也至少要附上文档说明其行为. - 不要用 ``##`` 处理函数，类和变量的名字。 -6.17. 0, ``nullptr`` 和 ``NULL`` +6.16. 0, ``nullptr`` 和 ``NULL`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -578,7 +542,7 @@ 字符 (串) 用 ``'\0'``, 不仅类型正确而且可读性好. -6.18. sizeof +6.17. sizeof ~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -604,7 +568,7 @@ return false; } -6.19. auto +6.18. auto ~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -677,7 +641,7 @@ .. _braced-initializer-list: -6.20. 列表初始化 +6.19. 列表初始化 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -767,7 +731,7 @@ .. _lambda-expressions: -6.21. Lambda 表达式 +6.20. Lambda 表达式 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -805,7 +769,7 @@ .. _template-metaprogramming: -6.22. 模板编程 +6.21. 模板编程 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: 不要使用复杂的模板编程 @@ -836,7 +800,7 @@ .. _boost: -6.23. Boost 库 +6.22. Boost 库 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. tip:: @@ -889,7 +853,7 @@ - `Array `_ : ``boost/array.hpp``, 改用 `std::array `_ -6.24. C++11 +6.23. C++11 ~~~~~~~~~~~~~~~~~~~~~~ .. tip::