From 19b4e25c690e090cd4aaac5772fac69a5f918312 Mon Sep 17 00:00:00 2001 From: Yi Yang Date: Sat, 2 Jul 2022 13:08:37 +0800 Subject: [PATCH] tweak --- README.md | 5 +-- src/SUMMARY.md | 104 ++++++++++++++++++++++++------------------------- 2 files changed, 53 insertions(+), 56 deletions(-) diff --git a/README.md b/README.md index 8d25537..63b8f5e 100644 --- a/README.md +++ b/README.md @@ -5,11 +5,9 @@ [![Backers on Open Collective](https://opencollective.com/EffectiveModernCppChinese/backers/badge.svg)](#backers) [![Sponsors on Open Collective](https://opencollective.com/EffectiveModernCppChinese/sponsors/badge.svg)](#sponsors) -> ! 2017.10开始更新
> ! 标注“已修订”的章节表示已经没有大致的错误
> ! 我没有版权，我没有版权，我没有版权
> ! 本书要求读者具有C++基础
-> ! 未翻译的条款名称现在直译，翻译时可能适当修改
> ! [在线浏览](https://cntransgroup.github.io/EffectiveModernCppChinese)
> ! [PDF格式英文版下载](0.Public/EffectiveModernCpp.pdf),仅供翻译参考
@@ -38,7 +36,7 @@ 4. __智能指针__ 1. [Item 18:对于独占资源使用std::unique_ptr](src/4.SmartPointers/item18.md) 由 @wendajiang贡献 2. [Item 19:对于共享资源使用std::shared_ptr](src/4.SmartPointers/item19.md) 已修订 - 3. [Item 20:当std::shard_ptr可能悬空时使用std::weak_ptr](src/4.SmartPointers/item20.md) 更新完成 + 3. [Item 20:当std::shard_ptr可能悬空时使用std::weak_ptr](src/4.SmartPointers/item20.md) 4. [Item 21:优先考虑使用std::make_unique和std::make_shared而非new](src/4.SmartPointers/item21.md) 由 @pusidun贡献 5. [Item 22:当使用Pimpl惯用法，请在实现文件中定义特殊成员函数](src/4.SmartPointers/item22.md) 由 @BlurryLight贡献 5. __右值引用，移动语义，完美转发__ @@ -67,6 +65,7 @@ 2. [Item 42:考虑就地创建而非插入](src/8.Tweaks/item42.md) 由 @wendajiang贡献 ## 其他资源 ++ [**在线阅读**](https://cntransgroup.github.io/EffectiveModernCppChinese) + 本书[PDF格式的中文版](./0.Public/translated/translate-zh-combine.pdf)见于此，该版本通常同步或者滞后于当前Markdown文档 + [Effective C++ Xmind Doc](./0.Public/EffectModernC++.xmind) diff --git a/src/SUMMARY.md b/src/SUMMARY.md index 6e5d644..617b6af 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -1,53 +1,51 @@ -# Summary - -- [Introduction](./Introduction.md) -- [Chapter 1. Deducing Types]() - - [Item 1: Understanding template type deduction](./1.DeducingTypes/item1.md) - - [Item 2: Understand auto type deduction](./1.DeducingTypes/item2.md) - - [Item 3: Understand decltype](./1.DeducingTypes/item3.md) - - [Item 4: Know how to view deduced types](./1.DeducingTypes/item4.md) -- [Chapter 2. auto]() - - [Item 5: Prefer auto to explicit type declarations](./2.Auto/item5.md) - - [Item 6: Use the explicitly typed initializer idiom when auto deduces undesired types](./2.Auto/item6.md) -- [Chapter 3. Moving to Modern C++]() - - [Item 7: Distinguish between () and {} when creating objects](./3.MovingToModernCpp/item7.md) - - [Item 8: Prefer nullptr to 0 or NULL](./3.MovingToModernCpp/item8.md) - - [Item 9: Prefer alias declarations to typedefs](./3.MovingToModernCpp/item9.md) - - [Item 10: Prefer scoped enums to unscoped enums](./3.MovingToModernCpp/item10.md) - - [Item 11: Prefer deleted functions to private undefined ones](./3.MovingToModernCpp/item11.md) - - [Item 12: Declare overriding functions override](./3.MovingToModernCpp/item12.md) - - [Item 13: Prefer const_iterators to iterators](./3.MovingToModernCpp/item13.md) - - [Item 14: Declare functions noexcept if they won't emit exceptions](./3.MovingToModernCpp/item14.md) - - [Item 15: Use constexpr whenever possible](./3.MovingToModernCpp/item15.md) - - [Item 16: Make const member functions thread safe](./3.MovingToModernCpp/item16.md) - - [Item 17: Understand special member funciton generation](./3.MovingToModernCpp/item17.md) -- [Chapter 4. Smart Pointer]() - - [Item 18: Use std::unique_ptr for exclusive-ownership resource management](./4.SmartPointers/item18.md) - - [Item 19: Use std::shared_ptr for shared-ownership resource management](./4.SmartPointers/item19.md) - - [Item 20: Use std::weak_ptr for std::shared_ptr like pointers that can dangle](./4.SmartPointers/item20.md) - - [Item 21: Prefer std::make_unique and std::make_shared to direct use of new](./4.SmartPointers/item21.md) - - [Item 22: When using the Pimpl Idiom, define special member functions in the implementation file](./4.SmartPointers/item22.md) -- [Chapter 5. Rvalue References, Move Semantics, and Perfect Forwarding]() - - [Item 23: Understand std::move and std::forward](./5.RRefMovSemPerfForw/item23.md) - - [Item 24: Distinguish universal references from rvalue references](./5.RRefMovSemPerfForw/item24.md) - - [Item 25: Use std::move on rvalue references, std::forward on universal references](./5.RRefMovSemPerfForw/item25.md) - - [Item 26: Avoid overloading on universal references](./5.RRefMovSemPerfForw/item26.md) - - [Item 27: Familiarize yourself with alternatives to overaloading on univeral references](./5.RRefMovSemPerfForw/item27.md) - - [Item 28: Understand reference collapsing](./5.RRefMovSemPerfForw/item28.md) - - [Item 29: Assume that move operations are not present not cheap, and not used](./5.RRefMovSemPerfForw/item29.md) - - [Item 30: Familiarize yourself with perfect forwarding failure cases](./5.RRefMovSemPerfForw/item30.md) -- [Chapter 6. Lambda Expressions]() - - [Item 31: Avoid default capture modes](./6.LambdaExpressions/item31.md) - - [Item 32: Use init capture to move objects into closures](./6.LambdaExpressions/item32.md) - - [Item 33: Use decltype on auto&¶meters to std::forward them](./6.LambdaExpressions/item33.md) - - [Item 34: Prefer lambdas to std::bind](./6.LambdaExpressions/item34.md) -- [Chapter 7. The Concurrency API]() - - [Item 35: Prefer task-based programming to thread-based](./7.TheConcurrencyAPI/Item35.md) - - [Item 36: Specify std::launch::async if asynchronicity is essential](./7.TheConcurrencyAPI/item36.md) - - [Item 37: Make std::threads unjionable on all paths](./7.TheConcurrencyAPI/item37.md) - - [Item 38: Be aware of varying thread handle destructor behavior](./7.TheConcurrencyAPI/item38.md) - - [Item 39: Consider void futures for one-shot event communication](./7.TheConcurrencyAPI/item39.md) - - [Item 40: Use std::atomic for concurrency, volatile for special memory](./7.TheConcurrencyAPI/item40.md) -- [Chapter 8. Tweaks]() - - [Item 41: Consider pass by value for copyable parameters that are cheap to move and always copied](./8.Tweaks/item41.md) - - [Item 42: Consider emplacement instead of insertion](./8.Tweaks/item42.md) \ No newline at end of file +- [简介](./Introduction.md) +- [第一章 类型推导]() + - [Item 1:理解模板类型推导](./1.DeducingTypes/item1.md) + - [Item 2:理解auto类型推导](./1.DeducingTypes/item2.md) + - [Item 3:理解decltype](./1.DeducingTypes/item3.md) + - [Item 4:学会查看类型推导结果](./1.DeducingTypes/item4.md) +- [第二章 auto]() + - [Item 5:优先考虑auto而非显式类型声明](./2.Auto/item5.md) + - [Item 6:auto推导若非己愿，使用显式类型初始化惯用法](./2.Auto/item6.md) +- [第三章 移步现代C++]() + - [Item 7:区别使用()和{}创建对象](./3.MovingToModernCpp/item7.md) + - [Item 8:优先考虑nullptr而非0和NULL](./3.MovingToModernCpp/item8.md) + - [Item 9:优先考虑别名声明而非typedefs](./3.MovingToModernCpp/item9.md) + - [Item 10:优先考虑限域枚举而非未限域枚举](./3.MovingToModernCpp/item10.md) + - [Item 11:优先考虑使用deleted函数而非使用未定义的私有声明](./3.MovingToModernCpp/item11.md) + - [Item 12:使用override声明重载函数](./3.MovingToModernCpp/item12.md) + - [Item 13:优先考虑const_iterator而非iterator](./3.MovingToModernCpp/item13.md) + - [Item 14:如果函数不抛出异常请使用noexcept](./3.MovingToModernCpp/item14.md) + - [Item 15:尽可能的使用constexpr](./3.MovingToModernCpp/item15.md) + - [Item 16:让const成员函数线程安全](./3.MovingToModernCpp/item16.md) + - [Item 17:理解特殊成员函数函数的生成](./3.MovingToModernCpp/item17.md) +- [第四章 智能指针]() + - [Item 18:对于独占资源使用std::unique_ptr](./4.SmartPointers/item18.md) + - [Item 19:对于共享资源使用std::shared_ptr](./4.SmartPointers/item19.md) + - [Item 20:当std::shard_ptr可能悬空时使用std::weak_ptr](./4.SmartPointers/item20.md) + - [Item 21:优先考虑使用std::make_unique和std::make_shared而非new](./4.SmartPointers/item21.md) + - [Item 22:当使用Pimpl惯用法，请在实现文件中定义特殊成员函数](./4.SmartPointers/item22.md) +- [第五章 右值引用，移动语义，完美转发]() + - [Item 23:理解std::move和std::forward](./5.RRefMovSemPerfForw/item23.md) + - [Item 24:区别通用引用和右值引用](./5.RRefMovSemPerfForw/item24.md) + - [Item 25:对于右值引用使用std::move，对于通用引用使用std::forward](./5.RRefMovSemPerfForw/item25.md) + - [Item 26:避免重载通用引用](./5.RRefMovSemPerfForw/item26.md) + - [Item 27:熟悉重载通用引用的替代品](./5.RRefMovSemPerfForw/item27.md) + - [Item 28:理解引用折叠](./5.RRefMovSemPerfForw/item28.md) + - [Item 29:认识移动操作的缺点](./5.RRefMovSemPerfForw/item29.md) + - [Item 30:熟悉完美转发失败的情况](./5.RRefMovSemPerfForw/item30.md) +- [第六章 Lambda表达式]() + - [Item 31:避免使用默认捕获模式](./6.LambdaExpressions/item31.md) + - [Item 32:使用初始化捕获来移动对象到闭包中](./6.LambdaExpressions/item32.md) + - [Item 33:对于std::forward的auto&&形参使用decltype](./6.LambdaExpressions/item33.md) + - [Item 34:优先考虑lambda表达式而非std::bind](./6.LambdaExpressions/item34.md) +- [第七章 并发API]() + - [Item 35:优先考虑基于任务的编程而非基于线程的编程](./7.TheConcurrencyAPI/Item35.md) + - [Item 36:如果有异步的必要请指定std::launch::threads](./7.TheConcurrencyAPI/item36.md) + - [Item 37:从各个方面使得std::threads unjoinable](./7.TheConcurrencyAPI/item37.md) + - [Item 38:关注不同线程句柄析构行为](./7.TheConcurrencyAPI/item38.md) + - [Item 39:考虑对于单次事件通信使用void](./7.TheConcurrencyAPI/item39.md) + - [Item 40:对于并发使用std::atomic，volatile用于特殊内存区](./7.TheConcurrencyAPI/item40.md) +- [第八章 微调]() + - [Item 41:对于那些可移动总是被拷贝的形参使用传值方式](./8.Tweaks/item41.md) + - [Item 42:考虑就地创建而非插入](./8.Tweaks/item42.md) \ No newline at end of file