QString

コンテンツ

クラス名

QStringクラスはUnicode文字列を表します。
内部で各文字は16ビットのQCharとして保存されます。
公式リファレンス

継承関係

なし

メンバ関数

コンストラクタ

表示

QString::QString()
空の QString オブジェクトを生成します。

---

QString::QString(const QChar * unicode, int size = -1)

指定した文字列で初期化した QString オブジェクトを生成します。

パラメータ

• unicode 文字列

0である場合は空の QString オブジェクトを生成します。

• size

文字数を指定する
負の値を指定した場合はヌル文字までとなります。

注意

末尾のヌル文字は生成する QString オブジェクトに含まれません。

---

QString::QString(QChar ch)

指定した文字で初期化した QString オブジェクトを生成します。

パラメータ

• ch 文字

---

QString::QString(int size, QChar ch)

指定した文字数を指定した文字で埋めて初期化した QString オブジェクトを生成します。

パラメータ

• size 文字数
• ch 使用する文字

---

QString::QString(QLatin1String str)

指定した文字列で初期化した QString オブジェクトを生成します。

パラメータ

• str 文字列

---

QString::QString(const char * str)

指定した文字列で初期化した QString オブジェクトを生成します。

パラメータ

• str 文字列

注意

8bitのchar型文字列からUnicodeへの変換には fromUtf8() が使用されます。
QT_NO_CAST_FROM_ASCII マクロを定義することで、このコンストラクタを無効にできます。

---

QString::QString(const QByteArray & ba)

指定した文字列で初期化した QString オブジェクトを生成します。

パラメータ

• ba 文字列

注意

バイト配列からUnicodeへの変換には fromUtf8() が使用されます。
最初のヌル文字までコピーします。ヌル文字が含まれない場合はバイト配列全体をコピーします。
QT_NO_CAST_FROM_ASCII マクロを定義することで、このコンストラクタを無効にできます。

コピーコンストラクタ

表示

QString::QString(const QString & other)

パラメータ

• other コピー元

注意

QString クラスはコピーオンライトを使用しています。
暗黙の共有参考

ムーブコンストラクタ

表示

QString::QString(QString && other)

デストラクタ

表示

QString::~QString()

先頭に文字列を追加する

表示

QString & QString::prepend(const QString & str)
この文字列の先頭に指定した文字列を追加します。

パラメータ

• str 追加する文字列

---

QString & QString::prepend(QLatin1String str)

この文字列の先頭に指定した文字列を追加します。

パラメータ

• str 追加する文字列

---

QString & QString::prepend(const QByteArray & ba)

この文字列の先頭に指定した文字列を追加します。

パラメータ

• ba 追加する文字列

注意

バイト配列からUnicodeへの変換には fromUtf8() が使用されます。
QT_NO_CAST_FROM_ASCII マクロを定義することで、この関数を無効にできます。

---

QString & QString::prepend(const char * str)

この文字列の先頭に指定した文字列を追加します。

パラメータ

• str 追加する文字列

注意

バイト配列からUnicodeへの変換には fromUtf8() が使用されます。
QT_NO_CAST_FROM_ASCII マクロを定義することで、この関数を無効にできます。

---

QString & QString::prepend(QChar ch)

この文字列の末尾に指定した文字を追加します。

パラメータ

• ch 追加する文字

---

void QString::push_front(const QString & other)

この文字列の末尾に指定した文字列を追加します。
STLとの互換性のための関数です。

パラメータ

• str 追加する文字列

---

void QString::push_front(QChar ch)

この文字列の末尾に指定した文字を追加します。

パラメータ

• ch 追加する文字

末尾に文字列を追加する

表示

QString & QString::append(const QString & str)
この文字列の末尾に指定した文字列を追加します。

パラメータ

• str 追加する文字列

---

QString & QString::append(const QStringRef & reference)

この文字列の末尾に指定した文字列を追加します。

パラメータ

• reference 追加する文字列

---

QString & QString::append(const QChar * str, int len)

この文字列の末尾に指定した文字列を追加します。

パラメータ

• size 文字数
• ch 使用する文字

---

QString & QString::append(QLatin1String str)

この文字列の末尾に指定した文字列を追加します。

パラメータ

• str 追加する文字列

---

QString & QString::append(const QByteArray & ba)

この文字列の末尾に指定した文字列を追加します。

パラメータ

• ba 追加する文字列

注意

バイト配列からUnicodeへの変換には fromUtf8() が使用されます。
QT_NO_CAST_FROM_ASCII マクロを定義することで、この関数を無効にできます。

---

QString & QString::append(const char * str)

この文字列の末尾に指定した文字列を追加します。

パラメータ

• str 追加する文字列

注意

バイト配列からUnicodeへの変換には fromUtf8() が使用されます。
QT_NO_CAST_FROM_ASCII マクロを定義することで、この関数を無効にできます。

---

QString & QString::append(QChar ch)

この文字列の末尾に指定した文字を追加します。

パラメータ

• ch 追加する文字

---

void QString::push_back(const QString & other)

この文字列の末尾に指定した文字列を追加します。
STLとの互換性のための関数です。

パラメータ

• str 追加する文字列

---

void QString::push_back(QChar ch)

この文字列の末尾に指定した文字を追加します。

パラメータ

• ch 追加する文字

文字列をフォーマットする

表示

QString QString::arg(const QString & a, int fieldWidth = 0, QChar fillChar = QLatin1Char( ' ' )) const

