C++ explicit关键字

表格展示

特性	用法	适用场景
防止隐式类型转换	在类构造函数前加上explicit关键字，禁止隐式地将单个参数类型转换为当前类类型。	当你希望防止构造函数因单参数调用而导致的非预期类型转换时。
应用于单参数构造函数	explicit ClassName(Type param);	需要明确创建类对象而不是通过隐式转换的场景。例如，避免将int隐式转换为某个表示数字类的对象。
可用于转换操作符	C++11之后，explicit可以用于类的转换操作符。如：explicit operator bool() const;	当定义有歧义的类型转换操作，例如将类对象转换为bool类型时可能引起的二义性，你希望调用者明确进行类型转换。
控制复制列表初始化	C++11引入的复制列表初始化（例如ClassName obj = {arg};）在explicit构造函数前不允许。	当你的类有可能通过复制列表进行初始化，并且希望防止这种隐式转换时。
防止函数参数隐式转换	在函数接受对象作为参数时，该对象的构造函数如果声明为explicit，则禁止隐式转换作为实参。	例如，函数void func(const ClassName& obj);接收ClassName的对象，explicit构造函数避免了隐式转换参数。
结合多参数构造函数使用	从C++11开始，explicit还可以用于多参数构造函数，控制是否允许隐式的复制列表初始化。	例如，避免复制初始化explicit ClassName(Type1 param1, Type2 param2);
与委托构造函数共同使用	explicit可以用于委托构造函数，确保在使用委托构造时，调用路径中不会由于隐式转换而引发意外的构造调用。	当类有一个接受单个参数的委托构造函数时，通过使其explicit避免隐式转换。

class MyClass {
public:
    // 单参数构造函数，使用explicit防止隐式类型转换
    explicit MyClass(int value) : data(value) {}

    // 转换操作符，使用explicit要求显式类型转换
    explicit operator bool() const {
        return data != 0;
    }

private:
    int data;
};

int main() {
    MyClass obj = 42;        // 错误，因为构造函数是explicit的
    MyClass obj2(42);        // 正确，显式调用构造函数
    bool flag = obj;         // 错误，因为转换操作符是explicit的
    bool flag2 = static_cast<bool>(obj); // 正确，显式转换
}

具体地

C++中的explicit关键字只能用于修饰只有一个参数的类构造函数, 它的作用是表明该构造函数是显示的, 而非隐式的。跟它相对应的另一个关键字是implicit, 意思是隐藏的,类构造函数默认情况下即声明为implicit(隐式).

那么显示声明的构造函数和隐式声明的有什么区别呢? 我们来看下面的例子:

class CxString  // 没有使用explicit关键字的类声明, 即默认为隐式声明  
{  
public:  
    char *_pstr;  
    int _size;  
    CxString(int size)  
    {  
        _size = size;                // string的预设大小  
        _pstr = malloc(size + 1);    // 分配string的内存  
        memset(_pstr, 0, size + 1);  
    }  
    CxString(const char *p)  
    {  
        int size = strlen(p);  
        _pstr = malloc(size + 1);    // 分配string的内存  
        strcpy(_pstr, p);            // 复制字符串  
        _size = strlen(_pstr);  
    }   
};  
  
    // 下面是调用:  
  
    CxString string1(24);     // 为CxString预分配24字节的大小的内存  
    CxString string2 = 10;    // 为CxString预分配10字节的大小的内存  
    CxString string3;         // 这样是不行的, 因为没有默认构造函数, 错误为: “CxString”: 没有合适的默认构造函数可用  
    CxString string4("aaaa"); // 
    CxString string5 = "bbb"; // 调用的是CxString(const char *p)  
    CxString string6 = 'c';   // 其实调用的是CxString(int size), 且size等于'c'的ascii码  
    string1 = 2;              // 为CxString预分配2字节的大小的内存  
    string2 = 3;              // 为CxString预分配3字节的大小的内存  
    string3 = string1;        // 至少编译是没问题的, 但是如果析构函数里用free释放_pstr内存指针的时候可能会报错, 完整的代码必须重载运算符"=", 并在其中处理内存释放  

 上面的代码中, "CxString string2 = 10;" 这句为什么是可以的呢?

