Funcția wcstombs () din C ++ convertește un șir larg de caractere într-o secvență echivalentă multibyte.
Funcția wcstombs () este definită în fișierul antet.
wcstombs () prototip
size_t wcstombs (char * dest, const wchar_t * src, size_t max);
Funcția wcstombs () ia trei argumente și returnează o valoare întreagă.
Această funcție convertește șirul larg de caractere al cărui prim element este indicat de src în reprezentarea sa multibyte.
Rezultatul este stocat la locația de memorie indicată de dest. Parametrul max reprezintă numărul maxim de caractere largi care urmează să fie convertite.
Mecanismul de conversie este același cu cel al wctomb, cu excepția faptului că starea de conversie wctomb nu este afectată. Conversia se oprește dacă:
- Este întâlnit un caracter nul, care este apoi convertit și stocat.
- S-a găsit un wchar_t care nu corespunde unui caracter valid în localitatea C curentă.
- numărul maxim de caractere largi a fost convertit.
wcstombs () Parametri
- dest: Pointer către matricea de caractere multibyte rezultată.
- src: Pointer către primul element al caracterului larg care este convertit în caracter multibyte.
- max: numărul maxim de caractere largi care urmează să fie convertite.
wcstombs () Valoare returnată
- Dacă conversia are succes, wcstombs () returnează numărul de caractere multibyte, cu excepția caracterului de terminare (adică ' 0') care este scris în matricea de destinație.
- Dacă apare o eroare în timpul conversiei, aceasta returnează -1.
Exemplu: Cum funcționează funcția wcstombs ()?
#include #include using namespace std; int main() ( wchar_t src() = L"Welcome To Programiz.com"; char dest(50); int num; num = wcstombs(dest, src, 50); cout << "Number of wide character converted = " << num << endl; cout << "Multibyte Character String = " << dest << endl; return 0; )
Când rulați programul, o posibilă ieșire va fi:
Număr de caractere largi convertite = 24 șiruri de caractere multibyte = Bine ați venit la Programiz.com
