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 character-sets encoding file にあります。

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

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

コーデックに別名がある場合、リストには同じコーデックが多数含まれる可能性があります。

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

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)

BOM（バイトオーダーマーク）とcontent-typeメタヘッダをチェックすることによって、与えられたバイト配列ba 、提供されたHTMLのスニペットのエンコーディングを検出しようとし、ユニコードにhtmlをデコードすることができるQTextCodec インスタンスを返します。提供されたコンテンツからコーデックが検出できない場合は、defaultCodec が返される。

codecForUtfText()も参照のこと 。

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

これはオーバーロードされた関数です。

BOM (Byte Order Mark) と content-type メタヘッダをチェックすることで、指定されたバイト配列ba に含まれる HTML のスニペットのエンコーディングを検出し、html を unicode にデコードできるQTextCodec インスタンスを返します。コーデックが検出できない場合、このオーバーロードは Latin-1QTextCodec を返す。

[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)

提供されたスニペットba のエンコーディングを BOM (Byte Order Mark) を使って検出し、テキストを unicode にデコードできるQTextCodec インスタンスを返します。この関数は、以下のコーデックのいずれかを検出することができます：

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

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

codecForHtml()も参照 。

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

これはオーバーロードされた関数です。

提供されたスニペットba のエンコーディングを BOM (Byte Order Mark) を使って検出し、テキストを unicode にデコードできるQTextCodec インスタンスを返します。この関数は、以下のコーデックのいずれかを検出することができます：

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

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

codecForHtml()も参照 。

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

QTextCodec サブクラスはこの関数を再実装しなければなりません。

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

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

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

QTextCodec サブクラスはこの関数を再実装しなければなりません。

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

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

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

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

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

input 配列からの文字の最初のnumber を、Unicode からこのコーデックのエンコーディングに変換し、結果をQByteArray で返します。

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

QByteArray QTextCodec::fromUnicode(QStringView str) const

これはオーバーロードされた関数です。

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

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

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

返されたオブジェクトを削除するのは呼び出し側の責任です。

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

flags を指定 し てQTextEncoder を作成 し 、 Unicode デー タ の塊 をchar * デー タ と し てエン コ ー ド し ます。

返されたオブジェクトの削除は呼び出し側の責任です。

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

QTextCodec のサブクラスは、この関数を再実装しなければならない。この関数は MIBenum を返します（詳しくはIANA character-sets encoding file を参照してください）。QTextCodec の各サブクラスは、この関数に対して正しい一意の値を返すことが重要です。

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

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

コーデックがIANA character-sets encoding ファイルに文字セットとして登録されている場合、このメソッドはコーデックに好ましい 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, QTextCodec::ConverterState *state = nullptr) const

このコーデックのエンコーディングからinput の最初のsize 文字を Unicode に変換し、結果をQString で返します。

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

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

これはオーバーロードされた関数です。

chars にはソース文字が含まれます。