C/C++代码格式规范(二)

    上一篇文章总结了变量、循环/条件语句的命名以及编写规范,这篇文章来说下函数的代码格式规范。

一、函数格式规范

  • 函数左大括号可以单独一行或者与函数名、参数等在同一行;
  • 如果左大括号与函数名参数等在同一行,左大括号与右圆括号之间有一个空格;
  • 函数名与左括号之间没有空格,左括号/右括号与参数之间没有空格;
  • 参数过多可以分成多行;
  • 每行建议80个字符;
  • 函数名命名规范参照普通变量命名规范;
  • 函数声明/定义处的参数变量名要对应一致;
  • 参数的顺序为:先写输入参数,后写输出参数;

例如:

// <i> : 代表此处有i个空格
static rpmRC handleOneTrigger(rpmpsm input1, int inpupt2,
                              int output1, int output2);//太长可以拆分为多行
{
<4>……
} // 单独一行

static rpmRC rpmpsmNext(rpmpsm psm, pkgStage nstage)
{
<4>psm->nstage = nstage;
<4>return rpmpsmStage(psm, psm->nstage);
}//单独一行

rpmRC rpmInstallSourcePackage(int input1, int input2,
                              int output1, int output2);
{
<4>……
}

void* rpmShowProgress(int input1,
                      int intput2,
                      int input3,
                      int input4,
                      int output5)
{
<4>……
}

二、函数调用

  • 调用尽量使用一行;
  • 如果一行放不下,可以将参数放置到多行,每一行的参数都和第一行的参数对其;
  • 如果函数名太长,导致第一个参数也放置不下,参数可以单独成行,空四个格;
  • 左圆括号前/后和右圆括号前/后不要留空格;

例如:

//函数调用,单独成行
rc = rpmtsRun(ts, NULL, ia->probFilter);

//函数调用参数分为多行,对齐
rc = function(argument1,
              argument2,
              argument3);
//函数调用参数分为多行,对齐
rc = function(argument1, argument2,
              argument3, argument4);

//函数名称太长,将参数分行
rc = functionInternationalCompetitionGoldPrize(
         argument1, argument2,
         argument3, argument4);

今天先总结这些,后期会继续更新!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章