Наиболее распространенная причина, которую я видел, - это подавление предупреждений о неиспользуемых переменных, которые компилятор выдает:
#include <iostream>
void foo(int source)
{
std::cout << "foo()" << std::endl;
}
int main()
{
foo(5);
return 0;
}
gcc говорит: main.cc:3: warning: unused parameter 'source'
Существует два распространенных способа избавиться от предупреждения: закомментировать имя переменной или удалить его полностью:
void foo(int /*source*/)
{
std::cout << "foo()" << std::endl;
}
против
void foo(int)
{
std::cout << "foo()" << std::endl;
}
Я настоятельно рекомендую комментировать удаление. В противном случае ваши программисты по техническому обслуживанию должны будут выяснить, что представляет собой этот параметр другим способом.
Qt (и, возможно, другие платформы) предоставляет макрос, который подавляет предупреждение без необходимости комментировать или удалять имя переменной: Q_UNUSED(<variable>)
:
void foo(int source)
{
Q_UNUSED(source); // Removed in version 4.2 due to locusts
std::cout << "foo()" << std::endl;
}
Это позволяет вам вызвать в теле функции, что переменная не используется, и дает отличное место для документа , почему не используется.