cntransgroup / effectivemoderncppchinese Goto Github PK

View Code? Open in Web Editor NEW

7.2K 7.2K 1.1K 32.44 MB

《Effective Modern C++》- 完成翻译

Home Page: https://cntransgroup.github.io/EffectiveModernCppChinese/

effectivemoderncppchinese's Introduction

《Effective Modern C++ 》翻译

标注“已修订”的章节表示已经没有大致的错误

本书要求读者具有C++基础

PDF格式英文版下载,仅供翻译参考

在线浏览(推荐)

其他资源

在线阅读(推荐，与翻译内容同步更新)
本书PDF格式的中文版见于此，该版本通常同步或者滞后于当前Markdown文档
Effective C++ Xmind Doc

贡献者

感谢所有参与翻译/勘误/建议的贡献者们~

免责声明

译者纯粹出于学习目的与个人兴趣翻译本书，不追求任何经济利益。译者保留对此版本译文的署名权，其他权利以原作者和出版社的主张为准。本译文只供学习研究参考之用，不得公开传播发行或用于商业用途。有能力阅读英文书籍者请购买正版支持。

effectivemoderncppchinese's People

Contributors

Stargazers

Watchers

Forkers

sync2github dreamzhou xin-lover greylibrary slideclick stuhj zf2015 ftd2012 snolkmg ktcer zgsxwsdxg vmlinuxer cmejj zhihuazhanggdut zjkdragon eglrp memxz flying7993 hoshinotsuki fanghuoqianglfl chujiangke windski yurunyang1998 autohe mrwangcheng hillbamboo stonebegin yoursmile552 opencollective ewenwan byronrwth sweetquiet rexchun wydahai harveyhwliu asianhawk minggongzero zhangtianxiang chimayangfan zhangzheng0317 qqqqzl xiankang leo59 jiangyilun planck-a catmiyc xuhuajie-2021 llcc343 zjh19861014 fabri-guo mincau jeffreyforkfolder langyo caijieming-ng csysl willku1024 wincsb mingjitianming july0426 szloveni pusidun motionlessperi 0x01111 atnightly angelo-abel marscactus flpi007 saberdance gitqqqhs congzheualberta yssource rallymanw nehcuh yph0258691 rainbowmessi918 iverson31024 buyunhui yf704209745 yfyyyainaer alittlebug ryanlee2014 hexi519 kurikomoe anchuanxu johnite starliiit liangzai951 feiyunwill nkzxw lucienxian gwan95 littlepai doalter wendajiang star-in-night ggg006 xuyufan936831611 fanjaedong bugme1024 fangolf

effectivemoderncppchinese's Issues

item34 "其中第四个形参了音量" 应该为 "其中第四个形参指定了音量"

Chapter 5：Item29.md

The first letter should not be capital. The sequence of files in chapter 5 is incorrect. 🙃

item 11中有句话没翻译

"This chapter is largely devoted to common practices in C++98 that have been superseded by better practices in C++11."

这句话两种翻译：
1.本节主要致力于讨论C ++ 98中的常见实践，这些实践已被C ++ 11中的更好的实践所取代。
2.本节主要致力于讨论C++98被C++11中更好的实践所取代的那些常见实践。

那种更好呢？个人感觉delete这节应该主要讨论的是C++11的东西，如果采用翻译1，则感觉像是在讨论C++98。

....

当然了，非常感谢大佬们的无私奉献。但是确实不少地方好像是机器翻译的，按照英文的思维来翻译。对新手很难。

Chapter3 Item12 多处重载应该为重写

有三处重载应该修改为重写

Item 12:使⽤override声明重载函数
条款12：使⽤override声明重载函数
记住：
为重载函数加上override

chapter1: item3 "在这种形式下auto不再进⾏auto类型推导"

原文：

译文：

这里的翻译好像是错的。

原文的意思应该是
使用了这种声明形式， auto是要使用类型推导规则去推导他的类型的。更准确的说是编译器会从函数的实现去推导出函数的返回类型。

{简单的说就是， auto 是要使用函数的实现，通过类型推导规则推导出函数的返回类型}

而译文，给出了相返的意思。“不推导类型”，应该是错误的，

第一章第四节的boost网站错误

boost库官网是 https://boost.org，文章里的.com是食品网站

Item9中有如下一段翻译反了

std::remove_const::type // 从T中产出const T -----应为从const T产生T
std::remove_reference::type // 从T中产出T&和T&& ----应为重T&和T&&产生T
std::add_lvalue_reference::type // 从T&中产出T ---应为从T产生T&

Item17 中的关于deprecated的翻译问题

Item17多处对于 deprecated 这个词的翻译存在问题。一般会将其译为“过时的”，即当前标准仍支持，但是以后可能将其废弃（停止支持），而不是带着 is 将 is deprecated 译为“被废弃”。希望可以纠正这个小小的问题。

条款二十一中第三段的加粗错误

