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 を取得するには、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 (Byte Order Mark) と content-type メタヘッダをチェックして、指定されたバイト配列ba に含まれる HTML のスニペットのエンコーディングを検出し、html を unicode にデコードできる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) を使って検出し、テキストをユニコードにデコードできる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) を使って検出し、テキストをユニコードにデコードできる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 をこのコーデックのエンコーディングからユニコードに変換し、その結果を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 にはソース文字が含まれます。