C ++ wcstol () - C ++ szabványos könyvtár

A wcstol () függvény a C ++ - ban egy széles karakterlánc tartalmát a megadott bázis integrális számaként értelmezi, és értékét hosszú int-ként adja vissza.

A wcstol () függvény egy mutatót is beállít, amely a széles karakterlánc utolsó érvényes karaktere után az első karakterre mutat, ha van ilyen, különben a mutató nullára van állítva.

A fejlécfájlban van meghatározva.

 A 10. alaphoz és az L "12abc" széles húrhoz Érvényes numerikus rész -> 12 Első karakter az érvényes numerikus rész után -> a

wcstol () prototípus

 hosszú wcstol (const wchar_t * str, wchar_t ** str_end, int alap);

A wcstol () függvény paraméterként egy széles karakterláncot, egy mutatót a széles karakterhez és egy egész érték alapot vesz fel, a széles karakterlánc tartalmát az adott bázis integrális számaként értelmezi, és hosszú int értéket ad vissza.

wcstol () Paraméterek

  • str: Széles karakterlánc, amely integrális számot képvisel.
  • str_end: Mutató egy széles karakterre mutató mutatóra. Az str_end értékét a függvény a következő karakterre állítja az str-ben az utolsó érvényes karakter után. Ez a paraméter lehet egy null mutató is, ebben az esetben nem használják.
  • alap: Az integrálérték alapja. Az alap érvényes értékeinek halmaza (0, 2, 3,…, 35, 36).

wcstol () Visszatérési érték

A wcstol () függvény visszatér:

  • hosszú int érték (amelyet a karakterláncból konvertálunk).
  • 0, ha nem lehet érvényes konverziót végrehajtani.

1. példa: Hogyan működik a wcstol () függvény?

 #include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t str1() = L"101aau16b6"; wchar_t str2() = L"59"; wchar_t *end; long value; int base = 10; value = wcstol(str1, &end, base); wcout << L"String value = " << str1 << endl; wcout << L"Long Int value = " << value << endl; wcout << L"End String = " << end << endl; value = wcstol(str2, &end, base); wcout << L"String value = " << str2 << endl; wcout << L"Long Int value = " << value << endl; wcout << L"End String = " << end << endl; return 0; )

A program futtatásakor a kimenet a következő lesz:

 Karakterlánc értéke = 101aa ᚶ Hosszú Int érték = 101 Vég Karakterlánc = aa ᚶ Karakterlánc értéke = 59 Hosszú Int értéke = 59 Vége karakterlánc =

A wcstol () függvény érvényes egész értéke a következőkből áll:

  • Opcionális + vagy - jel.
  • 0 előtag az oktális bázishoz (csak akkor érvényes, ha a bázis = 8 vagy 0).
  • 0x vagy 0X előtag hexadecimális bázisra (csak akkor alkalmazható, ha a bázis = 16 vagy 0).
  • Számjegyek és / vagy ábécék sorozata (ha az alap nagyobb, mint 10).

A paraméteralap érvényes értékei: (0, 2, 3,…, 35, 36). A 2. bázis érvényes számjegyeinek halmaza (0, 1), a 3. bázis esetében (0, 1, 2) és így tovább. A 11 és 36 közötti bázisok esetében az érvényes számjegyek ábécét tartalmaznak. A 11 bázis érvényes számjegyeinek halmaza (0, 1,…, 9, A, a), a 12 bázis esetében (0, 1,…, 9, A, a, B, b) és így tovább.

2. példa: wcstol () függvény különböző bázisokkal

 #include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t *end; wchar_t str() = L"311bzu03feu03ff"; wcout << str << L" to Long Int with base-5 = " << wcstol(str, &end, 5) << endl; wcout << L"End String = " << end << endl << endl; wcout << str << L" to Long Int with base-5 = " << wcstol(str, &end, 12) << endl; wcout << L"End String = " << end << endl << endl; wcout << str << L" to Long Int with base-5 = " << wcstol(str, &end, 36) << endl; wcout << L"End String = " << end << endl << endl; return 0; )

A program futtatásakor a kimenet a következő lesz:

 311bzϾϿ-tól hosszú int-ig alap-5 = 81 végződés = bzϾϿ 311bz Long-tól hosszú int-ig alap-5-ig = 5351 vég-karakterlánc = zϾϿ 311bzϾϿ-ig hosszú int-ig alap-5 = 5087231 vég-karakterlánc = ϾϿ

A wcstol () függvény mindaddig figyelmen kívül hagyja az összes vezető szóköz karaktert, amíg meg nem találja az elsődleges nem szóköz karaktert.

Általában a wcstol () függvény érvényes egész argumentuma a következő formában van:

 (szóköz) (- | +) (0 | 0x) (alfanumerikus karakterek)

Ezután, ebből a karakterből kiindulva, a lehető legtöbb karakterre van szükség, amely érvényes egész ábrázolást alkot, és hosszú int értékké alakítja őket. Bármi, ami az utolsó érvényes karakter után marad a karakterláncból, figyelmen kívül marad, és nincs hatása az eredményre.

3. példa: wcstol () függvény a szóköz és az érvénytelen konverzió vezetéséhez

 #include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t *end; wcout << L" 205u03e2x to Long Int with base-5 = " << wcstol(L" 205u03e2x", &end, 5) << endl; wcout << L"End String = " << end << endl << endl; wcout << L"xu019cz201 to Long Int with base-12 = " << wcstol(L"xu019cz201", &end, 12) << endl; wcout << L"End String = " << end << endl << endl; return 0; )

A program futtatásakor a kimenet a következő lesz:

 205Ϣx - hosszú int alap-5 = 10 végső karakterlánc = 5Ϣx xƜz201 - hosszú int 12-es alap = 0 végső karakterlánc = xƜz201

Ha az alap 0, akkor a numerikus alapot automatikusan meghatározza a karakterlánc formátumának megnézésével. Ha az előtag 0, akkor az alapja oktális (8). Ha az előtag 0x vagy 0X, akkor az alap hexadecimális (16), különben az alap decimális (10).

4. példa: wcstol () függvény 0 bázissal

 #include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t *end; wcout << L"0539u1e84 to Long Int with base-0 = " << wcstol(L"0539u1e84", &end, 0) << endl; wcout << L"End String = " << end << endl << endl; wcout << L"0xa31u05e2 to Long Int with base-0 = " << wcstol(L"0xa31u05e2", &end, 0) << endl; wcout << L"End String = " << end << endl << endl; wcout << L"119xu060f to Long Int with base-0 = " << wcstol(L"119xu060f", &end, 0) << endl; wcout << L"End String = " << end << endl << endl; return 0; )

A program futtatásakor a kimenet a következő lesz:

 0539Ẅ-ig Hosszú Int bázis-0 = 43 végső húr = 9Ẅ 0xa31 ע Hosszú Int-hez bázis-0 = 2609 Vég Húr = ע 119x ؏ Hosszú Int-ig bázis-0 = 119 Vég húr = x ؏

érdekes cikkek...