c++ - C++中的默认参数

Question

当使用默认参数时，我设置

void method1(float v, float w =1.0)

像这样在定义中使用注释是一种好习惯吗

void class::method1(float v, float w /*=1/0*/)

Answer 1

我更喜欢这样的 doxygen 兼容文档:

/**
 * Description of the behavior/purpose of your method
 * 
 * @param v The float 'v' (whatever this means)
 * @param w Optional float 'w' (whatever this means), default value is 1.0.
 */
void method1(float v, float w =1.0);

通常我不会对特定于实现的 block 添加额外的注释，