Bagikan melalui

Fungsi WindowsSubstringWithSpecifiedLength (winstring.h)

  • Artikel

Mengambil substring dari string yang ditentukan. Substring dimulai pada posisi karakter tertentu dan memiliki panjang yang ditentukan.

Sintaks

HRESULT WindowsSubstringWithSpecifiedLength(
  HSTRING string,
  UINT32  startIndex,
  UINT32  length,
  HSTRING *newString
);

Parameter

string

Jenis: [in] HSTRING

String asli.

startIndex

Jenis: [in] UINT32

Posisi karakter awal substring berbasis nol dalam instans ini.

length

Jenis: [in] UINT32

Jumlah karakter untuk substring.

newString

Jenis: [out] HSTRING*

String yang setara dengan substring yang dimulai pada startIndex dalam string, atau NULL jika startIndex sama dengan panjang string.

Mengembalikan nilai

Jenis: HRESULT

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
 Substring berhasil dibuat.
E_INVALIDARG
 newString adalah NULL, atau panjang startIndexplus lebih besar dari MAXUINT32, yaitu 4.294.967.295; yaitu, 0xFFFFFFFF heksadesimal.
E_BOUNDS
 startIndex lebih besar dari panjang string, atau panjang startIndex plus menunjukkan posisi tidak dalam string.
E_OUTOFMEMORY
 Gagal mengalokasikan substring baru.

Keterangan

Setiap panggilan ke fungsi WindowsSubstringWithSpecifiedLength harus dicocokkan dengan panggilan yang sesuai ke WindowsDeleteString.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header winstring.h

Lihat juga

WindowsDeleteString