_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。有关更多信息，请参见 平台调用示例。

请参见

参考

字符串操作(crt)

区域设置

多字节字符序列的说明

_mbsnbcat， _mbsnbcat_l