std::make_unique和std::make_shared是三个make函数中的两个：接收任意的多参数集合，完美转发到构造函数去动态分配一个对象，然后返回这个指向这个对象的指针。第三个make函数是std::allocate_shared。它行为和std::make_shared一样，只不过第一个参数是用来动态分配内存的allocator对象。

其中"make函数"被显示为**make函数**，没有加粗。

Bug: Item19

最后的 "Things to Remember" 第一条:
std::shared_ptr为任意共享所有权的资源**提供**一种自动垃圾回收的便捷方式

[item8]对run-of-the-mill的翻译有误

英文原版靠近结尾的部分：

The 0 passed in the call to lockAndCall was intended to represent a null pointer, but what actually got passed was a run-of-the-mill int.

run-of-the-mill意为“普通的，常规的，平平无奇的”，而不是译文中的“相差十万八千里”。

是否会有计划将项目部署在gitbook上

markdown阅读起来还是比较繁琐，尤其是目录置顶的设计对于快速跳转不是很友好。想请问下是否会有计划将项目部署在类似gitbook之类阅读体验比较友好的平台上。

条款11：誊抄错误

原文是：const void* 和 const char*

现在如果使用void*和char*调用processPointer就是无效的，按常理说const void*和const void*也应该无效，所以这些实例也应该标注delete:

条款30翻译润色

==========原文==========
给定我们的目标函数f和转发函数fwd，如果f使用某特定实参做一件事，但是fwd使用相同的实参做另一件事，完美转发就会失败：

f( expression ); //如果这个做某件事，
fwd( expression ); //但是这个做另外的某件事，fwd完美转发expression给f会失败
导致这种失败的实参种类有很多。知道它们是什么以及如何解决它们很重要，因此让我们来看看无法做到完美转发的实参类型。
============应该改为=============
给定我们的目标函数f和转发函数fwd，如果f使用某特定实参会执行某个操作，但是fwd使用相同的实参会执行不同的操作，完美转发就会失败

anyone can get a video for this?

Item 13 中格式问题

typedef std::vector<int>::iterator IterT; 	// typetypedef
std::vector<int>::const_iterator ConstIterT; // defs

应改成

typedef std::vector<int>::iterator IterT;       // type-
std::vector<int>::const_iterator ConstIterT; // defs

条款二十六：避免在通用引用上重载有个笔误~

logAndAdd(petName); //跟之前一样，拷贝右值到multiset
应该是
logAndAdd(petName); //跟之前一样，拷贝左值到multiset

[Item 1] 语句不通顺

item1一开始，如下图

红框中，改为：
ParamType是一个通用引用
更好一些。

Item 25-26 翻译中

占个坑

感谢无私的奉献者们！

条款17 有错误

条款17 请记住第三条拷贝构造函数仅当类没有显式声明拷贝构造函数时才自动生成，并且如果用户声明了移动操作，拷贝构造就是delete。拷贝赋值运算符仅当类没有显式声明拷贝赋值运算符时才自动生成，并且如果用户声明了移动操作，拷贝赋值运算符就是delete。当用户声明了析构函数，拷贝操作的自动生成已被废弃。

最后一句，当用户声明了析构函数，拷贝操作的自动生成已被废弃。

拷贝操作是不是应该改为移动操作。

Item 11 错别字

src: https://github.com/CnTransGroup/EffectiveModernCppChinese/blob/master/src/3.MovingToModernCpp/item11.md?plain=1#L96

typo：item24变量命名错误

item24中markdown源代码中第35行的val2应当是var2

第二种情况是auto声明符，它是从以上示例中拿出的：
auto&& val2 = var1;                 //var2是一个通用引用

提供一个基于当前网页的生成的pdf版,主要是带书签,方便浏览

Effective Modern C++11_14.pdf

想生成 mobi 格式的有啥建议吗

Item5 错别字

原文： The last two examples

src: https://github.com/CnTransGroup/EffectiveModernCppChinese/blob/master/src/2.Auto/item5.md?plain=1#L131

建议不翻译代码注释

代码部分保留原文会好些

PDF的目录层次不正确

第二章：编译器版本更新导致结果不正确

auto x1 = 27; //类型是int，值是27
auto x2(27); //同上
auto x3 = { 27 }; //类型是std::initializer_list，
//值是{ 27 }
auto x4{ 27 }; //同上

当gcc编译器大于5.0，auto x4{ 27 }; x4的类型是int 而不是initialized_list

`item3.md`内的一个链接未能正确建立

如下代码块所示，item24116行的超链接未填充内容，应填充为https://github.com/kelthuzadx/EffectiveModernCppChinese/blob/master/5.RRefMovSemPerfForw/item24.md

要想支持这样使用`authAndAccess`我们就得修改一下当前的声明使得它支持左值和右值。重载是一个不错的选择（一个函数重载声明为左值引用，另一个声明为右值引用），但是我们就不得不维护两个重载函数。另一个方法是使`authAndAccess`的引用可以绑定左值和右值，[Item24]()解释了那正是通用引用能做的，所以我们这里可以使用通用引用进行声明：

