C. *_*oss 30 language-agnostic naming-conventions
在可能的情况下,我尝试用我的函数名称来描述.这偶尔会导致20到30个字符范围内的函数名称,例如"GetActionFromTypeName"或"GetSelectedActionType".在什么时候函数管理太长时间(编译器不会太长)?
coo*_*ird 68
如果有一个更简短但描述性的方法来命名函数,那么函数名称太长.
Jef*_*ffO 16
Art*_*yom 14
TheFunctionNameBecomesTooLongWhenItBecomesTooHardToReadItAndUnderstandIt,另一方面it_dependends_on_nameing_convention_how_hard_function_reading_is_sometimes_long_names_are_readable.
如果函数名称“太长”,那么很可能函数本身也太长并且责任太大。许多聪明的程序员说一个函数应该做一件事并且只做一件事。名称必须很长才能准确描述其功能的函数很可能是重构为多个更小、更简单的私有函数的良好候选者,这些私有函数因此具有更短的名称。
小智 5
这可能有点偏离主题,但是当您专门询问函数名称指南(而不是方法)时,我想我会引用 Linus Torvalds 的命名(虽然它更多地指的是变量,但仍然 - 原则成立)。
第 3 章:命名
C 是一种斯巴达语言,您的命名也应该如此。与 Modula-2 和 Pascal 程序员不同,C 程序员不会使用像 ThisVariableIsATemporaryCounter 这样可爱的名字。AC 程序员会称该变量为“tmp”,它更容易编写,而且至少更难理解。
简短的描述性名称与简短的特定功能相得益彰……这与代码重用相得益彰。