_strncnt、_wcsncnt、_mbsnbcnt、_mbsnbcnt_l、_mbsnccnt、_mbsnccnt_l

在指定的计数中返回字符书或字节数。

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 返回在 str多字节字符中第一个 count 找到字节数。 如果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 返回在 str多字节字符中第一个 count 找到字节数。 如果 _mbsnccnt 和 _mbsnccnt_l 在双字节字符的第二个字节会遇到 null，第一个字节也视为空且不包含在返回的计数值。 _mbsnccnt 和 _mbsnccnt_l 替换 btom，因此应在 btom位置。

如果 str 是空指针或是 count 为 0，这些函数调用无效参数处理程序，如 参数验证所述，errno 设置为 EINVAL，函数返回 0。

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale。 这些不带 _l 后缀的函数的版本使用为该区域设置相关的行为的当前区域设置；带有 _l 后缀的版本相同，只不过它们使用传递的区域设置参数。 有关详细信息，请参阅区域设置。

一般文本例程映射

要求

有关兼容性的更多信息，请参见兼容性。

示例

// 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