首页 文章详情

C++核心准则SF.3:使用.h文件管理所有在多个源文件中使用的声明

面向对象思考 | 351 2020-10-05 23:00 0 0 0
UniSMS (合一短信)

SF.3: Use .h files for all declarations used in multiple source files

SF.3:使用.h文件管理所有在多个源文件中使用的声明


Reason(原因)

Maintainability. Readability.

维护性。可读性。


Example, bad(反面示例)

// bar.cpp:
void bar() { cout << "bar\n"; }

// foo.cpp:
extern void bar();
void foo() { bar(); }

A maintainer of bar cannot find all declarations of bar if its type needs changing. The user of bar cannot know if the interface used is complete and correct. At best, error messages come (late) from the linker.

如果需要修改bar的类型,维护者无法找到bar的所有声明。bar的用户无法知道所用的接口是否完全和正确。


Enforcement(实施建议)

  • Flag declarations of entities in other source files not placed in a .h.

  • 标记实体的定义没有放在.h文件中而放在其他源文件中的情况。


原文链接

https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#sf3-use-h-files-for-all-declarations-used-in-multiple-source-files


新书介绍

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

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

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




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

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

面向对象开发,面向对象思考!



good-icon 0
favorite-icon 0
收藏
回复数量: 0
    暂无评论~~
    Ctrl+Enter