Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

O cabeçalho <wchar.h> — caracteres largos e WEOF

O cabeçalho <wchar.h> disponibiliza operações com caracteres e cadeias largas, bem como conversões multibyte. WEOF assinala, entre outras condições, o fim da entrada.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <wchar.h>

<wchar.h> declara funções de entrada/saída, de gestão de cadeias largas e de conversão multibyte. Disponibiliza wchar_t, wint_t e o tipo de estado de conversão mbstate_t.

WEOF é uma expressão constante do tipo wint_t que não representa um carácter. Não tem necessariamente de ser negativo nem igual a EOF. Guarde o resultado de fgetwc num wint_t, e não num wchar_t, antes de o comparar com WEOF. Como WEOF pode indicar o fim do ficheiro ou um erro, verifique feof e ferror.

O exemplo lê um ficheiro temporário vazio. A saída apresentada pressupõe que as operações com o ficheiro são bem-sucedidas. O código apresentado foi executado sem alterações num ambiente isolado e a sua saída padrão coincidiu exatamente com a saída indicada.

Exemplos

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    FILE *stream = tmpfile();
    if (stream == NULL) {
        return 1;
    }

    wint_t ch = fgetwc(stream);
    int ended = ch == WEOF && feof(stream) && !ferror(stream);

    if (fclose(stream) != 0) {
        return 1;
    }
    if (!ended) {
        return 1;
    }

    puts("end of file");
    return 0;
}

Resultado

end of file

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes