Bagikan melalui


Fungsi StrToIntExA (shlwapi.h)

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

Sintaks

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 itu hilang.

Menampilkan nilai

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 menjadi 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 diacu 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 menjadi 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

   
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)