QTextCodec Class

QByteArray encodedString = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QString string = codec->toUnicode(encodedString);

QString string = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QByteArray encodedString = codec->fromUnicode(string);

QTextCodec *codec = QTextCodec::codecForName("Shift-JIS");
QTextDecoder *decoder = codec->makeDecoder();

QString string;
while (new_data_available()) {
    QByteArray chunk = get_new_data();
    string += decoder->toUnicode(chunk);
}
delete decoder;

メンバ関数のドキュメント

[protected] QTextCodec::QTextCodec()

QTextCodec を作成し、それに最高の優先順位を割り当てます。QTextCodec は常にヒープ上で（つまり、new を使用して）作成する必要があります。Qt が所有権を取得し、アプリケーションの終了時にこれを削除します。

[virtual noexcept protected] QTextCodec::~QTextCodec()

QTextCodec を破棄します。なお、コーデックを自分で削除してはなりません。一度作成されると、その管理はQtの責任となります。

警告：この関数は再入可能ではありません。

[virtual] QList<QByteArray> QTextCodec::aliases() const

サブクラスは、対象のコーデックに対する複数のエイリアスを返すことができます。

コーデックの標準エイリアスは、IANAの文字セットエンコーディングファイルに記載されています。

[static] QList<QByteArray> QTextCodec::availableCodecs()

利用可能なすべてのコーデックを、名前順にリストとして返します。QTextCodec::codecForName() を呼び出すと、その名前に対応するQTextCodec を取得できます。

コーデックにエイリアスがある場合、リストには同じコーデックが複数回含まれることがあります。

注： この関数はスレッドセーフです。

関連項目： availableMibs()、name()、およびaliases()。

[static] QList<int> QTextCodec::availableMibs()

利用可能なすべてのコーデックのMIBのリストを返します。MIBのQTextCodec を取得するには、QTextCodec::codecForMib() を呼び出してください。

注： この関数はスレッドセーフです。

availableCodecs() およびmibEnum()も参照してください 。

bool QTextCodec::canEncode(QChar ch) const

Unicode文字ch がこのコーデックで完全にエンコードできる場合はtrue を返し、そうでない場合はfalse を返します。

bool QTextCodec::canEncode(QStringView s) const

Unicode文字列 `s ` がこのコーデックで完全にエンコードできる場合は `true ` を返し、そうでない場合は `false` を返します。

bool QTextCodec::canEncode(const QString &s) const

s エンコード可能かどうかをテストする文字列が含まれています。

[static] QTextCodec *QTextCodec::codecForHtml(const QByteArray &ba, QTextCodec *defaultCodec)

指定されたバイト配列（ba ）に含まれるHTMLスニペットのエンコーディングを、BOM（バイト順マーク）およびコンテンツタイプ・メタヘッダーを確認することで検出しようと試み、そのHTMLをUnicodeにデコードできるQTextCodec インスタンスを返します。提供されたコンテンツからコーデックを検出できない場合は、defaultCodec が返されます。

codecForUtfText()も参照してください 。

[static] QTextCodec *QTextCodec::codecForHtml(const QByteArray &ba)

指定されたバイト配列（ba ）に含まれるHTMLスニペットのエンコーディングを、BOM（バイト順マーク）およびコンテンツタイプ・メタヘッダーを確認することで検出し、そのHTMLをUnicodeにデコードできるQTextCodec インスタンスを返します。エンコーディングを検出できない場合、このオーバーロードはLatin-1のQTextCodec を返します。

[static] QTextCodec *QTextCodec::codecForLocale()

このロケールに最も適したコーデックへのポインタを返します。

そのバックエンドが使用されている場合は、ICU からコーデックが取得されます。そうでない場合は、OS 固有の API から取得されることがあります。後者の場合、コーデックの名前は「System」となる場合があります。

注： この関数はスレッドセーフです。

setCodecForLocale()も参照してください 。

[static] QTextCodec *QTextCodec::codecForMib(int mib)

MIBenum mib に一致するQTextCodec を返します。

注： この関数はスレッドセーフです。

[static] QTextCodec *QTextCodec::codecForName(const QByteArray &name)

インストールされているすべてのQTextCodec オブジェクトを検索し、name に最も一致するものを返します。一致の判定では大文字小文字を区別しません。name という名前に一致するコーデックが見つからない場合は、nullptr を返します。

注： この関数はスレッドセーフです。

[static] QTextCodec *QTextCodec::codecForName(const char *name)

インストールされているすべてのQTextCodec オブジェクトを検索し、name に最も一致するオブジェクトを返します。一致の判定は大文字小文字を区別しません。name という名前に一致するコーデックが見つからなかった場合は、nullptr を返します。

[static] QTextCodec *QTextCodec::codecForUtfText(const QByteArray &ba, QTextCodec *defaultCodec)

BOM（バイト順マーク）を使用して、指定されたスニペットba のエンコーディングを検出し、そのテキストをUnicodeにデコードできるQTextCodec インスタンスを返します。この関数は、以下のコーデックのいずれかを検出できます：

