Função de biblioteca C - mblen ()

Descrição

A função da biblioteca C int mblen(const char *str, size_t n) retorna o comprimento de um caractere multibyte apontado pelo argumento str.

Declaração

A seguir está a declaração para a função mblen ().

int mblen(const char *str, size_t n)

Parâmetros

str - Este é o ponteiro para o primeiro byte de um caractere multibyte.
n - Este é o número máximo de bytes a serem verificados para comprimento de caracteres.

Valor de retorno

A função mblen () retorna o número de bytes passados da sequência multibyte começando em str, se um caractere largo não nulo foi reconhecido. Ele retorna 0, se um caractere largo nulo foi reconhecido. Ele retorna -1, se uma sequência de bytes múltiplos inválida foi encontrada ou se não foi possível analisar um caractere de bytes múltiplos completo.

Exemplo

O exemplo a seguir mostra o uso da função mblen ().

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main () {
   int len;
   char *pmbnull  = NULL;
   char *pmb = (char *)malloc( MB_CUR_MAX );
   wchar_t *pwc = L"Hi";
   wchar_t *pwcs = (wchar_t *)malloc( sizeof( wchar_t ));

   printf("Converting to multibyte string\n");
   len = wcstombs( pmb, pwc, MB_CUR_MAX);
   printf("Characters converted %d\n", len);
   printf("Hex value of first multibyte character: %#.4x\n", pmb);
   
   len = mblen( pmb, MB_CUR_MAX );
   printf( "Length in bytes of multibyte character %x: %u\n", pmb, len );
   
   pmb = NULL;
   
   len = mblen( pmb, MB_CUR_MAX );
   printf( "Length in bytes of multibyte character %x: %u\n", pmb, len );
   
   return(0);
}

Vamos compilar e executar o programa acima que produzirá o seguinte resultado -

Converting to multibyte string
Characters converted 1
Hex value of first multibyte character: 0x168c6010
Length in bytes of multibyte character 168c6010: 1
Length in bytes of multibyte character 0: 0

↰ Previous page