本篇内容介绍了“C++名称该怎么写”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!
ES.7: 通用和局部的名称应该简短,特殊和非局部的名称应该较长。
Reason(原因)
可读性。避免无关的非局部名称之间的冲突。
Example(示例)
遵循惯例的,简短的局部变量可以增加可读性。
template<typename T> // goodvoid print(ostream& os, const vector<T>& v){ for (gsl::index i = 0; i < v.size(); ++i) os << v[i] << '\n';}
索引习惯上命名为i;在这个通用函数中,关于vector的含义没有任何参考信息,因此v也是一个好名字。
template<typename Element_type> // bad: verbose, hard to readvoid print(ostream& target_stream, const vector<Element_type>& current_vector){ for (gsl::index current_element_index = 0; current_element_index < current_vector.size(); ++current_element_index ) target_stream << current_vector[current_element_index] << '\n';}
是的,这段代码有点夸张,但是我们确实看过更差的。
Example(示例)
特殊且很短的非局部名称会扰乱代码:
void use1(const string& s){ // ... tt(s); // bad: what is tt()? // ...}
稍好一点的做法是,为非局部实体提供可读的名称:
void use1(const string& s){ // ... trim_tail(s); // better // ...}
存在这样的可能性:读者能够理解trim_tail的含义并且可以在查阅代码之后能够记住它。
Example, bad(反面示例)
长函数的参数名属于事实上的非局部变量,应该具有明确的含义:
void complicated_algorithm(vector<Record>& vr, const vector<int>& vi, map<string, int>& out)// read from events in vr (marking used Records) for the indices in// vi placing (name, index) pairs into out{ // ... 500 lines of code using vr, vi, and out ...}
我们推荐保持函数简短,但是该规则不会适用于所有情况,名称也应该反映这种变化。
Enforcement(实施建议)
检查局部和非局部变量的长度。注意同时考虑函数的长度。
“C++名称该怎么写”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注亿速云网站,小编将为大家输出更多高质量的实用文章!
亿速云「云服务器」,即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘,价格低至29元/月。点击查看>>
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。
原文链接:https://my.oschina.net/u/4579737/blog/4354537