QTextStream Class

メンバ関数ドキュメント

QTextStream::QTextStream()

QTextStream を構築する。読み書きに使用する前に、デバイスまたは文字列を割り当てる必要があります。

setDevice() およびsetString()も参照してください 。

[explicit] QTextStream::QTextStream(QIODevice *device)

device を操作する QTextStream を構築します。

[explicit] QTextStream::QTextStream(FILE *fileHandle, QIODeviceBase::OpenMode openMode = ReadWrite)

openMode を使用してオープン・モードを定義し、fileHandle を操作する QTextStream を構築します。内部的には、FILEポインタを処理するためにQFile 。

このコンストラクタは、一般的な FILE ベースの入出力ストリームである stdin、stdout、stderr を直接操作する場合に便利です。例

QString str;
QTextStream in(stdin);
in >> str;

[explicit] QTextStream::QTextStream(QByteArray *array, QIODeviceBase::OpenMode openMode = ReadWrite)

array を操作する QTextStream を構築します。openMode を使用してオープンモードを定義します。内部的には、配列はQBuffer でラップされます。

[explicit] QTextStream::QTextStream(QString *string, QIODeviceBase::OpenMode openMode = ReadWrite)

string を操作する QTextStream を構築します。openMode を使ってオープンモードを定義します。

[explicit] QTextStream::QTextStream(const QByteArray &array, QIODeviceBase::OpenMode openMode = ReadOnly)

array を操作する QTextStream を構築します。openMode を使用してオープンモードを定義します。配列は、openMode の値に関係なく、読み取り専用としてアクセスされます。

このコンストラクタは、定数文字列を操作するのに便利です。例

int main(int argc, char *argv[])
{
    // read numeric arguments (123, 0x20, 4.5...)
    for (int i = 1; i < argc; ++i) {
          int number;
          QTextStream in(argv[i]);
          in >> number;
          ...
    }
}

[virtual noexcept] QTextStream::~QTextStream()

QTextStream を破棄する。

ストリームがデバイス上で動作している場合、flush() が暗黙的に呼び出される。そうでない場合、デバイスは影響を受けません。

bool QTextStream::atEnd() const

QTextStream から読み込むデータがもうない場合はtrue を返し、そうでない場合はfalse を返す。これはQIODevice::atEnd() を呼び出すのと似ているが同じではない。QTextStream は内部 Unicode バッファも考慮に入れているからだ。

bool QTextStream::autoDetectUnicode() const

自動 Unicode 検出が有効な場合はtrue を返し、そうでない場合はfalse を返す。Unicode 自動検出はデフォルトで有効になっています。

setAutoDetectUnicode() およびsetEncoding()も参照 。

QIODevice *QTextStream::device() const

QTextStream に関連付けられた現在のデバイス、またはデバイスが割り当てられていない場合はnullptr を返す。

setDevice() およびstring()も参照のこと 。

QStringConverter::Encoding QTextStream::encoding() const

現在ストリームに割り当てられているエンコーディングを返します。

setEncoding()、setAutoDetectUnicode() およびlocale()も参照 。

QTextStream::FieldAlignment QTextStream::fieldAlignment() const

現在のフィールド・アライメントを返す。

setFieldAlignment() およびfieldWidth()も参照 。

int QTextStream::fieldWidth() const

現在のフィールド幅を返します。

setFieldWidth()も参照 。

void QTextStream::flush()

デバイスに書き込まれるのを待っているバッファされたデータをすべてフラッシュする。

QTextStream が文字列を操作する場合、この関数は何もしない。

bool QTextStream::generateByteOrderMark() const

UTF エンコーディング使用時に UTF BOM（Byte Order Mark）を生成するようにQTextStream が設定されている場合はtrue を返し、そうでない場合はfalse を返します。それ以外の場合は を返します。 UTF BOM 生成はデフォルトで false に設定されています。

setGenerateByteOrderMark()も参照 。

int QTextStream::integerBase() const

整数の現在の底を返す。0 は、数値を読み込む際に基数を検出することを意味し、 10 (10進数) は、数値を生成する際に基数を検出することを意味する。

setIntegerBase()、QString::number() およびnumberFlags()も参照 。

QLocale QTextStream::locale() const

このストリームのロケールを返します。デフォルトのロケールは C です。

setLocale()も参照 ください。

