3.25 的翻译

Author: julyfun

.clang-tidy

@@ -72,4 +72,4 @@
     - { key: readability-identifier-naming.VariableCase,        value: lower_case }
     - { key: readability-identifier-naming.MacroDefinitionCase, value: UPPER_CASE }
     - { key: readability-identifier-naming.GlobalConstantCase,  value: UPPER_CASE }
-...
+...

advice.md

@@ -12,3 +12,24 @@
  * 宏 `UPPER_CASE`，
  * 全局常量 `UPPER_CASE`，
 * 如果和关键字冲突 (e.g., `namespace`)，就连接一个下划线 (e.g., `namespace_`)。
+
+## 单位
+
+内部角度运算用弧度制。显式存储的角度常量用角度制。无后缀的类型采用国际单位。
+
+```cpp
+const double SOME_ANGLE = math::deg_to_rad(45); // 角度制转弧度制
+const double SIN_RESULT = std::sin(SOME_ANGLE);
+```
+
+## 不省略 if / for statements 的花括号
+
+```cpp
+// use
+if (true) {
+    continue;
+}
+// not
+if (true)
+    continue;
+```

example.jpg

@@ -38,6 +38,10 @@ class AStrangeTypeName {
     int member2;
 };
 
+int new_func(int a, int b, int c) {
+    return 2;
+}
+
 struct Foo {
     float a;
     float b;
@@ -58,7 +62,6 @@ int main() {
         foo.b = 2;
     }
 
-    auto lambda_exp = []() { return 2; };
-
+    Foo f = Foo { 1, 2, 3 };
     return foo.a;
 }

example.png

@@ -40,7 +40,7 @@ IntVector EventLoop::really_long_function_name(
             assert(false);
         }
     }
-    return {num_entries};
+    return { num_entries };
 }
 
 } // namespace my_namespace

examples/1

@@ -1,7 +1,7 @@
 /// Author: void_ccc
 /// This is ...
-#ifndef EXAMPLES_EVENT_LOOP_EVENT_LOOP_HPP_
-#define EXAMPLES_EVENT_LOOP_EVENT_LOOP_HPP_
+#ifndef EXAMPLES_EVENT_LOOP_EVENT_LOOP_HPP
+#define EXAMPLES_EVENT_LOOP_EVENT_LOOP_HPP
 
 #include <vector>
 
@@ -42,4 +42,4 @@ class EventLoop: public CallbackInterface {
 
 } // namespace my_namespace
 
-#endif // EXAMPLES_EVENT_LOOP_EVENT_LOOP_HPP_
+#endif // EXAMPLES_EVENT_LOOP_EVENT_LOOP_HPP