C++核心准则​SF.10：避免依赖隐式包含的名称

SF.10: Avoid dependencies on implicitly #included names

SF.10：避免依赖隐式包含的名称

 

Reason（原因）

Avoid surprises. Avoid having to change #includes if an #included header changes. Avoid accidentally becoming dependent on implementation details and logically separate entities included in a header.

避免意外。避免因为包含的头文件的变更引起包含指令的变化。避免偶然依赖实现细节并从逻辑上分离某个头文件中包含的实体。

 

Example, bad（反面示例）

#include <iostream>
using namespace std;

void use()
{
    string s;
    cin >> s;               // fine
    getline(cin, s);        // error: getline() not defined
    if (s == "surprise") {  // error == not defined
        // ...
    }
}

<iostream> exposes the definition of std::string ("why?" makes for a fun trivia question), but it is not required to do so by transitively including the entire <string> header, resulting in the popular beginner question "why doesn't getline(cin,s); work?" or even an occasional "strings cannot be compared with ==).

<iostream>暴露了std::string的定义（“为什么？”会引出一个有趣的细节问题），这种做法的结果是一般的初学者问题：“为什么getlin(cin,s)不动作”，甚至偶然还会出现字符串无法使用==和）比较的问题。可以通过直接包含完全的<string>头文件消除这个需求。

The solution is to explicitly #include <string>:

解决方案就是显式包含<string>：

 

Example, good（范例）

#include <iostream>
#include <string>
using namespace std;

void use()
{
    string s;
    cin >> s;               // fine
    getline(cin, s);        // fine
    if (s == "surprise") {  // fine
        // ...
    }
}

Note（注意）

Some headers exist exactly to collect a set of consistent declarations from a variety of headers. For example:

有些头文件只是为了汇集了一套选自大量头文件的声明而存在，例如：

// basic_std_lib.h:

#include <string>
#include <map>
#include <iostream>
#include <random>
#include <vector>

a user can now get that set of declarations with a single #include"

现在用户可以使用一条包含指令引入一套声明：

#include "basic_std_lib.h"

This rule against implicit inclusion is not meant to prevent such deliberate aggregation.

本规则反对隐式包含，但无意阻止这种有意识的组合。

 

Enforcement（实施建议）

Enforcement would require some knowledge about what in a header is meant to be "exported" to users and what is there to enable implementation. No really good solution is possible until we have modules.

实施建议需要某些关于头文件意图向用户暴露什么和有什么可以让实现有效的知识。直到模块功能可用之前都不会有真正完美的解决方案。

 

原文链接

​​https:///isocpp/CppCoreGuidelines/blob/master/#sf10-avoid-dependencies-on-implicitly-included-names​​

 

新书介绍

​​《实战Python设计模式》​​是作者最近出版的新书，拜托多多关注！

本书利用Python 的标准GUI 工具包tkinter，通过可执行的示例对23 个设计模式逐个进行说明。这样一方面可以使读者了解真实的软件开发工作中每个设计模式的运用场景和想要解决的问题；另一方面通过对这些问题的解决过程进行说明，让读者明白在编写代码时如何判断使用设计模式的利弊，并合理运用设计模式。

对设计模式感兴趣而且希望随学随用的读者通过本书可以快速跨越从理解到运用的门槛；希望学习Python GUI 编程的读者可以将本书中的示例作为设计和开发的参考；使用Python 语言进行图像分析、数据处理工作的读者可以直接以本书中的示例为基础，迅速构建自己的系统架构。

 

---

 

觉得本文有帮助？请分享给更多人。

关注微信公众号【面向对象思考】轻松学习每一天！

面向对象开发，面向对象思考！