QTextStream::NumberFlags QTextStream::numberFlags() const

現在の番号フラグを返す。

setNumberFlags()、integerBase() およびrealNumberNotation()も参照 。

QChar QTextStream::padChar() const

現在のパッド文字を返す。

setPadChar() およびsetFieldWidth()も参照 。

qint64 QTextStream::pos() const

ストリームの現在位置に対応するデバイス位置を返すか、エラーが発生した場合 (デバイスや文字列がない場合、デバイスエラーが発生した場合など) は -1 を返す。

QTextStream はバッファリングされるため、この関数は有効なデバイス位置を再構築するためにデバイスをシークしなければならない場合があります。この処理には時間がかかるので、タイトなループ内でこの関数を呼び出すのは避けたい。

seek()も参照のこと 。

QString QTextStream::read(qint64 maxlen)

ストリームから最大でmaxlen 文字読み取り、読み取ったデータをQString として返す。

readAll()、readLine()、QIODevice::read()も参照のこと 。

QString QTextStream::readAll()

ストリームの内容全体を読み込み、それをQString として返す。 大きなファイルを扱う場合は、メモリを大量に消費するので、この関数は避けること。

利用可能なデータ量がわからない場合は、readLine() を呼び出すほうがよい。

readLine()も参照 。

QString QTextStream::readLine(qint64 maxlen = 0)

ストリームから1行のテキストを読み込み、それをQString として返す。 許可される行の最大長はmaxlen に設定される。 ストリームにこれより長い行がある場合、行はmaxlen 文字の後で分割され、分割されて返される。

maxlen が0の場合、行の長さは任意である。

返される行には行末文字(" \n "または" \rn")がないので、QString::trimmed()を呼び出す必要はない。

ストリームがファイルの最後まで読み込まれた場合、readLine() は NULLQString を返します。文字列の場合、またはそれをサポートするデバイスの場合は、atEnd() を使用してストリームの終わりを明示的にテストできます。

readAll() およびQIODevice::readLine()も参照 。

bool QTextStream::readLineInto(QString *line, qint64 maxlen = 0)

ストリームから1行のテキストをline に読み込む。line がnullptr の場合、読み込んだ行は格納されない。

許容される行の最大長はmaxlen に設定される。 ストリームにこれより長い行がある場合、行はmaxlen 文字以降で分割され、分割されて返される。

maxlen が0の場合、行の長さは任意である。

結果の行には行末文字（"˶n "または"˶rn"）がないので、QString::trimmed （）を呼び出す必要はない。

line に読み込もうとするデータに対して十分な容量がある場合、この関数は新しいメ モリを確保する必要がない。このため、readLine() よりも高速である。

ストリームがファイルの最後まで読み込まれたか、エラーが発生した場合はfalse を返し、そうでない場合はtrue を返す。呼び出し前のline の内容は、どのような場合でも破棄される。

readAll() およびQIODevice::readLine()も参照のこと 。

QTextStream::RealNumberNotation QTextStream::realNumberNotation() const

現在の実数表記を返す。

setRealNumberNotation()、realNumberPrecision()、numberFlags() およびintegerBase()も参照 。

int QTextStream::realNumberPrecision() const

現在の実数の精度、または実数を生成する際にQTextStream が書き込む分数の桁数 (FixedNotation,ScientificNotation)、または最大有効桁数 (SmartNotation)を返す。

setRealNumberPrecision()、setRealNumberNotation()、realNumberNotation()、numberFlags()、integerBase()も参照 。

void QTextStream::reset()

QTextStream のフォーマットオプションをリセットし、元の構築状態に戻す。デバイス、文字列、バッファリングされたデータはそのまま残される。

void QTextStream::resetStatus()

テキスト・ストリームの状態をリセットする。

QTextStream::Status 、status()、setStatus()も参照のこと 。

bool QTextStream::seek(qint64 pos)

デバイス内の位置pos をシークする。成功すればtrue を返し、そうでなければfalse を返す。

void QTextStream::setAutoDetectUnicode(bool enabled)

enabled が true の場合、QTextStream は、ストリームデータを覗いて UTF-8、UTF-16、または UTF-32 のバイトオーダーマーク（BOM）を見つけられるかどうかを調べることで、Unicode エンコーディングの検出を試みます。このマークが見つかった場合、QTextStream は現在のエンコーディングを UTF エンコーディングに置き換えます。

