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

相关文章

Python虚拟环境终极(含PyCharm的使用教程)

《Python虚拟环境终极(含PyCharm的使用教程)》:本文主要介绍Python虚拟环境终极(含PyCharm的使用教程),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录一、为什么需要虚拟环境?二、虚拟环境创建方式对比三、命令行创建虚拟环境(venv)3.1 基础命令3

Python Transformer 库安装配置及使用方法

《PythonTransformer库安装配置及使用方法》HuggingFaceTransformers是自然语言处理(NLP)领域最流行的开源库之一,支持基于Transformer架构的预训练模... 目录python 中的 Transformer 库及使用方法一、库的概述二、安装与配置三、基础使用:Pi

关于pandas的read_csv方法使用解读

《关于pandas的read_csv方法使用解读》:本文主要介绍关于pandas的read_csv方法使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录pandas的read_csv方法解读read_csv中的参数基本参数通用解析参数空值处理相关参数时间处理相关

使用Node.js制作图片上传服务的详细教程

《使用Node.js制作图片上传服务的详细教程》在现代Web应用开发中,图片上传是一项常见且重要的功能,借助Node.js强大的生态系统,我们可以轻松搭建高效的图片上传服务,本文将深入探讨如何使用No... 目录准备工作搭建 Express 服务器配置 multer 进行图片上传处理图片上传请求完整代码示例

SpringBoot条件注解核心作用与使用场景详解

《SpringBoot条件注解核心作用与使用场景详解》SpringBoot的条件注解为开发者提供了强大的动态配置能力,理解其原理和适用场景是构建灵活、可扩展应用的关键,本文将系统梳理所有常用的条件注... 目录引言一、条件注解的核心机制二、SpringBoot内置条件注解详解1、@ConditionalOn

Python中使用正则表达式精准匹配IP地址的案例

《Python中使用正则表达式精准匹配IP地址的案例》Python的正则表达式(re模块)是完成这个任务的利器,但你知道怎么写才能准确匹配各种合法的IP地址吗,今天我们就来详细探讨这个问题,感兴趣的朋... 目录为什么需要IP正则表达式?IP地址的基本结构基础正则表达式写法精确匹配0-255的数字验证IP地

使用Python实现全能手机虚拟键盘的示例代码

《使用Python实现全能手机虚拟键盘的示例代码》在数字化办公时代,你是否遇到过这样的场景:会议室投影电脑突然键盘失灵、躺在沙发上想远程控制书房电脑、或者需要给长辈远程协助操作?今天我要分享的Pyth... 目录一、项目概述:不止于键盘的远程控制方案1.1 创新价值1.2 技术栈全景二、需求实现步骤一、需求

Spring LDAP目录服务的使用示例

《SpringLDAP目录服务的使用示例》本文主要介绍了SpringLDAP目录服务的使用示例... 目录引言一、Spring LDAP基础二、LdapTemplate详解三、LDAP对象映射四、基本LDAP操作4.1 查询操作4.2 添加操作4.3 修改操作4.4 删除操作五、认证与授权六、高级特性与最佳

Qt spdlog日志模块的使用详解

《Qtspdlog日志模块的使用详解》在Qt应用程序开发中,良好的日志系统至关重要,本文将介绍如何使用spdlog1.5.0创建满足以下要求的日志系统,感兴趣的朋友一起看看吧... 目录版本摘要例子logmanager.cpp文件main.cpp文件版本spdlog版本:1.5.0采用1.5.0版本主要

C++ vector的常见用法超详细讲解

《C++vector的常见用法超详细讲解》:本文主要介绍C++vector的常见用法,包括C++中vector容器的定义、初始化方法、访问元素、常用函数及其时间复杂度,通过代码介绍的非常详细,... 目录1、vector的定义2、vector常用初始化方法1、使编程用花括号直接赋值2、使用圆括号赋值3、ve