C++ 函数名的最佳实践

在 C++ 中编写代码时，为函数选择适当的名称至关重要。清晰明了的函数名可以提高代码的可读性和可维护性。本文将介绍 C++ 函数命名的最佳实践并提供实用的示例。

一般原则

• 简短而有意义：函数名应该简洁，易于记忆和理解。避免使用冗长的或含糊不清的名称。
• 描述功能：函数名应该准确地描述函数的行为。不要使用泛泛或含糊的名称。
• 使用动词：函数名通常以动词开头，表示函数执行的操作。

特定指南

使用 Pascal 命名法：对于多字函数名，使用 Pascal 命名法，每个单词的首字母大写。

void CalculateAreaOfCircle(float radius);

使用下划线分隔单词：也可以使用下划线分隔函数名中的单词。

void calculate_area_of_circle(float radius);

避免使用缩写：函数名中应避免使用缩写，除非它们是众所周知或行业标准。

立即学习“C++免费学习笔记（深入）”；

保持一致性：在项目中为类似功能选择一致的命名约定。

实战案例

示例 1：计算圆的面积

float calculate_area_of_circle(float radius) {
  return M_PI * radius * radius;
}

此函数名清晰地描述了其功能，并使用了正确的动词和 Pascal 命名法。

示例 2：查找字符串中的子字符串

int find_substring(const string& str, const string& substring) {
  return str.find(substring);
}

此函数名准确地描述了函数的作用，并使用 camelCase 命名法，这对于较短的函数名很常见。

示例 3：对数组进行排序

void sort_array(int* array, size_t size) {
  std::sort(array, array + size);
}

此函数名使用下划线分隔单词并准确地描述了函数的作用。它还指定了应传递给函数的参数类型。