比字符串指针前移 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> |
有关兼容性的详细信息,请参阅 兼容性。