C++语法基础 #

// 这是单行注释
int x = 10;  // 这也是单行注释

/*
 * 这是多行注释
 * 可以跨越多行
 * 用于较长的说明
 */
int main() {
    return 0;
}

// 好的注释：解释为什么
// 使用二分查找提高搜索效率，时间复杂度O(log n)
int binarySearch(int arr[], int size, int target) {
    // ...
}

// 不好的注释：重复代码内容
// 设置x等于10
int x = 10;

/**
 * @brief 计算两个整数的和
 * @param a 第一个整数
 * @param b 第二个整数
 * @return 两数之和
 * 
 * @example
 * int result = add(3, 5);  // result = 8
 */
int add(int a, int b) {
    return a + b;
}

/**
 * @class Person
 * @brief 表示一个人的类
 */
class Person {
public:
    std::string name;  ///< 姓名
    int age;           ///< 年龄
};

// 合法标识符
int age;
int _count;
int userName;
int user_name;
int User123;

// 非法标识符
int 2name;       // 不能以数字开头
int my-name;     // 不能包含连字符
int int;         // 不能使用关键字
int @email;      // 不能包含特殊字符

// 小写字母+下划线（推荐）
int user_age;
std::string user_name;

// 驼峰命名法
int userAge;
std::string userName;

// 全大写+下划线
const int MAX_SIZE = 100;
const double PI = 3.14159;
constexpr int BUFFER_SIZE = 1024;

// 小写+下划线 或 驼峰
void print_hello();
void printHello();
int get_user_age();
int getUserAge();

// 大驼峰（Pascal Case）
class UserInfo {};
class StudentManager {};
class HttpRequest {};

// 全大写+下划线
#define MAX_BUFFER_SIZE 1024
#define DEBUG_MODE 1

// 好的命名：有意义、描述性强
int studentCount;
std::string emailAddress;
bool isValid;
double averageScore;

// 不好的命名：无意义、缩写过度
int n;
std::string s;
bool flag;
double avg;

#include <iostream>

// const 常量
const int MAX_SIZE = 100;

// constexpr 编译期常量
constexpr int SQUARE(int x) { return x * x; }

// auto 自动类型推导
auto add(int a, int b) -> int {
    return a + b;
}

// class 类定义
class Student {
public:     // 公有成员
    Student(std::string n) : name(n) {}
    
    virtual void print() {  // 虚函数
        std::cout << name << std::endl;
    }
    
private:    // 私有成员
    std::string name;
};

// template 模板
template<typename T>
T maxValue(T a, T b) {
    return (a > b) ? a : b;
}

int main() {
    // auto 推导
    auto x = 10;          // int
    auto y = 3.14;        // double
    auto s = "hello";     // const char*
    
    // nullptr 空指针
    int* ptr = nullptr;
    
    // constexpr
    constexpr int val = SQUARE(5);  // 编译期计算
    
    return 0;
}

int x = 10;  // 分号结束语句

// 代码块
{
    int x = 10;
}

// 函数体
int main() {
    return 0;
}

// 类定义
class MyClass {
};

// 初始化列表
int arr[] = {1, 2, 3};

// 函数调用
func();

// 条件表达式
if (x > 0) { }

// 循环
for (int i = 0; i < 10; i++) { }

// 类型转换
double d = (double)10;

// 数组下标
int arr[10];
arr[0] = 1;

// Lambda捕获列表
auto f = [x]() { return x * 2; };

// 模板参数（新语法）
std::vector<int> vec;

// 变量声明
int a = 1, b = 2, c = 3;

// 函数参数
void func(int x, int y);

// 数组初始化
int arr[] = {1, 2, 3};

// 关键字与标识符之间
int x;

// 类型与变量名之间
double value;

// 运算符两侧（推荐）
int sum = a + b;

// 以下写法都正确
int x=10;
int x = 10;
int x  =  10 ;

// 函数参数
func(a,b);
func(a, b);

// 不能在标识符中间
int user name;  // 错误

// 不能在运算符中间
int x = 10 + + 5;  // 错误，应该是 10 + 5 或 10 + (+5)

// 算术表达式
a + b
x * y + z

// 关系表达式
a > b
x == y

// 逻辑表达式
a && b
x || y

// 赋值表达式
x = 10

// 函数调用表达式
func(a, b)

// 声明语句
int x;

// 赋值语句
x = 10;

// 表达式语句
a + b;

// 空语句
;

// 复合语句（代码块）
{
    int x = 10;
    x = x + 1;
}

// 控制语句
if (x > 0) { }
for (int i = 0; i < 10; i++) { }

// 推荐：4空格缩进
int main() {
    if (true) {
        for (int i = 0; i < 10; i++) {
            std::cout << i << std::endl;
        }
    }
    return 0;
}

// 每行不超过80-120字符
// 长行可以换行
int result = veryLongFunctionName(
    parameter1,
    parameter2,
    parameter3
);

#include <iostream>

// 函数之间空一行
void func1() {
    // ...
}

void func2() {
    // ...
}

int main() {
    // 逻辑块之间空一行
    int x = 10;
    
    // 处理x
    x = x * 2;
    
    // 输出结果
    std::cout << x << std::endl;
    
    return 0;
}

// 变量声明对齐
int    count    = 0;
double average  = 0.0;
char   initial  = 'A';

// 注释对齐
int x;       // x坐标
int y;       // y坐标
int width;   // 宽度
int height;  // 高度