この関数はsetEncoding() と併用することもできます。エンコーディングを UTF-8 に設定してから UTF-16 の検出を有効にするのが一般的です。

autoDetectUnicode() およびsetEncoding()も参照 。

void QTextStream::setDevice(QIODevice *device)

現在のデバイスをdevice に設定する。すでにデバイスが割り当てられている場合、QTextStream は、古いデバイスを置き換える前にflush() を呼び出す。

device() およびsetString()も参照のこと 。

void QTextStream::setEncoding(QStringConverter::Encoding encoding)

このストリームのエンコーディングをencoding に設定する。 このエンコーディングは、割り当てられたデバイスから読み込まれるデータのデコードと、 書き込まれるデータのエンコーディングに使用される。デフォルトではQStringConverter::Utf8 が使用され、自動ユニコード検出が有効になっている。

QTextStream が文字列を操作する場合、この関数は何もしません。

encoding()、setAutoDetectUnicode()、setLocale()も参照のこと 。

void QTextStream::setFieldAlignment(QTextStream::FieldAlignment mode)

フィールドのアライメントをmode に設定する。setFieldWidth() と併用すると、テキストを左揃え、右揃え、中央揃えにした書式付き出力を生成できる。

fieldAlignment() およびsetFieldWidth()も参照 。

void QTextStream::setFieldWidth(int width)

width width が 0 （デ フ ォ ル ト ） の と き は、 フ ィ ール ド 幅は、 生成 さ れ る テ キ ス ト の長 さ と 等 し く な り ます。

fieldWidth() およびsetPadChar()も参照してください 。

void QTextStream::setGenerateByteOrderMark(bool generate)

generate が真でUTFエンコーディングが使用されている場合、QTextStream は、データがデバイスに書き込まれる前にBOM（バイト・オーダー・マーク）を挿入する。generate が偽の場合、BOM は挿入されない。この関数は、データが書き込まれる前に呼び出されなければならない。そうでない場合は、何もしません。

generateByteOrderMark() およびbom()も参照のこと 。

void QTextStream::setIntegerBase(int base)

base base には、2（2進数）、8（8進数）、10（10進数）、16（16進数）のいずれかを指定する。 が0の場合、 は、ストリーム上のデータを検査することで、ベースを検出しようとする。数値を生成する場合、 は、基数が明示的に設定されていない限り、基数が10であると仮定する。base QTextStream QTextStream

integerBase()、QString::number()、setNumberFlags()も参照の こと。

void QTextStream::setLocale(const QLocale &locale)

このストリームのロケールをlocale に設定します。 指定したロケールは、数値とその文字列表現との間の変換に使用されます。

デフォルトのロケールは C で、これは特殊なケースです。 後方互換性の理由から、千のグループセパレータは使用されません。

locale()も参照 。

void QTextStream::setNumberFlags(QTextStream::NumberFlags flags)

現在の数値フラグをflags に設定する。flags はNumberFlag enum のフラグのセットで、生成されるコードをフォーマットするためのオプション（例えば、数値の基数や符号を常に記述するかどうか）を記述する。

numberFlags()、setIntegerBase()、setRealNumberNotation()も参照の こと。

void QTextStream::setPadChar(QChar ch)

パッド文字をch に設定する。 デフォルト値は ASCII スペース文字 (' ')、またはQChar(0x20) である。この文字は、テキスト生成時にフィールド内のスペースを埋めるために使用されます。

例

QString s;
QTextStream out(&s);
out.setFieldWidth(10);
out.setFieldAlignment(QTextStream::AlignCenter);
out.setPadChar('-');
out << "Qt" << "rocks!";

文字列s ：

----Qt------rocks!--

padChar() およびsetFieldWidth()も参照 。

void QTextStream::setRealNumberNotation(QTextStream::RealNumberNotation notation)

実数表記をnotation (SmartNotation,FixedNotation,ScientificNotation) に設定する。数値を読み込んだり生成したりする際に、QTextStream はこの値を使用して実数の書式を検出する。

realNumberNotation()、setRealNumberPrecision()、setNumberFlags()、setIntegerBase()も参照のこと 。

void QTextStream::setRealNumberPrecision(int precision)

