sub-rotina mbsinit

Propósito

Determinar status do objeto de conversão.

Biblioteca

Biblioteca Padrão (libc.a)

Sintaxe

#include <wchar.h>

int mbsinit (const mbstate_t * ps) ;

Descrição

Se ps não for um ponteiro nulo, a função mbsinit determina se o objeto apontado por ps descreve um estado de conversão inicial.

O objeto mbstate_t é usado para descrever o estado de conversão atual a partir de uma sequência de caracteres em particular para uma sequência de caracteres de grande caráter (ou vice-versa) sob as regras de uma configuração particular da categoria LC_CTYPE do locale atual.

O estado de conversão inicial corresponde, para uma conversão em qualquer direção, para o início de uma nova sequência de caracteres no estado de turno inicial. Um objeto zero avaliado mbstate_t é pelo menos uma maneira de descrever um estado de conversão inicial. Um objeto zero avaliado mbstate_t pode ser usado para iniciar a conversão envolvendo qualquer sequência de caracteres, em qualquer configuração de categoria LC_CTYPE.

Valores De Retorno

A função mbsinit retorna diferente de zero se ps for um ponteiro nulo, ou se o objeto apontado-para descrever um estado de conversão inicial; caso contrário, ele retorna zero.

Se um objeto mbstate_t é alterado por qualquer uma das funções descritas comorestartable, e é então usado com uma sequência de caracteres diferente, ou na outra direção de conversão, ou com uma configuração de categoria LC_CTYPE diferente, do que em chamadas de função anteriores, o comportamento é indefinido.