有意愿协作共同翻译么？

我已经阅读完了英文版的《Modern Effective C++》，有些晦涩难懂的地方希望找人交流，同时也有意愿共同翻译。
如果你有兴趣的话，我可以来翻译本书的一部分条款。

针对条款四十一中Widget::addName()三种传递方式中的值传递

针对该函数关于传入右值的使用解释

class Widget {                                  //方法3：传值
public:
    void addName(std::string newName)
    { names.push_back(std::move(newName)); }
    …
};

按值传递：无论传递左值还是右值，都必须构造newName形参。如果传递的是左值，...，如果传递的是右值，需要移动的开销。在函数的实现中，newName总是采用移动的方式到Widget::names。开销总结：左值...，右值实参两次移动。对比...。

如：Widget::addName(string("123"))，应该是直接初始化一次(string("123"))，移动构造函数一次(std::move(newName)->push_back)，而不是右值实参两次移动。

Item 3 `names` 翻译歧义

根据原文：

Declarations introduce names and types without giving details

names 在后续的翻译中应该是 变量名，直译为名字不太合适。

src: https://github.com/CnTransGroup/EffectiveModernCppChinese/blob/master/src/1.DeducingTypes/item3.md?plain=1#L176

中文版是否已经有出版的？

在京东上看到，似乎已经有出版社出版了 Effective Modern C++ 了

链接：京东

关于一段话的请教

这里想请教一下，ParamType不是通用引用类型吗，是原版这样说的，还是后来加上的。在第一个item里面的一段文字

Item37: TheadRAII的析构似乎并非异步

在ThreadRAII的实例代码下提到：

这份代码中，我们选择在ThreadRAII的析构函数中异步执行join的动作

~ThreadRAII() { if (t.joinable()) { if (action == DtorAction::join) { t.join(); } else { t.detach(); } } }

此处析构函数并非异步吧？
如果传入DtorAction为join，主线程应该会被ThreadRAII的析构阻塞，直到线程任务return。

比起使用非限域枚举，限域有很多可圈可点的地方，它避免命名空间污染，防止不经意间使用隐式转换。 （下面这句我没看懂，保留原文。。（是什么典故吗。。。）） In many cases, you may decide that typing a few extra characters is a reasonable price to pay for the ability to avoid the pitfalls of an enum technology that dates to a time when the state of the art in digital telecommunications was the 2400-baud modem.

这句话暴露了Scott的年龄。

这句话的意思就是：
大多数情况下，你应该会觉得多敲几个（几行）字符作为避免使用未限域枚举这种老得和2400波特率猫同时代技术的代价是值得的。

pdf 版的一个小错误虽然deleted寒暑假不能被使⽤，它它们还是存在于你的程序中。

应该是 虽然deleted函数不能被使用，但它们还是存在于你的程序中。

条款7 各种翻译错误

1 原文的两行注释合起来是一句话

意为：没有声明std::initializer_list的构造函数

2 此外条款7有一处把parse翻译成“决议”很不合适

原文的用词和句法都很确切易懂，作为译者应尽量保持这种风格，而不是刻意使用“决议”这类看似高级实则有害的词汇。

添加“高深莫测”的意味只会降低翻译质量。

3 又一处错误

红框内是多余的，导致注释无法理解：

4 没有区分括号和花括号

条款7的目标就是区分brace和parens，然而译文的“括号”既用于指代brace，又指代parens。造成混淆。

5 注释的翻译错误过多，必须对照原文才能理解

看起来译者并未读懂原文，也不理解各个例子的代码……

`item40.md`内的一个链接未能正确建立

如下代码块所示，item4063行的超链接未填充内容，应填充为https://github.com/kelthuzadx/EffectiveModernCppChinese/blob/master/7.TheConcurrencyAPI/item39.md

RMW操作不是仅有的`std::atomic`在并发中有效而`volatile`无效的例子。假定一个任务计算第二个任务需要的一个重要的值。当第一个任务完成计算，必须传递给第二个任务。[Item39]()表明一种使用`std::atomic<bool>`的方法来使第一个任务通知第二个任务计算完成。计算值的任务的代码如下：

第三章 Item7：誊抄错误

示例引用中注释部分：

Widget w4{10, 5.0};     //使用花括号初始化，但是现在
                        //调用std::initializer_list版本构造函数
                        //(10 和 true 转化为long double)

应为：

Widget w4{10, 5.0};     //使用花括号初始化，但是现在
                        //调用std::initializer_list版本构造函数
                        //(10 和 5.0 转化为long double)

大佬继续翻译呀～等熟肉2333

或许可以重新做一份中文pdf整合了？

发现中文合集都是去年1月的事情了，这中间的修改还挺多的，所以希望管理员可以重新上传一份中文整合？因为我并不知道具体格式（中文或者字体啥的问题？）所以并不好个人制作一份commit上去。