Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/header/codecvt"

From cppreference.com
< cpp‎ | header
m (→‎Notes: +the rationale for removal, P2861R2, [diff.cpp23.depr].)
(move synopsis to template)
Line 16: Line 16:
  
 
===Synopsis===
 
===Synopsis===
−
{{source|1=
+
{{cpp/synopsis/codecvt}}
−
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 {{lc|std::codecvt_utf8}}====
+
−
{{source|1=
+
−
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 {{lc|std::codecvt_utf16}}====
+
−
{{source|1=
+
−
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 {{lc|std::codecvt_utf8_utf16}}====
+
−
{{source|1=
+
−
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();
+
−
    };
+
−
}
+
−
}}
+
  
 
{{langlinks|ja|zh}}
 
{{langlinks|ja|zh}}

Revision as of 03:52, 29 November 2023

 
C++
 
Standard library headers
Algorithms
<algorithm>
<numeric>
Strings
<cctype>
<cstring>
<cuchar> (C++11)
<cwchar>
<cwctype>
<string_view> (C++17)
<string>
Text processing
<clocale>
<codecvt> (C++11/17/26*)
<locale>
<regex> (C++11)
<text_encoding> (C++26)   
Numerics
<cfenv> (C++11)
<cmath>
<complex>
<linalg> (C++26)
<numbers> (C++20)
<random> (C++11)
<valarray>
Time
<chrono> (C++11)
<ctime>
C compatibility
<ccomplex> (C++11/17/20*)
<ciso646> (until C++20)
<cstdalign> (C++11/17/20*)
<cstdbool> (C++11/17/20*)
<ctgmath> (C++11/17/20*)
 

This header is part of the Localization library.

Contents

Classes

(C++11)(deprecated in C++17)(removed in C++26)
 converts between UTF-8 and UCS-2/UCS-4
(class template) [edit]
(C++11)(deprecated in C++17)(removed in C++26)
 converts between UTF-16 and UCS-2/UCS-4
(class template) [edit]
(C++11)(deprecated in C++17)(removed in C++26)
 converts between UTF-8 and UTF-16
(class template) [edit]
(C++11)(deprecated in C++17)(removed in C++26)
 tags to alter behavior of the standard codecvt facets
(enum) [edit]

Notes

<codecvt> is deprecated in C++17 and removed in C++26.

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

Synopsis

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

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

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

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();
    };
}
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/header/codecvt&oldid=164383"