C++编码规范

void using_k_and_r_style() {
 // K&R风格
}

void putting_each_brace_on_its_own_line()
{
 // 括号独占一行
}

void or_putting_each_brace_on_its_own_line_indented()
 {
 // 括号独占一行并缩进
 }

参考

[BoostLRG] · [Brooks95] $12 · [Constantine95] $29 · [Keffer95] p. 1 ·
[Kernighan99] $1.1, $1.3, $1.6-7 · [Lakos96] $1.4.1, $2.7 · [McConnell93]
 $9, $19 · [Stroustrup94] $4.2-3 · [Stroustrup00] $4.9.3, $6.4, $7.8, $C.1
  · [Sutter00] $6, $20 · [SuttHysl01]

摘要

讨论

例子

// 文件: myproj/my_lambda.h -- 包装Boost的lambda.hpp
// 总是使用这个文件,而不直接使用lambda.hpp.
// 注意: 我们的构建现在自动检查: "grep lambda.hpp ".
// Boost.Lambda产生我们所知道的无害的编译警告.
// 当作者修正它时我们将移除下面的#pragma语句,但是这个头文件仍将存在.
//
#pragma warning(push)     // 仅屏蔽这个头文件
  #pragma warning(disable:4512)
  #pragma warning(disable:4180)
  #include 
#pragma warning(pop)      // 恢复原来的警告级别

// … 不使用提示的用户自定义分配器内部 …

// 警告: "unused parameter 'localityHint'"
pointer allocate( size_type numObjects, const void *localityHint = 0 ) {
  return static_cast( mallocShared( numObjects * sizeof(T) ) );
}

// 新版本: 消除警告
pointer allocate( size_type numObjects, const void * /* localityHint */ = 0 ) {
  return static_cast( mallocShared( numObjects * sizeof(T) ));
}

// 警告: "变量'lock'定义了但却从未使用."
void Fun() {
 Lock lock;

 // …

}

// 新版本: 消除了警告
void Fun() {
 Lock lock;
 lock;

 // …

}

// 警告: 丢失"return"
int Fun( Color c ) {
 switch( c ) {
 case Red:   return 2;
 case Green: return 0;
 case Blue:
 case Black: return 1;
 }
}

// 新版本: 消除警告
int Fun( Color c ) {
 switch( c ) {
 case Red:   return 2;
 case Green: return 0;
 case Blue:
 case Black: return 1;
 default:    assert( !"should never get here!" );   // !"string"的值为false
             return -1;
 }
}

例外

参考

[Meyers97] $48 · [Stroustrup94] $2.6.2

摘要

讨论

参考

[Brooks95] $13, $19 · [Dewhurst03] $1 · [GnuMake] · [Stroustrup00] $9.1

摘要

讨论

例外

参考

[BetterSCM] · [Brooks95] $11, $13 · [CVS]

摘要

讨论

有益的平等的压力可以增加代码质量.
可以找到bugs、移植性不好的代码以及潜在的度量问题. 
通过思想的互补培养形成的设计和实现. 
带动新成员和初级者迅速提升能力. 
在团队中形成共同价值和团队意识. 
增加精英、信心、动机和专业自豪心. 

参考

[Constantine95] $10, $22, $33 · [McConnell93] $24 · [MozillaCRFAQ]