_strncnt、_wcsncnt、_mbsnbcnt、_mbsnbcnt_l、_mbsnccnt、_mbsnccnt_l
返回字符或字节数。在提供的计数中。
重要
_mbsnbcnt、_mbsnbcnt_l、_mbsnccnt和 _mbsnccnt_l 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。
size_t _strncnt(
const char *str,
size_t count
);
size_t _wcsncnt(
const wchar_t *str,
size_t count
);
size_t _mbsnbcnt(
const unsigned char *str,
size_t count
);
size_t _mbsnbcnt_l(
const unsigned char *str,
size_t count,
_locale_t locale
);
size_t _mbsnccnt(
const unsigned char *str,
size_t count
);
size_t _mbsnccnt_l(
const unsigned char *str,
size_t count,
_locale_t locale
);
参数
str
将检查的字符串。count
在 str或字节的将检查的字符数。locale
使用的区域设置。
返回值
_mbsnbcnt 和 _mbsnbcnt_l 返回在 str多字节字符第一 count 找到字节数。 _mbsnccnt 和 _mbsnccnt_l 返回在字节第一 count 找到的字符数 str。 如果 null 字符遇到，在 str 的是完成之前，会返回字节数或字符。在 null 字符之前发现。 如果 str 小于 count 字符或字节包括，它们返回字符或字节数。在该字符串。 如果 count 小于零，则返回 0。 在早期版本中，这些函数具有类型 int 的返回值而不是 size_t。
_strncnt 在单字节字符字符串 str的第一个 count 字节返回字符数。 _wcsncnt 返回的字符数。宽字符字符串 str的第一 count 宽字符的。
备注
_mbsnbcnt 和 _mbsnbcnt_l 计数。str多字节字符第一 count 找到字节数。 _mbsnbcnt 和 _mbsnbcnt_l 替换 mtob，因此应在 mtob位置。
_mbsnccnt 和 _mbsnccnt_l 计数在字节第一 count 找到的字符数 str。 如果 _mbsnccnt 和 _mbsnccnt_l 在双字节字符的第二个字节会遇到 null，第一个字节也视为空且不包含在返回的绑定值。 _mbsnccnt 和 _mbsnccnt_l 替换 btom，因此应在 btom位置。
如果 str 是 null 指针或是 count 为 0，这些函数调用的参数无效处理程序如 参数验证所述，errno 设置为 EINVAL，这样，函数返回 0。
输出值受设置 LC_CTYPE 类设置的影响区域设置；请参见 setlocale 有关更多信息。 这些功能的版本不 _l 后缀为该区域设置相关的行为使用当前区域设置；与 _l 后缀的版本相同，只不过它们使用传入的区域设置参数。 有关更多信息，请参见区域设置。
一般文本例程映射
实例 |
未定义的_UNICODE 和_MBCS |
定义的_MBCS |
定义的_UNICODE |
|---|---|---|---|
_tcsnbcnt |
_strncnt |
_mbsnbcnt |
_wcsncnt |
_tcsnccnt |
_strncnt |
_mbsnbcnt |
n/a |
_wcsncnt |
n/a |
n/a |
_mbsnbcnt |
_wcsncnt |
n/a |
n/a |
_mbsnccnt |
n/a |
n/a |
_mbsnbcnt_l |
_mbsnccnt_l |
要求
实例 |
必需的标头 |
|---|---|
_mbsnbcnt |
<mbstring.h> |
_mbsnbcnt_l |
<mbstring.h> |
_mbsnccnt |
<mbstring.h> |
_mbsnccnt_l |
<mbstring.h> |
_strncnt |
<tchar.h> |
_wcsncnt |
<tchar.h> |
有关更多兼容性信息，请参见中介绍的 兼容性。
示例
// crt_mbsnbcnt.c
#include <mbstring.h>
#include <stdio.h>
int main( void )
{
unsigned char str[] = "This is a multibyte-character string.";
unsigned int char_count, byte_count;
char_count = _mbsnccnt( str, 10 );
byte_count = _mbsnbcnt( str, 10 );
if ( byte_count - char_count )
printf( "The first 10 characters contain %d multibyte characters\n", char_count );
else
printf( "The first 10 characters are single-byte.\n");
}
Output
The first 10 characters are single-byte.
.NET Framework 等效项
不适用。若要调用标准 C 函数，请使用 PInvoke。有关更多信息，请参见 平台调用示例。