mbrlen(3) Library Functions Manual mbrlen(3) NOMBRE mbrlen - determina el numero de bytes en el siguiente caracter multibyte BIBLIOTECA Biblioteca Estandar C (libc, -lc) SINOPSIS #include size_t mbrlen(const char s[restrict .n], size_t n, mbstate_t *restrict ps); DESCRIPCION La funcion mbrlen() inspecciona, como mucho, n bytes de la cadena multibyte que comienza en s y determina el siguiente caracter multibyte completo. La funcion actualiza el estado de cambios *ps. Si el caracter multibyte no es el caracter ancho nulo, devuelve el numero de bytes que se han consumido de s. Si el caracter multibyte es el caracter ancho nulo, restablece el estado de cambios *ps al estado inicial y devuelve 0. Si los n bytes que comienzan en s no contienen un caracter multibyte completo, mbrlen() devuelve (size_t) -2. Esto puede ocurrir incluso si n >= MB_CUR_MAX, si la cadena multibyte contiene sequencias de cambios redundantes. Si la cadena multibyte que comienza en s contiene una secuencia multibyte invalida antes del siguiente caracter completo, mbrlen() devuelve (size_t) -1 y asigna a errno el valor EILSEQ. En este caso, los efectos sobre *ps son indefinidos. If ps is NULL, a static anonymous state known only to the mbrlen() function is used instead. VALOR DEVUELTO La funcion mbrlen() devuelve el numero de bytes examinados de la cadena multibyte que comienza en s, si se ha reconocido un caracter ancho no nulo. Devuelve 0 si se ha reconocido un caracter ancho nulo. Devuelve (size_t) -1 y asigna a errno el valor EILSEQ, si se ha encontrado una secuencia multibyte invalida. Devuelve (size_t) -2 si no ha podido recorrer una caracter multibyte completo, indicando que se deberia incrementar n. ATRIBUTOS Para obtener una explicacion de los terminos usados en esta seccion, vease attributes(7). +---------------------+--------------------+---------------------------+ |Interfaz | Atributo | Valor | +---------------------+--------------------+---------------------------+ |mbrlen() | Seguridad del hilo | MT-Unsafe race:mbrlen/!ps | +---------------------+--------------------+---------------------------+ ESTANDARES C11, POSIX.1-2008. HISTORIAL POSIX.1-2001, C99. NOTAS El comportamiento de mbrlen() depende de la categoria LC_CTYPE de la localizacion actual. VEASE TAMBIEN mbrtowc(3) TRADUCCION La traduccion al espanol de esta pagina del manual fue creada por Juan Piernas Esta traduccion es documentacion libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algun error en la traduccion de esta pagina del manual, envie un correo electronico a . Paginas de manual de Linux 6.06 31 Octubre 2023 mbrlen(3)