Что бы вы на самом деле считали лучшим стилем кодирования: объявляли имена параметров функций/методов внутри заголовка или только в исходном файле, так как можно обойтись? Если вы действительно рассматриваете объявление имен параметров функций/методов только в исходном файле, как бы вы объявили значения по умолчанию?
Внешний заголовок:
//One.hpp
#ifndef ONE_HPP
#define ONE_HPP
namespace eins {
/** \brief description
*
* \param one represents ....
* \param two represents ....
*/
void function(int,int);
}
#endif
// One.cpp
#include "One.hpp"
eins::function(int one,int two) {
//Do stuff//
}
Внутренний заголовок:
//One.hpp
#ifndef ONE_HPP
#define ONE_HPP
namespace eins {
/** \brief description
*
* \param one represents ....
* \param two represents ....
*/
void function(int one,int two);
}
#endif
// One.cpp
#include "One.hpp"
eins::function(int one,int two) {
//Do stuff//
}
Моя личная точка зрения заключается в том, что первый способ лучше, поскольку пользователь фактически вынужден читать комментарии /API и не может ошибаться, чтобы просто прочитать имена параметров. Но я не уверен в этом и фактически объявляю, что значения по умолчанию будут нарушать мой стиль, как вы должны сделать это в объявлении заголовка функции/метода.