_strninc, _wcsninc, _mbsninc, _mbsninc_l

Memajukan penunjuk string menurut n karakter.

Penting

_mbsninc dan _mbsninc_l tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

char *_strninc(
   const char *str,
   size_t count
);
wchar_t *_wcsninc(
   const wchar_t *str,
   size_t count
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);

Parameter

str
String sumber.

count
Jumlah karakter untuk menaikkan penunjuk string.

locale
Lokal untuk digunakan.

Nilai hasil

Masing-masing rutinitas ini mengembalikan penunjuk ke str setelah str dinaikkan oleh count karakter atau NULL jika pointer yang disediakan adalah NULL. Jika count lebih besar dari atau sama dengan jumlah karakter dalam str, hasilnya tidak ditentukan.

Keterangan

Fungsi _mbsninc bertambah str berdasarkan count karakter multibyte. _mbsninc mengenali urutan karakter multibyte sesuai dengan halaman kode multibyte yang saat ini digunakan.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

Rutinitas Tchar.h	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc dan _wcsninc merupakan string karakter byte tunggal dan versi string karakter lebar dari _mbsninc. _wcsninc dan _strninc disediakan hanya untuk pemetaan ini dan tidak boleh digunakan sebaliknya. Untuk informasi selengkapnya, lihat Menggunakan pemetaan teks generik dan Pemetaan teks generik.

_mbsninc_l identik kecuali menggunakan parameter lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.

Persyaratan

Rutin	Header yang diperlukan
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<tchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Baca juga

Manipulasi string
Lokal
Interpretasi urutan karakter multibyte
_strdec, _wcsdec, _mbsdec, _mbsdec_l
_strinc, _wcsinc, _mbsinc, _mbsinc_l
_strnextc, _wcsnextc, _mbsnextc, _mbsnextc_l