Fungsi StrToIntExW (shlwapi.h)

Artikel
03/15/2023

Mengonversi string yang mewakili angka desimal atau heksadesimal menjadi bilangan bulat.

Sintaks

BOOL StrToIntExW(
  [in]  PCWSTR     pszString,
        STIF_FLAGS dwFlags,
  [out] int        *piRet
);

Parameter

[in] pszString

Jenis: PCTSTR

Penunjuk ke string yang dihentikan null untuk dikonversi. Untuk detail lebih lanjut mengenai bentuk string yang valid, lihat bagian Keterangan.

dwFlags

Jenis: STIF_FLAGS

Salah satu nilai berikut yang menentukan bagaimana pszString harus diurai untuk konversinya ke bilangan bulat.

STIF_DEFAULT

String di pszString berisi representasi nilai desimal.

STIF_SUPPORT_HEX

String di pszString berisi representasi nilai desimal atau heksadesimal. Perhatikan bahwa dalam representasi heksadesimal, karakter A-F tidak peka huruf besar/kecil.

[out] piRet

Jenis: int*

Penunjuk ke int yang menerima string yang dikonversi. Misalnya, dalam kasus string "123", bilangan bulat yang diarahkan oleh nilai ini menerima nilai bilangan bulat 123.

Jika fungsi ini mengembalikan FALSE, nilai ini tidak terdefinisi.

Jika nilai yang dikembalikan terlalu besar untuk dimuat dalam variabel jenis int, parameter ini berisi 32 bit berurutan rendah dari nilai. Setiap bit berurutan tinggi di luar yang hilang.

Nilai kembali

Jenis: BOOL

Mengembalikan TRUE jika string dikonversi; jika tidak FALSE.

Keterangan

String yang ditujukkan oleh parameter pszString harus memiliki salah satu formulir berikut agar berhasil diurai.

Formulir ini diterima sebagai nilai desimal di bawah salah satu bendera. Sintaks ''' (spasi putih opsional)(tanda opsional)(satu atau beberapa digit desimal) '''
Formulir ini diperlukan untuk nilai heksadesimal ketika bendera STIF_SUPPORT_HEX diteruskan. Sintaks ''' (spasi putih opsional)(tanda opsional)0x(satu atau beberapa digit heksadesimal) '''
```
(optional white space)(optional sign)0X(one or more hexadecimal digits)
```

Tanda opsional dapat berupa karakter '-' atau '+'; jika dihilangkan, tanda diasumsikan positif.

Catatan Jika nilai diurai sebagai heksadesimal, tanda opsional diabaikan, meskipun itu adalah karakter '-'. Misalnya, string "-0x1" diurai sebagai 1, bukan -1.

Jika string yang ditujukkan oleh pszString berisi karakter yang tidak valid, karakter tersebut dianggap sebagai akhir string yang akan dikonversi dan sisanya diabaikan. Misalnya, mengingat string heksadesimal "0x00am123" yang tidak valid, StrToIntEx hanya mengenali "0x00a", mengonversinya ke nilai bilangan bulat 10, dan mengembalikan TRUE.

Catatan

Header shlwapi.h mendefinisikan StrToIntEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 4.71 atau yang lebih baru)

Bagikan melalui