Fungsi StrToInt64ExA (shlwapi.h)

Artikel
03/13/2024

Mengonversi string yang mewakili nilai desimal atau heksadesimal menjadi bilangan bulat 64-bit.

Sintaks

BOOL StrToInt64ExA(
  [in]  PCSTR      pszString,
        STIF_FLAGS dwFlags,
  [out] LONGLONG   *pllRet
);

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 64-bit.

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] pllRet

Jenis: LONGLONG*

Penunjuk ke variabel jenis LONGLONG yang menerima nilai bilangan bulat 64-bit dari string yang dikonversi. Misalnya, dalam kasus string "123", bilangan bulat yang diarahkan oleh nilai ini menerima nilai 123.

Jika fungsi ini mengembalikan FALSE, nilai ini tidak terdefinisi.

Jika nilai yang dikembalikan terlalu besar untuk dimuat dalam variabel jenis LONGLONG, parameter ini berisi 64 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, StrToInt64Ex hanya mengenali "0x00a", mengonversinya ke nilai bilangan bulat 10, dan mengembalikan TRUE.

Jika pllRetNULL, fungsi mengembalikan TRUE jika string dapat dikonversi, meskipun tidak melakukan konversi.

Catatan

Header shlwapi.h mendefinisikan StrToInt64Ex 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 5.0 atau yang lebih baru)

Bagikan melalui