# Standard library header <codecvt> (C++11)(deprecated in C++17)(removed in C++26)

> C++ Atlas: `cppatlas.com/w/cpp/header/codecvt` | Source: https://en.cppreference.com/w/cpp/header/codecvt | Domain: Standard headers | Standards: C++11, C++17, C++26

This header is part of the text processing library.

## Official Specification Summary (cppreference)

This header is part of the text processing library.

**Classes**

- `codecvt_utf8` (C++11): converts between UTF-8 and UCS-2/UCS-4 (class template)
- `codecvt_utf16` (C++11): converts between UTF-16 and UCS-2/UCS-4 (class template)
- `codecvt_utf8_utf16` (C++11): converts between UTF-8 and UTF-16 (class template)
- `codecvt_mode` (C++11): tags to alter behavior of the standard codecvt facets (enum)

### Notes

`<codecvt>` is deprecated in C++17 and removed in C++26 (see P2871R3).

The reason for removal is that this feature no longer implements the current Unicode Standard, supporting only the obsolete UCS-2 encoding.

### Synopsis

```cpp
namespace std {
  enum codecvt_mode {
    consume_header = 4,
    generate_header = 2,
    little_endian = 1
  };

  template<class Elem, unsigned long Maxcode = 0x10ffff,
           codecvt_mode Mode = (codecvt_mode)0>
    class codecvt_utf8;

  template<class Elem, unsigned long Maxcode = 0x10ffff,
           codecvt_mode Mode = (codecvt_mode)0>
    class codecvt_utf16;

  template<class Elem, unsigned long Maxcode = 0x10ffff,
           codecvt_mode Mode = (codecvt_mode)0>
    class codecvt_utf8_utf16;
}
```

#### Class `std::codecvt_utf8`

```cpp
namespace std {
  template<class Elem, unsigned long Maxcode = 0x10ffff,
           codecvt_mode Mode = (codecvt_mode)0>
    class codecvt_utf8 : public codecvt<Elem, char, mbstate_t> {
    public:
      explicit codecvt_utf8(size_t refs = 0);
      ~codecvt_utf8();
    };
}
```

#### Class `std::codecvt_utf16`

```cpp
namespace std {
  template<class Elem, unsigned long Maxcode = 0x10ffff,
           codecvt_mode Mode = (codecvt_mode)0>
    class codecvt_utf16 : public codecvt<Elem, char, mbstate_t> {
    public:
      explicit codecvt_utf16(size_t refs = 0);
      ~codecvt_utf16();
    };
}
```

#### Class `std::codecvt_utf8_utf16`

```cpp
namespace std {
  template<class Elem, unsigned long Maxcode = 0x10ffff,
           codecvt_mode Mode = (codecvt_mode)0>
    class codecvt_utf8_utf16 : public codecvt<Elem, char, mbstate_t> {
    public:
      explicit codecvt_utf8_utf16(size_t refs = 0);
      ~codecvt_utf8_utf16();
    };
}
```

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