実数の精度をprecision に設定します。この値は、実数 (FixedNotation,ScientificNotation) を生成する際にQTextStream が書き込むべき分数の桁数、または最大有効桁数 (SmartNotation) を記述します。

精度は負の値にはできません。デフォルト値は6である。

realNumberPrecision() およびsetRealNumberNotation()も参照 。

void QTextStream::setStatus(QTextStream::Status status)

テキスト・ストリームのステータスをstatus に設定する。

それ以降の setStatus() の呼び出しは、resetStatus() が呼び出されるまで無視される。

Status 、status()、resetStatus()も参照 。

void QTextStream::setString(QString *string, QIODeviceBase::OpenMode openMode = ReadWrite)

与えられたopenMode を使用して、現在の文字列をstring に設定する。デバイスが既に割り当てられている場合、QTextStream は、それを置き換える前にflush() を呼び出す。

string() およびsetDevice()も参照のこと 。

void QTextStream::skipWhiteSpace()

非空白文字が検出されるか、atEnd() が真を返すまで、ストリームから空白文字を読み込んで破棄する。この関数は、ストリームを1文字ずつ読み込む場合に便利です。

空白文字は、QChar::isSpace() がtrue を返すすべての文字です。

operator>>()も参照 。

QTextStream::Status QTextStream::status() const

テキスト・ストリームの状態を返す。

QTextStream::Status 、setStatus()、resetStatus()も参照 。

QString *QTextStream::string() const

QTextStream に割り当てられている現在の文字列、または文字列が割り当てられていない場合はnullptr を返す。

setString() およびdevice()も参照 。

QTextStream &QTextStream::operator<<(QChar c)

文字c をストリームに書き込み、QTextStream への参照を返します。

setFieldWidth()も参照のこと 。

QTextStream &QTextStream::operator<<(const QString &string)

文字列string をストリームに書き込み、その参照をQTextStream に返します。 文字列はまず、指定されたエンコーディング (デフォルトは UTF-8) でエンコードされてからストリームに書き込まれます。

setFieldWidth() およびsetEncoding()も参照 。

QTextStream &QTextStream::operator<<(float f)

実数f をストリームに書き込み、QTextStream への参照を返す。 デフォルトでは、QTextStream は、SmartNotation を使用して、最大6桁の精度で格納する。setRealNumberNotation （）、setRealNumberPrecision （）、setNumberFlags （）を呼び出すと、QTextStream が実数に使用するテキスト表現を変更できる。

setFieldWidth()、setRealNumberNotation()、setRealNumberPrecision()、setNumberFlags()も参照の こと。

QTextStream &QTextStream::operator<<(short i)

整数値i をストリームに書き込み、QTextStream への参照を返す。 デフォルトでは、数値は10進数形式で格納されるが、setIntegerBase() を呼び出して基数を設定することもできる。

setFieldWidth() およびsetNumberFlags()も参照 。

QTextStream &QTextStream::operator<<(QLatin1StringView string)

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

string をストリームに書き込み、QTextStream への参照を返します。

QTextStream &QTextStream::operator<<(QStringView string)

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

string をストリームに書き込み、QTextStream への参照を返します。

QTextStream &QTextStream::operator<<(char c)

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

c を ASCII からQChar に変換し、ストリームに書き込む。

[since 6.3.1] QTextStream &QTextStream::operator<<(char16_t c)

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

Unicode 文字c をストリームに書き込み、QTextStream への参照を返します。

この関数は Qt 6.3.1 で導入されました。

QTextStream &QTextStream::operator<<(const QByteArray &array)

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

array をストリームに書き込む。array の内容はQString::fromUtf8() で変換される。

QTextStream &QTextStream::operator<<(const char *string)

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

string が指す定数文字列をストリームに書き込みます。string は UTF-8 エンコーディングであると仮定されます。この演算子は、定数文字列データを扱うときに便利です。例

QTextStream out(stdout);
out << "Qt rocks!" << Qt::endl;

警告:QTextStream は、string が ' \0' 文字で終端するテキスト文字列を指していると仮定しています。終端 ' \0' 文字がない場合、アプリケーションがクラッシュする可能性があります。

QTextStream &QTextStream::operator<<(const void *ptr)

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

ptr 、16進数を基数としてストリームに書き込みます。

QTextStream &QTextStream::operator<<(double f)

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

doublef をストリームに書き込みます。

