diff --git a/README.md b/README.md index f2f2f2f4..7c9fe43e 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,7 @@ Quick Reference [Bash](./docs/bash.md) [C](./docs/c.md) [C#](./docs/cs.md) +[CPP](./docs/cpp.md) [Dart](./docs/dart.md) [Docker](./docs/docker.md) [Dockerfile](./docs/dockerfile.md) diff --git a/docs/cpp.md b/docs/cpp.md new file mode 100644 index 00000000..17a7d06d --- /dev/null +++ b/docs/cpp.md @@ -0,0 +1,792 @@ +C++ 备忘清单 +=== + +提供基本语法和方法的 [C++](https://zh.cppreference.com/) 快速参考备忘单 + +入门 +-------- + +### hello.cpp + +```cpp +#include +int main() { + std::cout << "Hello Quick Reference\n"; + return 0; +} +``` + +编译运行 + +```shell +$ g++ hello.cpp -o hello +$ ./hello +Hello Quick Reference +``` + +### 变量 + +```cpp +int number = 5; // 整数 +float f = 0.95; // 浮点数 +double PI = 3.14159; // 浮点数 +char yes = 'Y'; // 特点 +std::string s = "ME"; // 字符串(文本) +bool isRight = true; // 布尔值 +// 常量 +const float RATE = 0.8; +``` + +---- + +```cpp +int age {25}; // 自 C++11 +std::cout << age; // 打印 25 +``` + +### 原始数据类型 + +数据类型 | 大小 | 范围 +:- | -- | -- +`int` | 4 bytes | -231 到 231-1 +`float` | 4 bytes | _N/A_ +`double` | 8 bytes | _N/A_ +`char` | 1 byte | -128 到 127 +`bool` | 1 byte | `true` / `false` +`void` | _N/A_ | _N/A_ +`wchar_t` | 2 到 4 bytes | 1 个宽字符 + + +### 用户输入 + +```cpp +int num; +std::cout << "Type a number: "; +std::cin >> num; +std::cout << "You entered " << num; +``` + +### 交换 + +```cpp +int a = 5, b = 10; +std::swap(a, b); +// 输出: a=10, b=5 +std::cout << "a=" << a << ", b=" << b; +``` + +### 注释 + +```cpp +// C++中的单行注释 +/* 这是一个多行注释 + 在 C++ 中 */ +``` + +### If 语句 + +```cpp +if (a == 10) { + // do something +} +``` + +查看: [条件](#c-条件) + +### 循环 + +```cpp +for (int i = 0; i < 10; i++) { + std::cout << i << "\n"; +} +``` + +查看: [循环 Loops](#c-循环) + +### 函数 + + +```cpp +#include + +void hello(); // 声明 + +int main() { // 主函数 + hello(); // 执行函数 +} + +void hello() { // 定义 + std::cout << "Hello Quick Reference!\n"; +} +``` + +查看: [函数 Functions](#c-函数) + +### 引用 + +```cpp +int i = 1; +int& ri = i; // ri 是对 i 的引用 +ri = 2; // i 现在改为 2 +std::cout << "i=" << i; +i = 3; // i 现在改为 3 +std::cout << "ri=" << ri; +``` + +`ri` 和 `i` 指的是相同的内存位置 + +### 命名空间 + +```cpp +#include +namespace ns1 {int val(){return 5;}} +int main() +{ + std::cout << ns1::val(); +} +``` + +---- + +```cpp +#include +namespace ns1 {int val(){return 5;}} +using namespace ns1; +using namespace std; +int main() +{ + cout << val(); +} +``` + +名称空间允许名称下的全局标识符 + +C++ 数组 +------ + +### 定义 + +```cpp +std::array marks; // 定义 +marks[0] = 92; +marks[1] = 97; +marks[2] = 98; +// 定义和初始化 +std::array = {92, 97, 98}; +// 有空成员 +std::array marks = {92, 97}; +std::cout << marks[2]; // 输出: 0 +``` + +### 操控 + +```cpp +┌─────┬─────┬─────┬─────┬─────┬─────┐ +| 92 | 97 | 98 | 99 | 98 | 94 | +└─────┴─────┴─────┴─────┴─────┴─────┘ + 0 1 2 3 4 5 +``` + +---- + +```cpp +std::array marks = { + 92, 97, 98, 99, 98, 94 +}; +// 打印第一个元素 +std::cout << marks[0]; +// 将第 2 个元素更改为 99 +marks[1] = 99; +// 从用户那里获取输入 +std::cin >> marks[2]; +``` + +### 展示 + +```cpp +char ref[5] = {'R', 'e', 'f'}; +// 基于范围的for循环 +for (const int &n : ref) { + std::cout << std::string(1, n); +} +// 传统的for循环 +for (int i = 0; i < sizeof(ref); ++i) { + std::cout << ref[i]; +} +``` + +### 多维 + +```cpp + j0 j1 j2 j3 j4 j5 + ┌────┬────┬────┬────┬────┬────┐ +i0 | 1 | 2 | 3 | 4 | 5 | 6 | + ├────┼────┼────┼────┼────┼────┤ +i1 | 6 | 5 | 4 | 3 | 2 | 1 | + └────┴────┴────┴────┴────┴────┘ +``` + +---- + +```cpp +int x[2][6] = { + {1,2,3,4,5,6}, {6,5,4,3,2,1} +}; +for (int i = 0; i < 2; ++i) { + for (int j = 0; j < 6; ++j) { + std::cout << x[i][j] << " "; + } +} +// 输出: 1 2 3 4 5 6 6 5 4 3 2 1 +``` + +C++ 条件 +------------ + +### If Clause + +```cpp +if (a == 10) { + // do something +} +``` + +---- + +```cpp +int number = 16; +if (number % 2 == 0) +{ + std::cout << "even"; +} +else +{ + std::cout << "odd"; +} +// 输出: even +``` + +### Else if 语句 + +```cpp +int score = 99; +if (score == 100) { + std::cout << "Superb"; +} +else if (score >= 90) { + std::cout << "Excellent"; +} +else if (score >= 80) { + std::cout << "Very Good"; +} +else if (score >= 70) { + std::cout << "Good"; +} +else if (score >= 60) + std::cout << "OK"; +else + std::cout << "What?"; +``` + +### 运算符 + + +#### 关系运算符 + +:--|-- +:--|-- +`a == b` | a 等于 b +`a != b` | a 不等于 b +`a < b` | a 小于 b +`a > b` | a 大于 b +`a <= b` | a 小于或等于 b +`a >= b` | a 大于或等于 b + +#### 赋值运算符 + +范例 | 相当于 +:--|-- +`a += b` | _Aka_ `a = a + b` +`a -= b` | _Aka_ `a = a - b` +`a *= b` | _Aka_ `a = a * b` +`a /= b` | _Aka_ `a = a / b` +`a %= b` | _Aka_ `a = a % b` + +#### 逻辑运算符 + +| Example | Meaning | +|----------------|------------------------| +| `exp1 && exp2` | Both are true _(AND)_ | +| `exp1 || exp2` | Either is true _(OR)_ | +| `!exp` | `exp` is false _(NOT)_ | + +#### 位运算符 + +| Operator | Description | +|----------|-------------------------| +| `a & b` | Binary AND | +| `a | b` | Binary OR | +| `a ^ b` | Binary XOR | +| `a ~ b` | Binary One's Complement | +| `a << b` | Binary Shift Left | +| `a >> b` | Binary Shift Right | + +### 三元运算符 + +``` + ┌── True ──┐ +Result = Condition ? Exp1 : Exp2; + └───── False ─────┘ +``` + +---- + +```cpp +int x = 3, y = 5, max; +max = (x > y) ? x : y; +// 输出: 5 +std::cout << max << std::endl; +``` + +---- + +```cpp +int x = 3, y = 5, max; +if (x > y) { + max = x; +} else { + max = y; +} +// 输出: 5 +std::cout << max << std::endl; +``` + +### switch 语句 + +```cpp +int num = 2; +switch (num) { + case 0: + std::cout << "Zero"; + break; + case 1: + std::cout << "One"; + break; + case 2: + std::cout << "Two"; + break; + case 3: + std::cout << "Three"; + break; + default: + std::cout << "What?"; + break; +} +``` + +C++ 循环 +------------ + +### While + +```cpp +int i = 0; +while (i < 6) { + std::cout << i++; +} +// 输出: 012345 +``` + +### Do-while + +```cpp +int i = 1; +do { + std::cout << i++; +} while (i <= 5); +// 输出: 12345 +``` + +### Continue 语句 + +```cpp +for (int i = 0; i < 10; i++) { + if (i % 2 == 0) { + continue; + } + std::cout << i; +} // 输出: 13579 +``` + +### 无限循环 + +```cpp +while (true) { // true or 1 + std::cout << "无限循环"; +} +``` + +---- + +```cpp +for (;;) { + std::cout << "无限循环"; +} +``` + +---- + +```cpp +for(int i = 1; i > 0; i++) { + std::cout << "infinite loop"; +} +``` + +### for_each (C++11 起) + +```cpp +#include +int main() +{ + auto print = [](int num) { + std::cout << num << std::endl; + }; + std::array arr = {1, 2, 3, 4}; + std::for_each(arr.begin(), arr.end(), print); + return 0; +} +``` + + +### 基于范围 (C++11 起) + +```cpp +for (int n : {1, 2, 3, 4, 5}) { + std::cout << n << " "; +} +// 输出: 1 2 3 4 5 +``` + +---- + +```cpp +std::string hello = "Quick Reference.ME"; +for (char c: hello) +{ + std::cout << c << " "; +} +// 输出: Q u i c k R e f . M E +``` + +### 中断语句 + +```cpp +int password, times = 0; +while (password != 1234) { + if (times++ >= 3) { + std::cout << "Locked!\n"; + break; + } + std::cout << "Password: "; + std::cin >> password; // input +} +``` + +### Several variations + +```cpp +for (int i = 0, j = 2; i < 3; i++, j--){ + std::cout << "i=" << i << ","; + std::cout << "j=" << j << ";"; +} +// 输出: i=0,j=2;i=1,j=1;i=2,j=0; +``` + +C++ 函数 +------------ + +### 参数和返回 + +```cpp +#include +int add(int a, int b) { + return a + b; +} +int main() { + std::cout << add(10, 20); +} +``` + +`add` 是一个接受 2 个整数并返回整数的函数 + +### 重载 + +```cpp +void fun(string a, string b) { + std::cout << a + " " + b; +} +void fun(string a) { + std::cout << a; +} +void fun(int a) { + std::cout << a; +} +``` + +### 内置函数 + +```cpp +#include +#include // 导入库 + +int main() { + // sqrt() 来自 cmath + std::cout << sqrt(9); +} +``` + +C++ 预处理器 +------------ + +### 预处理器 + + +- [if](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [elif](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [else](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [endif](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [ifdef](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [ifndef](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [define](https://zh.cppreference.com/w/cpp/preprocessor/replace) +- [undef](https://zh.cppreference.com/w/cpp/preprocessor/replace) +- [include](https://zh.cppreference.com/w/cpp/preprocessor/include) +- [line](https://zh.cppreference.com/w/cpp/preprocessor/line) +- [error](https://zh.cppreference.com/w/cpp/preprocessor/error) +- [pragma](https://zh.cppreference.com/w/cpp/preprocessor/impl) +- [defined](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [__has_include](https://zh.cppreference.com/w/cpp/feature_test) +- [__has_cpp_attribute](https://zh.cppreference.com/w/cpp/feature_test) +- [export](https://zh.cppreference.com/w/cpp/keyword/export) +- [import](https://zh.cppreference.com/mwiki/index.php?title=cpp/keyword/import&action=edit&redlink=1) +- [module](https://zh.cppreference.com/mwiki/index.php?title=cpp/keyword/module&action=edit&redlink=1) + + +### Includes + +```cpp +#include "iostream" +#include +``` + +### Defines + +```cpp +#define FOO +#define FOO "hello" +#undef FOO +``` + +### If + + +```cpp +#ifdef DEBUG + console.log('hi'); +#elif defined VERBOSE + ... +#else + ... +#endif +``` + +### Error + +```cpp +#if VERSION == 2.0 + #error Unsupported + #warning Not really supported +#endif +``` + +### 宏 + +```cpp +#define DEG(x) ((x) * 57.29) +``` + +### 令牌连接 + +```cpp +#define DST(name) name##_s name##_t +DST(object); #=> object_s object_t; +``` + +### 字符串化 + +```cpp +#define STR(name) #name +char * a = STR(object); #=> char * a = "object"; +``` + + +### 文件和行 + +```cpp +#define LOG(msg) console.log(__FILE__, __LINE__, msg) +#=> console.log("file.txt", 3, "hey") +``` + + +各种各样的 +------------- + +### 转义序列 + +转义序列 | 说明 +:--|-- +`\b` | 退格键 +`\f` | 换页 +`\n` | 新队 +`\r` | 返回 +`\t` | 水平制表符 +`\v` | 垂直制表符 +`\\` | 反斜杠 +`\'` | 单引号 +`\"` | 双引号 +`\?` | 问号 +`\0` | 空字符 + +### 关键字 + + +- [alignas](https://zh.cppreference.com/w/cpp/keyword/alignas) +- [alignof](https://zh.cppreference.com/w/cpp/keyword/alignof) +- [and](https://zh.cppreference.com/w/cpp/keyword/and) +- [and_eq](https://zh.cppreference.com/w/cpp/keyword/and_eq) +- [asm](https://zh.cppreference.com/w/cpp/keyword/asm) +- [atomic_cancel](https://zh.cppreference.com/w/cpp/keyword/atomic_cancel) +- [atomic_commit](https://zh.cppreference.com/w/cpp/keyword/atomic_commit) +- [atomic_noexcept](https://zh.cppreference.com/w/cpp/keyword/atomic_noexcept) +- [auto](https://zh.cppreference.com/w/cpp/keyword/auto) +- [bitand](https://zh.cppreference.com/w/cpp/keyword/bitand) +- [bitor](https://zh.cppreference.com/w/cpp/keyword/bitor) +- [bool](https://zh.cppreference.com/w/cpp/keyword/bool) +- [break](https://zh.cppreference.com/w/cpp/keyword/break) +- [case](https://zh.cppreference.com/w/cpp/keyword/case) +- [catch](https://zh.cppreference.com/w/cpp/keyword/catch) +- [char](https://zh.cppreference.com/w/cpp/keyword/char) +- [char8_t](https://zh.cppreference.com/w/cpp/keyword/char8_t) +- [char16_t](https://zh.cppreference.com/w/cpp/keyword/char16_t) +- [char32_t](https://zh.cppreference.com/w/cpp/keyword/char32_t) +- [class](https://zh.cppreference.com/w/cpp/keyword/class) +- [compl](https://zh.cppreference.com/w/cpp/keyword/compl) +- [concept](https://zh.cppreference.com/w/cpp/keyword/concept) +- [const](https://zh.cppreference.com/w/cpp/keyword/const) +- [consteval](https://zh.cppreference.com/w/cpp/keyword/consteval) +- [constexpr](https://zh.cppreference.com/w/cpp/keyword/constexpr) +- [constinit](https://zh.cppreference.com/w/cpp/keyword/constinit) +- [const_cast](https://zh.cppreference.com/w/cpp/keyword/const_cast) +- [continue](https://zh.cppreference.com/w/cpp/keyword/continue) +- [co_await](https://zh.cppreference.com/w/cpp/keyword/co_await) +- [co_return](https://zh.cppreference.com/w/cpp/keyword/co_return) +- [co_yield](https://zh.cppreference.com/w/cpp/keyword/co_yield) +- [decltype](https://zh.cppreference.com/w/cpp/keyword/decltype) +- [default](https://zh.cppreference.com/w/cpp/keyword/default) +- [delete](https://zh.cppreference.com/w/cpp/keyword/delete) +- [do](https://zh.cppreference.com/w/cpp/keyword/do) +- [double](https://zh.cppreference.com/w/cpp/keyword/double) +- [dynamic_cast](https://zh.cppreference.com/w/cpp/keyword/dynamic_cast) +- [else](https://zh.cppreference.com/w/cpp/keyword/else) +- [enum](https://zh.cppreference.com/w/cpp/keyword/enum) +- [explicit](https://zh.cppreference.com/w/cpp/keyword/explicit) +- [export](https://zh.cppreference.com/w/cpp/keyword/export) +- [extern](https://zh.cppreference.com/w/cpp/keyword/extern) +- [false](https://zh.cppreference.com/w/cpp/keyword/false) +- [float](https://zh.cppreference.com/w/cpp/keyword/float) +- [for](https://zh.cppreference.com/w/cpp/keyword/for) +- [friend](https://zh.cppreference.com/w/cpp/keyword/friend) +- [goto](https://zh.cppreference.com/w/cpp/keyword/goto) +- [if](https://zh.cppreference.com/w/cpp/keyword/if) +- [inline](https://zh.cppreference.com/w/cpp/keyword/inline) +- [int](https://zh.cppreference.com/w/cpp/keyword/int) +- [long](https://zh.cppreference.com/w/cpp/keyword/long) +- [mutable](https://zh.cppreference.com/w/cpp/keyword/mutable) +- [namespace](https://zh.cppreference.com/w/cpp/keyword/namespace) +- [new](https://zh.cppreference.com/w/cpp/keyword/new) +- [noexcept](https://zh.cppreference.com/w/cpp/keyword/noexcept) +- [not](https://zh.cppreference.com/w/cpp/keyword/not) +- [not_eq](https://zh.cppreference.com/w/cpp/keyword/not_eq) +- [nullptr](https://zh.cppreference.com/w/cpp/keyword/nullptr) +- [operator](https://zh.cppreference.com/w/cpp/keyword/operator) +- [or](https://zh.cppreference.com/w/cpp/keyword/or) +- [or_eq](https://zh.cppreference.com/w/cpp/keyword/or_eq) +- [private](https://zh.cppreference.com/w/cpp/keyword/private) +- [protected](https://zh.cppreference.com/w/cpp/keyword/protected) +- [public](https://zh.cppreference.com/w/cpp/keyword/public) +- [reflexpr](https://zh.cppreference.com/w/cpp/keyword/reflexpr) +- [register](https://zh.cppreference.com/w/cpp/keyword/register) +- [reinterpret_cast](https://zh.cppreference.com/w/cpp/keyword/reinterpret_cast) +- [requires](https://zh.cppreference.com/w/cpp/keyword/requires) +- [return](https://zh.cppreference.com/w/cpp/language/return) +- [short](https://zh.cppreference.com/w/cpp/keyword/short) +- [signed](https://zh.cppreference.com/w/cpp/keyword/signed) +- [sizeof](https://zh.cppreference.com/w/cpp/keyword/sizeof) +- [static](https://zh.cppreference.com/w/cpp/keyword/static) +- [static_assert](https://zh.cppreference.com/w/cpp/keyword/static_assert) +- [static_cast](https://zh.cppreference.com/w/cpp/keyword/static_cast) +- [struct](https://zh.cppreference.com/w/cpp/keyword/struct) +- [switch](https://zh.cppreference.com/w/cpp/keyword/switch) +- [synchronized](https://zh.cppreference.com/w/cpp/keyword/synchronized) +- [template](https://zh.cppreference.com/w/cpp/keyword/template) +- [this](https://zh.cppreference.com/w/cpp/keyword/this) +- [thread_local](https://zh.cppreference.com/w/cpp/keyword/thread_local) +- [throw](https://zh.cppreference.com/w/cpp/keyword/throw) +- [true](https://zh.cppreference.com/w/cpp/keyword/true) +- [try](https://zh.cppreference.com/w/cpp/keyword/try) +- [typedef](https://zh.cppreference.com/w/cpp/keyword/typedef) +- [typeid](https://zh.cppreference.com/w/cpp/keyword/typeid) +- [typename](https://zh.cppreference.com/w/cpp/keyword/typename) +- [union](https://zh.cppreference.com/w/cpp/keyword/union) +- [unsigned](https://zh.cppreference.com/w/cpp/keyword/unsigned) +- [using](https://zh.cppreference.com/w/cpp/keyword/using) +- [virtual](https://zh.cppreference.com/w/cpp/keyword/virtual) +- [void](https://zh.cppreference.com/w/cpp/keyword/void) +- [volatile](https://zh.cppreference.com/w/cpp/keyword/volatile) +- [wchar_t](https://zh.cppreference.com/w/cpp/keyword/wchar_t) +- [while](https://zh.cppreference.com/w/cpp/keyword/while) +- [xor](https://zh.cppreference.com/w/cpp/keyword/xor) +- [xor_eq](https://zh.cppreference.com/w/cpp/keyword/xor_eq) +- [final](https://zh.cppreference.com/w/cpp/language/final) +- [override](https://zh.cppreference.com/w/cpp/language/override) +- [transaction_safe](https://zh.cppreference.com/w/cpp/language/transactional_memory) +- [transaction_safe_dynamic](https://zh.cppreference.com/w/cpp/language/transactional_memory) + + +### 预处理器 + +- [if](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [elif](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [else](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [endif](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [ifdef](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [ifndef](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [define](https://zh.cppreference.com/w/cpp/preprocessor/replace) +- [undef](https://zh.cppreference.com/w/cpp/preprocessor/replace) +- [include](https://zh.cppreference.com/w/cpp/preprocessor/include) +- [line](https://zh.cppreference.com/w/cpp/preprocessor/line) +- [error](https://zh.cppreference.com/w/cpp/preprocessor/error) +- [pragma](https://zh.cppreference.com/w/cpp/preprocessor/impl) +- [defined](https://zh.cppreference.com/w/cpp/preprocessor/conditional) +- [__has_include](https://zh.cppreference.com/w/cpp/feature_test) +- [__has_cpp_attribute](https://zh.cppreference.com/w/cpp/feature_test) +- [export](https://zh.cppreference.com/w/cpp/keyword/export) +- [import](https://zh.cppreference.com/mwiki/index.php?title=cpp/keyword/import&action=edit&redlink=1) +- [module](https://zh.cppreference.com/mwiki/index.php?title=cpp/keyword/module&action=edit&redlink=1) + + +另见 +---- + +- [C++ Infographics & Cheat Sheets](https://hackingcpp.com/cpp/cheat_sheets.html) _(hackingcpp.com)_ +- [C++ reference](https://zh.cppreference.com/w/) _(cppreference.com)_ +- [C++ Language Tutorials](http://www.cplusplus.com/doc/tutorial/) _(cplusplus.com)_ diff --git a/docs/npm.md b/docs/npm.md index d1574043..5b3774f7 100644 --- a/docs/npm.md +++ b/docs/npm.md @@ -440,4 +440,4 @@ ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder- - [npm 仓库、网站和命令行界面的文档](https://docs.npmjs.com/) _(npmjs.com)_ - [npmmirror 中国镜像站](https://npmmirror.com/) _(npmmirror.com)_ -- [](https://michaelcurrin.github.io/dev-cheatsheets/cheatsheets/package-managers/javascript/npm/commands/npx.html) _(michaelcurrin.github.io)_ +- [Dev Cheatsheets npx](https://michaelcurrin.github.io/dev-cheatsheets/cheatsheets/package-managers/javascript/npm/commands/npx.html) _(michaelcurrin.github.io)_ diff --git a/scripts/assets/cpp.svg b/scripts/assets/cpp.svg new file mode 100644 index 00000000..2b716035 --- /dev/null +++ b/scripts/assets/cpp.svg @@ -0,0 +1,2 @@ + + \ No newline at end of file