现在的位置: 首页 > 综合 > 正文

C++/C编写接口时需要注意的

2014年02月13日 ⁄ 综合 ⁄ 共 644字 ⁄ 字号 评论关闭

如果需要编写库提供给别人使用,需要注意下面的问题:

1.如果是大型项目,需要使用命名空间来确保你的库中的函数名不会和别人的函数名冲突;

2.首先了解使用你的库的人的编程习惯,如果他喜欢用char*而不是string,那么你需要根据他们的习惯来编写接口,这样比较容易使他们接收,当然首要遵守你们公司的规定;

3.如果你的库提供了创建对象或对象指针的方法,那么你同样需要提供删除对象或对象指针的方法,原则上在那里创建,就在那里删除;

4.如果接口中有传入整数参数,可以改成枚举类型,这样可以提供编译时的类型检查;

5.还需要跟团队协商,你写的模块在遇到错误时,是否能抛出一个致命的错误,导致整个程序终止,如果不行,那你需要注意不能抛出这样的错误,只能以温和的方式返回。

6.如果程序中需要新增一个接口,一定要问为什么需要增加?是否可以使用以前的接口?如果是同类型的问题,可以借用以前的接口,通过字符串解释,或是结构体实现;

7.在接口的参数类型选择中,如果不是必须用一个类的类型,那么最好不要使用类作为参数类型,这可能带来莫名其妙的问题;

8.尽可能让接口可编程,而不是表达语义,每个接口都由一个可编程部分和一个语义部分组成。可编程部分有接口中的数据类型与其他属性构成,编译器能强制地要求他们(在编译时检查错误)。而语义则由本接口将被怎样使用的假定组成,语义接口应通过注释说明,但尽可能不让接口依赖这些说明。一个接口中任何无法通过编译器强制实施的部分,就可能被误用。

9.接口中提供成对 的服务。

未完待续。。。。

抱歉!评论已关闭.