MBLEN(3)

NOME
mblen - determina o número de bytes no próximo caracter multibyte

SINÓPSE
#include <stdlib.h>

int mblen (const char *s, size_t n);

DESCRIÇÃO
Se s não for um ponteiro NULO, a função mblen procura até os n bytes, no máximo, da string multibyte que começa em s, e extrai o próximo caracter multibyte completo. Ela usa um estado transitório anônimo e estático apenas conhecido pela função mblen. Se o caracter multibyte não for o caracter largo NULO, ela retorna o número de bytes consumidos de s. Se o caracter multibyte for o caracter largo NULO, ela retorna 0.

Se os n bytes a partir de s não contiverem um caracter multibyte completo, mblen retorna -1. Isso pode acontecer se n >= MB_CUR_MAX, se a string multibyte contém seqüências transitórias redundantes.

Se a string multibyte começando em s contiver uma seqüência multibyte inválida antes do próximo caracter completo, mblen também retorna -1.

Se s for um ponteiro NULO, a função mblen reinicializa o estado transitório apenas conhecido por esta função ao estado inicial, e retorna valores diferentes de zero se a codificação tiver um estado transitório diferente do comum, ou zero se a codificação for independente de estado (stateless).

VALORES RETORNADOS
A função mblen retorna o número de bytes analisados (parsed) da seqüência multibyte começando em s, se um caracter largo diferente de NULO for reconhecido. Ela retorna 0 se um caracter NULO for reconhecido. Retorna -1 se uma seqüência multibyte inválida for encontrada, ou se ela não puder analisar (parse) um caracter multibyte completo.

DE ACORDO COM
ISO/ANSI C, UNIX98.

VEJA TAMBÉM
mbrlen(3).

NOTAS
O comportamento de mblen depende da categoria LC_CTYPE da localização atual.

A função mbrlen fornece uma interface melhor para a mesma funcionalidade.

TRADUZIDO POR LDP-BR em 18/07/2001.

  Tradução:
E. A. Tacão <tacao@conectiva.com.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>