Fungsi VarParseNumFromStr (oleauto.h)

Artikel
03/01/2024

Mengurai string, dan membuat deskripsi tipe independen dari angka yang diwakilinya.

Sintaks

HRESULT VarParseNumFromStr(
  [in]  LPCOLESTR strIn,
  [in]  LCID      lcid,
  [in]  ULONG     dwFlags,
  [out] NUMPARSE  *pnumprs,
  [out] BYTE      *rgbDig
);

Parameter

[in] strIn

String input yang akan dikonversi.

[in] lcid

Pengidentifikasi lokal.

[in] dwFlags

Memungkinkan penelepon mengontrol penguraian, sehingga menentukan sintaks angka yang dapat diterima. Jika bidang ini diatur ke nol, string input tidak boleh berisi apa pun kecuali digit desimal. Mengatur setiap bit bendera yang ditentukan memungkinkan penguraian fitur sintaksis tersebut. Penguraian Otomatisasi Standar (misalnya, seperti yang digunakan oleh VarI2FromStr) memiliki semua bendera yang ditetapkan (NUMPRS_STD).

[out] pnumprs

Hasil yang diurai.

[out] rgbDig

Nilai untuk digit dalam rentang 0–7, 0–9, atau 0–15, tergantung pada apakah angka tersebut oktal, desimal, atau heksadesimal. Semua nol di depan telah dilucuti. Untuk angka desimal, nol berikutnya juga dilucuti, kecuali angkanya nol, dalam hal ini satu digit nol akan ada.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_OUTOFMEMORY	Alokasi memori internal gagal. (Digunakan untuk DBCS hanya untuk membuat salinan dengan semua karakter lebar yang dipetakan sempit.)
DISP_E_TYPEMISMATCH	Tidak ada angka yang valid dalam string, atau tidak ada tanda kurung tutup untuk mencocokkan yang dibuka. Dalam kasus sebelumnya, cDig dan cchUsed dalam struktur NUMPARSE akan menjadi nol. Dalam yang terakhir, struktur NUMPARSE dan array digit sepenuhnya diperbarui, seolah-olah tanda kurung penutup ada.
DISP_E_OVERFLOW	Untuk digit heksadesimal dan oktal, ada lebih banyak digit daripada yang akan masuk ke dalam array. Untuk desimal, eksponen melebihi maksimum yang mungkin. Dalam kedua kasus, struktur NUMPARSE dan array digit sepenuhnya diperbarui (untuk desimal, bidang cchUsed mengecualikan seluruh eksponen).

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	oleauto.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll

Bagikan melalui