std::codecvt_utf8_utf16
De cppreference.com
|
|
This page has been machine-translated from the English version of the wiki using Google Translate.
The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here. |
<metanoindex/>
<tbody> </tbody>| Déclaré dans l'en-tête <codecvt>
|
||
template< class Elem, unsigned long Maxcode = 0x10ffff, std::codecvt_mode Mode = (std::codecvt_mode)0 > class codecvt_utf8_utf16 : public std::codecvt<Elem, char, std::mbstate_t>; |
||
std::codecvt_utf8_utf16 est une facette std::codecvt qui encapsule conversion entre une chaîne UTF-8 octets codée en UTF-16 et chaîne de caractères codé. Si
Elem est un type 32-bit, une UTF-16 codet seront utilisés pour chaque caractère 32-bit de la séquence de sortie. Cette facette codecvt peut être utilisé pour lire et écrire des fichiers UTF-8, à la fois du texte et binaire .Original:
std::codecvt_utf8_utf16 is a std::codecvt facet which encapsulates conversion between a UTF-8 encoded byte string and UTF-16 encoded character string. If
Elem is a 32-bit type, one UTF-16 codepoint will be stored in each 32-bit character of the output sequence. This codecvt facet can be used to read and write UTF-8 files, both text and binary.The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
Sommaire
Paramètres de modèle
| Elem | - | char16_t supporte, char32_t, ou wchar_t Original: either char16_t, char32_t, or wchar_t The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
| Maxcode | - | la plus grande valeur de
Elem que cette facette va lire ou écrire sans erreur Original: the largest value of Elem that this facet will read or write without error The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
| Mode | - | une constante de std::codecvt_mode type
Original: a constant of type std::codecvt_mode The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
Inherited from std::codecvt
Member types
| Type du membre | Définition |
intern_type
|
internT
|
extern_type
|
externT
|
state_type
|
stateT
|
Member objects
Nom du membre
Original: Member name The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
Type |
id (statique )
Original: static The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
std::locale::id |
Member functions
Invoque do_out Original: invokes do_out The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre publique de std::codecvt)
| |
Invoque do_in Original: invokes do_in The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre publique de std::codecvt)
| |
Invoque do_unshift Original: invokes do_unshift The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre publique de std::codecvt)
| |
Invoque do_encoding Original: invokes do_encoding The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre publique de std::codecvt)
| |
Invoque do_always_noconv Original: invokes do_always_noconv The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre publique de std::codecvt)
| |
Invoque do_length Original: invokes do_length The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre publique de std::codecvt)
| |
Invoque do_max_length Original: invokes do_max_length The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre publique de std::codecvt)
|
Protected member functions
[ virtuel ]Original: virtual The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
convertit une chaîne de Internt à Externt, comme lors de l'écriture dans un fichier Original: converts a string from internT to externT, such as when writing to file The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre virtuelle protégée de std::codecvt)
|
[ virtuel ]Original: virtual The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
convertit une chaîne de Externt à internt, comme lors de la lecture du fichier Original: converts a string from externT to internT, such as when reading from file The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre virtuelle protégée de std::codecvt)
|
[ virtuel ]Original: virtual The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
génère la séquence de caractères de terminaison de caractères Externt pour la conversion incomplète Original: generates the termination character sequence of externT characters for incomplete conversion The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre virtuelle protégée de std::codecvt)
|
[ virtuel ]Original: virtual The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
retourne le nombre de caractères Externt nécessaires pour produire une Internt caractère, si constante Original: returns the number of externT characters necessary to produce one internT character, if constant The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre virtuelle protégée de std::codecvt)
|
[ virtuel ]Original: virtual The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
Teste si la facette code pour une conversion d'identité pour toutes les valeurs des arguments valables Original: tests if the facet encodes an identity conversion for all valid argument values The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre virtuelle protégée de std::codecvt)
|
[ virtuel ]Original: virtual The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
calcule la longueur de la chaîne Externt qui serait consommée par conversion en tampon Internt proposée Original: calculates the length of the externT string that would be consumed by conversion into given internT buffer The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre virtuelle protégée de std::codecvt)
|
[ virtuel ]Original: virtual The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
retourne le nombre de caractères maximum Externt qui pourraient être transformés en un seul caractère Internt Original: returns the maximum number of externT characters that could be converted into a single internT character The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (fonction membre virtuelle protégée de std::codecvt)
|
Inherited from std::codecvt_base
| Type du membre | Définition |
enum result { ok, partial, error, noconv };
|
Type d'énumération sans portée
Original: Unscoped enumeration type The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
Énumération constante
Original: Enumeration constant The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
Definition |
ok
|
conversion a été effectuée sans erreur
Original: conversion was completed with no error The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
partial
|
tous les caractères de source ont été converties
Original: not all source characters were converted The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
error
|
rencontré un caractère non valide
Original: encountered an invalid character The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
noconv
|
aucune conversion n'est requise, l'entrée et les types de sortie sont les mêmes
Original: no conversion required, input and output types are the same The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
Exemple
L'exemple suivant illustre la lecture d'un fichier UTF-8 en une chaîne UTF-16 sur un système 32-bit avec
wchar_t
Original:
The following example demonstrates reading a UTF-8 file into a UTF-16 string on a system with 32-bit
wchar_t
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
#include <fstream>
#include <iostream>
#include <string>
#include <locale>
#include <codecvt>
int main()
{
std::ofstream("text.txt") << u8"z\u6c34\U0001d10b";
std::wifstream file1("text.txt");
file1.imbue(std::locale("en_US.UTF8"));
std::cout << "Normal read from file (using default UTF-8/UTF-32 codecvt)\n";
for(wchar_t c; file1 >> c; )
std::cout << std::hex << std::showbase << c << '\n';
std::wifstream file2("text.txt");
file2.imbue(std::locale(file2.getloc(), new std::codecvt_utf8_utf16<wchar_t>));
std::cout << "UTF-16 read from the same file (using codecvt_utf8_utf16)\n";
for(wchar_t c; file2 >> c; )
std::cout << std::hex << std::showbase << c << '\n';
}
Résultat :
Normal read from file (using default UTF-8/UTF-32 codecvt)
0x7a
0x6c34
0x1d10b
UTF-16 read from the same file (using codecvt_utf8_utf16)
0x7a
0x6c34
0xd834
0xdd0b
Voir aussi
| Character conversions |
narrow multibyte (char) |
UTF-8 (char) |
UTF-16 (char16_t) |
|---|---|---|---|
| UTF-16 | mbrtoc16 / c16rtomb | codecvt<char16_t, char, mbstate_t> codecvt_utf8_utf16<char16_t> codecvt_utf8_utf16<char32_t> codecvt_utf8_utf16<wchar_t> |
N/A |
| UCS2 | No | codecvt_utf8<char16_t> | codecvt_utf16<char16_t> |
| UTF-32/UCS4 (char32_t) |
mbrtoc32 / c32rtomb | codecvt<char32_t, char, mbstate_t> codecvt_utf8<char32_t> |
codecvt_utf16<char32_t> |
| UCS2/UCS4 (wchar_t) |
No | codecvt_utf8<wchar_t> | codecvt_utf16<wchar_t> |
| wide (wchar_t) |
codecvt<wchar_t, char, mbstate_t> mbsrtowcs / wcsrtombs |
No | No |
convertis entre les codages de caractères, y compris UTF-8, UTF-16, UTF-32 Original: converts between character encodings, including UTF-8, UTF-16, UTF-32 The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (classe générique) | |
(C++11) |
balises pour modifier le comportement des facettes codecvt standard Original: tags to alter behavior of the standard codecvt facets The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (classe) |
(C++11) |
convertit entre UTF-8 et UCS2/UCS4 Original: converts between UTF-8 and UCS2/UCS4 The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (classe générique) |
(C++11) |
convertit entre UTF-16 et UCS2/UCS4 Original: converts between UTF-16 and UCS2/UCS4 The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (classe générique) |