コンテンツ
メソッド
文字列を削除する
対応するregion、endregionプラグインが不足しています。対になるようプラグインを配置してください。
void QString::chop(int n)
文字列の末尾から指定した文字数を切り捨てます。
パラメータ
現在の文字数より大きい値の場合は空の文字列になります。
void QString::clear()
空の文字列になります。
文字数を取得する
対応するregion、endregionプラグインが不足しています。対になるようプラグインを配置してください。
int QString::count() const
int QString::length() const
int QString::size() const
この文字列の文字数を返します。
注意
文字数には末尾のヌル文字は含まれません。
空の文字列かどうか調べる
対応するregion、endregionプラグインが不足しています。対になるようプラグインを配置してください。
bool QString::isNull() const
この文字列が初期化されていない場合はtrue、そうでない場合はfalseを返します。
bool QString::isEmpty() const
この文字列が空の文字列である場合はtrue、そうでない場合はfalseを返します。
文字列を指定した文字で分割する
対応するregion、endregionプラグインが不足しています。対になるようプラグインを配置してください。
QStringList QString::split(const QString & sep, SplitBehavior behavior = KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringList QString::split(QChar sep, SplitBehavior behavior = KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
この文字列を指定した文字列で分割して文字列リストで返します。
パラメータ
- sep 区切り文字
- behavior 分割する際の挙動
|キー|値|説明
QString::KeepEmptyParts |
0 |
空の文字列も返り値のリストに含めます |
QString::SkipEmptyParts |
1 |
空の文字列は返り値のリストには含めません |
返り値
マッチしなかった場合は要素が文字列全体である要素数がひとつの文字列リストを返します。
QStringList QString::split(const QRegExp & rx, SplitBehavior behavior = KeepEmptyParts) const
QStringList QString::split(const QRegularExpression & re, SplitBehavior behavior = KeepEmptyParts) const
区切り文字列の指定を正規表現で行えます。
その他
対応するregion、endregionプラグインが不足しています。対になるようプラグインを配置してください。
void QString::swap(QString & other)
このオブジェクトの文字列を指定したオブジェクトの文字列と交換します。
文字列同士を比較する
対応するregion、endregionプラグインが不足しています。対になるようプラグインを配置してください。
int QString::compare(const QString & s1, const QString & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive) [static]
int QString::compare(const QString & s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive) [static]
int QString::compare(QLatin1String s1, const QString & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive) [static]
int QString::compare(const QString & s1, const QStringRef & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive) [static]
指定した文字列同士を比較します。
パラメータ
- s1 比較対象の文字列1
- s2 比較対象の文字列2
- cs 大文字小文字を区別するかどうか
キー |
値 |
説明 |
Qt::CaseSensitive |
0 |
大文字小文字を区別する |
Qt::CaseSensitive |
1 |
大文字小文字を区別しない |
返り値
|返り値|意味
値<0 |
s1がs2より小さい |
値=0 |
s1とs2が等しい |
値>0 |
s1がs2より大きい |
オーバーロードの一覧
s1 |
s2 |
QString |
QString |
QString |
QLatin1String |
QLatin1String |
QString |
QString |
QStringRef |
int QString::compare(const QString & other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int QString::compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int QString::compare(const QStringRef & ref, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
この文字列と指定した文字列を比較します。
パラメータ
- other 比較対象の文字列
- cs 大文字小文字を区別するかどうか
オーバーロードの一覧
other |
QLatin1String |
QLatin1String |
QStringRef |
int QString::localeAwareCompare(const QString & s1, const QString & s2) [static]
int QString::localeAwareCompare(const QString & s1, const QStringRef & s2) [static]
ロケールやOS依存の仕様に基き、指定した文字列同士を比較します。
パラメータ
- other 比較対象の文字列
- cs 大文字小文字を区別するかどうか
オーバーロードの一覧
s1 |
s2 |
QString |
QString |
QString |
QStringRef |
int QString::localeAwareCompare(const QString & other) const
int QString::localeAwareCompare(const QStringRef & other) const
ロケールやOS依存の仕様に基き、この文字列と指定した文字列を比較します。
パラメータ
- other 比較対象の文字列
- cs 大文字小文字を区別するかどうか
オーバーロードの一覧
bool QString::operator!=(QLatin1String other) const
bool QString::operator!=(const QByteArray & other) const
bool QString::operator!=(const char * other) const
この文字列と指定した文字列が異なる場合はtrue、そうでない場合はfalseを返します。
bool QString::operator==(const QByteArray & other) const
bool QString::operator==(const char * other) const
この文字列と指定した文字列が等しい場合はtrue、そうでない場合はfalseを返します。
bool QString::operator>(QLatin1String other) const
bool QString::operator>(const QByteArray & other) const
bool QString::operator>(const char * other) const
この文字列より指定した文字列の方が大きい場合はtrue、そうでない場合はfalseを返します。
bool QString::operator>=(QLatin1String other) const
bool QString::operator>=(const QByteArray & other) const
bool QString::operator>=(const char * other) const
この文字列より指定した文字列の方が大さい場合はtrue、そうでない場合はfalseを返します。
bool QString::operator<(QLatin1String other) const
bool QString::operator<(const QByteArray & other) const
bool QString::operator<(const char * other) const
この文字列より指定した文字列の方が小きい場合はtrue、そうでない場合はfalseを返します。
bool QString::operator<=(QLatin1String other) const
bool QString::operator<=(const QByteArray & other) const
bool QString::operator<=(const char * other) const
この文字列より指定した文字列の方が小きい場合はtrue、そうでない場合はfalseを返します。
QByteArray 及び char を引数にとる関数について
バイト配列からUnicodeへの変換には fromUtf8() が使用されます。
QT_NO_CAST_FROM_ASCII マクロを定義することで、この関数を無効にできます。
非メンバ関数
bool operator!=(const char * s1, const QString & s2)
bool operator==(const char * s1, const QString & s2)
bool operator<(const char * s1, const QString & s2)
bool operator<=(const char * s1, const QString & s2)
bool operator>(const char * s1, const QString & s2)
bool operator>=(const char * s1, const QString & s2)
指定した文字列同士を比較します。
他の型から QString オブジェクトを生成する
[[QString]] QString::fromCFString(CFStringRef string) [static]
CF文字列をQString文字列に変換します。
パラメータ
注意
この関数はMacOS及びiOSでのみ対応しています。
QString QString::fromLatin1(const char * str, int size = -1) [static]
Latin1文字列をQString文字列に変換します。
パラメータ
- str 変換する文字列
- size str の文字数 (デフォルト: 文字列全体)
- 1の場合は文字列全体になります。
QString QString::fromLatin1(const QByteArray & str) [static]
Latin1文字列をQString文字列に変換します。
パラメータ
QString QString::fromLocal8Bit(const char * str, int size = -1) [static]
8bit文字列をQString文字列に変換します。
パラメータ
- str 変換する文字列
- size str の文字数 (デフォルト: 文字列全体)
- 1の場合は文字列全体になります。
QString QString::fromLocal8Bit(const QByteArray & str) [static]
8bit文字列をQString文字列に変換します。
パラメータ
QString QString::fromNSString(const NSString * string) [static]
NS文字列をQString文字列に変換します。
パラメータ
注意
この関数はMacOS及びiOSでのみ対応しています。
QString QString::fromRawData(const [[QChar]] * unicode, int size) [static]
Unicode文字列をQString文字列に変換します。
パラメータ
- unicode 文字列
- size unicode の文字数
注意
渡される unicode はコピーされないため、このオブジェクトが存在する間は変更及び削除してはいけません。
このオブジェクトで編集やコピーを行った場合はディープコピーが生成されるので、unicode の値が変わることはありません。
このオブジェクトの中身を unicode() などで取得した場合、終端はヌル文字で終わりません。
QString QString::fromStdString(const std::string & str) [static]
std::string文字列をQString文字列に変換します。
変換には fromUtf8() が使用されます。
パラメータ
注意
この関数はQtの設定でSTL互換性を有効にしていた場合のみ利用できます。
QString QString::fromStdWString(const std::wstring & str) [static]
std::wstring文字列をQString文字列に変換します。
パラメータ
注意
指定文字列はWindows環境ではUTF16、Unix環境ではUCS4であると仮定します。
QString QString::fromUcs4(const uint * unicode, int size = -1) [static]
UCS4文字列をQString文字列に変換します。
パラメータ
- unicode 文字列
- size unicode の文字数
- 1の場合、unicode はヌル終端文字でなければなりません。
QString QString::fromUtf8(const char * str, int size = -1) [static]
UTF8文字列をQString文字列に変換します。
パラメータ
QString QString::fromUtf8(const QByteArray & str) [static]
UTF8文字列をQString文字列に変換します。
パラメータ
QString QString::fromUtf16(const ushort * unicode, int size = -1) [static]
UTF8文字列をQString文字列に変換します。
パラメータ
この文字列はディープコピーされます。
注意
この関数はBOMを解析し、バイトオーダーを決定します。
解析に失敗した場合はホストコンピューターのバイトオーダーで仮定します。
QString QString::fromWCharArray(const wchar_t * string, int size = -1) [static]
wchar_t文字列をQString文字列に変換します。
パラメータ
CFStringRef QString::toCFString() const
この文字列をCF文字列に変換します。
注意
この関数はMacOS及びiOSでのみ対応しています。
double QString::toDouble(bool * ok = 0) const
この文字列をdouble型に変換します。
パラメータ
返り値
失敗した場合は0を返します。
注意
Cロケールに従います。
float QString::toFloat(bool * ok = 0) const
この文字列をfloat型に変換します。
パラメータ
返り値
失敗した場合は0を返します。
注意
Cロケールに従います。
int QString::toInt(bool * ok = 0, int base = 10) const
uint QString::toUInt(bool * ok = 0, int base = 10) const
short QString::toShort(bool * ok = 0, int base = 10) const
ushort QString::toUShort(bool * ok = 0, int base = 10) const
long QString::toLong(bool * ok = 0, int base = 10) const
ulong QString::toULong(bool * ok = 0, int base = 10) const
qlonglong QString::toLongLong(bool * ok = 0, int base = 10) const
qulonglong QString::toULongLong(bool * ok = 0, int base = 10) const
この文字列を整数型に変換します。
パラメータ
- ok 変換結果を格納する
- base 文字列の数字が何進数か
0の場合、C言語の表記が使用されます。
- この文字列が0xから始まる場合は16進数として扱われます。
- この文字列が0から始まる場合は8進数として扱われます。
- それ以外の場合は10進数として扱われます。
返り値
失敗した場合は0を返します。
QByteArray QString::toLatin1() const
この文字列をLatin1文字列に変換します。
返り値
この文字列にLatin1文字以外が含まれていた場合の返されるバイト配列の中身が未定義です。
こういった文字は?マークに置き換えられるでしょう。
QByteArray QString::toLocal8Bit() const
この文字列を8bit文字列に変換します。
変換には QTextCodec::codecForLocale() が使用されます。
ロケール設定がされていない場合は toLatin1() と同じになります。
返り値
この文字列に8bit文字以外が含まれていた場合の返されるバイト配列の中身が未定義です。
NSString * QString::toNSString() const
この文字列をNS文字列に変換します。
注意
この関数はMacOS及びiOSでのみ対応しています。
std::string QString::toStdString() const
この文字列をstd::string文字列に変換します。
std::wstring QString::toStdWString() const
この文字列をstd::wstring文字列に変換します。
QVector<uint> QString::toUcs4() const
UCS-4/UTF-32表現の文字列を QVector<uint> で返します。
QByteArray QString::toUtf8() const
この文字列をUTF8文字列に変換します。
int QString::toWCharArray(wchar_t * array) const
?
文字列を設定する
QString & QString::setNum(int n, int base = 10)
QString & QString::setNum(uint n, int base = 10)
QString & QString::setNum(short n, int base = 10)
QString & QString::setNum(ushort n, int base = 10)
QString & QString::setNum(long n, int base = 10)
QString & QString::setNum(ulong n, int base = 10)
QString & QString::setNum(qlonglong n, int base = 10)
QString & QString::setNum(qulonglong n, int base = 10)
整数を指定した表示形式でこの文字列に設定します。
パラメータ
- n 整数
- base 表示形式 (何進数で表示するか)
オーバーロード
整数の型 |
int |
uint |
short |
ushort |
long |
ulong |
qlonglong |
qulonglong |
QString & QString::setNum(double n, char format = 'g', int precision = 6)
QString & QString::setNum(float n, char format = 'g', int precision = 6)
小数を指定した表示形式でこの文字列に設定します。
パラメータ
- double 小数
- format 表示形式
- precision 小数部分を何桁で表示するか
注意
表示形式には常に QLocale::C を使用します。
オーバーロード
QString QString::number(int n, int base = 10) [static]
QString QString::number(uint n, int base = 10) [static]
QString QString::number(long n, int base = 10) [static]
QString QString::number(ulong n, int base = 10) [static]
QString QString::number(qlonglong n, int base = 10) [static]
QString QString::number(qulonglong n, int base = 10) [static]
整数を指定した表示形式の文字列で返します。
パラメータ
- n 整数
- base 表示形式 (何進数で表示するか)
オーバーロード
整数の型 |
int |
uint |
long |
ulong |
qlonglong |
qulonglong |
QString QString::number(double n, char format = 'g', int precision = 6) [static]
小数を指定した表示形式でこの文字列に設定します。
パラメータ
- double 小数
- format 表示形式
- precision 小数部分を何桁で表示するか
注意
表示形式には常に QLocale::C を使用します。
QString & QString::setRawData(const QChar * unicode, int size)
指定文字列を設定します。
パラメータ
- unicode 文字列
- size unicode の文字数
注意
渡される unicode はコピーされないため、このオブジェクトが存在する間は変更及び削除してはいけません。
既にある QString オブジェクトを利用する場合にメモリを節約するのにこの関数を利用できます。
QString & QString::setUnicode(const QChar * unicode, int size)
指定文字数にリサイズした後、指定文字列をコピーして設定します。
パラメータ
- unicode 文字列
- size リサイズ後の文字数
unicode がNULLの場合、コピーは行われませんが、リサイズは行われます。
QString & QString::setUtf16(const ushort * unicode, int size)
指定文字数にリサイズした後、指定文字列をコピーして設定します。
パラメータ
- unicode 文字列
- size リサイズ後の文字数
unicode がNULLの場合、コピーは行われませんが、リサイズは行われます。
注意
fromUtf16() と異なり、BOMや異なるバイトオーダーは対応していません。
最終更新:2014年08月30日 13:18