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

本文探讨了如何通过设计安全的接口来减少用户错误的可能性。提出了使用自定义数据类型、枚举类型以及智能指针等手段来确保接口的正确使用。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

  “最好的情况,就是如果客户企图使用某个接口而却没有获得预期的行为,这个代码就不应该通过编译;如果代码通过了编译,它的作为就该是客户想要的。”
  所以在接口设计时,应该从用户的角度出发,考虑用户会犯什么错误:
  

class Date  
{  
public:  
    Date(int m, int d, int y):day(d),month(m),year(y){}  
private:  

    int month;  
    int day;  
    int year;  
};  
  • 那么用户在调用构造函数时,可能会犯两种错误:
    1.把年月日的顺序输乱了。
    2.可能会输入一个不合法的日期,比如2月30号之类的。

对付这些错误,最好的办法就是定义新的数据类型来取代原来的int:

struct Day  
{  
    //将构造函数声明为explict,可以避免发生隐式类型转化  
    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):month(m),day(d),year(y){}  
private:  
    Month month;  
    Day day;  
    Year year;  
};  

  此时,用户只能这样输入:class Date d1(Month(9),Day(8),Year(2012));这至少避免了参数次序的问题。对于这些参数的取值范围,我们可以使用枚举类型。但是由于枚举类型可以被当做int来使用,所以并不是安全的。比较安全的办法是预先定义所有有效的month:
  

class Month  
{  
public:  
    static Month Jan(){return Month(1);}  
    static Month Feb(){return Month(2);}  

private:  
    explicit Month(int m):month(m){}  
    int month;  
};  

  这样的话,你只能这样调用class Date d1(Month::Jan(),Day(8),Year(2012));那么出错的机会就大大降低了。
  还有一种思路可以降低代码出错的可能:就是尽可能让你定义的类型与内置数据类型的行为一致。
  如果要求用户必须做某件事,那么就有可能发生错误,因为用户有可能会忘记。典型的操作就是对内存的new和delete。最好的办法就是前面提到过的:以对象管理资源。当对象被析构时,自动释放内存。最典型的用法就使用时shared_ptr:
  

class ManageResouse  
{  
public:  
    explicit ManageResouse(tr1::shared_ptr<int> p):ptr(p){}  
    void value(int i){*ptr = i;}  
    void printValue(){cout<<*ptr<<endl;}  
private:  
    tr1::shared_ptr<int> ptr;  
};  

    tr1::shared_ptr<int> p ( new int(10));  
    ManageResouse rs1(p);  
    ManageResouse rs2(p);  
    rs1.value(1);  
    rs2.printValue();  

  注意,正确的用法是直接将new出来的对象变为一个智能指针,而类的接口都是使用智能指针的。
  总之,好的接口容易被正确的使用,不宜被误用。促进正确使用的办法包括接口的一致性以及与内置类型兼容。阻止误用的办法包括建立新的类型,限制类型的操作,束缚对象值,消除用户的管理管理责任。

CH341A编程器是一款广泛应用的通用编程设备,尤其在电子工程和嵌入式系统开发领域中,它被用来烧录各种类型的微控制器、存储器和其他IC芯片。这款编程器的最新版本为1.3,它的一个显著特点是增加了对25Q256等32M芯片的支持。 25Q256是一种串行EEPROM(电可擦可编程只读存储器)芯片,通常用于存储程序代码、配置数据或其他非易失性信息。32M在这里指的是存储容量,即该芯片可以存储32兆位(Mbit)的数据,换算成字节数就是4MB。这种大容量的存储器在许多嵌入式系统中都有应用,例如汽车电子、工业控制、消费电子设备等。 CH341A编程器的1.3版更新,意味着它可以与更多的芯片型号兼容,特别是针对32M容量的芯片进行了优化,提高了编程效率和稳定性。26系列芯片通常指的是Microchip公司的25系列SPI(串行外围接口)EEPROM产品线,这些芯片广泛应用于各种需要小体积、低功耗和非易失性存储的应用场景。 全功能版的CH341A编程器仅支持25Q256,还支持其他大容量芯片,这意味着它具有广泛的兼容性,能够满足同项目的需求。这包括但限于微控制器、EPROM、EEPROM、闪存、逻辑门电路等多种类型芯片的编程。 使用CH341A编程器进行编程操作时,首先需要将设备通过USB连接到计算机,然后安装相应的驱动程序和编程软件。在本例中,压缩包中的"CH341A_1.30"很可能是编程软件的安装程序。安装后,用户可以通过软件界面选择需要编程的芯片类型,加载待烧录的固件或数据,然后执行编程操作。编程过程中需要注意的是,确保正确设置芯片的电压、时钟频率等参数,以防止损坏芯片。 CH341A编程器1.3版是面向电子爱好者和专业工程师的一款实用工具,其强大的兼容性和易用性使其在众多编程器中脱颖而出。对于需要处理25Q256等32M芯片的项目,或者26系列芯片的编程工作,CH341A编程器是理想的选择。通过持续的软件更新和升级,它保持了与现代电子技术同步,确保用户能方便地对各种芯片进行编程和调试。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值