QString QString::arg(QChar a, int fieldWidth = 0, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(char a, int fieldWidth = 0, QChar fillChar = QLatin1Char( ' ' )) const

この文字列の最も小さい番号の置換マーカーを指定した文字で置換した文字列を返します。

置換マーカーとは

%1、%2、…、%99で指定する置換する目印です。
置換マーカーの数は最大99個です。

パラメータ

• a 置換後の文字列
• fieldWidth 置換後の文字幅

置換後の文字列が指定した文字幅未満の場合、指定した文字で埋めます。
正の値を指定した場合は右詰め、負の値を指定した場合は左詰めになります。

• fillChar に余白を埋める文字

注意

置換マーカーがない存在しない場合は、警告が表示されます。
その場合の結果は未定義です。

---

QString QString::arg(const QString & a1, const QString & a2) const
QString QString::arg(const QString & a1, const QString & a2, const QString & a3) const
QString QString::arg(const QString & a1, const QString & a2, const QString & a3, const QString & a4) const
QString QString::arg(const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5) const
QString QString::arg(const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6) const
QString QString::arg(const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7) const
QString QString::arg(const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7, const QString & a8) const
QString QString::arg(const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7, const QString & a8, const QString & a9) const

一度に複数の置換マーカーを指定した文字で置換できます。

---

QString QString::arg(int a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(uint a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(long a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(long a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(ulong a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(qlonglong a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(qulonglong a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(short a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const
QString QString::arg(ushort a, int fieldWidth = 0, int base = 10, QChar fillChar = QLatin1Char( ' ' )) const

置換後の文字が整数の場合はこの関数を使用して指定した書式で置換できます。

パラメータ

• a 置換後の数字
• fieldWidth 置換した後の文字幅 正の値を指定した場合は右詰め、負の値を指定した場合は左詰め
• base 進数

デフォルトは10 2～36で指定

• fieldWidth 置換後の文字幅

置換後の文字列が指定した文字幅未満の場合、指定した文字で埋めます。
正の値を指定した場合は右詰め、負の値を指定した場合は左詰めになります。

• fillChar に余白を埋める文字

0(数字のゼロ)を指定した場合はロケールの0を使用します。
負の値では-符号の前に0で埋めます。

Lフラグ

%L1というように表記すると、数字はローカル表記になります。
ローカル表記への変換は QLocale::setDefault() を使用して設定されたデフォルトのロケール設定を使用します。
ロケールが設定されていない場合はCのロケールが使用されます。
Lフラグは10進表記以外では無視されます。

---

QString QString::arg(double a, int fieldWidth = 0, char format = 'g', int precision = -1, QChar fillChar = QLatin1Char( ' ' )) const

置換後の文字が実数の場合はこの関数を使用して指定した書式で置換できます。

パラメータ

• a 置換後の数字
• fieldWidth 置換後の文字幅

置換後の文字列が指定した文字幅未満の場合、指定した文字で埋めます。
正の値を指定した場合は右詰め、負の値を指定した場合は左詰めになります。

• format 書式

書式	値
e	[-]9.9e[+｜-]999
E	[-]9.9E[+｜-]999
f	[-]9.9
g	eまたはf 簡潔に表せる方を選択
G	Eまたはf 簡潔に表せる方を選択

• precision 小数点何桁まで表示するか
• fillChar に余白を埋める文字

0(数字のゼロ)を指定した場合はロケールの0を使用します。
負の値では-符号の前に0で埋めます。

Lフラグ

%L1というように表記すると、数字はローカル表記になります。
ローカル表記への変換は QLocale::setDefault() を使用して設定されたデフォルトのロケール設定を使用します。
ロケールが設定されていない場合はCのロケールが使用されます。

---

QString & QString::sprintf(const char * cformat, ...)

置換マーカーを指定した文字で置換してフォーマットした文字列を返します。

パラメータ

• cformat

QString & QString::vsprintf(const char * cformat, va_list ap)

置換マーカーを指定した文字で置換してフォーマットした文字列を返します。

パラメータ

• cformat 置換マーカーを含む文字列
• va_list ap

文字列を取得する

表示

const QChar QString::at(int position) const
この文字列の指定したインデックスの文字を返します。

パラメータ

• position インデックス

インデックスは有効な範囲でなければなりません。 ( 0 <= position < size() )

---

QCharRef QString::operator[](int position)
QCharRef QString::operator[](uint position)

この文字列の指定したインデックスの文字を返します。
QCharRef は QChar& のように使用できるヘルパークラスで、この返されたオブジェクトに変更を加えると、QString オブジェクトの方にも変更が反映されます。

---

const QChar QString::operator[](int position) const
const QChar QString::operator[](uint position) const

この文字列の指定したインデックスの文字を返します。

---

iterator QString::begin()
const_iterator QString::begin() const
const_iterator QString::cbegin() const

文字列の先頭を指すSTLスタイルのイテレータを返します。

---

iterator QString::end()
const_iterator QString::end() const
const_iterator QString::cend() const

文字列の末尾を指すSTLスタイルのイテレータを返します。

---

const QChar * QString::constData() const
const QChar * QString::data() const
QChar * QString::data()

このオブジェクトに保存されている文字列に対するポインタを返します。

返り値

末尾はヌル文字です。

注意

返されるポインタはこのオブジェクトが破棄または修正されるまで有効です。

---

const QChar * QString::unicode() const

このオブジェクトに保存されているUnicode表現の文字列に対するポインタを返します。

返り値

末尾はヌル文字です。

注意

返されるポインタはこのオブジェクトが破棄または修正されるまで有効です。

---

const ushort * QString::utf16() const

このオブジェクトに保存されている文字列を末尾がヌル文字であるunsigned shorts配列に対するポインタで返します。

返り値

末尾はヌル文字です。

注意

返されるポインタはこのオブジェクトが破棄または修正されるまで有効です。