_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
Devuelve el número de caracteres o bytes de un recuento especificado.
Importante
_mbsnbcnt, _mbsnbcnt_l, _mbsnccnt y _mbsnccnt_l no se pueden usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución.Para obtener más información, vea Funciones de CRT no admitidas con /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
);
Parámetros
str
Cadena que se va a examinar.count
Número de caracteres o bytes que se van a examinar en str.locale
Configuración regional que se va a usar.
Valor devuelto
_mbsnbcnt y _mbsnbcnt_l devuelven el número de bytes que se encuentran en el primer count de caracteres multibyte de str. _mbsnccnt y _mbsnccnt_l devuelven el número de caracteres que se encuentran en el primer count de bytes de str. Si se encuentra un carácter nulo antes de que el examen de str haya terminado, devuelven el número de bytes o caracteres encontrados antes del carácter nulo. Si str consta de menos caracteres o bytes que count, devuelven el número de caracteres o bytes de la cadena. Si count es menor que cero, devuelven 0. En versiones anteriores, estas funciones tenían un valor devuelto de tipo int en lugar de size_t.
_strncnt devuelve el número de caracteres de los primeros bytes de count de la cadena str de un solo byte. _wcsncnt devuelve el número de caracteres de los primeros caracteres anchos de count de cadena de caracteres anchos str.
Comentarios
_mbsnbcnt y _mbsnbcnt_l cuentan el número de bytes que se encuentran en el primer count de caracteres multibyte de str. _mbsnbcnt y _mbsnbcnt_l reemplazan mtob y deben usarse en lugar de mtob.
_mbsnccnt y _mbsnccnt_l cuentan el número de caracteres que se encuentran en el primer count de bytes de str. Si _mbsnccnt y _mbsnccnt_l encuentran un valor NULL en el segundo byte de un carácter de doble byte, el primer byte también se considera NULL y no se incluye en el valor de recuento devuelto. _mbsnccnt y _mbsnccnt_l reemplazan btom y deben usarse en lugar de btom.
Si str es un puntero nulo o count es 0, estas funciones invocan el controlador de parámetros no válidos, como se describe en Validación de parámetros, errno se establece en EINVAL y la función devuelve 0.
El valor de salida se ve afectado por el valor de la categoría LC_CTYPE de la configuración regional; vea setlocale para obtener más información. Las versiones de estas funciones sin el sufijo _l usan la configuración regional actual de su comportamiento dependiente de la configuración regional; las versiones con el sufijo _l son idénticas salvo que usan el parámetro locale pasado en su lugar. Para obtener más información, vea Configuración regional.
Asignaciones de rutina de texto genérico
Rutina |
_UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_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 |
Requisitos
Rutina |
Encabezado necesario |
|---|---|
_mbsnbcnt |
<mbstring.h> |
_mbsnbcnt_l |
<mbstring.h> |
_mbsnccnt |
<mbstring.h> |
_mbsnccnt_l |
<mbstring.h> |
_strncnt |
<tchar.h> |
_wcsncnt |
<tchar.h> |
Para obtener más información sobre compatibilidad, vea Compatibilidad.
Ejemplo
// 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");
}
Resultados
The first 10 characters are single-byte.
Equivalente en .NET Framework
No es aplicable Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.