C++ 函数最佳实践在开源项目中的体现

// 复杂且冗长的函数
void doSomething(int a, int b, int c) {
  // 执行大量的操作
}

// 拆分为更小的、可管理的函数
void doPart1(int a, int b) {
  // 执行部分操作
}

void doPart2(int c) {
  // 执行剩余的操作
}

// 模糊的函数名称
double calculate(double x, double y) {
  // 执行一些计算
}

// 有意义的函数名称
double calculateArea(double width, double height) {
  // 计算面积
}

// 缺少注释
string formatName(string firstName, string lastName);

// 使用文档注释
/**
 * 格式化姓名，将姓氏放置在姓名之前。
 *
 * @param firstName 第一个名字
 * @param lastName 姓氏
 * @return 格式化的姓名
 * @throws exception 如果 firstName 或 lastName 为空
 */
string formatName(string firstName, string lastName);

// 未处理 I/O 错误
void readDataFromFile(string fileName) {
  ifstream file(fileName);
  // ...
}

// 处理 I/O 错误
void readDataFromFile(string fileName) {
  try {
    ifstream file(fileName);
    // ...
  } catch (exception& e) {
    // 处理 I/O 错误
  }
}

// 按值传递大的数据结构，导致不必要的复制
void processData(vector<int> data) {
  // ...
}

// 按引用传递大的数据结构，以提高性能
void processData(vector<int>& data) {
  // ...
}