_strninc, _wcsninc, _mbsninc, _mbsninc_l

比字符串指针前移 n 个字符。

重要

_mbsninc 和 _mbsninc_l 无法用于在 Windows 运行时中执行的应用程序。 有关详细信息，请参阅通用 Windows 平台应用中不支持的 CRT 函数。

语法

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
);

参数

str
资源字符串。

count
要增加字符串指针的字符数。

locale
要使用的区域设置。

返回值

在 str 增加 count 个字符之后，每个例程均返回一个指向 str 的指针；如果提供的指针是 NULL，则返回 NULL。 如果 count 大于或等于 str 中的字符数，则结果是不确定的。

备注

_mbsninc 函数使 str 增加 count 个多字节字符。 _mbsninc 根据当前使用的多字节代码页识别多字节字符序列。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

Tchar.h 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_tcsninc	_strninc	_mbsninc	_wcsninc

_strninc 和 _wcsninc 是 _mbsninc 的单字节字符字符串和宽字符字符串版本。 仅为此映射提供 _wcsninc 和 _strninc，否则不应该使用它们。 有关详细信息，请参阅使用一般文本映射和一般文本映射。

_mbsninc_l 是相同的，只不过它改用传递的区域设置参数。 有关详细信息，请参阅 Locale。

要求

例程	必需的标头
_mbsninc	<mbstring.h>
_mbsninc_l	<mbstring.h>
_strninc	<tchar.h>
_wcsninc	<tchar.h>

有关兼容性的详细信息，请参阅 兼容性。

另请参阅

字符串操作
区域设置
多字节字符序列的解释
_strdec、_wcsdec、_mbsdec、_mbsdec_l
_strinc、_wcsinc、_mbsinc、_mbsinc_l
_strnextc、_wcsnextc、_mbsnextc、_mbsnextc_l