• UTF-32 リトルエンディアン
• UTF-32 ビッグエンディアン
• UTF-16 リトルエンディアン
• UTF-16 ビッグエンディアン
• UTF-8

提供されたコンテンツからコーデックを検出できない場合、defaultCodec が返されます。

codecForHtml()も参照してください 。

[static] QTextCodec *QTextCodec::codecForUtfText(const QByteArray &ba)

BOM（バイト順マーク）を使用して、指定されたスニペットba のエンコーディングを検出し、そのテキストをUnicodeにデコードできるQTextCodec インスタンスを返します。この関数は、以下のコーデックのいずれかを検出できます：

• UTF-32 リトルエンディアン
• UTF-32 ビッグエンディアン
• UTF-16 リトルエンディアン
• UTF-16 ビッグエンディアン
• UTF-8

提供されたコンテンツからコーデックを検出できない場合、このオーバーロードは Latin-1 形式の `QTextCodec` を返します。

codecForHtml()も参照してください 。

[pure virtual protected] QByteArray QTextCodec::convertFromUnicode(const QChar *input, int number, int *state) const

QTextCodec サブクラスはこの関数を再実装する必要があります。

input 配列の先頭number の文字を、Unicodeからサブクラスのエンコーディングに変換し、その結果をQByteArray として返します。

state nullptr である場合、変換はステートレスであり、デフォルトの変換ルールを使用する必要があります。 が でない場合、コーデックは変換後の状態を に保存し、structの および メンバーを調整する必要があります。state nullptr state remainingChars invalidChars

[pure virtual protected] QString QTextCodec::convertToUnicode(const char *chars, int len, int *state) const

QTextCodec サブクラスはこの関数を再実装する必要があります。

chars の先頭len 文字を、サブクラスのエンコーディングからUnicodeに変換し、結果をQString として返します。

state nullptr である場合、変換はステートレスとなり、デフォルトの変換ルールが使用されるべきです。 が でない場合、コーデックは変換後の状態を に保存し、struct の および メンバを調整する必要があります。state nullptr state remainingChars invalidChars

QByteArray QTextCodec::fromUnicode(const QString &str) const

str を Unicode からこのコーデックのエンコーディングに変換し、結果をQByteArray に格納して返します。

QByteArray QTextCodec::fromUnicode(const QChar *input, int number, int *state = nullptr) const

input 配列の先頭number 文字を、Unicodeからこのコーデックのエンコーディングに変換し、その結果をQByteArray に格納して返します。

使用されたコンバータのstate が更新されます。

QByteArray QTextCodec::fromUnicode(QStringView str) const

str を Unicode からこのコーデックのエンコーディングに変換し、結果をQByteArray に格納して返します。

QTextDecoder *QTextCodec::makeDecoder(int flags = DefaultConversion) const

指定されたflags を持つQTextDecoder を作成し、char * データのチャンクをデコードして、Unicodeデータのチャンクを生成します。

返されたオブジェクトの削除は、呼び出し元が行う必要があります。

QTextEncoder *QTextCodec::makeEncoder(int flags = DefaultConversion) const

指定されたflags を持つQTextEncoder を作成し、Unicodeデータのチャンクをchar * データとしてエンコードします。

返されたオブジェクトの削除は、呼び出し元が責任を持って行う必要があります。

[pure virtual] int QTextCodec::mibEnum() const

QTextCodec のサブクラスは、この関数を再実装する必要があります。この関数はMIBenumを返します（詳細については、IANAの文字セットエンコーディングファイルを参照してください）。QTextCodec の各サブクラスが、この関数に対して正しい一意の値を返すことが重要です。

[pure virtual] QByteArray QTextCodec::name() const

QTextCodec サブクラスはこの関数を再実装する必要があります。この関数は、サブクラスがサポートするエンコーディングの名前を返します。

コーデックがIANA の文字セットエンコーディングファイルに文字セットとして登録されている場合、このメソッドは、定義されている場合はそのコーデックの優先 MIME 名、そうでない場合はその名前を返す必要があります。

[static] void QTextCodec::setCodecForLocale(QTextCodec *c)

コーデックをc に設定します。これはcodecForLocale()によって返されます。c がnullptr の場合、コーデックはデフォルトにリセットされます。

これは、ロケールの設定に独自のメカニズムを使用したい一部のアプリケーションで必要になる場合があります。

警告:この関数は再入可能ではありません。

codecForLocale()も参照してください 。

QString QTextCodec::toUnicode(const QByteArray &a) const

a を、このコーデックのエンコーディングから Unicode に変換し、その結果をQString として返します。

QString QTextCodec::toUnicode(const char *input, int size, int *state = nullptr) const

input の先頭size 文字を、このコーデックのエンコーディングからUnicodeに変換し、その結果をQString として返します。

使用されたコンバータのstate が更新されます。

QString QTextCodec::toUnicode(const char *chars) const

chars ソース文字列が含まれています。