fwide

Определено в заголовочном файле `<wchar.h>`
int fwide( FILE* stream, int mode );		(начиная с C95)

Если mode > 0, функция пытается сделать поток stream ориентированным на широкие символы. Если mode < 0, функция пытается сделать поток stream байтово-ориентированным. Если mode == 0, функция только проверяет текущую ориентацию потока.

Если ориентация потока уже определена (в результате выполнения операции вывода или предыдущего вызова fwide), эта функция ничего не делает.

Параметры

stream	-	указатель на поток ввода-вывода C, ориентацию которого нужно изменить или проверить
mode	-	целое значение больше нуля, чтобы сделать поток ориентированным на широкие символы, меньше нуля — чтобы сделать его узким, или ноль — только для проверки

Возвращаемое значение

Целое число больше нуля, если после вызова поток ориентирован на широкие символы; меньше нуля, если после вызова поток байтово-ориентированный; и ноль, если у потока нет ориентации.

Пример

Следующий код задаёт и сбрасывает ориентацию потока.

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

void show_orientation(int n)
{
    n < 0 ? puts("\tnarrow orientation"):
    n > 0 ? puts("\twide orientation"):
            puts("\tno orientation");
}

void try_read(FILE* fp)
{
    int c = fgetc(fp);
    c == EOF
        ? printf("\tnarrow character read failed\n")
        : printf("\tnarrow character read '%c'\n", c);
 
    wint_t wc = fgetwc(fp);
    wc == WEOF
        ? printf("\twide character read failed\n")
        : printf("\twide character read '%lc'\n", wc);
}

int main(void)
{
    enum fwide_orientation { narrow = -1, query, wide };

    FILE* fp = fopen("main.cpp", "r");
    if (!fp)
    {
        perror("fopen() failed");
        return EXIT_FAILURE;
    }

    puts("1) A newly opened stream has no orientation.");
    show_orientation(fwide(fp, query));

    puts("2) Establish byte orientation.");
    show_orientation(fwide(fp, narrow));
    try_read(fp);

    puts("3) Only freopen() can reset stream orientation.");
    if (freopen("main.cpp", "r", fp) == NULL)
    {
       perror("freopen() failed");
       return EXIT_FAILURE;
    }

    puts("4) A reopened stream has no orientation.");
    show_orientation(fwide(fp, query));

    puts("5) Establish wide orientation.");
    show_orientation(fwide(fp, wide));
    try_read(fp);

    fclose(fp);
}

Возможный вывод:

1) A newly opened stream has no orientation.
        no orientation
2) Establish byte orientation.
        narrow orientation
        narrow character read '#'
        wide character read failed
3) Only freopen() can reset stream orientation.
4) A reopened stream has no orientation.
        no orientation
5) Establish wide orientation.
        wide orientation
        narrow character read failed
        wide character read '#'

Ссылки

Стандарт C23 (ISO/IEC 9899:2024):

7.29.3.5 Функция fwide (стр.: TBD)

Стандарт C17 (ISO/IEC 9899:2018):

7.29.3.5 Функция fwide (стр.: 309)

Стандарт C11 (ISO/IEC 9899:2011):

7.29.3.5 Функция fwide (стр.: 423)

Стандарт C99 (ISO/IEC 9899:1999):

7.24.3.5 Функция fwide (стр.: 369)

См. также

fopenfopen_s (C11)	открывает файл (функция)
Документация C++ для `fwide`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/c/io/fwide