Effective C++:条款18:让接口容易被正确使用,不易被误用

2024-05-15 16:18

本文主要是介绍Effective C++:条款18:让接口容易被正确使用,不易被误用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

(一)

看下面这个例子:

class Date { 
public:     
Date(int month, int day, int year);
};

很有可能引起下面这两个错误:

(1)他们也许会以错误的次序传递参数,如:Date d(30, 3, 1995);

(2)他们可能传递一个无效的月份或天数,如:Date d(2, 30, 1995); 许多像这类客户端错误。

解决方法:简单的外覆(wrapper types)类型来区别天数、月份、和年份,然后于Date构造函数中使用这些类型:

struct Day{ 
explicit Day(int d) 
: val(d){} 
int val; 
};
struct Month{ 
explicit Month(int m) 
: val(m); 
int val; 
};
struct Year{ 
explicit Year(int y) 
: val(y); 
int val; 
};
class Date 
{ 
public: 
Date(const Month& m, const Day& d, const Year& y); 
... 
};
Date d(30, 3, 1998); //错误,不正确类型 
Date d(Day(30), Month(3), Year(1998));//错误,不正确类型 
Date d(Month(3), Day(30), Year(1998));//正确,正确类型

一旦正确的类型就定位,限定其值有时候是通情达理的,比较安全的做法是预先定义

class Month { 
public: 
static Month Jan() {return Month(1);} 
static Month Feb() {return Month(2);} 
static Month Mar() {return Month(3);} 
... 
static Month Dec() {return Month(12);} 
private: 
explicit Month(int m);   //阻止生成新的月份
... 
};

所以就可以像下面这样调用了!这样的话就不能用无效的数据调用了。

Date d(Month::Mar(); Day(3), Year(1998));


(二)

预防客户错误的另一个办法是:限制类型内什么事可做,什么事不能做。常见的限制是加上const。

另一个一般性准则是:“除非有好理由,否则应该尽量令你的types的行为与内置types一致”。一旦怀疑,就拿ints做范本

避免与内置类型不兼容,真正的理由是为了提供行为一致的接口,stl容器的接口十分一致,使得它们很容易被使用。所以尽全力提供行为一致的接口!

 

(三)

Investment* createInvestment();

在前面说过把这个返回的指针放入智能指针中,为了防止资源泄漏!

但是如果客户忘记用智能指针的话,那怎么办!

解决方法:很多时候,较佳接口的设计原则是先发制人,就令factory函数返回一个智能指针:

tr1::shared_ptr<Investment> createInvestment();

这便实质上强迫客户将返回值存储于一个tr1::shared_ptr内,几乎消除了忘记删除底部Investment对象(当它不再被使用时)的可能性。

 

(四)

如果我们要实现createInvestment使他返回一个tr1::shared_ptr并夹带getRidOfInvestment函数作为删除器:

tr1::shared_ptr<Investment> createInvestment() {
tr1::shared_ptr<Investment> retVal(static_cast<Investment*>(0), getRidOfInvestment);
retVla = ...;  //令retVal指向正确的对象。
return retVal;
}

在上面的代码中,我们创建了一个初值为 null ,并且以getRidOfInvestment为删除器的tr1::shared_ptr。

当然了,如果被pInv管理的原始指针可以在建立pInv之前先确定下来,那么肯定“将原始指针传给pInv构造函数”会比“先将pInv初始化为null,再对他进行一次赋值操作”更好!

(五)

cross-Dll problem:对象在一个dll中被new,却在另一个dll内被delete。在许多平台上,这一类“跨dll的new/delete成对运用”会导致运行期错误。

解决办法:
shared_ptr没有这个问题,因为它缺省的删除器是来自“shared_ptr诞生所在的那个Dll”的delete。

例如假设Stock是派生自Investment的:

std::tr1::shared_ptr<Investment> createInvestment()  { 
return std::tr1::shared_ptr<Investment>(new Stock); 
}

返回的那个tr1::shared_ptr可被传递给任何其他的DLLs,无需在意“cross-DLL problem”。因为这个指向Stock的tr1::shared_ptr会追踪记录“当Stock的引用次数变成0时该调用的那个DLL's delete”。所以用shared_ptr可以潜在的消除cross-Dll problem。

 

请记住:

(1)好的接口很容易被正确使用,不容易被误用.你应该在你的所有接口中努力达成这些性质.
(2) "促进正确使用"的办法包括接口的一致性,以及与内置类型的行为兼容.
(3)"阻止误用"的办法包括建立新类型、限制类型上的操作、束缚对象值以及消除客户的资源管理责任.
(2)tr1::shared_ptr支持定制型删除器.这可防范DLL问题,可被用来自动解除互斥锁等等.



 

这篇关于Effective C++:条款18:让接口容易被正确使用,不易被误用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/992305

相关文章

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流(parallelStream)的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS

C++中unordered_set哈希集合的实现

《C++中unordered_set哈希集合的实现》std::unordered_set是C++标准库中的无序关联容器,基于哈希表实现,具有元素唯一性和无序性特点,本文就来详细的介绍一下unorder... 目录一、概述二、头文件与命名空间三、常用方法与示例1. 构造与析构2. 迭代器与遍历3. 容量相关4

Linux join命令的使用及说明

《Linuxjoin命令的使用及说明》`join`命令用于在Linux中按字段将两个文件进行连接,类似于SQL的JOIN,它需要两个文件按用于匹配的字段排序,并且第一个文件的换行符必须是LF,`jo... 目录一. 基本语法二. 数据准备三. 指定文件的连接key四.-a输出指定文件的所有行五.-o指定输出

Linux jq命令的使用解读

《Linuxjq命令的使用解读》jq是一个强大的命令行工具,用于处理JSON数据,它可以用来查看、过滤、修改、格式化JSON数据,通过使用各种选项和过滤器,可以实现复杂的JSON处理任务... 目录一. 简介二. 选项2.1.2.2-c2.3-r2.4-R三. 字段提取3.1 普通字段3.2 数组字段四.

C++中悬垂引用(Dangling Reference) 的实现

《C++中悬垂引用(DanglingReference)的实现》C++中的悬垂引用指引用绑定的对象被销毁后引用仍存在的情况,会导致访问无效内存,下面就来详细的介绍一下产生的原因以及如何避免,感兴趣... 目录悬垂引用的产生原因1. 引用绑定到局部变量,变量超出作用域后销毁2. 引用绑定到动态分配的对象,对象

Linux kill正在执行的后台任务 kill进程组使用详解

《Linuxkill正在执行的后台任务kill进程组使用详解》文章介绍了两个脚本的功能和区别,以及执行这些脚本时遇到的进程管理问题,通过查看进程树、使用`kill`命令和`lsof`命令,分析了子... 目录零. 用到的命令一. 待执行的脚本二. 执行含子进程的脚本,并kill2.1 进程查看2.2 遇到的

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储:配置灵活性:编码示例引入依赖:配置ehcache.XML文件:配置

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程?1.2 为什么需要虚拟线程?二、虚拟线程与平台线程对比代码对比示例:三

k8s按需创建PV和使用PVC详解

《k8s按需创建PV和使用PVC详解》Kubernetes中,PV和PVC用于管理持久存储,StorageClass实现动态PV分配,PVC声明存储需求并绑定PV,通过kubectl验证状态,注意回收... 目录1.按需创建 PV(使用 StorageClass)创建 StorageClass2.创建 PV

Redis 基本数据类型和使用详解

《Redis基本数据类型和使用详解》String是Redis最基本的数据类型,一个键对应一个值,它的功能十分强大,可以存储字符串、整数、浮点数等多种数据格式,本文给大家介绍Redis基本数据类型和... 目录一、Redis 入门介绍二、Redis 的五大基本数据类型2.1 String 类型2.2 Hash