From b386fff302bee4c6022329336a312b80953a0097 Mon Sep 17 00:00:00 2001 From: Khanh Tran <32532742+khanhtc1202@users.noreply.github.com> Date: Sun, 26 Dec 2021 18:19:38 +0900 Subject: [PATCH 01/39] git: ignore temporarily created build assets (#220) --- .gitignore | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 1c18bcf2..f6224793 100644 --- a/.gitignore +++ b/.gitignore @@ -40,6 +40,11 @@ website/src/modern-cpp/zh-cn/* website/src/modern-cpp/en-us/* website/src/modern-cpp/exercises website/src/modern-cpp/code +website/src/modern-cpp/about/donate.md +website/src/modern-cpp/assets/alipay.jpg website/src/modern-cpp/assets/cover-2nd-en.png website/src/modern-cpp/assets/cover-2nd.png -website/src/modern-cpp/assets/figures/* \ No newline at end of file +website/src/modern-cpp/assets/cover-2nd-en-logo.png +website/src/modern-cpp/assets/cover-2nd-logo.png +website/src/modern-cpp/assets/figures/* +website/src/modern-cpp/assets/wechat.jpg From 7e6ada9b7c385959b25e2e8d8b7526ea9d0d677e Mon Sep 17 00:00:00 2001 From: Valeriy Dmitriev Date: Mon, 3 Jan 2022 18:19:32 +0500 Subject: [PATCH 02/39] book: typo fixes (#219) --- book/en-us/07-thread.md | 8 ++++---- book/en-us/08-filesystem.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/book/en-us/07-thread.md b/book/en-us/07-thread.md index a49caa4d..7f2d85fb 100644 --- a/book/en-us/07-thread.md +++ b/book/en-us/07-thread.md @@ -69,7 +69,7 @@ int main() { Because C++ guarantees that all stack objects will be destroyed at the end of the declaration period, such code is also extremely safe. Whether `critical_section()` returns normally or if an exception is thrown in the middle, a stack rollback is thrown, and `unlock()` is automatically called. -And `std::unique_lock` is more flexible than `std::lock_guard`, `std::unique_lock` is more flexible. +`std::unique_lock` is more flexible than `std::lock_guard`. Objects of `std::unique_lock` manage the locking and unlocking operations on the `mutex` object with exclusive ownership (no other `unique_lock` objects owning the ownership of a `mutex` object). So in concurrent programming, it is recommended to use `std::unique_lock`. `std::lock_guard` cannot explicitly call `lock` and `unlock`, and `std::unique_lock` can be called anywhere after the declaration. @@ -255,7 +255,7 @@ int main() { } ``` -Intuitively, `a = 5;` seems in `t2` seems to always execute before `flag = 1;`, and `while (flag != 1)` in `t1` seems to guarantee `std ::cout << "b = " << b << std::endl;` will not be executed before the mark is changed. Logically, it seems that the value of `b` should be equal to 5. +Intuitively, it seems that `a = 5;` in `t2` always executes before `flag = 1;` and `while (flag != 1)` in `t1`. It looks like there is a guarantee the line `std ::cout << "b = " << b << std::endl;` will not be executed before the mark is changed. Logically, it seems that the value of `b` should be equal to 5. But the actual situation is much more complicated than this, or the code itself is undefined behavior because, for `a` and `flag`, they are read and written in two parallel threads. There has been competition. Also, even if we ignore competing for reading and writing, it is still possible to receive out-of-order execution of the CPU and the impact of the compiler on the rearrangement of instructions. Cause `a = 5` to occur after `flag = 1`. Thus `b` may output 0. @@ -272,7 +272,7 @@ This is a very strong set of synchronization conditions, in other words when it This seems too harsh for a variable that requires only atomic operations (no intermediate state). The research on synchronization conditions has a very long history, and we will not go into details here. Readers should understand that under the modern CPU architecture, atomic operations at the CPU instruction level are provided. -Therefore, in the C + + 11 multi-threaded shared variable reading and writing, the introduction of the `std::atomic` template, so that we instantiate an atomic type, will be a +Therefore, in the C++11 multi-threaded shared variable reading and writing, the introduction of the `std::atomic` template, so that we instantiate an atomic type, will be a Atomic type read and write operations are minimized from a set of instructions to a single CPU instruction. E.g: ```cpp @@ -544,7 +544,7 @@ They provide a critical foundation for standardized high-performance computing f ## Further Readings -- [C++ 并发编程(中文版)](https://www.amazon.com/dp/1617294691/ref=cm_sw_em_r_mt_dp_U_siEmDbRMMF960) +- [C++ Concurrency in Action](https://www.amazon.com/dp/1617294691/ref=cm_sw_em_r_mt_dp_U_siEmDbRMMF960) - [Thread document](http://en.cppreference.com/w/cpp/thread) - Herlihy, M. P., & Wing, J. M. (1990). Linearizability: a correctness condition for concurrent objects. ACM Transactions on Programming Languages and Systems, 12(3), 463–492. https://doi.org/10.1145/78969.78972 diff --git a/book/en-us/08-filesystem.md b/book/en-us/08-filesystem.md index d0c86838..078cd76c 100644 --- a/book/en-us/08-filesystem.md +++ b/book/en-us/08-filesystem.md @@ -10,7 +10,7 @@ order: 8 The file system library provides functions related to the operation of the file system, path, regular files, directories, and so on. -Similar to the regular expression library, he was one of the first libraries +Similar to the regular expression library, it was one of the first libraries to be launched by boost and eventually merged into the C++ standard. ## 8.1 Document and Link From 847b53632de7ee76f4a1bc9723dff063bfb5a28c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lucas=20Vilas-B=C3=B4as?= Date: Mon, 21 Feb 2022 06:47:39 -0300 Subject: [PATCH 03/39] book: add a line break for code formatting (#224) --- book/en-us/02-usability.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index e0c26525..2153b32e 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -299,7 +299,8 @@ int main() { MagicFoo magicFoo = {1, 2, 3, 4, 5}; std::cout << "magicFoo: "; - for (std::vector::iterator it = magicFoo.vec.begin(); it != magicFoo.vec.end(); ++it) std::cout << *it << std::endl; + for (std::vector::iterator it = magicFoo.vec.begin(); it != magicFoo.vec.end(); ++it) + std::cout << *it << std::endl; } ``` From 1db84fe462cb5b94d298957ac4fcbd14ec907473 Mon Sep 17 00:00:00 2001 From: ambiguoustexture <59325440+ambiguoustexture@users.noreply.github.com> Date: Fri, 25 Feb 2022 23:23:03 +0800 Subject: [PATCH 04/39] book, code: fix typos (#225) --- book/zh-cn/03-runtime.md | 2 +- code/3/3.3.rvalue.cpp | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index 3738bc1a..e2855df9 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -333,7 +333,7 @@ void foo() { ``` 由于 `int&` 不能引用 `double` 类型的参数，因此必须产生一个临时值来保存 `s` 的值， -从而当 `increase()` 修改这个临时值时，从而调用完成后 `s` 本身并没有被修改。 +从而当 `increase()` 修改这个临时值时，调用完成后 `s` 本身并没有被修改。 第二个问题，为什么常量引用允许绑定到非左值？原因很简单，因为 Fortran 需要。 diff --git a/code/3/3.3.rvalue.cpp b/code/3/3.3.rvalue.cpp index 2406ea83..20b30ca8 100644 --- a/code/3/3.3.rvalue.cpp +++ b/code/3/3.3.rvalue.cpp @@ -20,7 +20,7 @@ void reference(std::string&& str) { int main() { std::string lv1 = "string,"; // lv1 is a lvalue - // std::string&& r1 = s1; // illegal, rvalue can't ref to lvalue + // std::string&& r1 = lv1; // illegal, rvalue can't ref to lvalue std::string&& rv1 = std::move(lv1); // legal, std::move can convert lvalue to rvalue std::cout << rv1 << std::endl; // string, From afdc39431f08ac9b71eb1bb8aa997742b2b3b0e8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lucas=20Vilas-B=C3=B4as?= Date: Mon, 28 Feb 2022 05:58:23 -0300 Subject: [PATCH 05/39] book: add line breaks for code formatting (#226) --- book/en-us/05-pointers.md | 10 ++++++++-- book/en-us/06-regex.md | 38 +++++++++++++++++++++----------------- 2 files changed, 29 insertions(+), 19 deletions(-) diff --git a/book/en-us/05-pointers.md b/book/en-us/05-pointers.md index 2e248803..fca5ce77 100644 --- a/book/en-us/05-pointers.md +++ b/book/en-us/05-pointers.md @@ -58,20 +58,26 @@ auto pointer = std::make_shared(10); auto pointer2 = pointer; // reference count+1 auto pointer3 = pointer; // reference count+1 int *p = pointer.get(); // no increase of reference count + std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 3 std::cout << "pointer2.use_count() = " << pointer2.use_count() << std::endl; // 3 std::cout << "pointer3.use_count() = " << pointer3.use_count() << std::endl; // 3 pointer2.reset(); std::cout << "reset pointer2:" << std::endl; + std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 2 -std::cout << "pointer2.use_count() = " << pointer2.use_count() << std::endl; // 0, pointer2 has reset +std::cout << "pointer2.use_count() = " + << pointer2.use_count() << std::endl; // 0, pointer2 has reset std::cout << "pointer3.use_count() = " << pointer3.use_count() << std::endl; // 2 + pointer3.reset(); std::cout << "reset pointer3:" << std::endl; + std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 1 std::cout << "pointer2.use_count() = " << pointer2.use_count() << std::endl; // 0 -std::cout << "pointer3.use_count() = " << pointer3.use_count() << std::endl; // 0, pointer3 has reset +std::cout << "pointer3.use_count() = " + << pointer3.use_count() << std::endl; // 0, pointer3 has reset ``` ## 5.3 `std::unique_ptr` diff --git a/book/en-us/06-regex.md b/book/en-us/06-regex.md index 5793645a..6d4f47c8 100644 --- a/book/en-us/06-regex.md +++ b/book/en-us/06-regex.md @@ -84,7 +84,8 @@ We use a simple example to briefly introduce the use of this library. Consider t int main() { std::string fnames[] = {"foo.txt", "bar.txt", "test", "a0.txt", "AAA.txt"}; - // In C++, `\` will be used as an escape character in the string. In order for `\.` to be passed as a regular expression, it is necessary to perform second escaping of `\`, thus we have `\\.` + // In C++, `\` will be used as an escape character in the string. In order for `\.` + // to be passed as a regular expression, it is necessary to perform second escaping of `\`, thus we have `\\.` std::regex txt_regex("[a-z]+\\.txt"); for (const auto &fname: fnames) std::cout << fname << ": " << std::regex_match(fname, txt_regex) << std::endl; @@ -186,29 +187,32 @@ Please implement the member functions `start()` and `parse_request`. Enable serv template void start_server(SERVER_TYPE &server) { - // process GET request for /match/[digit+numbers], e.g. GET request is /match/abc123, will return abc123 + // process GET request for /match/[digit+numbers], e.g. + // GET request is /match/abc123, will return abc123 server.resource["fill_your_reg_ex"]["GET"] = [](ostream& response, Request& request) { string number=request.path_match[1]; - response << "HTTP/1.1 200 OK\r\nContent-Length: " << number.length() << "\r\n\r\n" << number; + response << "HTTP/1.1 200 OK\r\nContent-Length: " << number.length() + << "\r\n\r\n" << number; }; // peocess default GET request; anonymous function will be called if no other matches // response files in folder web/ // default: index.html - server.default_resource["fill_your_reg_ex"]["GET"] = [](ostream& response, Request& request) { - string filename = "www/"; - - string path = request.path_match[1]; - - // forbidden use `..` access content outside folder web/ - size_t last_pos = path.rfind("."); - size_t current_pos = 0; - size_t pos; - while((pos=path.find('.', current_pos)) != string::npos && pos != last_pos) { - current_pos = pos; - path.erase(pos, 1); - last_pos--; - } + server.default_resource["fill_your_reg_ex"]["GET"] = + [](ostream& response, Request& request) { + string filename = "www/"; + + string path = request.path_match[1]; + + // forbidden use `..` access content outside folder web/ + size_t last_pos = path.rfind("."); + size_t current_pos = 0; + size_t pos; + while((pos=path.find('.', current_pos)) != string::npos && pos != last_pos) { + current_pos = pos; + path.erase(pos, 1); + last_pos--; + } // (...) }; From aca2d372d73bcb2486958b463599362208abdace Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=B0=AD=E4=B9=9D=E9=BC=8E?= <109224573@qq.com> Date: Mon, 28 Feb 2022 17:00:16 +0800 Subject: [PATCH 06/39] book: use https for urls (#223) --- README-zh-cn.md | 4 ++-- README.md | 2 +- book/en-us/00-preface.md | 2 +- book/en-us/01-intro.md | 2 +- book/en-us/02-usability.md | 4 ++-- book/en-us/03-runtime.md | 2 +- book/en-us/04-containers.md | 2 +- book/en-us/05-pointers.md | 4 ++-- book/en-us/06-regex.md | 6 +++--- book/en-us/07-thread.md | 4 ++-- book/en-us/08-filesystem.md | 2 +- book/en-us/09-others.md | 2 +- book/en-us/10-cpp20.md | 4 ++-- book/en-us/appendix1.md | 4 ++-- book/en-us/appendix2.md | 2 +- book/en-us/toc.md | 2 +- book/zh-cn/00-preface.md | 4 ++-- book/zh-cn/01-intro.md | 8 ++++---- book/zh-cn/02-usability.md | 6 +++--- book/zh-cn/03-runtime.md | 4 ++-- book/zh-cn/04-containers.md | 4 ++-- book/zh-cn/05-pointers.md | 6 +++--- book/zh-cn/06-regex.md | 8 ++++---- book/zh-cn/07-thread.md | 6 +++--- book/zh-cn/08-filesystem.md | 4 ++-- book/zh-cn/09-others.md | 4 ++-- book/zh-cn/10-cpp20.md | 6 +++--- book/zh-cn/appendix1.md | 6 +++--- book/zh-cn/appendix2.md | 4 ++-- book/zh-cn/toc.md | 4 ++-- pdf/en-us/meta/template.tex | 2 +- pdf/zh-cn/meta/template.tex | 2 +- website/src/modern-cpp/about/copyright.md | 4 ++-- website/themes/moderncpp/layout/index.ejs | 4 ++-- website/themes/moderncpp/layout/page.ejs | 4 ++-- 35 files changed, 69 insertions(+), 69 deletions(-) diff --git a/README-zh-cn.md b/README-zh-cn.md index 1b0aef83..4b06afa7 100644 --- a/README-zh-cn.md +++ b/README-zh-cn.md @@ -59,6 +59,6 @@ $ make build ## 许可 -知识共享许可协议 +知识共享许可协议 -本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](./LICENSE)。 +本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](./LICENSE)。 diff --git a/README.md b/README.md index 537b6adb..45df2bec 100644 --- a/README.md +++ b/README.md @@ -65,4 +65,4 @@ The author is grateful to all contributors, including but not limited to [Contri ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](./LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](./LICENSE). diff --git a/book/en-us/00-preface.md b/book/en-us/00-preface.md index 067cf0ea..b93705a3 100644 --- a/book/en-us/00-preface.md +++ b/book/en-us/00-preface.md @@ -49,4 +49,4 @@ There are few exercises At the end of each chapter of the book. It is for testin ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/01-intro.md b/book/en-us/01-intro.md index e31087bb..0b203dda 100644 --- a/book/en-us/01-intro.md +++ b/book/en-us/01-intro.md @@ -146,4 +146,4 @@ Don't worry at the moment, we will come to meet them in our later chapters. ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 2153b32e..ee908378 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -485,7 +485,7 @@ R add(T x, U y) { } ``` -> Note: There is no difference between typename and class in the template parameter list. Before the keyword typename appears, class is used to define the template parameters. However, when defining a variable with [nested dependency type](http://en.cppreference.com/w/cpp/language/dependent_name#The_typename_disambiguator_for_dependent_names) in the template, you need to use typename to eliminate ambiguity. +> Note: There is no difference between typename and class in the template parameter list. Before the keyword typename appears, class is used to define the template parameters. However, when defining a variable with [nested dependency type](https://en.cppreference.com/w/cpp/language/dependent_name#The_typename_disambiguator_for_dependent_names) in the template, you need to use typename to eliminate ambiguity. Such code is very ugly because the programmer must explicitly indicate the return type when using this template function. @@ -1106,4 +1106,4 @@ This section introduces the enhancements to language usability in modern C++, wh ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/03-runtime.md b/book/en-us/03-runtime.md index 878c127c..d75f1bc4 100644 --- a/book/en-us/03-runtime.md +++ b/book/en-us/03-runtime.md @@ -637,4 +637,4 @@ Lambda expression ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/04-containers.md b/book/en-us/04-containers.md index 96842464..fe1d5300 100644 --- a/book/en-us/04-containers.md +++ b/book/en-us/04-containers.md @@ -305,4 +305,4 @@ Although `std::tuple` is effective, the standard library provides limited functi ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/05-pointers.md b/book/en-us/05-pointers.md index fca5ce77..38c167cc 100644 --- a/book/en-us/05-pointers.md +++ b/book/en-us/05-pointers.md @@ -202,8 +202,8 @@ The technology of smart pointers is not novel. It is a common technology in many ## Further Readings -- [Why does C++11 have `make_shared` but not `make_unique`](http://stackoverflow.com/questions/12580432/why-does-c11-have-make-shared-but-not-make-unique) +- [Why does C++11 have `make_shared` but not `make_unique`](https://stackoverflow.com/questions/12580432/why-does-c11-have-make-shared-but-not-make-unique) ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/06-regex.md b/book/en-us/06-regex.md index 6d4f47c8..dd2963fb 100644 --- a/book/en-us/06-regex.md +++ b/book/en-us/06-regex.md @@ -227,9 +227,9 @@ An suggested solution can be found [here](../../exercises/6). ## Further Readings -1. [Comments from `std::regex`'s author](http://zhihu.com/question/23070203/answer/84248248) -2. [Library document of Regular Expression](http://en.cppreference.com/w/cpp/regex) +1. [Comments from `std::regex`'s author](https://zhihu.com/question/23070203/answer/84248248) +2. [Library document of Regular Expression](https://en.cppreference.com/w/cpp/regex) ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/07-thread.md b/book/en-us/07-thread.md index 7f2d85fb..8c5d0333 100644 --- a/book/en-us/07-thread.md +++ b/book/en-us/07-thread.md @@ -545,9 +545,9 @@ They provide a critical foundation for standardized high-performance computing f ## Further Readings - [C++ Concurrency in Action](https://www.amazon.com/dp/1617294691/ref=cm_sw_em_r_mt_dp_U_siEmDbRMMF960) -- [Thread document](http://en.cppreference.com/w/cpp/thread) +- [Thread document](https://en.cppreference.com/w/cpp/thread) - Herlihy, M. P., & Wing, J. M. (1990). Linearizability: a correctness condition for concurrent objects. ACM Transactions on Programming Languages and Systems, 12(3), 463–492. https://doi.org/10.1145/78969.78972 ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE).` +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE).` diff --git a/book/en-us/08-filesystem.md b/book/en-us/08-filesystem.md index 078cd76c..10085030 100644 --- a/book/en-us/08-filesystem.md +++ b/book/en-us/08-filesystem.md @@ -27,4 +27,4 @@ TODO: ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). \ No newline at end of file +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). \ No newline at end of file diff --git a/book/en-us/09-others.md b/book/en-us/09-others.md index 9db078ef..773a9612 100644 --- a/book/en-us/09-others.md +++ b/book/en-us/09-others.md @@ -203,4 +203,4 @@ effective Let the compiler optimize our code to the maximum extent possible. ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/10-cpp20.md b/book/en-us/10-cpp20.md index 8988edf3..04c69ee1 100644 --- a/book/en-us/10-cpp20.md +++ b/book/en-us/10-cpp20.md @@ -94,9 +94,9 @@ This is still full of charm for a programming language that is already in its th ## Further Readings - [Why Concepts didn't make C++17？](http://honermann.net/blog/2016/03/06/why-concepts-didnt-make-cxx17/) -- [C++11/14/17/20 Compiler Support](http://en.cppreference.com/w/cpp/compiler_support) +- [C++11/14/17/20 Compiler Support](https://en.cppreference.com/w/cpp/compiler_support) - [C++ History](https://en.cppreference.com/w/cpp/language/history) ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). diff --git a/book/en-us/appendix1.md b/book/en-us/appendix1.md index dd17766b..cfde041c 100644 --- a/book/en-us/appendix1.md +++ b/book/en-us/appendix1.md @@ -10,7 +10,7 @@ First of all, congratulations 🎉 on reading this book! I hope this book has ra As mentioned in the introduction to this book, this book is just a book that takes you quickly to the new features of modern C++ 11/14/17/20, rather than the advanced learning practice of C++ "Black Magic". The author of course also thinks about this demand, but the content is very difficult and there are few audiences. Here, the author lists some materials that can help you learn more about modern C++ based on this book. I hope I can help you: -- [C++ Reference](http://en.cppreference.com/w) +- [C++ Reference](https://en.cppreference.com/w) - [CppCon YouTube Channel](https://www.youtube.com/user/CppCon/videos) - [Ulrich Drepper. What Every Programmer Should Know About Memory. 2007](https://people.freebsd.org/~lstewart/articles/cpumemory.pdf) - to be added @@ -19,4 +19,4 @@ As mentioned in the introduction to this book, this book is just a book that tak ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). \ No newline at end of file +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). \ No newline at end of file diff --git a/book/en-us/appendix2.md b/book/en-us/appendix2.md index 8d377b9c..aa1053e9 100644 --- a/book/en-us/appendix2.md +++ b/book/en-us/appendix2.md @@ -36,4 +36,4 @@ TODO: ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). \ No newline at end of file +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). \ No newline at end of file diff --git a/book/en-us/toc.md b/book/en-us/toc.md index 89607e0a..2f03b307 100644 --- a/book/en-us/toc.md +++ b/book/en-us/toc.md @@ -109,4 +109,4 @@ Table of Content | Last Chapter | [Next Chapter: Preface](./00-preface.md) ## Licenses -Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). \ No newline at end of file +Creative Commons License
This work was written by [Ou Changkun](https://changkun.de) and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. The code of this repository is open sourced under the [MIT license](../../LICENSE). \ No newline at end of file diff --git a/book/zh-cn/00-preface.md b/book/zh-cn/00-preface.md index a60a0ef6..ec04257d 100644 --- a/book/zh-cn/00-preface.md +++ b/book/zh-cn/00-preface.md @@ -46,6 +46,6 @@ C++17 则是近三年依赖 C++ 社区一致推进的方向，也指出了 **现 ## 许可 -知识共享许可协议 +知识共享许可协议 -本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/01-intro.md b/book/zh-cn/01-intro.md index 80e324c1..a74a3724 100644 --- a/book/zh-cn/01-intro.md +++ b/book/zh-cn/01-intro.md @@ -138,12 +138,12 @@ clean: ## 进一步阅读的参考文献 - [C++ 语言导学. Bjarne Stroustrup](https://www.amazon.cn/dp/B00WUBYBYS/ref=sr_1_1?ie=UTF8&qid=1522400738&sr=8-1&keywords=C%2B%2B+%E8%AF%AD%E8%A8%80%E5%AF%BC%E5%AD%A6) -- [C++ 历史](http://en.cppreference.com/w/cpp/language/history) -- [C++ 特性在 GCC/Clang 等编译器中的支持情况](http://en.cppreference.com/w/cpp/compiler_support) +- [C++ 历史](https://en.cppreference.com/w/cpp/language/history) +- [C++ 特性在 GCC/Clang 等编译器中的支持情况](https://en.cppreference.com/w/cpp/compiler_support) - [C++98 与 C99 之间的区别](http://david.tribble.com/text/cdiffs.htm#C99-vs-CPP98) ## 许可 -知识共享许可协议 +知识共享许可协议 -本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index b4710e2d..a12bacb4 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -417,7 +417,7 @@ R add(T x, U y) { } ``` -> 注意：typename 和 class 在模板参数列表中没有区别，在 typename 这个关键字出现之前，都是使用 class 来定义模板参数的。但在模板中定义有[嵌套依赖类型](http://en.cppreference.com/w/cpp/language/dependent_name#The_typename_disambiguator_for_dependent_names)的变量时，需要用 typename 消除歧义 +> 注意：typename 和 class 在模板参数列表中没有区别，在 typename 这个关键字出现之前，都是使用 class 来定义模板参数的。但在模板中定义有[嵌套依赖类型](https://en.cppreference.com/w/cpp/language/dependent_name#The_typename_disambiguator_for_dependent_names)的变量时，需要用 typename 消除歧义 这样的代码其实变得很丑陋，因为程序员在使用这个模板函数的时候，必须明确指出返回类型。但事实上我们并不知道 `add()` 这个函数会做什么样的操作，以及获得一个什么样的返回类型。 @@ -1019,6 +1019,6 @@ std::cout << new_enum::value3 << std::endl ## 许可 -知识共享许可协议 +知识共享许可协议 -本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index e2855df9..857d8adc 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -567,6 +567,6 @@ constexpr _Tp&& forward(typename std::remove_reference<_Tp>::type&& __t) noexcep ## 许可 -知识共享许可协议 +知识共享许可协议 -本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/04-containers.md b/book/zh-cn/04-containers.md index d39205db..e3aded40 100644 --- a/book/zh-cn/04-containers.md +++ b/book/zh-cn/04-containers.md @@ -305,6 +305,6 @@ for(int i = 0; i != tuple_len(new_tuple); ++i) ## 许可 -知识共享许可协议 +知识共享许可协议 -本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/05-pointers.md b/book/zh-cn/05-pointers.md index bdfaf595..08dc48b8 100644 --- a/book/zh-cn/05-pointers.md +++ b/book/zh-cn/05-pointers.md @@ -183,10 +183,10 @@ int main() { ## 进一步阅读的参考资料 -1. [stackoverflow 上关于『C++11为什么没有 make_unique』的讨论](http://stackoverflow.com/questions/12580432/why-does-c11-have-make-shared-but-not-make-unique) +1. [stackoverflow 上关于『C++11为什么没有 make_unique』的讨论](https://stackoverflow.com/questions/12580432/why-does-c11-have-make-shared-but-not-make-unique) ## 许可 -知识共享许可协议 +知识共享许可协议 -本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/06-regex.md b/book/zh-cn/06-regex.md index 65647575..b24da50b 100644 --- a/book/zh-cn/06-regex.md +++ b/book/zh-cn/06-regex.md @@ -230,11 +230,11 @@ void start_server(SERVER_TYPE &server) { ## 进一步阅读的参考资料 -1. [知乎『如何评价 GCC 的 C++11 正则表达式？』中原库作者 Tim Shen 的回答](http://zhihu.com/question/23070203/answer/84248248) -2. [正则表达式库文档](http://en.cppreference.com/w/cpp/regex) +1. [知乎『如何评价 GCC 的 C++11 正则表达式？』中原库作者 Tim Shen 的回答](https://zhihu.com/question/23070203/answer/84248248) +2. [正则表达式库文档](https://en.cppreference.com/w/cpp/regex) ## 许可 -知识共享许可协议 +知识共享许可协议 -本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/07-thread.md b/book/zh-cn/07-thread.md index e4982040..6a402bc9 100644 --- a/book/zh-cn/07-thread.md +++ b/book/zh-cn/07-thread.md @@ -554,11 +554,11 @@ C++11 语言层提供了并发编程的相关支持，本节简单的介绍了 ` ## 进一步阅读的参考资料 - [C++ 并发编程\(中文版\)](https://www.gitbook.com/book/chenxiaowei/cpp_concurrency_in_action/details) -- [线程支持库文档](http://en.cppreference.com/w/cpp/thread) +- [线程支持库文档](https://en.cppreference.com/w/cpp/thread) - Herlihy, M. P., & Wing, J. M. (1990). Linearizability: a correctness condition for concurrent objects. ACM Transactions on Programming Languages and Systems, 12(3), 463–492. https://doi.org/10.1145/78969.78972 ## 许可 -知识共享许可协议 +知识共享许可协议 -本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/08-filesystem.md b/book/zh-cn/08-filesystem.md index 050a6167..be60a5a2 100644 --- a/book/zh-cn/08-filesystem.md +++ b/book/zh-cn/08-filesystem.md @@ -22,6 +22,6 @@ TODO: ## 许可 -知识共享许可协议 +知识共享许可协议 -本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/09-others.md b/book/zh-cn/09-others.md index fe9d7c59..8dc1861e 100644 --- a/book/zh-cn/09-others.md +++ b/book/zh-cn/09-others.md @@ -187,6 +187,6 @@ int main() { ## 许可 -知识共享许可协议 +知识共享许可协议 -本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/book/zh-cn/10-cpp20.md b/book/zh-cn/10-cpp20.md index df09348d..c1a4f6a0 100644 --- a/book/zh-cn/10-cpp20.md +++ b/book/zh-cn/10-cpp20.md @@ -89,11 +89,11 @@ TODO: ## 进一步阅读的参考资料 - [Why Concepts didn't make C++17？](http://honermann.net/blog/2016/03/06/why-concepts-didnt-make-cxx17/) -- [C++11/14/17/20 编译器支持情况](http://en.cppreference.com/w/cpp/compiler_support) +- [C++11/14/17/20 编译器支持情况](https://en.cppreference.com/w/cpp/compiler_support) - [C++ 历史](https://en.cppreference.com/w/cpp/language/history) ## 许可 -知识共享许可协议 +知识共享许可协议 -本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 \ No newline at end of file +本教程由[欧长坤](https://github.com/changkun)撰写，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 \ No newline at end of file diff --git a/book/zh-cn/appendix1.md b/book/zh-cn/appendix1.md index fbc6a2f1..e0a32d6c 100644 --- a/book/zh-cn/appendix1.md +++ b/book/zh-cn/appendix1.md @@ -10,7 +10,7 @@ order: 11 正如本书引言部分提到的，本书只是一本带你快速领略现代 C++ 11/14/17/20 新特性的读物，而非进阶学习实践 C++『黑魔法』的内容。笔者当然也想到了这个需求，只是这样的内容非常艰深，鲜有受众。在此，笔者列出一些能够帮助你在此书基础之上进一步学习现代 C++ 的资料，希望能够祝你一臂之力： -- [C++ 参考](http://en.cppreference.com/w) +- [C++ 参考](https://en.cppreference.com/w) - [CppCon YouTube 频道](https://www.youtube.com/user/CppCon/videos) - [Ulrich Drepper. 每位程序员都需要知道的内存知识. 2007](https://people.freebsd.org/~lstewart/articles/cpumemory.pdf) - 待补充 @@ -19,6 +19,6 @@ order: 11 ## 许可 -知识共享许可协议 +知识共享许可协议 -本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 \ No newline at end of file +本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 \ No newline at end of file diff --git a/book/zh-cn/appendix2.md b/book/zh-cn/appendix2.md index 6fce2b02..bf8e907f 100644 --- a/book/zh-cn/appendix2.md +++ b/book/zh-cn/appendix2.md @@ -36,6 +36,6 @@ TODO: ## 许可 -知识共享许可协议 +知识共享许可协议 -本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 \ No newline at end of file +本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 \ No newline at end of file diff --git a/book/zh-cn/toc.md b/book/zh-cn/toc.md index 5a444896..fa2cbd9b 100644 --- a/book/zh-cn/toc.md +++ b/book/zh-cn/toc.md @@ -109,6 +109,6 @@ ## 许可 -知识共享许可协议 +知识共享许可协议 -本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 +本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 MIT 协议开源，参见[许可](../../LICENSE)。 diff --git a/pdf/en-us/meta/template.tex b/pdf/en-us/meta/template.tex index 380f6195..bd22952d 100644 --- a/pdf/en-us/meta/template.tex +++ b/pdf/en-us/meta/template.tex @@ -172,7 +172,7 @@ \vspace{1em} \textbf{\large License} - \noindent This work was written by \href{https://github.com/changkun}{Ou Changkun} and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. \texttt{\small http://creativecommons.org/licenses/by-nc-nd/4.0/} + \noindent This work was written by \href{https://github.com/changkun}{Ou Changkun} and licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. \texttt{\small https://creativecommons.org/licenses/by-nc-nd/4.0/} \vspace{5em} \includegraphics{../../assets/cover-2nd-en} diff --git a/pdf/zh-cn/meta/template.tex b/pdf/zh-cn/meta/template.tex index 69f60116..9288c338 100644 --- a/pdf/zh-cn/meta/template.tex +++ b/pdf/zh-cn/meta/template.tex @@ -179,7 +179,7 @@ \vspace{1em} \textbf{\large 版权声明} - \noindent 本书系\href{https://github.com/changkun}{欧长坤}著，采用“知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议 (cc by-nc-sa)”进行许可。\texttt{\small http://creativecommons.org/licenses/by-nc-nd/4.0/} + \noindent 本书系\href{https://github.com/changkun}{欧长坤}著，采用“知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议 (cc by-nc-sa)”进行许可。\texttt{\small https://creativecommons.org/licenses/by-nc-nd/4.0/} \vspace{7em} \includegraphics{../../assets/cover-2nd} diff --git a/website/src/modern-cpp/about/copyright.md b/website/src/modern-cpp/about/copyright.md index c63c60e5..b065dc43 100755 --- a/website/src/modern-cpp/about/copyright.md +++ b/website/src/modern-cpp/about/copyright.md @@ -4,6 +4,6 @@ type: about order: 3 --- -知识共享许可协议 +知识共享许可协议 -本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 [MIT](https://opensource.org/licenses/MIT) 协议开源。 \ No newline at end of file +本书系[欧长坤](https://github.com/changkun)著，采用[知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/)许可。项目中代码使用 [MIT](https://opensource.org/licenses/MIT) 协议开源。 \ No newline at end of file diff --git a/website/themes/moderncpp/layout/index.ejs b/website/themes/moderncpp/layout/index.ejs index 0dbd3cd9..f5677d0f 100755 --- a/website/themes/moderncpp/layout/index.ejs +++ b/website/themes/moderncpp/layout/index.ejs @@ -51,11 +51,11 @@ diff --git a/website/themes/moderncpp/layout/page.ejs b/website/themes/moderncpp/layout/page.ejs index 15616e53..29209a2b 100755 --- a/website/themes/moderncpp/layout/page.ejs +++ b/website/themes/moderncpp/layout/page.ejs @@ -26,7 +26,7 @@

Changkun Ou © 2016-<%- new Date().getFullYear() %>. - The book is licensed under Creative Commons Attribution-NonCommercial-NoDerivatives 4.0, code is open sourced under the MIT License. + The book is licensed under Creative Commons Attribution-NonCommercial-NoDerivatives 4.0, code is open sourced under the MIT License.

If you like the book, you could donate the author. @@ -36,7 +36,7 @@

欧长坤 © 2016-<%- new Date().getFullYear() %> 版权所有， - 采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议许可，代码使用 MIT 协议开源。 + 采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议许可，代码使用 MIT 协议开源。

如果你认为本书对你起到了帮助，可以资助作者。 From e276dac7d1896f3745a73141bbe8f69e2331bb11 Mon Sep 17 00:00:00 2001 From: ambiguoustexture <59325440+ambiguoustexture@users.noreply.github.com> Date: Tue, 1 Mar 2022 22:59:05 +0800 Subject: [PATCH 07/39] book: re-compose words to avoid out of pdf's margin (#229) --- book/en-us/04-containers.md | 2 +- book/zh-cn/04-containers.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/book/en-us/04-containers.md b/book/en-us/04-containers.md index fe1d5300..36acbb3b 100644 --- a/book/en-us/04-containers.md +++ b/book/en-us/04-containers.md @@ -118,7 +118,7 @@ And select the appropriate location to insert into the container. When traversin The elements in the unordered container are not sorted, and the internals is implemented by the Hash table. The average complexity of inserting and searching for elements is `O(constant)`, Significant performance gains can be achieved without concern for the order of the elements inside the container. -C++11 introduces two sets of unordered containers: `std::unordered_map`/`std::unordered_multimap` and +C++11 introduces two unordered containers: `std::unordered_map`/`std::unordered_multimap` and `std::unordered_set`/`std::unordered_multiset`. Their usage is basically similar to the original `std::map`/`std::multimap`/`std::set`/`set::multiset` diff --git a/book/zh-cn/04-containers.md b/book/zh-cn/04-containers.md index e3aded40..b884ffda 100644 --- a/book/zh-cn/04-containers.md +++ b/book/zh-cn/04-containers.md @@ -115,7 +115,7 @@ std::sort(arr.begin(), arr.end()); 而无序容器中的元素是不进行排序的，内部通过 Hash 表实现，插入和搜索元素的平均复杂度为 `O(constant)`， 在不关心容器内部元素顺序时，能够获得显著的性能提升。 -C++11 引入了两组无序容器：`std::unordered_map`/`std::unordered_multimap` 和 +C++11 引入了的两组无序容器分别是：`std::unordered_map`/`std::unordered_multimap` 和 `std::unordered_set`/`std::unordered_multiset`。 它们的用法和原有的 `std::map`/`std::multimap`/`std::set`/`set::multiset` 基本类似， From 80db4e3d4aed1fc64c0a4c7d65060cb594de2116 Mon Sep 17 00:00:00 2001 From: ambiguoustexture <59325440+ambiguoustexture@users.noreply.github.com> Date: Sat, 5 Mar 2022 23:24:52 +0800 Subject: [PATCH 08/39] book: re-compose words again to avoid out of pdf's margin (#230) --- book/zh-cn/05-pointers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/zh-cn/05-pointers.md b/book/zh-cn/05-pointers.md index 08dc48b8..b88428a9 100644 --- a/book/zh-cn/05-pointers.md +++ b/book/zh-cn/05-pointers.md @@ -19,7 +19,7 @@ order: 5 也就是我们常说的 RAII 资源获取即初始化技术。 凡事都有例外，我们总会有需要将对象在自由存储上分配的需求，在传统 C++ 里我们只好使用 `new` 和 `delete` 去 -『记得』对资源进行释放。而 C++11 引入了智能指针的概念，使用了引用计数的想法，让程序员不再需要关心手动释放内存。 +『记得』对资源进行释放。而 C++11 引入智能指针的概念，使用引用计数的想法，让程序员不再需要关心手动释放内存。 这些智能指针就包括 `std::shared_ptr`/`std::unique_ptr`/`std::weak_ptr`，使用它们需要包含头文件 ``。 > 注意：引用计数不是垃圾回收，引用计数能够尽快收回不再被使用的对象，同时在回收的过程中也不会造成长时间的等待， From b5f594023949745651a1d6808b77722bedd77937 Mon Sep 17 00:00:00 2001 From: Changkun Ou Date: Sat, 26 Mar 2022 14:00:23 +0100 Subject: [PATCH 09/39] pdf: use correct license Fixes #232 --- pdf/zh-cn/meta/template.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pdf/zh-cn/meta/template.tex b/pdf/zh-cn/meta/template.tex index 9288c338..956270f6 100644 --- a/pdf/zh-cn/meta/template.tex +++ b/pdf/zh-cn/meta/template.tex @@ -179,7 +179,7 @@ \vspace{1em} \textbf{\large 版权声明} - \noindent 本书系\href{https://github.com/changkun}{欧长坤}著，采用“知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议 (cc by-nc-sa)”进行许可。\texttt{\small https://creativecommons.org/licenses/by-nc-nd/4.0/} + \noindent 本书系\href{https://github.com/changkun}{欧长坤}著，采用“知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议 (CC BY-NC-ND)”进行许可。\texttt{\small https://creativecommons.org/licenses/by-nc-nd/4.0/} \vspace{7em} \includegraphics{../../assets/cover-2nd} From cfda52200adfbf8de1e867b520b2fee009392a96 Mon Sep 17 00:00:00 2001 From: Augus <34206897+DrAugus@users.noreply.github.com> Date: Fri, 6 May 2022 22:16:04 +0800 Subject: [PATCH 10/39] book: fix indent (#236) --- book/zh-cn/03-runtime.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index 857d8adc..c43ab0f4 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -397,8 +397,8 @@ int main() { int main() { -std::string str = "Hello world."; -std::vector v; + std::string str = "Hello world."; + std::vector v; // 将使用 push_back(const T&), 即产生拷贝行为 v.push_back(str); From 4dfd34e8a003789445c0d8aa2908f55425de30dc Mon Sep 17 00:00:00 2001 From: Lukas Prokop Date: Tue, 12 Jul 2022 08:40:48 +0200 Subject: [PATCH 11/39] =?UTF-8?q?book:=20=E2=80=9Cnon-linear=E2=80=9D=20sh?= =?UTF-8?q?ould=20be=20=E2=80=9Cnon-constant=E2=80=9D=20(#241)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit There is no notion of linearity in this book. However, the context makes it clear that non-constant values are meant. --- book/en-us/03-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/en-us/03-runtime.md b/book/en-us/03-runtime.md index d75f1bc4..969e6a91 100644 --- a/book/en-us/03-runtime.md +++ b/book/en-us/03-runtime.md @@ -374,7 +374,7 @@ int main() { } ``` -The first question, why not allow non-linear references to bind to non-lvalues? +The first question, why not allow non-constant references to bind to non-lvalues? This is because there is a logic error in this approach: ```cpp From 66d33aa2f47ab29cbdd096bde18eec53db0da084 Mon Sep 17 00:00:00 2001 From: Ofey Chan Date: Sun, 17 Jul 2022 03:38:11 -0700 Subject: [PATCH 12/39] book: markdown style fixes (#243) --- book/en-us/03-runtime.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/book/en-us/03-runtime.md b/book/en-us/03-runtime.md index 969e6a91..e1ddd42b 100644 --- a/book/en-us/03-runtime.md +++ b/book/en-us/03-runtime.md @@ -529,7 +529,7 @@ both lvalue and rvalue. But follow the rules below: | T&& | rvalue ref | T&& | Therefore, the use of `T&&` in a template function may not be able to make an rvalue reference, and when a lvalue is passed, a reference to this function will be derived as an lvalue. -More precisely, ** no matter what type of reference the template parameter is, the template parameter can be derived as a right reference type** if and only if the argument type is a right reference. +More precisely, **no matter what type of reference the template parameter is, the template parameter can be derived as a right reference type** if and only if the argument type is a right reference. This makes `v` successful delivery of lvalues. Perfect forwarding is based on the above rules. The so-called perfect forwarding is to let us pass the parameters, @@ -586,7 +586,7 @@ static_cast param passing: lvalue reference Regardless of whether the pass parameter is an lvalue or an rvalue, the normal pass argument will forward the argument as an lvalue. So `std::move` will always accept an lvalue, which forwards the call to `reference(int&&)` to output the rvalue reference. -Only `std::forward` does not cause any extra copies and ** perfectly forwards ** (passes) the arguments of the function to other functions that are called internally. +Only `std::forward` does not cause any extra copies and **perfectly forwards** (passes) the arguments of the function to other functions that are called internally. `std::forward` is the same as `std::move`, and nothing is done. `std::move` simply converts the lvalue to the rvalue. `std::forward` is just a simple conversion of the parameters. From the point of view of the phenomenon, From 97b6cc75f7a01bc148f51bd3aad0ff4d0e9717cb Mon Sep 17 00:00:00 2001 From: Lukas Prokop Date: Sun, 17 Jul 2022 12:38:57 +0200 Subject: [PATCH 13/39] book: typo fixes (#240) --- book/en-us/03-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/en-us/03-runtime.md b/book/en-us/03-runtime.md index e1ddd42b..35e2252c 100644 --- a/book/en-us/03-runtime.md +++ b/book/en-us/03-runtime.md @@ -339,7 +339,7 @@ void reference(std::string&& str) { int main() { std::string lv1 = "string,"; // lv1 is a lvalue - // std::string&& r1 = s1; // illegal, rvalue can't ref to lvalue + // std::string&& r1 = lv1; // illegal, rvalue can't ref to lvalue std::string&& rv1 = std::move(lv1); // legal, std::move can convert lvalue to rvalue std::cout << rv1 << std::endl; // string, From dd7b707acf711fa453838538e77ee75e0fbb8a2d Mon Sep 17 00:00:00 2001 From: gliangbupt Date: Sun, 17 Jul 2022 18:42:17 +0800 Subject: [PATCH 14/39] book: add missing header file (#233) --- book/en-us/02-usability.md | 2 ++ book/zh-cn/02-usability.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index ee908378..79a754f2 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -285,6 +285,8 @@ such as: ```cpp #include #include +#include + class MagicFoo { public: std::vector vec; diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index a12bacb4..8b1731c5 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -233,6 +233,8 @@ int main() { ```cpp #include #include +#include + class MagicFoo { public: std::vector vec; From 0616cb816dc9885e46e58f31f87459ea803ea23c Mon Sep 17 00:00:00 2001 From: Changkun Ou Date: Sun, 17 Jul 2022 12:44:21 +0200 Subject: [PATCH 15/39] book: markdown style fixes Fixes #235 --- book/zh-cn/03-runtime.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index c43ab0f4..a6610dab 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -69,7 +69,7 @@ void lambda_reference_capture() { #### 3. 隐式捕获 -手动书写捕获列表有时候是非常复杂的，这种机械性的工作可以交给编译器来处理，这时候可以在捕获列表中写一个 +手动书写捕获列表有时候是非常复杂的，这种机械性的工作可以交给编译器来处理，这时候可以在捕获列表中写一个 `&` 或 `=` 向编译器声明采用引用捕获或者值捕获. 总结一下，捕获提供了 Lambda 表达式对外部值进行使用的功能，捕获列表的最常用的四种形式可以是： @@ -213,14 +213,14 @@ int main() { 要弄明白右值引用到底是怎么一回事，必须要对左值和右值做一个明确的理解。 -**左值(lvalue, left value)**，顾名思义就是赋值符号左边的值。准确来说， +**左值** (lvalue, left value)，顾名思义就是赋值符号左边的值。准确来说， 左值是表达式（不一定是赋值表达式）后依然存在的持久对象。 -**右值(rvalue, right value)**，右边的值，是指表达式结束后就不再存在的临时对象。 +**右值** (rvalue, right value)，右边的值，是指表达式结束后就不再存在的临时对象。 而 C++11 中为了引入强大的右值引用，将右值的概念进行了进一步的划分，分为：纯右值、将亡值。 -**纯右值(prvalue, pure rvalue)**，纯粹的右值，要么是纯粹的字面量，例如 `10`, `true`； +**纯右值** (prvalue, pure rvalue)，纯粹的右值，要么是纯粹的字面量，例如 `10`, `true`； 要么是求值结果相当于字面量或匿名临时对象，例如 `1+2`。非引用返回的临时变量、运算表达式产生的临时变量、 原始字面量、Lambda 表达式都属于纯右值。 @@ -232,7 +232,7 @@ class Foo { public: void bar() { right = "still rvalue"; // 此处字符串字面量为右值 - } + } }; int main() { @@ -352,19 +352,19 @@ void foo() { class A { public: int *pointer; - A():pointer(new int(1)) { - std::cout << "构造" << pointer << std::endl; + A():pointer(new int(1)) { + std::cout << "构造" << pointer << std::endl; } - A(A& a):pointer(new int(*a.pointer)) { - std::cout << "拷贝" << pointer << std::endl; + A(A& a):pointer(new int(*a.pointer)) { + std::cout << "拷贝" << pointer << std::endl; } // 无意义的对象拷贝 - A(A&& a):pointer(a.pointer) { + A(A&& a):pointer(a.pointer) { a.pointer = nullptr; - std::cout << "移动" << pointer << std::endl; + std::cout << "移动" << pointer << std::endl; } - ~A(){ - std::cout << "析构" << pointer << std::endl; - delete pointer; + ~A(){ + std::cout << "析构" << pointer << std::endl; + delete pointer; } }; // 防止编译器优化 From d740ee8b7c1494689867cbb52df6a5a4ee2bd0b7 Mon Sep 17 00:00:00 2001 From: Changkun Ou Date: Sun, 17 Jul 2022 12:47:50 +0200 Subject: [PATCH 16/39] book: reword for latex style fixes Fixes #227 --- book/en-us/06-regex.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/book/en-us/06-regex.md b/book/en-us/06-regex.md index dd2963fb..d927d226 100644 --- a/book/en-us/06-regex.md +++ b/book/en-us/06-regex.md @@ -34,7 +34,7 @@ and lowercase letters, all numbers, all punctuation, and some other symbols. A special character is a character with special meaning in a regular expression and is also the core matching syntax of a regular expression. See the table below: -| Special characters | Description | +| Symbol | Description | | :----------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `$` | Matches the end position of the input string. | | `(`,`)` | Marks the start and end of a subexpression. Subexpressions can be obtained for later use. | @@ -52,7 +52,7 @@ A special character is a character with special meaning in a regular expression The qualifier is used to specify how many times a given component of a regular expression must appear to satisfy the match. See the table below: -| Character | Description | +| Symbol | Description | | :-------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `*` | matches the previous subexpression zero or more times. For example, `foo*` matches `fo` and `foooo`. `*` is equivalent to `{0,}`. | | `+` | matches the previous subexpression one or more times. For example, `foo+` matches `foo` and `foooo` but does not match `fo`. `+` is equivalent to `{1,}`. | @@ -84,7 +84,7 @@ We use a simple example to briefly introduce the use of this library. Consider t int main() { std::string fnames[] = {"foo.txt", "bar.txt", "test", "a0.txt", "AAA.txt"}; - // In C++, `\` will be used as an escape character in the string. In order for `\.` + // In C++, `\` will be used as an escape character in the string. In order for `\.` // to be passed as a regular expression, it is necessary to perform second escaping of `\`, thus we have `\\.` std::regex txt_regex("[a-z]+\\.txt"); for (const auto &fname: fnames) @@ -187,18 +187,18 @@ Please implement the member functions `start()` and `parse_request`. Enable serv template void start_server(SERVER_TYPE &server) { - // process GET request for /match/[digit+numbers], e.g. + // process GET request for /match/[digit+numbers], e.g. // GET request is /match/abc123, will return abc123 server.resource["fill_your_reg_ex"]["GET"] = [](ostream& response, Request& request) { string number=request.path_match[1]; - response << "HTTP/1.1 200 OK\r\nContent-Length: " << number.length() + response << "HTTP/1.1 200 OK\r\nContent-Length: " << number.length() << "\r\n\r\n" << number; }; // peocess default GET request; anonymous function will be called if no other matches // response files in folder web/ // default: index.html - server.default_resource["fill_your_reg_ex"]["GET"] = + server.default_resource["fill_your_reg_ex"]["GET"] = [](ostream& response, Request& request) { string filename = "www/"; From b22404503e6459df049410dae232231d81f179e5 Mon Sep 17 00:00:00 2001 From: Changkun Ou Date: Sun, 17 Jul 2022 12:51:14 +0200 Subject: [PATCH 17/39] book: use compact table Updates #227 --- book/en-us/06-regex.md | 42 +++++++++++++++++++++--------------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/book/en-us/06-regex.md b/book/en-us/06-regex.md index d927d226..1ac999ee 100644 --- a/book/en-us/06-regex.md +++ b/book/en-us/06-regex.md @@ -34,32 +34,32 @@ and lowercase letters, all numbers, all punctuation, and some other symbols. A special character is a character with special meaning in a regular expression and is also the core matching syntax of a regular expression. See the table below: -| Symbol | Description | -| :----------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `$` | Matches the end position of the input string. | -| `(`,`)` | Marks the start and end of a subexpression. Subexpressions can be obtained for later use. | -| `*` | Matches the previous subexpression zero or more times. | -| `+` | Matches the previous subexpression one or more times. | -| `.` | Matches any single character except the newline character `\n`. | -| `[` | Marks the beginning of a bracket expression. | -| `?` | Matches the previous subexpression zero or one time, or indicates a non-greedy qualifier. | -| `\` | Marks the next character as either a special character, or a literal character, or a backward reference, or an octal escape character. For example, `n` Matches the character `n`. `\n` matches newline characters. The sequence `\\` Matches the `'\'` character, while `\(` matches the `'('` character. | -| `^` | Matches the beginning of the input string, unless it is used in a square bracket expression, at which point it indicates that the set of characters is not accepted. | -| `{` | Marks the beginning of a qualifier expression. | -| `\|` | Indicates a choice between the two. | +| Symbol | Description | +|:----------------:|:---| +| `$` | Matches the end position of the input string.| +| `(`,`)` | Marks the start and end of a subexpression. Subexpressions can be obtained for later use.| +| `*` | Matches the previous subexpression zero or more times. | +| `+` | Matches the previous subexpression one or more times.| +| `.` | Matches any single character except the newline character `\n`.| +| `[` | Marks the beginning of a bracket expression.| +| `?` | Matches the previous subexpression zero or one time, or indicates a non-greedy qualifier.| +| `\` | Marks the next character as either a special character, or a literal character, or a backward reference, or an octal escape character. For example, `n` Matches the character `n`. `\n` matches newline characters. The sequence `\\` Matches the `'\'` character, while `\(` matches the `'('` character. | +| `^` | Matches the beginning of the input string, unless it is used in a square bracket expression, at which point it indicates that the set of characters is not accepted.| +| `{` | Marks the beginning of a qualifier expression.| +| `\|` | Indicates a choice between the two.| ### Quantifiers The qualifier is used to specify how many times a given component of a regular expression must appear to satisfy the match. See the table below: -| Symbol | Description | -| :-------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `*` | matches the previous subexpression zero or more times. For example, `foo*` matches `fo` and `foooo`. `*` is equivalent to `{0,}`. | -| `+` | matches the previous subexpression one or more times. For example, `foo+` matches `foo` and `foooo` but does not match `fo`. `+` is equivalent to `{1,}`. | -| `?` | matches the previous subexpression zero or one time. For example, `Your(s)?` can match `Your` in `Your` or `Yours`. `?` is equivalent to `{0,1}`. | -| `{n}` | `n` is a non-negative integer. Matches the determined `n` times. For example, `o{2}` cannot match `o` in `for`, but can match two `o` in `foo`. | -| `{n,}` | `n` is a non-negative integer. Match at least `n` times. For example, `o{2,}` cannot match `o` in `for`, but matches all `o` in `foooooo`. `o{1,}` is equivalent to `o+`. `o{0,}` is equivalent to `o*`. | -| `{n,m}` | `m` and `n` are non-negative integers, where `n` is less than or equal to `m`. Matches at least `n` times and matches up to `m` times. For example, `o{1,3}` will match the first three `o` in `foooooo`. `o{0,1}` is equivalent to `o?`. Note that there can be no spaces between the comma and the two numbers. | +| Symbol | Description | +|:-------:|:-----| +| `*` | matches the previous subexpression zero or more times. For example, `foo*` matches `fo` and `foooo`. `*` is equivalent to `{0,}`.| +| `+` | matches the previous subexpression one or more times. For example, `foo+` matches `foo` and `foooo` but does not match `fo`. `+` is equivalent to `{1,}`.| +| `?` | matches the previous subexpression zero or one time. For example, `Your(s)?` can match `Your` in `Your` or `Yours`. `?` is equivalent to `{0,1}`.| +| `{n}` | `n` is a non-negative integer. Matches the determined `n` times. For example, `o{2}` cannot match `o` in `for`, but can match two `o` in `foo`.| +| `{n,}` | `n` is a non-negative integer. Match at least `n` times. For example, `o{2,}` cannot match `o` in `for`, but matches all `o` in `foooooo`. `o{1,}` is equivalent to `o+`. `o{0,}` is equivalent to `o*`.| +| `{n,m}` | `m` and `n` are non-negative integers, where `n` is less than or equal to `m`. Matches at least `n` times and matches up to `m` times. For example, `o{1,3}` will match the first three `o` in `foooooo`. `o{0,1}` is equivalent to `o?`. Note that there can be no spaces between the comma and the two numbers. | With these two tables, we can usually read almost all regular expressions. From 25a8fd2bc4056f7e35d32e97b2363bc335b4d859 Mon Sep 17 00:00:00 2001 From: Changkun Ou Date: Sun, 17 Jul 2022 12:56:56 +0200 Subject: [PATCH 18/39] book: fix incorrect suggestions Fixes #239 --- book/en-us/07-thread.md | 4 ++-- book/zh-cn/07-thread.md | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/book/en-us/07-thread.md b/book/en-us/07-thread.md index 8c5d0333..359c6cb3 100644 --- a/book/en-us/07-thread.md +++ b/book/en-us/07-thread.md @@ -468,7 +468,7 @@ To achieve the ultimate performance and achieve consistency of various strength As you can see, `std::memory_order_release` ensures that a write before a release does not occur after the release operation, which is a **backward barrier**, and `std::memory_order_acquire` ensures that a subsequent read or write after a acquire does not occur before the acquire operation, which is a **forward barrier**. For the `std::memory_order_acq_rel` option, combines the characteristics of the two barriers and determines a unique memory barrier, such that reads and writes of the current thread will not be rearranged across the barrier. - + Let's check an example: ```cpp @@ -495,7 +495,7 @@ To achieve the ultimate performance and achieve consistency of various strength acquire.join(); ``` - In this case we used `compare_exchange_strong`, which is the Compare-and-swap primitive, which has a weaker version, `compare_exchange_weak`, which allows a failure to be returned even if the exchange is successful. The reason is due to a false failure on some platforms, specifically when the CPU performs a context switch, another thread loads the same address to produce an inconsistency. In addition, the performance of `compare_exchange_strong` may be slightly worse than `compare_exchange_weak`, but in most cases, `compare_exchange_strong` should be limited. + In this case we used `compare_exchange_strong`, which is the Compare-and-swap primitive, which has a weaker version, `compare_exchange_weak`, which allows a failure to be returned even if the exchange is successful. The reason is due to a false failure on some platforms, specifically when the CPU performs a context switch, another thread loads the same address to produce an inconsistency. In addition, the performance of `compare_exchange_strong` may be slightly worse than `compare_exchange_weak`. However, in most cases, `compare_exchange_weak` is discouraged due to the complexity of its usage. 4. Sequential Consistent Model: Under this model, atomic operations satisfy sequence consistency, which in turn can cause performance loss. It can be specified explicitly by `std::memory_order_seq_cst`. Let's look at a final example: diff --git a/book/zh-cn/07-thread.md b/book/zh-cn/07-thread.md index 6a402bc9..ea99ed09 100644 --- a/book/zh-cn/07-thread.md +++ b/book/zh-cn/07-thread.md @@ -260,7 +260,7 @@ int main() { } ``` -从直观上看，`t2` 中 `a = 5;` 这一条语句似乎总在 `flag = 1;` 之前得到执行，而 `t1` 中 `while (flag != 1)` +从直观上看，`t2` 中 `a = 5;` 这一条语句似乎总在 `flag = 1;` 之前得到执行，而 `t1` 中 `while (flag != 1)` 似乎保证了 `std::cout << "b = " << b << std::endl;` 不会再标记被改变前执行。从逻辑上看，似乎 `b` 的值应该等于 5。 但实际情况远比此复杂得多，或者说这段代码本身属于未定义的行为，因为对于 `a` 和 `flag` 而言，他们在两个并行的线程中被读写， 出现了竞争。除此之外，即便我们忽略竞争读写，仍然可能受 CPU 的乱序执行，编译器对指令的重排的影响， @@ -408,7 +408,7 @@ int main() { y.load() c = a + b x.store(3) ``` - 上面给出的三种例子都是属于因果一致的，因为整个过程中，只有 `c` 对 `a` 和 `b` 产生依赖，而 `x` 和 `y` + 上面给出的三种例子都是属于因果一致的，因为整个过程中，只有 `c` 对 `a` 和 `b` 产生依赖，而 `x` 和 `y` 在此例子中表现为没有关系（但实际情况中我们需要更详细的信息才能确定 `x` 与 `y` 确实无关） 4. 最终一致性：是最弱的一致性要求，它只保障某个操作在未来的某个时间节点上会被观察到，但并未要求被观察到的时间。因此我们甚至可以对此条件稍作加强，例如规定某个操作被观察到的时间总是有界的。当然这已经不在我们的讨论范围之内了。 @@ -504,7 +504,7 @@ int main() { acquire.join(); ``` - 在此例中我们使用了 `compare_exchange_strong`，它便是比较交换原语（Compare-and-swap primitive），它有一个更弱的版本，即 `compare_exchange_weak`，它允许即便交换成功，也仍然返回 `false` 失败。其原因是因为在某些平台上虚假故障导致的，具体而言，当 CPU 进行上下文切换时，另一线程加载同一地址产生的不一致。除此之外，`compare_exchange_strong` 的性能可能稍差于 `compare_exchange_weak`，但大部分情况下，`compare_exchange_strong` 应该被有限考虑。 + 在此例中我们使用了 `compare_exchange_strong` 比较交换原语（Compare-and-swap primitive），它有一个更弱的版本，即 `compare_exchange_weak`，它允许即便交换成功，也仍然返回 `false` 失败。其原因是因为在某些平台上虚假故障导致的，具体而言，当 CPU 进行上下文切换时，另一线程加载同一地址产生的不一致。除此之外，`compare_exchange_strong` 的性能可能稍差于 `compare_exchange_weak`，但大部分情况下，鉴于其使用的复杂度而言，`compare_exchange_weak` 应该被有限考虑。 4. 顺序一致模型：在此模型下，原子操作满足顺序一致性，进而可能对性能产生损耗。可显式的通过 `std::memory_order_seq_cst` 进行指定。最后来看一个例子： From 41b88c861e757aa4ad5cf93fd3829678ef09f39e Mon Sep 17 00:00:00 2001 From: Timothy Liu Date: Sun, 17 Jul 2022 19:18:50 +0800 Subject: [PATCH 19/39] book: redo string literal explanation (#237) --- book/en-us/03-runtime.md | 30 +++++++++++++++++++++--------- book/zh-cn/03-runtime.md | 28 +++++++++++++++++++--------- 2 files changed, 40 insertions(+), 18 deletions(-) diff --git a/book/en-us/03-runtime.md b/book/en-us/03-runtime.md index 35e2252c..e12e6086 100644 --- a/book/en-us/03-runtime.md +++ b/book/en-us/03-runtime.md @@ -263,22 +263,34 @@ Temporary variables returned by non-references, temporary variables generated by operation expressions, original literals, and Lambda expressions are all pure rvalue values. -Note that a string literal became rvalue in a class, and remains an lvalue in other cases (e.g., in a function)： +Note that a literal (except a string literal) is a prvalue. However, a string +literal is an lvalue with type `const char` array. Consider the following examples: ```cpp -class Foo { - const char*&& right = "this is a rvalue"; -public: - void bar() { - right = "still rvalue"; // the string literal is a rvalue - } -}; +#include int main() { - const char* const &left = "this is an lvalue"; // the string literal is an lvalue + // Correct. The type of "01234" is const char [6], so it is an lvalue + const char (&left)[6] = "01234"; + + // Assert success. It is a const char [6] indeed. Note that decltype(expr) + // yields lvalue reference if expr is an lvalue and neither an unparenthesized + // id-expression nor an unparenthesized class member access expression. + static_assert(std::is_same::value, ""); + + // Error. "01234" is an lvalue, which cannot be referenced by an rvalue reference + // const char (&&right)[6] = "01234"; } ``` +However, an array can be implicitly converted to a corresponding pointer.The result, if not an lvalue reference, is an rvalue (xvalue if the result is an rvalue reference, prvalue otherwise): + +```cpp +const char* p = "01234"; // Correct. "01234" is implicitly converted to const char* +const char*&& pr = "01234"; // Correct. "01234" is implicitly converted to const char*, which is a prvalue. +// const char*& pl = "01234"; // Error. There is no type const char* lvalue +``` + **xvalue, expiring value** is the concept proposed by C++11 to introduce rvalue references (so in traditional C++, pure rvalue and rvalue are the same concepts), a value that is destroyed but can be moved. diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index a6610dab..10f82cad 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -224,22 +224,32 @@ int main() { 要么是求值结果相当于字面量或匿名临时对象，例如 `1+2`。非引用返回的临时变量、运算表达式产生的临时变量、 原始字面量、Lambda 表达式都属于纯右值。 -需要注意的是，字符串字面量只有在类中才是右值，当其位于普通函数中是左值。例如： +需要注意的是，字面量除了字符串字面量以外，均为纯右值。而字符串字面量是一个左值，类型为 `const char` 数组。例如： ```cpp -class Foo { - const char*&& right = "this is a rvalue"; // 此处字符串字面量为右值 -public: - void bar() { - right = "still rvalue"; // 此处字符串字面量为右值 - } -}; +#include int main() { - const char* const &left = "this is an lvalue"; // 此处字符串字面量为左值 + // 正确，"01234" 类型为 const char [6]，因此是左值 + const char (&left)[6] = "01234"; + + // 断言正确，确实是 const char [6] 类型，注意 decltype(expr) 在 expr 是左值 + // 且非无括号包裹的 id 表达式与类成员表达式时，会返回左值引用 + static_assert(std::is_same::value, ""); + + // 错误，"01234" 是左值，不可被右值引用 + // const char (&&right)[6] = "01234"; } ``` +但是注意，数组可以被隐式转换成相对应的指针类型，而转换表达式的结果（如果不是左值引用）则一定是个右值（右值引用为将亡值，否则为纯右值）。例如： + +```cpp +const char* p = "01234"; // 正确，"01234" 被隐式转换为 const char* +const char*&& pr = "01234"; // 正确，"01234" 被隐式转换为 const char*，该转换的结果是纯右值 +// const char*& pl = "01234"; // 错误，此处不存在 const char* 类型的左值 +``` + **将亡值(xvalue, expiring value)**，是 C++11 为了引入右值引用而提出的概念（因此在传统 C++ 中， 纯右值和右值是同一个概念），也就是即将被销毁、却能够被移动的值。 From e50e3c64f26aa1801b3ca42629915603e9128cac Mon Sep 17 00:00:00 2001 From: ReEcho <59325440+ambiguoustexture@users.noreply.github.com> Date: Sun, 17 Jul 2022 19:29:30 +0800 Subject: [PATCH 20/39] book: formatting style updates (#231) --- book/en-us/02-usability.md | 6 +++-- book/en-us/03-runtime.md | 12 +++++---- book/en-us/05-pointers.md | 14 +++++------ book/en-us/06-regex.md | 50 +++++++++++++++++++++----------------- book/en-us/07-thread.md | 18 ++++++++------ book/zh-cn/02-usability.md | 9 ++++--- book/zh-cn/03-runtime.md | 7 +++--- book/zh-cn/05-pointers.md | 20 ++++++++------- book/zh-cn/06-regex.md | 24 ++++++++++++------ book/zh-cn/07-thread.md | 22 +++++++++-------- 10 files changed, 106 insertions(+), 76 deletions(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 79a754f2..619b49b0 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -214,7 +214,8 @@ int main() { } // should output: 1, 4, 3, 4. can be simplified using `auto` - for (std::vector::iterator element = vec.begin(); element != vec.end(); ++element) + for (std::vector::iterator element = vec.begin(); element != vec.end(); + ++element) std::cout << *element << std::endl; } ``` @@ -301,7 +302,8 @@ int main() { MagicFoo magicFoo = {1, 2, 3, 4, 5}; std::cout << "magicFoo: "; - for (std::vector::iterator it = magicFoo.vec.begin(); it != magicFoo.vec.end(); ++it) + for (std::vector::iterator it = magicFoo.vec.begin(); + it != magicFoo.vec.end(); ++it) std::cout << *it << std::endl; } ``` diff --git a/book/en-us/03-runtime.md b/book/en-us/03-runtime.md index e12e6086..8c7c145e 100644 --- a/book/en-us/03-runtime.md +++ b/book/en-us/03-runtime.md @@ -221,8 +221,8 @@ int foo(int a, int b, int c) { ; } int main() { - // bind parameter 1, 2 on function foo, and use std::placeholders::_1 as placeholder - // for the first parameter. + // bind parameter 1, 2 on function foo, + // and use std::placeholders::_1 as placeholder for the first parameter. auto bindFoo = std::bind(foo, std::placeholders::_1, 1,2); // when call bindFoo, we only need one param left bindFoo(1); @@ -355,7 +355,8 @@ int main() std::string&& rv1 = std::move(lv1); // legal, std::move can convert lvalue to rvalue std::cout << rv1 << std::endl; // string, - const std::string& lv2 = lv1 + lv1; // legal, const lvalue reference can extend temp variable's lifecycle + const std::string& lv2 = lv1 + lv1; // legal, const lvalue reference can + // extend temp variable's lifecycle // lv2 += "Test"; // illegal, const ref can't be modified std::cout << lv2 << std::endl; // string,string, @@ -482,8 +483,9 @@ int main() { // "str: Hello world." std::cout << "str: " << str << std::endl; - // use push_back(const T&&), no copy - // the string will be moved to vector, and therefore std::move can reduce copy cost + // use push_back(const T&&), + // no copy the string will be moved to vector, + // and therefore std::move can reduce copy cost v.push_back(std::move(str)); // str is empty now std::cout << "str: " << str << std::endl; diff --git a/book/en-us/05-pointers.md b/book/en-us/05-pointers.md index 38c167cc..dab6df95 100644 --- a/book/en-us/05-pointers.md +++ b/book/en-us/05-pointers.md @@ -57,27 +57,27 @@ And see the reference count of an object by `use_count()`. E.g: auto pointer = std::make_shared(10); auto pointer2 = pointer; // reference count+1 auto pointer3 = pointer; // reference count+1 -int *p = pointer.get(); // no increase of reference count +int *p = pointer.get(); // no increase of reference count -std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 3 +std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 3 std::cout << "pointer2.use_count() = " << pointer2.use_count() << std::endl; // 3 std::cout << "pointer3.use_count() = " << pointer3.use_count() << std::endl; // 3 pointer2.reset(); std::cout << "reset pointer2:" << std::endl; -std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 2 +std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 2 std::cout << "pointer2.use_count() = " - << pointer2.use_count() << std::endl; // 0, pointer2 has reset + << pointer2.use_count() << std::endl; // pointer2 has reset, 0 std::cout << "pointer3.use_count() = " << pointer3.use_count() << std::endl; // 2 pointer3.reset(); std::cout << "reset pointer3:" << std::endl; -std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 1 +std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 1 std::cout << "pointer2.use_count() = " << pointer2.use_count() << std::endl; // 0 std::cout << "pointer3.use_count() = " - << pointer3.use_count() << std::endl; // 0, pointer3 has reset + << pointer3.use_count() << std::endl; // pointer3 has reset, 0 ``` ## 5.3 `std::unique_ptr` @@ -85,7 +85,7 @@ std::cout << "pointer3.use_count() = " `std::unique_ptr` is an exclusive smart pointer that prohibits other smart pointers from sharing the same object, thus keeping the code safe: ```cpp -std::unique_ptr pointer = std::make_unique(10); // make_unique was introduced in C++14 +std::unique_ptr pointer = std::make_unique(10); // make_unique, from C++14 std::unique_ptr pointer2 = pointer; // illegal ``` diff --git a/book/en-us/06-regex.md b/book/en-us/06-regex.md index 1ac999ee..e8b98547 100644 --- a/book/en-us/06-regex.md +++ b/book/en-us/06-regex.md @@ -84,8 +84,9 @@ We use a simple example to briefly introduce the use of this library. Consider t int main() { std::string fnames[] = {"foo.txt", "bar.txt", "test", "a0.txt", "AAA.txt"}; - // In C++, `\` will be used as an escape character in the string. In order for `\.` - // to be passed as a regular expression, it is necessary to perform second escaping of `\`, thus we have `\\.` + // In C++, `\` will be used as an escape character in the string. + // In order for `\.` to be passed as a regular expression, + // it is necessary to perform second escaping of `\`, thus we have `\\.` std::regex txt_regex("[a-z]+\\.txt"); for (const auto &fname: fnames) std::cout << fname << ": " << std::regex_match(fname, txt_regex) << std::endl; @@ -104,7 +105,8 @@ std::smatch base_match; for(const auto &fname: fnames) { if (std::regex_match(fname, base_match, base_regex)) { // the first element of std::smatch matches the entire string - // the second element of std::smatch matches the first expression with brackets + // the second element of std::smatch matches the first expression + // with brackets if (base_match.size() == 2) { std::string base = base_match[1].str(); std::cout << "sub-match[0]: " << base_match[0].str() << std::endl; @@ -187,32 +189,36 @@ Please implement the member functions `start()` and `parse_request`. Enable serv template void start_server(SERVER_TYPE &server) { - // process GET request for /match/[digit+numbers], e.g. - // GET request is /match/abc123, will return abc123 - server.resource["fill_your_reg_ex"]["GET"] = [](ostream& response, Request& request) { + // process GET request for /match/[digit+numbers], + // e.g. GET request is /match/abc123, will return abc123 + server.resource["fill_your_reg_ex"]["GET"] = + [](ostream& response, Request& request) + { string number=request.path_match[1]; response << "HTTP/1.1 200 OK\r\nContent-Length: " << number.length() << "\r\n\r\n" << number; }; - // peocess default GET request; anonymous function will be called if no other matches - // response files in folder web/ + // peocess default GET request; + // anonymous function will be called + // if no other matches response files in folder web/ // default: index.html server.default_resource["fill_your_reg_ex"]["GET"] = - [](ostream& response, Request& request) { - string filename = "www/"; - - string path = request.path_match[1]; - - // forbidden use `..` access content outside folder web/ - size_t last_pos = path.rfind("."); - size_t current_pos = 0; - size_t pos; - while((pos=path.find('.', current_pos)) != string::npos && pos != last_pos) { - current_pos = pos; - path.erase(pos, 1); - last_pos--; - } + [](ostream& response, Request& request) + { + string filename = "www/"; + + string path = request.path_match[1]; + + // forbidden use `..` access content outside folder web/ + size_t last_pos = path.rfind("."); + size_t current_pos = 0; + size_t pos; + while((pos=path.find('.', current_pos)) != string::npos && pos != last_pos) { + current_pos = pos; + path.erase(pos, 1); + last_pos--; + } // (...) }; diff --git a/book/en-us/07-thread.md b/book/en-us/07-thread.md index 359c6cb3..379d4d2a 100644 --- a/book/en-us/07-thread.md +++ b/book/en-us/07-thread.md @@ -145,7 +145,8 @@ int main() { std::cout << "waiting..."; result.wait(); // block until future has arrived // output result - std::cout << "done!" << std:: endl << "future result is " << result.get() << std::endl; + std::cout << "done!" << std:: endl << "future result is " + << result.get() << std::endl; return 0; } ``` @@ -196,7 +197,8 @@ int main() { // temporal unlock to allow producer produces more rather than // let consumer hold the lock until its consumed. lock.unlock(); - std::this_thread::sleep_for(std::chrono::milliseconds(1000)); // consumer is slower + // consumer is slower + std::this_thread::sleep_for(std::chrono::milliseconds(1000)); lock.lock(); if (!produced_nums.empty()) { std::cout << "consuming " << produced_nums.front() << std::endl; @@ -272,7 +274,7 @@ This is a very strong set of synchronization conditions, in other words when it This seems too harsh for a variable that requires only atomic operations (no intermediate state). The research on synchronization conditions has a very long history, and we will not go into details here. Readers should understand that under the modern CPU architecture, atomic operations at the CPU instruction level are provided. -Therefore, in the C++11 multi-threaded shared variable reading and writing, the introduction of the `std::atomic` template, so that we instantiate an atomic type, will be a +Therefore, in the C++11 multi-threaded shared variable reading and writing, the introduction of the `std::atomic` template, so that we instantiate an atomic type, will be an Atomic type read and write operations are minimized from a set of instructions to a single CPU instruction. E.g: ```cpp @@ -417,8 +419,11 @@ Weakening the synchronization conditions between processes, usually we will cons ``` 3 4 4 4 // The write operation of x was quickly observed 0 3 3 4 // There is a delay in the observed time of the x write operation - 0 0 0 4 // The last read read the final value of x, but the previous changes were not observed. - 0 0 0 0 // The write operation of x is not observed in the current time period, but the situation that x is 4 can be observed at some point in the future. + 0 0 0 4 // The last read read the final value of x, + // but the previous changes were not observed. + 0 0 0 0 // The write operation of x is not observed in the current time period, + // but the situation that x is 4 can be observed + // at some point in the future. ``` ### Memory Orders @@ -480,9 +485,8 @@ To achieve the ultimate performance and achieve consistency of various strength }); std::thread acqrel([&]() { int expected = 1; // must before compare_exchange_strong - while(!flag.compare_exchange_strong(expected, 2, std::memory_order_acq_rel)) { + while(!flag.compare_exchange_strong(expected, 2, std::memory_order_acq_rel)) expected = 1; // must after compare_exchange_strong - } // flag has changed to 2 }); std::thread acquire([&]() { diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index 8b1731c5..51a8b0d1 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -176,7 +176,8 @@ int main() { } // 将输出 1, 4, 3, 4 - for (std::vector::iterator element = vec.begin(); element != vec.end(); ++element) + for (std::vector::iterator element = vec.begin(); element != vec.end(); + ++element) std::cout << *element << std::endl; } ``` @@ -228,7 +229,7 @@ int main() { } ``` -为了解决这个问题，C++11 首先把初始化列表的概念绑定到了类型上，并将其称之为 `std::initializer_list`，允许构造函数或其他函数像参数一样使用初始化列表，这就为类对象的初始化与普通数组和 POD 的初始化方法提供了统一的桥梁，例如： +为解决这个问题，C++11 首先把初始化列表的概念绑定到类型上，称其为 `std::initializer_list`，允许构造函数或其他函数像参数一样使用初始化列表，这就为类对象的初始化与普通数组和 POD 的初始化方法提供了统一的桥梁，例如： ```cpp #include @@ -249,7 +250,9 @@ int main() { MagicFoo magicFoo = {1, 2, 3, 4, 5}; std::cout << "magicFoo: "; - for (std::vector::iterator it = magicFoo.vec.begin(); it != magicFoo.vec.end(); ++it) std::cout << *it << std::endl; + for (std::vector::iterator it = magicFoo.vec.begin(); + it != magicFoo.vec.end(); ++it) + std::cout << *it << std::endl; } ``` diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index 10f82cad..57839baf 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -136,7 +136,7 @@ Lambda 表达式的本质是一个和函数对象类型相似的类类型（称 #include using foo = void(int); // 定义函数类型, using 的使用见上一节中的别名语法 -void functional(foo f) { // 定义在参数列表中的函数类型 foo 被视为退化后的函数指针类型 foo* +void functional(foo f) { // 参数列表中定义的函数类型 foo 被视为退化后的函数指针类型 foo* f(1); // 通过函数指针调用函数 } @@ -193,7 +193,8 @@ int foo(int a, int b, int c) { ; } int main() { - // 将参数1,2绑定到函数 foo 上，但是使用 std::placeholders::_1 来对第一个参数进行占位 + // 将参数1,2绑定到函数 foo 上， + // 但使用 std::placeholders::_1 来对第一个参数进行占位 auto bindFoo = std::bind(foo, std::placeholders::_1, 1,2); // 这时调用 bindFoo 时，只需要提供第一个参数即可 bindFoo(1); @@ -551,7 +552,7 @@ constexpr _Tp&& forward(typename std::remove_reference<_Tp>::type&& __t) noexcep ``` 在这份实现中，`std::remove_reference` 的功能是消除类型中的引用， -而 `std::is_lvalue_reference` 用于检查类型推导是否正确，在 `std::forward` 的第二个实现中 +`std::is_lvalue_reference` 则用于检查类型推导是否正确，在 `std::forward` 的第二个实现中 检查了接收到的值确实是一个左值，进而体现了坍缩规则。 当 `std::forward` 接受左值时，`_Tp` 被推导为左值，所以返回值为左值；而当其接受右值时， diff --git a/book/zh-cn/05-pointers.md b/book/zh-cn/05-pointers.md index b88428a9..ef7467f7 100644 --- a/book/zh-cn/05-pointers.md +++ b/book/zh-cn/05-pointers.md @@ -19,15 +19,15 @@ order: 5 也就是我们常说的 RAII 资源获取即初始化技术。 凡事都有例外，我们总会有需要将对象在自由存储上分配的需求，在传统 C++ 里我们只好使用 `new` 和 `delete` 去 -『记得』对资源进行释放。而 C++11 引入智能指针的概念，使用引用计数的想法，让程序员不再需要关心手动释放内存。 -这些智能指针就包括 `std::shared_ptr`/`std::unique_ptr`/`std::weak_ptr`，使用它们需要包含头文件 ``。 +『记得』对资源进行释放。而 C++11 引入了智能指针的概念，使用了引用计数的想法，让程序员不再需要关心手动释放内存。 +这些智能指针包括 `std::shared_ptr`/`std::unique_ptr`/`std::weak_ptr`，使用它们需要包含头文件 ``。 > 注意：引用计数不是垃圾回收，引用计数能够尽快收回不再被使用的对象，同时在回收的过程中也不会造成长时间的等待， > 更能够清晰明确的表明资源的生命周期。 ## 5.2 `std::shared_ptr` -`std::shared_ptr` 是一种智能指针，它能够记录多少个 `shared_ptr` 共同指向一个对象，从而消除显式的调用 +`std::shared_ptr` 是一种智能指针，它能够记录多少个 `shared_ptr` 共同指向一个对象，从而消除显式的调用 `delete`，当引用计数变为零的时候就会将对象自动删除。 但还不够，因为使用 `std::shared_ptr` 仍然需要使用 `new` 来调用，这使得代码出现了某种程度上的不对称。 @@ -59,21 +59,23 @@ int main() { auto pointer = std::make_shared(10); auto pointer2 = pointer; // 引用计数+1 auto pointer3 = pointer; // 引用计数+1 -int *p = pointer.get(); // 这样不会增加引用计数 -std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 3 +int *p = pointer.get(); // 这样不会增加引用计数 +std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 3 std::cout << "pointer2.use_count() = " << pointer2.use_count() << std::endl; // 3 std::cout << "pointer3.use_count() = " << pointer3.use_count() << std::endl; // 3 pointer2.reset(); std::cout << "reset pointer2:" << std::endl; -std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 2 -std::cout << "pointer2.use_count() = " << pointer2.use_count() << std::endl; // 0, pointer2 已 reset +std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 2 +std::cout << "pointer2.use_count() = " + << pointer2.use_count() << std::endl; // pointer2 已 reset; 0 std::cout << "pointer3.use_count() = " << pointer3.use_count() << std::endl; // 2 pointer3.reset(); std::cout << "reset pointer3:" << std::endl; -std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 1 +std::cout << "pointer.use_count() = " << pointer.use_count() << std::endl; // 1 std::cout << "pointer2.use_count() = " << pointer2.use_count() << std::endl; // 0 -std::cout << "pointer3.use_count() = " << pointer3.use_count() << std::endl; // 0, pointer3 已 reset +std::cout << "pointer3.use_count() = " + << pointer3.use_count() << std::endl; // pointer3 已 reset; 0 ``` ## 5.3 `std::unique_ptr` diff --git a/book/zh-cn/06-regex.md b/book/zh-cn/06-regex.md index b24da50b..a4c6597e 100644 --- a/book/zh-cn/06-regex.md +++ b/book/zh-cn/06-regex.md @@ -94,7 +94,8 @@ C++11 提供的正则表达式库操作 `std::string` 对象， int main() { std::string fnames[] = {"foo.txt", "bar.txt", "test", "a0.txt", "AAA.txt"}; - // 在 C++ 中 \ 会被作为字符串内的转义符，为使 \. 作为正则表达式传递进去生效，需要对 \ 进行二次转义，从而有 \\. + // 在 C++ 中 \ 会被作为字符串内的转义符， + // 为使 \. 作为正则表达式传递进去生效，需要对 \ 进行二次转义，从而有 \\. std::regex txt_regex("[a-z]+\\.txt"); for (const auto &fname: fnames) std::cout << fname << ": " << std::regex_match(fname, txt_regex) << std::endl; @@ -103,7 +104,7 @@ int main() { 另一种常用的形式就是依次传入 `std::string`/`std::smatch`/`std::regex` 三个参数， 其中 `std::smatch` 的本质其实是 `std::match_results`。 -在标准库中， `std::smatch` 被定义为了 `std::match_results`， +故而在标准库的实现中， `std::smatch` 被定义为了 `std::match_results`， 也就是一个子串迭代器类型的 `match_results`。 使用 `std::smatch` 可以方便的对匹配的结果进行获取，例如： @@ -193,16 +194,23 @@ protected: template void start_server(SERVER_TYPE &server) { - // process GET request for /match/[digit+numbers], e.g. GET request is /match/abc123, will return abc123 - server.resource["fill_your_reg_ex"]["GET"] = [](ostream& response, Request& request) { + // process GET request for /match/[digit+numbers], + // e.g. GET request is /match/abc123, will return abc123 + server.resource["fill_your_reg_ex"]["GET"] = + [](ostream& response, Request& request) + { string number=request.path_match[1]; - response << "HTTP/1.1 200 OK\r\nContent-Length: " << number.length() << "\r\n\r\n" << number; + response << "HTTP/1.1 200 OK\r\nContent-Length: " + << number.length() << "\r\n\r\n" << number; }; - // peocess default GET request; anonymous function will be called if no other matches - // response files in folder web/ + // peocess default GET request; + // anonymous function will be called + // if no other matches response files in folder web/ // default: index.html - server.default_resource["fill_your_reg_ex"]["GET"] = [](ostream& response, Request& request) { + server.default_resource["fill_your_reg_ex"]["GET"] = + [](ostream& response, Request& request) + { string filename = "www/"; string path = request.path_match[1]; diff --git a/book/zh-cn/07-thread.md b/book/zh-cn/07-thread.md index ea99ed09..d6b08fd1 100644 --- a/book/zh-cn/07-thread.md +++ b/book/zh-cn/07-thread.md @@ -70,7 +70,7 @@ int main() { 由于 C++ 保证了所有栈对象在生命周期结束时会被销毁，所以这样的代码也是异常安全的。 无论 `critical_section()` 正常返回、还是在中途抛出异常，都会引发堆栈回退，也就自动调用了 `unlock()`。 -而 `std::unique_lock` 则相对于 `std::lock_guard` 出现的，`std::unique_lock` 更加灵活， +而 `std::unique_lock` 则是相对于 `std::lock_guard` 出现的，`std::unique_lock` 更加灵活， `std::unique_lock` 的对象会以独占所有权（没有其他的 `unique_lock` 对象同时拥有某个 `mutex` 对象的所有权） 的方式管理 `mutex` 对象上的上锁和解锁的操作。所以在并发编程中，推荐使用 `std::unique_lock`。 @@ -147,7 +147,8 @@ int main() { std::cout << "waiting..."; result.wait(); // 在此设置屏障，阻塞到期物的完成 // 输出执行结果 - std::cout << "done!" << std:: endl << "future result is " << result.get() << std::endl; + std::cout << "done!" << std:: endl << "future result is " + << result.get() << std::endl; return 0; } ``` @@ -198,7 +199,8 @@ int main() { } // 短暂取消锁，使得生产者有机会在消费者消费空前继续生产 lock.unlock(); - std::this_thread::sleep_for(std::chrono::milliseconds(1000)); // 消费者慢于生产者 + // 消费者慢于生产者 + std::this_thread::sleep_for(std::chrono::milliseconds(1000)); lock.lock(); while (!produced_nums.empty()) { std::cout << "consuming " << produced_nums.front() << std::endl; @@ -277,7 +279,7 @@ int main() { 这是一组非常强的同步条件，换句话说当最终编译为 CPU 指令时会表现为非常多的指令（我们之后再来看如何实现一个简单的互斥锁）。 这对于一个仅需原子级操作（没有中间态）的变量，似乎太苛刻了。 -关于同步条件的研究有着非常久远的历史，我们在这里不进行赘述。读者应该明白，在现代 CPU 体系结构下提供了 CPU 指令级的原子操作， +关于同步条件的研究有着非常久远的历史，我们在这里不进行赘述。读者应该明白，现代 CPU 体系结构提供了 CPU 指令级的原子操作， 因此在 C++11 中多线程下共享变量的读写这一问题上，还引入了 `std::atomic` 模板，使得我们实例化一个原子类型，将一个 原子类型读写操作从一组指令，最小化到单个 CPU 指令。例如： @@ -311,7 +313,7 @@ int main() { } ``` -当然，并非所有的类型都能提供原子操作，这是因为原子操作的可行性取决于 CPU 的架构以及所实例化的类型结构是否满足该架构对内存对齐 +当然，并非所有的类型都能提供原子操作，这是因为原子操作的可行性取决于具体的 CPU 架构，以及所实例化的类型结构是否能够满足该 CPU 架构对内存对齐 条件的要求，因而我们总是可以通过 `std::atomic::is_lock_free` 来检查该原子类型是否需支持原子操作，例如： ```cpp @@ -419,7 +421,7 @@ int main() { T2 ---------+------------+--------------------+--------+--------> - x.read() x.read() x.read() x.read() + x.read x.read() x.read() x.read() ``` 在上面的情况中，如果我们假设 x 的初始值为 0，则 `T2` 中四次 `x.read()` 结果可能但不限于以下情况： @@ -428,7 +430,8 @@ int main() { 3 4 4 4 // x 的写操作被很快观察到 0 3 3 4 // x 的写操作被观察到的时间存在一定延迟 0 0 0 4 // 最后一次读操作读到了 x 的最终值，但此前的变化并未观察到 - 0 0 0 0 // 在当前时间段内 x 的写操作均未被观察到，但未来某个时间点上一定能观察到 x 为 4 的情况 + 0 0 0 0 // 在当前时间段内 x 的写操作均未被观察到， + // 但未来某个时间点上一定能观察到 x 为 4 的情况 ``` ### 内存顺序 @@ -489,9 +492,8 @@ int main() { }); std::thread acqrel([&]() { int expected = 1; // must before compare_exchange_strong - while(!flag.compare_exchange_strong(expected, 2, std::memory_order_acq_rel)) { + while(!flag.compare_exchange_strong(expected, 2, std::memory_order_acq_rel)) expected = 1; // must after compare_exchange_strong - } // flag has changed to 2 }); std::thread acquire([&]() { @@ -553,7 +555,7 @@ C++11 语言层提供了并发编程的相关支持，本节简单的介绍了 ` ## 进一步阅读的参考资料 -- [C++ 并发编程\(中文版\)](https://www.gitbook.com/book/chenxiaowei/cpp_concurrency_in_action/details) +- [C++ 并发编程\(中文版\)](https://book.douban.com/subject/26386925/) - [线程支持库文档](https://en.cppreference.com/w/cpp/thread) - Herlihy, M. P., & Wing, J. M. (1990). Linearizability: a correctness condition for concurrent objects. ACM Transactions on Programming Languages and Systems, 12(3), 463–492. https://doi.org/10.1145/78969.78972 From 2e9eed9ecc4f855684be1e475e73e7c120979935 Mon Sep 17 00:00:00 2001 From: Changkun Ou Date: Sun, 17 Jul 2022 15:08:18 +0200 Subject: [PATCH 21/39] book: reword generic lambda Fixes #242 --- book/en-us/03-runtime.md | 16 ++++++---------- book/zh-cn/03-runtime.md | 8 +++----- 2 files changed, 9 insertions(+), 15 deletions(-) diff --git a/book/en-us/03-runtime.md b/book/en-us/03-runtime.md index 8c7c145e..a61d6654 100644 --- a/book/en-us/03-runtime.md +++ b/book/en-us/03-runtime.md @@ -126,13 +126,9 @@ initialize it in the expression. In the previous section, we mentioned that the `auto` keyword cannot be used in the parameter list because it would conflict with the functionality of the template. -But Lambda expressions are not ordinary functions, so Lambda expressions are not templated. -This has caused us some trouble: the parameter table cannot be generalized, -and the parameter table type must be clarified. - -Fortunately, this trouble only exists in C++11, starting with C++14. -The formal parameters of the Lambda function can use the `auto` keyword -to generate generic meanings: +But lambda expressions are not regular functions, without further specification on the typed parameter list, lambda expressions cannot utilize templates. Fortunately, this trouble +only exists in C++11, starting with C++14. The formal parameters of the lambda function +can use the `auto` keyword to utilize template generics: ```cpp void lambda_generic() { @@ -221,7 +217,7 @@ int foo(int a, int b, int c) { ; } int main() { - // bind parameter 1, 2 on function foo, + // bind parameter 1, 2 on function foo, // and use std::placeholders::_1 as placeholder for the first parameter. auto bindFoo = std::bind(foo, std::placeholders::_1, 1,2); // when call bindFoo, we only need one param left @@ -483,8 +479,8 @@ int main() { // "str: Hello world." std::cout << "str: " << str << std::endl; - // use push_back(const T&&), - // no copy the string will be moved to vector, + // use push_back(const T&&), + // no copy the string will be moved to vector, // and therefore std::move can reduce copy cost v.push_back(std::move(str)); // str is empty now diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index 57839baf..a8ce6d85 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -107,11 +107,9 @@ void lambda_expression_capture() { ### 泛型 Lambda 上一节中我们提到了 `auto` 关键字不能够用在参数表里，这是因为这样的写法会与模板的功能产生冲突。 -但是 Lambda 表达式并不是普通函数，所以 Lambda 表达式并不能够模板化。 -这就为我们造成了一定程度上的麻烦：参数表不能够泛化，必须明确参数表类型。 - -幸运的是，这种麻烦只存在于 C++11 中，从 C++14 开始， -Lambda 函数的形式参数可以使用 `auto` 关键字来产生意义上的泛型： +但是 Lambda 表达式并不是普通函数，所以在没有明确指明参数表类型的情况下，Lambda 表达式并不能够模板化。 +幸运的是，这种麻烦只存在于 C++11 中，从 C++14 开始，Lambda 函数的形式参数可以使用 `auto` +关键字来产生意义上的泛型： ```cpp auto add = [](auto x, auto y) { From 237c9905102af6ee2c059ac7f56211a898e94067 Mon Sep 17 00:00:00 2001 From: ALAN <48608756+AlanHN@users.noreply.github.com> Date: Sat, 20 Aug 2022 15:24:36 +0800 Subject: [PATCH 22/39] book: typo fixes (#248) --- book/en-us/02-usability.md | 4 ++-- book/zh-cn/02-usability.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 619b49b0..19eb4a30 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -378,8 +378,8 @@ One of the most common and notable examples of type derivation using `auto` is t ```cpp // before C++11 // cbegin() returns vector::const_iterator -// and therefore itr is type vector::const_iterator -for(vector::const_iterator it = vec.cbegin(); itr != vec.cend(); ++it) +// and therefore it is type vector::const_iterator +for(vector::const_iterator it = vec.cbegin(); it != vec.cend(); ++it) ``` When we have `auto`: diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index 51a8b0d1..5f0105b0 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -314,8 +314,8 @@ C++11 引入了 `auto` 和 `decltype` 这两个关键字实现了类型推导， ```cpp // 在 C++11 之前 // 由于 cbegin() 将返回 vector::const_iterator -// 所以 itr 也应该是 vector::const_iterator 类型 -for(vector::const_iterator it = vec.cbegin(); itr != vec.cend(); ++it) +// 所以 it 也应该是 vector::const_iterator 类型 +for(vector::const_iterator it = vec.cbegin(); it != vec.cend(); ++it) ``` 而有了 `auto` 之后可以： From 8182184f2aee5091b8791ba5a1549c3df380c41d Mon Sep 17 00:00:00 2001 From: stephen9357 Date: Fri, 9 Sep 2022 02:20:43 +0800 Subject: [PATCH 23/39] book: typo fixes (#249) --- book/en-us/02-usability.md | 2 +- book/zh-cn/02-usability.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 19eb4a30..12864e0d 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -222,7 +222,7 @@ int main() { In the above code, we can see that the `itr` variable is defined in the scope of the entire `main()`, which causes us to rename the other when a variable need to traverse -the entire `std::vectors` again. C++17 eliminates this limitation so that +the entire `std::vector` again. C++17 eliminates this limitation so that we can do this in if(or switch): ```cpp diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index 5f0105b0..d7193dd4 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -182,7 +182,7 @@ int main() { } ``` -在上面的代码中，我们可以看到 `itr` 这一变量是定义在整个 `main()` 的作用域内的，这导致当我们需要再次遍历整个 `std::vectors` 时，需要重新命名另一个变量。C++17 消除了这一限制，使得我们可以在 `if`（或 `switch`）中完成这一操作： +在上面的代码中，我们可以看到 `itr` 这一变量是定义在整个 `main()` 的作用域内的，这导致当我们需要再次遍历整个 `std::vector` 时，需要重新命名另一个变量。C++17 消除了这一限制，使得我们可以在 `if`（或 `switch`）中完成这一操作： ```cpp // 将临时变量放到 if 语句内 From f6538da3d67ecd951fb557b858d1e6bcae7676fa Mon Sep 17 00:00:00 2001 From: zincsamael Date: Sun, 11 Sep 2022 12:41:04 -0700 Subject: [PATCH 24/39] book: typo fixes (#250) --- book/en-us/01-intro.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/en-us/01-intro.md b/book/en-us/01-intro.md index 0b203dda..03ecd88c 100644 --- a/book/en-us/01-intro.md +++ b/book/en-us/01-intro.md @@ -43,7 +43,7 @@ Before learning modern C++, let's take a look at the main features that have dep - **C language style type conversion is deprecated (ie using `(convert_type)`) before variables, and `static_cast`, `reinterpret_cast`, `const_cast` should be used for type conversion.** -- **In particular, some of the C standard libraries that can be used are deprecated in the latest C++17 standard, such as ``, ``, `` and `` Wait** +- **In particular, some of the C standard libraries that can be used are deprecated in the latest C++17 standard, such as ``, ``, `` and `` etc.** - ... and many more From de86a78627237c24cf1b8f44f65d1fc82556cb3e Mon Sep 17 00:00:00 2001 From: Seiichi Uchida Date: Sun, 18 Sep 2022 22:55:12 +0900 Subject: [PATCH 25/39] book: typo fixes (#251) --- book/en-us/02-usability.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 12864e0d..10c13ffa 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -153,7 +153,7 @@ actually returns a constant at runtime, which causes illegal production. C++11 provides `constexpr` to let the user explicitly declare that the function or object constructor will become a constant expression at compile time. This keyword explicitly tells the compiler that it should verify that `len_foo` -should be a compile-time constant expression. Constant expression. +should be a compile-time constant expression. In addition, the function of `constexpr` can use recursion: From a1c4184b8dae37bbeaa250a5b6d996fd29772655 Mon Sep 17 00:00:00 2001 From: Yikai Cai <35102736+VVsxmja@users.noreply.github.com> Date: Tue, 6 Dec 2022 15:35:38 +0800 Subject: [PATCH 26/39] book: style fixes (#256) --- book/zh-cn/03-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index a8ce6d85..12894127 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -249,7 +249,7 @@ const char*&& pr = "01234"; // 正确，"01234" 被隐式转换为 const char* // const char*& pl = "01234"; // 错误，此处不存在 const char* 类型的左值 ``` -**将亡值(xvalue, expiring value)**，是 C++11 为了引入右值引用而提出的概念（因此在传统 C++ 中， +**将亡值** (xvalue, expiring value)，是 C++11 为了引入右值引用而提出的概念（因此在传统 C++ 中， 纯右值和右值是同一个概念），也就是即将被销毁、却能够被移动的值。 将亡值可能稍有些难以理解，我们来看这样的代码： From 4228ff2afb2b7fd829c460e2d67e084e191ec23d Mon Sep 17 00:00:00 2001 From: David Date: Fri, 30 Dec 2022 17:29:50 +0800 Subject: [PATCH 27/39] book: type fix (#257) --- book/en-us/02-usability.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 10c13ffa..3528c68a 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -548,7 +548,7 @@ std::cout << "q: " << q << std::endl; > To understand it you need to know the concept of parameter forwarding > in C++, which we will cover in detail in the -> [Language Runtime Hardening](./03-runtime.md) chapter, +> [Language Runtime Enhancements](./03-runtime.md) chapter, > and you can come back to the contents of this section later. In simple terms, `decltype(auto)` is mainly used to derive From 725df6b753b02a0bcffb52b79c52ef2bd67470c8 Mon Sep 17 00:00:00 2001 From: Guo Shuai Date: Mon, 27 Feb 2023 14:29:37 +0800 Subject: [PATCH 28/39] book: wording (#260) --- book/zh-cn/07-thread.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/zh-cn/07-thread.md b/book/zh-cn/07-thread.md index d6b08fd1..8e11407d 100644 --- a/book/zh-cn/07-thread.md +++ b/book/zh-cn/07-thread.md @@ -11,7 +11,7 @@ order: 7 ## 7.1 并行基础 `std::thread` 用于创建一个执行的线程实例，所以它是一切并发编程的基础，使用时需要包含 `` 头文件， -它提供了很多基本的线程操作，例如 `get_id()` 来获取所创建线程的线程 ID，使用 `join()` 来加入一个线程等等，例如： +它提供了很多基本的线程操作，例如 `get_id()` 来获取所创建线程的线程 ID，使用 `join()` 来等待一个线程结束（与该线程汇合）等等，例如： ```cpp #include From eca0b923075f1e71830a55ddaadc5f8bc44d17a1 Mon Sep 17 00:00:00 2001 From: GNAQ <41422940+GNAQ@users.noreply.github.com> Date: Tue, 7 Mar 2023 17:28:52 +0800 Subject: [PATCH 29/39] book: style fixes (#261) --- book/zh-cn/00-preface.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/zh-cn/00-preface.md b/book/zh-cn/00-preface.md index ec04257d..5e26f70e 100644 --- a/book/zh-cn/00-preface.md +++ b/book/zh-cn/00-preface.md @@ -11,7 +11,7 @@ order: 0 ## 引言 C++ 是一个用户群体相当大的语言。从 C++98 的出现到 C++11 的正式定稿经历了长达十年多之久的积累。C++14/17 则是作为对 C++11 的重要补充和优化，C++20 则将这门语言领进了现代化的大门，所有这些新标准中扩充的特性，给 C++ 这门语言注入了新的活力。 -那些还在坚持使用**传统 C++**（本书把 C++98 及其之前的 C++ 特性均称之为传统 C++）而未接触过现代 C++ 的 C++ 程序员在见到诸如 Lambda 表达式这类全新特性时，甚至会流露出『学的不是同一门语言』的惊叹之情。 +那些还在坚持使用**传统 C++** （本书把 C++98 及其之前的 C++ 特性均称之为传统 C++）而未接触过现代 C++ 的 C++ 程序员在见到诸如 Lambda 表达式这类全新特性时，甚至会流露出『学的不是同一门语言』的惊叹之情。 **现代 C++** (本书中均指 C++11/14/17/20) 为传统 C++ 注入的大量特性使得整个 C++ 变得更加像一门现代化的语言。现代 C++ 不仅仅增强了 C++ 语言自身的可用性，`auto` 关键字语义的修改使得我们更加有信心来操控极度复杂的模板类型。同时还对语言运行期进行了大量的强化，Lambda 表达式的出现让 C++ 具有了『匿名函数』的『闭包』特性，而这一特性几乎在现代的编程语言（诸如 Python/Swift/... ）中已经司空见惯，右值引用的出现解决了 C++ 长期以来被人诟病的临时对象效率问题等等。 From e86e4a4b94b5dbc691688fa61c4264934898524b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=A5=9D=E7=8D=BB=E7=9A=84=E5=B7=B4=E5=9F=BA=E5=8A=9B?= <68413810+Valkierja@users.noreply.github.com> Date: Sun, 7 May 2023 03:17:04 +0800 Subject: [PATCH 30/39] book: typo fixes (#262) --- book/zh-cn/03-runtime.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index 12894127..1760b3a8 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -523,8 +523,8 @@ static_cast 传参: 右值引用 static_cast 传参: 左值引用 ``` -无论传递参数为左值还是右值，普通传参都会将参数作为左值进行转发， -所以 `std::move` 总会接受到一个左值，从而转发调用了`reference(int&&)` 输出右值引用。 +无论传递参数为左值还是右值，普通传参都会将参数作为左值进行转发； +由于类似的原因，`std::move` 总会接受到一个左值，从而转发调用了`reference(int&&)` 输出右值引用。 唯独 `std::forward` 即没有造成任何多余的拷贝，同时**完美转发**(传递)了函数的实参给了内部调用的其他函数。 From ff6ee89e2a5b16e0ec2342a61171086187fd3a8b Mon Sep 17 00:00:00 2001 From: lingkerio whiher <112792583+lingkerio@users.noreply.github.com> Date: Sun, 7 May 2023 15:19:09 +0800 Subject: [PATCH 31/39] book: discriminative modification to the nature of override and overload (#265) --- book/en-us/02-usability.md | 2 +- book/zh-cn/02-usability.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 3528c68a..6da7d8e5 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -971,7 +971,7 @@ C++11 introduces the two keywords `override` and `final` to prevent this from ha ### override -When overriding a virtual function, introducing the `override` keyword will explicitly tell the compiler to overload, and the compiler will check if the base function has such a virtual function, otherwise it will not compile: +When overriding a virtual function, introducing the `override` keyword will explicitly tell the compiler to overload, and the compiler will check if the base function has such a virtual function with consistent function signature, otherwise it will not compile: ```cpp struct Base { diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index d7193dd4..ed4fe982 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -880,7 +880,7 @@ C++11 引入了 `override` 和 `final` 这两个关键字来防止上述情形 #### override -当重载虚函数时，引入 `override` 关键字将显式的告知编译器进行重载，编译器将检查基函数是否存在这样的虚函数，否则将无法通过编译： +当重载虚函数时，引入 `override` 关键字将显式的告知编译器进行重载，编译器将检查基函数是否存在这样的其函数签名一致的虚函数，否则将无法通过编译： ```cpp struct Base { From bdf0e899a7f9619acba31f8c5eee15bb2d6c6324 Mon Sep 17 00:00:00 2001 From: "A. Jiang" Date: Tue, 21 May 2024 05:53:15 +0800 Subject: [PATCH 32/39] book: fix imprecise description of `NULL` in C++ (#279) --- book/en-us/02-usability.md | 17 +++++++++-------- book/zh-cn/02-usability.md | 4 ++-- 2 files changed, 11 insertions(+), 10 deletions(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 6da7d8e5..51d3edcf 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -18,20 +18,21 @@ which refers to the language behavior that occurred before the runtime. ### nullptr -The purpose of `nullptr` appears to replace `NULL`. In a sense, -traditional C++ treats `NULL` and `0` as the same thing, -depending on how the compiler defines NULL, -and some compilers define NULL as `((void*)0)` Some will define it directly as `0`. +The purpose of `nullptr` appears to replace `NULL`. There are **null pointer constants** in the C and C++ languages, +which can be implicitly converted to null pointer value of any pointer type, +or null member pointer value of any pointer-to-member type in C++. +`NULL` is provided by the standard library implementation and defined as an implementation-defined null pointer constant. +In C, some standard libraries defines `NULL` as `((void*)0)` and some define it as `0`. -C++ **does not allow** to implicitly convert `void *` to other types. -But if the compiler tries to define `NULL` as `((void*)0)`, then in the following code: +C++ **does not allow** to implicitly convert `void *` to other types, and thus `((void*)0)` is not a valid implementation +of `NULL`. If the standard library tries to define `NULL` as `((void*)0)`, then compilation error would occur in the following code: ```cpp char *ch = NULL; ``` C++ without the `void *` implicit conversion has to define `NULL` as `0`. -This still creates a new problem. Defining `NULL` to 0 will cause the overloading feature in `C++` to be confusing. +This still creates a new problem. Defining `NULL` to `0` will cause the overloading feature in `C++` to be confusing. Consider the following two `foo` functions: ```cpp @@ -41,7 +42,7 @@ void foo(int); Then the `foo(NULL);` statement will call `foo(int)`, which will cause the code to be counterintuitive. -To solve this problem, C++11 introduced the `nullptr` keyword, which is specifically used to distinguish null pointers, 0. The type of `nullptr` is `nullptr_t`, which can be implicitly converted to any pointer or member pointer type, and can be compared equally or unequally with them. +To solve this problem, C++11 introduced the `nullptr` keyword, which is specifically used to distinguish null pointers, `0`. The type of `nullptr` is `nullptr_t`, which can be implicitly converted to any pointer or member pointer type, and can be compared equally or unequally with them. You can try to compile the following code using clang++: diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index ed4fe982..11047e7e 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -14,9 +14,9 @@ order: 2 ### nullptr -`nullptr` 出现的目的是为了替代 `NULL`。在某种意义上来说，传统 C++ 会把 `NULL`、`0` 视为同一种东西，这取决于编译器如何定义 `NULL`，有些编译器会将 `NULL` 定义为 `((void*)0)`，有些则会直接将其定义为 `0`。 +`nullptr` 出现的目的是为了替代 `NULL`。 C 与 C++ 语言中有**空指针常量**，它们能被隐式转换成任何指针类型的空指针值，或 C++ 中的任何成员指针类型的空成员指针值。 `NULL` 由标准库实现提供，并被定义为实现定义的空指针常量。在 C 中，有些标准库会把 `NULL` 定义为 `((void*)0)` 而有些将它定义为 `0`。 -C++ **不允许**直接将 `void *` 隐式转换到其他类型。但如果编译器尝试把 `NULL` 定义为 `((void*)0)`，那么在下面这句代码中： +C++ **不允许**直接将 `void *` 隐式转换到其他类型，从而 `((void*)0)` 不是 `NULL` 的合法实现。如果标准库尝试把 `NULL` 定义为 `((void*)0)`，那么下面这句代码中会出现编译错误： ```cpp char *ch = NULL; From 54e99e14617a17c7c6f9eb7936d77e449b0e20ce Mon Sep 17 00:00:00 2001 From: "A. Jiang" Date: Tue, 21 May 2024 05:54:46 +0800 Subject: [PATCH 33/39] book: avoid "let the compiler deduce the list by itself" (#277) --- book/en-us/03-runtime.md | 4 ++-- book/zh-cn/03-runtime.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/book/en-us/03-runtime.md b/book/en-us/03-runtime.md index a61d6654..8ecd2956 100644 --- a/book/en-us/03-runtime.md +++ b/book/en-us/03-runtime.md @@ -87,8 +87,8 @@ capture lists can be: - \[\] empty capture list - \[name1, name2, ...\] captures a series of variables -- \[&\] reference capture, let the compiler deduce the reference list by itself -- \[=\] value capture, let the compiler deduce the value list by itself +- \[&\] reference capture, determine the reference capture list from the uses the in function body +- \[=\] value capture, determine the value capture list from the uses in the function body #### 4. Expression capture diff --git a/book/zh-cn/03-runtime.md b/book/zh-cn/03-runtime.md index 1760b3a8..94517dc7 100644 --- a/book/zh-cn/03-runtime.md +++ b/book/zh-cn/03-runtime.md @@ -76,8 +76,8 @@ void lambda_reference_capture() { - \[\] 空捕获列表 - \[name1, name2, ...\] 捕获一系列变量 -- \[&\] 引用捕获, 让编译器自行推导引用列表 -- \[=\] 值捕获, 让编译器自行推导值捕获列表 +- \[&\] 引用捕获, 从函数体内的使用确定引用捕获列表 +- \[=\] 值捕获, 从函数体内的使用确定值捕获列表 #### 4. 表达式捕获 From 5c50dbc591b045e3633fbe957c7702e483664566 Mon Sep 17 00:00:00 2001 From: "A. Jiang" Date: Tue, 21 May 2024 05:56:11 +0800 Subject: [PATCH 34/39] book: avoid implication that `volatile` may be usable in concurrency (#281) --- book/en-us/07-thread.md | 2 +- book/zh-cn/07-thread.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/book/en-us/07-thread.md b/book/en-us/07-thread.md index 379d4d2a..14f74062 100644 --- a/book/en-us/07-thread.md +++ b/book/en-us/07-thread.md @@ -228,7 +228,7 @@ We simply can't expect multiple consumers to be able to produce content in a par ## 7.5 Atomic Operation and Memory Model Careful readers may be tempted by the fact that the example of the producer-consumer model in the previous section may have compiler optimizations that cause program errors. -For example, the boolean `notified` is not modified by `volatile`, and the compiler may have optimizations for this variable, such as the value of a register. +For example, the compiler may have optimizations for the variable `notified`, such as the value of a register. As a result, the consumer thread can never observe the change of this value. This is a good question. To explain this problem, we need to further discuss the concept of the memory model introduced from C++11. Let's first look at a question. What is the output of the following code? ```cpp diff --git a/book/zh-cn/07-thread.md b/book/zh-cn/07-thread.md index 8e11407d..c32a3c6b 100644 --- a/book/zh-cn/07-thread.md +++ b/book/zh-cn/07-thread.md @@ -232,7 +232,7 @@ int main() { ## 7.5 原子操作与内存模型 细心的读者可能会对前一小节中生产者消费者模型的例子可能存在编译器优化导致程序出错的情况产生疑惑。 -例如，布尔值 `notified` 没有被 `volatile` 修饰，编译器可能对此变量存在优化，例如将其作为一个寄存器的值， +例如，编译器可能对变量 `notified` 存在优化，例如将其作为一个寄存器的值， 从而导致消费者线程永远无法观察到此值的变化。这是一个好问题，为了解释清楚这个问题，我们需要进一步讨论 从 C++ 11 起引入的内存模型这一概念。我们首先来看一个问题，下面这段代码输出结果是多少？ @@ -242,7 +242,7 @@ int main() { int main() { int a = 0; - int flag = 0; + volatile int flag = 0; std::thread t1([&]() { while (flag != 1); From 78b1cdf6bb454a7ed067fc2e81faa719a847935d Mon Sep 17 00:00:00 2001 From: "A. Jiang" Date: Tue, 21 May 2024 05:58:17 +0800 Subject: [PATCH 35/39] book: correct description of function template deduction from `auto` (#280) --- book/en-us/02-usability.md | 16 +++++++++++----- book/zh-cn/02-usability.md | 17 +++++++++++------ 2 files changed, 22 insertions(+), 11 deletions(-) diff --git a/book/en-us/02-usability.md b/book/en-us/02-usability.md index 51d3edcf..eb8a21aa 100644 --- a/book/en-us/02-usability.md +++ b/book/en-us/02-usability.md @@ -418,17 +418,23 @@ auto i = 5; // i as int auto arr = new auto(10); // arr as int * ``` -Since C++ 20, `auto` can even be used as function arguments. Consider -the following example: +Since C++ 14, `auto` can even be used as function arguments in generic lambda expressions, +and such functionality is generalized to normal functions in C++ 20. +Consider the following example: ```cpp -int add(auto x, auto y) { +auto add14 = [](auto x, auto y) -> int { + return x+y; +} + +int add20(auto x, auto y) { return x+y; } auto i = 5; // type int auto j = 6; // type int -std::cout << add(i, j) << std::endl; +std::cout << add14(i, j) << std::endl; +std::cout << add20(i, j) << std::endl; ``` > **Note**: `auto` cannot be used to derive array types yet: @@ -481,7 +487,7 @@ type z == type x ### tail type inference -You may think that when we introduce `auto`, we have already mentioned that `auto` cannot be used for function arguments for type derivation. Can `auto` be used to derive the return type of a function? Still consider an example of an add function, which we have to write in traditional C++: +You may think that whether `auto` can be used to deduce the return type of a function. Still consider an example of an add function, which we have to write in traditional C++: ```cpp template diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index 11047e7e..c39f60a7 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -354,17 +354,22 @@ auto i = 5; // i 被推导为 int auto arr = new auto(10); // arr 被推导为 int * ``` -从 C++ 20 起，`auto` 甚至能用于函数传参，考虑下面的例子： +从 C++ 14 起，`auto` 能用于 lambda 表达式中的函数传参，而 C++ 20 起该功能推广到了一般的函数。考虑下面的例子： ```cpp -int add(auto x, auto y) { +auto add14 = [](auto x, auto y) -> int { return x+y; } -auto i = 5; // 被推导为 int -auto j = 6; // 被推导为 int -std::cout << add(i, j) << std::endl; +int add20(auto x, auto y) { + return x+y; +} + +auto i = 5; // type int +auto j = 6; // type int +std::cout << add14(i, j) << std::endl; +std::cout << add20(i, j) << std::endl; ``` > @@ -413,7 +418,7 @@ type z == type x ### 尾返回类型推导 -你可能会思考，在介绍 `auto` 时，我们已经提过 `auto` 不能用于函数形参进行类型推导，那么 `auto` 能不能用于推导函数的返回类型呢？还是考虑一个加法函数的例子，在传统 C++ 中我们必须这么写： +你可能会思考， `auto` 能不能用于推导函数的返回类型呢？还是考虑一个加法函数的例子，在传统 C++ 中我们必须这么写： ```cpp template From af45678ad42ddad195c954a5dd7ad80398440175 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?mq=E7=99=BD?= <3326284481@qq.com> Date: Tue, 21 May 2024 13:14:12 +0800 Subject: [PATCH 36/39] book: revise wording about "stack unwinding" --- book/en-us/07-thread.md | 4 +++- book/zh-cn/07-thread.md | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/book/en-us/07-thread.md b/book/en-us/07-thread.md index 14f74062..8173aefd 100644 --- a/book/en-us/07-thread.md +++ b/book/en-us/07-thread.md @@ -67,7 +67,9 @@ int main() { ``` Because C++ guarantees that all stack objects will be destroyed at the end of the declaration period, such code is also extremely safe. -Whether `critical_section()` returns normally or if an exception is thrown in the middle, a stack rollback is thrown, and `unlock()` is automatically called. +Whether `critical_section()` returns normally or if an exception is thrown in the middle, a stack unwinding is thrown, and `unlock()` is automatically called. + +> An exception is thrown and not caught (it is implementation-defined whether any stack unwinding is done in this case). `std::unique_lock` is more flexible than `std::lock_guard`. Objects of `std::unique_lock` manage the locking and unlocking operations on the `mutex` object with exclusive ownership (no other `unique_lock` objects owning the ownership of a `mutex` object). So in concurrent programming, it is recommended to use `std::unique_lock`. diff --git a/book/zh-cn/07-thread.md b/book/zh-cn/07-thread.md index c32a3c6b..ba80e7e5 100644 --- a/book/zh-cn/07-thread.md +++ b/book/zh-cn/07-thread.md @@ -68,7 +68,9 @@ int main() { ``` 由于 C++ 保证了所有栈对象在生命周期结束时会被销毁，所以这样的代码也是异常安全的。 -无论 `critical_section()` 正常返回、还是在中途抛出异常，都会引发堆栈回退，也就自动调用了 `unlock()`。 +无论 `critical_section()` 正常返回、还是在中途抛出异常，都会引发栈回溯，也就自动调用了 `unlock()`。 + +> 没有捕获抛出的异常（此时由实现定义是否进行栈回溯）。 而 `std::unique_lock` 则是相对于 `std::lock_guard` 出现的，`std::unique_lock` 更加灵活， `std::unique_lock` 的对象会以独占所有权（没有其他的 `unique_lock` 对象同时拥有某个 `mutex` 对象的所有权） From 2659a5f2073d7a96224567a9ebd0d5e5c266f6ba Mon Sep 17 00:00:00 2001 From: Shaobo Liu Date: Sat, 1 Jun 2024 18:08:51 +0800 Subject: [PATCH 37/39] book: add missing result (#291) Co-authored-by: Shaobo Liu --- book/zh-cn/02-usability.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/zh-cn/02-usability.md b/book/zh-cn/02-usability.md index c39f60a7..e9c84e9a 100644 --- a/book/zh-cn/02-usability.md +++ b/book/zh-cn/02-usability.md @@ -963,7 +963,7 @@ enum class new_enum : unsigned int { ```cpp if (new_enum::value3 == new_enum::value4) { - // 会输出 + // 会输出true std::cout << "new_enum::value3 == new_enum::value4" << std::endl; } ``` From 7b57e5e5a10a5707d278ffd4172815821202a6c9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?mq=E7=99=BD?= <3326284481@qq.com> Date: Sat, 1 Jun 2024 18:09:32 +0800 Subject: [PATCH 38/39] book: revise the description of RAII (#288) --- book/en-us/07-thread.md | 2 +- book/zh-cn/07-thread.md | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/book/en-us/07-thread.md b/book/en-us/07-thread.md index 8173aefd..2279efdc 100644 --- a/book/en-us/07-thread.md +++ b/book/en-us/07-thread.md @@ -35,7 +35,7 @@ C++11 introduces a class related to `mutex`, with all related functions in the ` It can be locked by its member function `lock()`, and `unlock()` can be unlocked. But in the process of actually writing the code, it is best not to directly call the member function, Because calling member functions, you need to call `unlock()` at the exit of each critical section, and of course, exceptions. -At this time, C++11 also provides a template class `std::lock_guard` for the RAII syntax for the mutex. +At this time, C++11 also provides a template class `std::lock_guard` for the RAII mechanism for the mutex. RAII guarantees the exceptional security of the code while keeping the simplicity of the code. diff --git a/book/zh-cn/07-thread.md b/book/zh-cn/07-thread.md index ba80e7e5..dbb35085 100644 --- a/book/zh-cn/07-thread.md +++ b/book/zh-cn/07-thread.md @@ -35,7 +35,8 @@ C++11 引入了 `mutex` 相关的类，其所有相关的函数都放在 ` Date: Sat, 1 Jun 2024 18:10:55 +0800 Subject: [PATCH 39/39] book: revise usage of "mutex" and "instantiation" (#292) --- book/en-us/07-thread.md | 8 ++++---- book/zh-cn/07-thread.md | 7 +++---- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/book/en-us/07-thread.md b/book/en-us/07-thread.md index 2279efdc..a9f41162 100644 --- a/book/en-us/07-thread.md +++ b/book/en-us/07-thread.md @@ -31,7 +31,7 @@ int main() { We have already learned the basics of concurrency technology in the operating system, or the database, and `mutex` is one of the cores. C++11 introduces a class related to `mutex`, with all related functions in the `` header file. -`std::mutex` is the most basic `mutex` class in C++11, and you can create a mutex by instantiating `std::mutex`. +`std::mutex` is the most basic mutex class in C++11, and a mutex can be created by constructing a `std::mutex` object. It can be locked by its member function `lock()`, and `unlock()` can be unlocked. But in the process of actually writing the code, it is best not to directly call the member function, Because calling member functions, you need to call `unlock()` at the exit of each critical section, and of course, exceptions. @@ -160,7 +160,7 @@ After encapsulating the target to be called, you can use `get_future()` to get a The condition variable `std::condition_variable` was born to solve the deadlock and was introduced when the mutex operation was not enough. For example, a thread may need to wait for a condition to be true to continue execution. A dead wait loop can cause all other threads to fail to enter the critical section so that when the condition is true, a deadlock occurs. -Therefore, the `condition_variable` instance is created primarily to wake up the waiting thread and avoid deadlocks. +Therefore, the `condition_variable` object is created primarily to wake up the waiting thread and avoid deadlocks. `notify_one()` of `std::condition_variable` is used to wake up a thread; `notify_all()` is to notify all threads. Below is an example of a producer and consumer model: @@ -276,8 +276,8 @@ This is a very strong set of synchronization conditions, in other words when it This seems too harsh for a variable that requires only atomic operations (no intermediate state). The research on synchronization conditions has a very long history, and we will not go into details here. Readers should understand that under the modern CPU architecture, atomic operations at the CPU instruction level are provided. -Therefore, in the C++11 multi-threaded shared variable reading and writing, the introduction of the `std::atomic` template, so that we instantiate an atomic type, will be an -Atomic type read and write operations are minimized from a set of instructions to a single CPU instruction. E.g: +Therefore, the `std::atomic` template is introduced in C++11 for the topic of multi-threaded shared variable reading and writing, which enables us to instantiate atomic types, +and minimize an atomic read or write operation from a set of instructions to a single CPU instruction. E.g: ```cpp std::atomic counter; diff --git a/book/zh-cn/07-thread.md b/book/zh-cn/07-thread.md index dbb35085..3c59a72d 100644 --- a/book/zh-cn/07-thread.md +++ b/book/zh-cn/07-thread.md @@ -31,7 +31,7 @@ int main() { 我们在操作系统、亦或是数据库的相关知识中已经了解过了有关并发技术的基本知识，`mutex` 就是其中的核心之一。 C++11 引入了 `mutex` 相关的类，其所有相关的函数都放在 `` 头文件中。 -`std::mutex` 是 C++11 中最基本的 `mutex` 类，通过实例化 `std::mutex` 可以创建互斥量， +`std::mutex` 是 C++11 中最基本的互斥量类，可以通过构造 `std::mutex` 对象创建互斥量， 而通过其成员函数 `lock()` 可以进行上锁，`unlock()` 可以进行解锁。 但是在实际编写代码的过程中，最好不去直接调用成员函数， 因为调用成员函数就需要在每个临界区的出口处调用 `unlock()`，当然，还包括异常。 @@ -163,7 +163,7 @@ int main() { 条件变量 `std::condition_variable` 是为了解决死锁而生，当互斥操作不够用而引入的。 比如，线程可能需要等待某个条件为真才能继续执行， 而一个忙等待循环中可能会导致所有其他线程都无法进入临界区使得条件为真时，就会发生死锁。 -所以，`condition_variable` 实例被创建出现主要就是用于唤醒等待线程从而避免死锁。 +所以，`condition_variable` 对象被创建出现主要就是用于唤醒等待线程从而避免死锁。 `std::condition_variable`的 `notify_one()` 用于唤醒一个线程； `notify_all()` 则是通知所有线程。下面是一个生产者和消费者模型的例子： @@ -283,8 +283,7 @@ int main() { 这对于一个仅需原子级操作（没有中间态）的变量，似乎太苛刻了。 关于同步条件的研究有着非常久远的历史，我们在这里不进行赘述。读者应该明白，现代 CPU 体系结构提供了 CPU 指令级的原子操作， -因此在 C++11 中多线程下共享变量的读写这一问题上，还引入了 `std::atomic` 模板，使得我们实例化一个原子类型，将一个 -原子类型读写操作从一组指令，最小化到单个 CPU 指令。例如： +因此在多线程下共享变量的读写这一问题上， C++11 中还引入了 `std::atomic` 模板，使得我们能实例化原子类型，并将一个原子写操作从一组指令，最小化到单个 CPU 指令。例如： ```cpp std::atomic counter;