QTextStream &QTextStream::operator<<(int i)

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

符号付き inti をストリームに書き込む。

QTextStream &QTextStream::operator<<(long i)

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

符号付き longi をストリームに書き込む。

QTextStream &QTextStream::operator<<(qlonglong i)

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

qlonglongi をストリームに書き込む。

QTextStream &QTextStream::operator<<(qulonglong i)

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

qulonglongi をストリームに書き込む。

QTextStream &QTextStream::operator<<(unsigned int i)

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

unsigned inti をストリームに書き込む。

QTextStream &QTextStream::operator<<(unsigned long i)

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

符号なし longi をストリームに書き込む。

QTextStream &QTextStream::operator<<(unsigned short i)

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

unsigned shorti をストリームに書き込む。

QTextStream &QTextStream::operator>>(QChar &c)

ストリームから文字を読み取り、それをc に格納する。QTextStream への参照を返すので、複数の演算子を入れ子にすることができる。例

QTextStream in(file);
QChar ch1, ch2, ch3;
in >> ch1 >> ch2 >> ch3;

空白文字はスキップされない。

QTextStream &QTextStream::operator>>(QString &str)

ストリームから単語を読み込んでstr に格納し、ストリームへの参照を返す。単語は空白（つまり、QChar::isSpace() がtrue を返すすべての文字）で区切られる。

先頭の空白はスキップされます。

QTextStream &QTextStream::operator>>(float &f)

ストリームから実数を読み取り、f に格納し、QTextStream への参照を返す。 数値は正しい型にキャストされる。ストリーム上で実数が検出されない場合、f は0.0に設定される。

特別な例外として、QTextStream は、"nan "と "inf "という文字列でNANとINFの浮動小数点数または倍数を表すことができる。

先頭の空白文字はスキップされる。

QTextStream &QTextStream::operator>>(short &i)

ストリームから整数を読み取り、i に格納した後、QTextStream への参照を返します。 数値は、格納される前に正しい型にキャストされます。ストリーム上で数値が検出されなかった場合、i は0に設定されます。

デフォルトでは、QTextStream は、以下のルールを使用して数値の基数を検出しようとします：

setIntegerBase() を呼び出すことにより、整数のベースを明示的に指定することができる。これにより自動検出が無効になり、QTextStream の速度が若干速くなる。

先頭の空白はスキップされる。

QTextStream &QTextStream::operator>>(QByteArray &array)

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

単語を UTF-8 に変換し、array に格納する。

QString::toLatin1()も参照 。

QTextStream &QTextStream::operator>>(char &c)

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

ストリームから文字を読み取り、それをc に格納します。ストリームからの文字は、格納される前に ISO-8859-1 に変換されます。

QChar::toLatin1()も参照してください 。

QTextStream &QTextStream::operator>>(char *c)

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

単語を UTF-8 に変換し、' \0'文字で終端されたc に格納します。単語がない場合は、' \0'文字だけが格納されます。

警告QTextStream は、c がワードを保持するのに十分なスペースを持つバッファを指していると仮定します。バッファが小さすぎると、アプリケーションがクラッシュする可能性があります。n QCharsからなる単語の場合、バッファは少なくとも3*n+1 文字の長さが必要です。

可能であれば、代わりにQByteArray 演算子を使用してください。

[since 6.4] QTextStream &QTextStream::operator>>(char16_t &c)

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

ストリームから文字を読み込み、c に格納します。

この関数は Qt 6.4 で導入されました。

QTextStream &QTextStream::operator>>(double &f)

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

実数を doublef に格納する。

QTextStream &QTextStream::operator>>(int &i)

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

整数を符号付き inti に格納する。

QTextStream &QTextStream::operator>>(long &i)

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

符号付き longi に整数を格納する。

QTextStream &QTextStream::operator>>(qlonglong &i)

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

整数を qlonglongi に格納します。

QTextStream &QTextStream::operator>>(qulonglong &i)

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

整数を qulonglongi に格納します。

QTextStream &QTextStream::operator>>(unsigned int &i)

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

整数を unsigned inti に格納します。

QTextStream &QTextStream::operator>>(unsigned long &i)

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

整数を unsigned longi に格納します。

QTextStream &QTextStream::operator>>(unsigned short &i)

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

整数を unsigned shorti に格納します。