C++ Library - <cuchar>

The <cuchar> header in C++ provides a functionality for conversion between the narrow and wide character encodings, particularly for work with UTF-8, UTF-16 and UTF-32 formats. It bridges the gap between the C-style character handling and modern C++ wide character. It ensures that the character data can be efficiently converted between different types.

This header includes the C-standard library <uchar.h> functions, offering a C++ compatible interface. The commonly used C++ <cuchar> copying functions are listed below along with their description.

Including <cuchar> Header

To include the <cuchar> header in your C++ program, you can use the following syntax.

#include <cuchar>

Functions of <cuchar> Header

Below is list of all functions from <cuchar> header.

Converting Multibyte to Wide string

In the following example, we are going to convert the multibyte string to a wide string.

#include <iostream>
#include <cuchar>
int main() {
   const char * x = "TutorialsPoint";
   wchar_t y[50];
   size_t a = mbstowcs(y, x, sizeof(y) / sizeof(wchar_t));
   if (a != (size_t) - 1) {
      std::wcout <<  "Result : " << y << std::endl;
   } else {
      std::cerr << "Conversion failed!" << std::endl;
   }
   return 0;
}

Output

Output of the above code is as follows −

Result : TutorialsPoint

Calculating Length

Consider the following example, where we are going to get the length of the wide-character string.

#include <iostream>
#include <cuchar>
int main() {
   const wchar_t * x = L "Welcome";
   size_t y = wcslen(x);
   std::wcout << L "Result : " << y << std::endl;
   return 0;
}

Output

Following is the output of the above code −

Result : 7