在C++中, 如果构造函数只有一个参数时, 那么在编译的时候就会有一个缺省的转换操作:将该构造函数对应数据类型的数据转换为该类对象。也就是说 "CxString string2 = 10;" 这段代码, 编译器自动将整型转换为CxString类对象, 实际上等同于下面的操作:

CxString string2(10);  或  
CxString temp(10);  
CxString string2 = temp; 
但是, 上面的代码中的_size代表的是字符串内存分配的大小, 那么调用的第二句 "CxString string2 = 10;" 和第六句 "CxString string6 = 'c';" 就显得不伦不类, 而且容易让人疑惑. 有什么办法阻止这种用法呢? 答案就是使用explicit关键字. 我们把上面的代码修改一下, 如下:

class CxString  // 使用关键字explicit的类声明, 显示转换  
{  
public:  
    char *_pstr;  
    int _size;  
    explicit CxString(int size)  
    {  
        _size = size;  
        // 代码同上, 省略...  
    }  
    CxString(const char *p)  
    {  
        // 代码同上, 省略...  
    }  
};  
  
    // 下面是调用:   
    CxString string1(24);     //  
    CxString string2 = 10;    // 这样是不行的, 因为explicit关键字取消了隐式转换  
    CxString string3;         // 这样是不行的, 因为没有默认构造函数  
    CxString string4("aaaa"); //   
    CxString string5 = "bbb"; // 调用的是CxString(const char *p)  
    CxString string6 = 'c';   // 这样是不行的, 其实调用的是CxString(int size), 且size等于'c'的ascii码, 但explicit关键字取消了隐式转换  
    string1 = 2;              // 这样也是不行的, 因为取消了隐式转换  
    string2 = 3;              // 这样也是不行的, 因为取消了隐式转换  
    string3 = string1;        // 这样也是不行的, 因为取消了隐式转换, 除非类实现操作符"="的重载  
 /// explicit关键字的作用就是防止类构造函数的隐式自动转换.

explicit关键字只对有一个参数的类构造函数有效, 如果类构造函数参数大于或等于两个时, 是不会产生隐式转换的, 所以explicit关键字也就无效了. 例如: 

class CxString  // explicit关键字在类构造函数参数大于或等于两个时无效  
{  
public:  
    char *_pstr;  
    int _age;  
    int _size;  
    explicit CxString(int age, int size)  
    {  
        _age = age;  
        _size = size;  
        // 代码同上, 省略...  
    }  
    CxString(const char *p)  
    {  
        // 代码同上, 省略...  
    }  
};  
  
    // 这个时候有没有explicit关键字都是一样的  

但是, 也有一个例外, 就是当除了第一个参数以外的其他参数都有默认值的时候, explicit关键字依然有效, 此时, 当调用构造函数时只传入一个参数, 等效于只有一个参数的类构造函数, 例子如下:

class CxString  // 使用关键字explicit声明  
{  
public:  
    int _age;  
    int _size;  
    explicit CxString(int age, int size = 0)  
    {  
        _age = age;  
        _size = size;  
        // 代码同上, 省略...  
    }  
    CxString(const char *p)  
    {  
        // 代码同上, 省略...  
    }  
};  
  
    // 下面是调用:  
  
    CxString string1(24);     //  
    CxString string2 = 10;    // 这样是不行的, 因为explicit关键字取消了隐式转换  
    CxString string3;         // 这样是不行的, 因为没有默认构造函数  
    string1 = 2;              // 这样也是不行的, 因为取消了隐式转换  
    string2 = 3;              // 这样也是不行的, 因为取消了隐式转换  
    string3 = string1;        // 这样也是不行的, 因为取消了隐式转换, 除非类实现操作符"="的重载