# fwide

> C++ Atlas: `cppatlas.com/w/c/io/fwide` | Source: https://en.cppreference.com/w/c/io/fwide | Domain: File input/output | Standards: C95, C11

If mode > 0, attempts to make stream wide-oriented. If mode < 0, attempts to make stream byte-oriented. If mode == 0, only queries the current orientation of the stream.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <wchar.h>
int fwide( FILE* stream, int mode ); // (since C95)
```

If `mode > 0`, attempts to make `stream` wide-oriented. If `mode < 0`, attempts to make `stream` byte-oriented. If `mode == 0`, only queries the current orientation of the stream.

If the orientation of the stream has already been decided (by executing output or by an earlier call to `fwide`), this function does nothing.

### Parameters

- `stream` - pointer to the C I/O stream to modify or query
- `mode` - integer value greater than zero to set the stream wide, less than zero to set the stream narrow, or zero to query only

### Return value

An integer greater than zero if the stream is wide-oriented after this call, less than zero if the stream is byte-oriented after this call, and zero if the stream has no orientation.

### Example

The following code sets and resets the stream orientation.

```c
#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);
}
```

Possible output:

```text
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 '#'
```

### References

- C23 standard (ISO/IEC 9899:2024):

  - 7.29.3.5 The fwide function (p: TBD)

- C17 standard (ISO/IEC 9899:2018):

  - 7.29.3.5 The fwide function (p: 309)

- C11 standard (ISO/IEC 9899:2011):

  - 7.29.3.5 The fwide function (p: 423)

- C99 standard (ISO/IEC 9899:1999):

  - 7.24.3.5 The fwide function (p: 369)

### See also

- [`fopen`](https://en.cppreference.com/w/c/io/fopen), [`fopen_s`](https://en.cppreference.com/w/c/io/fopen) (C11): opens a file (function)
- [C++ documentation for `fwide`](https://en.cppreference.com/w/cpp/io/c/fwide)

---
Attribution: content from https://en.cppreference.com/w/c/io/fwide (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.