Fungsi StrToIntExA (shlwapi.h)

Artikel
11/20/2024

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

Sintaksis

BOOL StrToIntExA(
  [in]  PCSTR      pszString,
        STIF_FLAGS dwFlags,
  [out] int        *piRet
);

Parameter

[in] pszString

Jenis: PCTSTR

Penunjuk ke string yang dihentikan null untuk dikonversi. Untuk detail lebih lanjut tentang 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.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika string dikonversi; jika tidak, FALSE.

Komentar

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

Formulir ini diterima sebagai nilai desimal di bawah salah satu bendera. Sintaks ''' (spasi kosong 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, bahkan jika 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 yang tidak valid "0x00am123", StrToIntEx hanya mengenali "0x00a", mengonversinya ke nilai bilangan bulat 10, dan mengembalikan TRUE.

Nota

Header shlwapi.h mendefinisikan StrToIntEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

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

Bagikan melalui