C/C++ में mbsrtowcs() फंक्शन

इस लेख में हम C++ STL में std::mbsrtowcs() फंक्शन के कार्य, सिंटैक्स और उदाहरणों पर चर्चा करेंगे।

std::mbsrtowcs() क्या है?

std::mbsrtowcs() फंक्शन C++ STL में एक इनबिल्ट फंक्शन है, जो हेडर फाइल में परिभाषित है। mbsrtowcs() का अर्थ है कि यह उस नल-टर्मिनेटेड मल्टीबाइट कैरेक्टर स्ट्रिंग को परिवर्तित करता है जिसका पहला बाइट *src है, उसके वाइड कैरेक्टर प्रतिनिधित्व में। यह फंक्शन रूपांतरण के अनुसार मान लौटाता है।

सिंटैक्स

size_t mbsrtowcs( wchar_t* pwc, char** str, size_t n, mbstate_t* ps);

पैरामीटर्स

फंक्शन निम्नलिखित पैरामीटर(पैरामीटर्स) स्वीकार करता है -

• pwc - यह उस लोकेशन का पॉइंटर है जहां हम आउटपुट स्टोर करना चाहते हैं।
• str - कैरेक्टर स्ट्रिंग जिसे इनपुट के रूप में उपयोग किया जाता है।
• n - यह उन बाइट्स की संख्या है जिन्हें चेक किया जाना है।
• ps - जब हम मल्टीबाइट स्ट्रिंग की व्याख्या कर रहे होते हैं तो यह स्टेट ऑब्जेक्ट का पॉइंटर होता है।

रिटर्न वैल्यू

यह फंक्शन निम्नलिखित शर्त के अनुसार अलग-अलग मान लौटाता है -

• 0 - फंक्शन शून्य लौटाएगा जब str में परिवर्तित होने वाला कैरेक्टर NULL हो।
• 1...n - नल-एंडिंग कैरेक्टर्स की संख्या जो परिवर्तित होकर स्ट्रिंग *str में स्टोर हुई।
• -1 - जब रूपांतरण के दौरान त्रुटि होती है तो errno को EILSEQ पर सेट किया जाता है।

उदाहरण

#include 
using namespace std;
int main(){
    setlocale(LC_ALL, "en_US.utf8");
    const char* ch = "\u0777\u0755";
    wchar_t arr[20];
    mbstate_t hold = mbstate_t();
    int highest = 10;
    int val = mbsrtowcs ( arr, &ch, highest, &hold );
    wcout << L"Wide characters are: "<< val << endl;
    wcout << L"Given Wide character is: " << arr << endl;
    return 0;
}

आउटपुट

Wide characters are: 2
Given Wide character is: ݷݕ

उदाहरण

#include 
using namespace std;
int main() {
    setlocale(LC_ALL, "en_US.utf8");
    const char* ch = u8"z\u00df\u6c34";
    wchar_t arr[20];
    mbstate_t hold = mbstate_t();
    int highest = 10;
    int val = mbsrtowcs ( arr, &ch, highest, &hold );
    wcout << L"Total Wide characters are: "<< val << endl;
    wcout << L"Given Wide character is: " << arr << endl;
    return 0;
}

आउटपुट

Total Wide characters are: 3
Given Wide character is: zß水