C++ mbstowcs()

在 C++ 中，mbstowcs() 函数的作用是将一个多字节字符的字符串转换为对应的宽字符字符串。它可以用来进行不同字符集之间的转换。参数包括要转换的字符串、宽字符数组和要转换的最大字符数等。

语法

#include <cstdlib>
size_t mbstowcs(wchar_t* dest, const char* src, size_t max);

其中，dest 代表转换后的宽字符数组的存放位置，src 代表要进行转换的多字节字符串，max 表示要转换的最大字符数。

返回值

该函数返回已转换的字符数，若遇到无法转换的字符则返回 -1。

例子

#include <iostream>
#include <cstring>

int main() {
    const char* source = "Hello, world!";
    size_t max = strlen(source) + 1;
    wchar_t* destination = new wchar_t[max];
    auto count = mbstowcs(destination, source, max);
    if (count != (size_t) -1) {
        std::wcout << L"The converted string is: " << destination << L"\n";
        std::wcout << L"Number of converted characters: " << count << L"\n";
    } else {
        std::cerr << "Error occurred during conversion.\n";
    }
    delete[] destination;
    return 0;
}

上述代码中，首先声明了一个多字节字符串 source，也声明了一个对应的宽字符数组 destination。然后通过调用 strlen() 取得 source 的长度，加 1 后得到需要保留的空间总量 max。接着调用 mbstowcs() 转换 source，将结果存放到 destination 中。最后通过判断转换结果是否正确，输出转换后的字符和转换字符的数量。注意，最后需要释放动态空间以避免内存泄漏。

输出结果如下：

The converted string is: Hello, world!
Number of converted characters: 14

总结

mbstowcs() 函数是一个用于多字节字符串和宽字符字符串转换的常用函数。在使用该函数时需要注意该函数的语法和返回值，以及避免出现内存泄漏等问题。