QLatin1StringView Class

メンバ関数ドキュメント

この文字列ビューを UTF-16 文字列ビューstr 、 Latin-1 文字列ビューl1 、または文字ch とそれぞれ比較します。この文字列がstr 、l1 またはch より小さい場合は負の整数を返し、str 、l1 またはch より大きい場合は正の整数を返し、等しい場合はゼロを返します。

cs がQt::CaseSensitive (デフォルト) の場合、検索は大文字小文字を区別し、それ以外の場合、検索は大文字小文字を区別しない。

operator==()、operator<()、operator>()も参照 。

この Latin-1 文字列ビューが、str で表示される UTF-16 文字列、l1 で表示される Latin-1 文字列、またはch で表示される文字列でそれぞれ始まる場合はtrue を返し、そうでない場合はfalse を返す。

cs がQt::CaseSensitive （デフォルト）の場合、検索は大文字小文字を区別します。

endsWith()も参照 。

falseこの Latin-1 文字列ビューが、閲覧した UTF-16 文字列str 、閲覧した Latin-1 文字列l1 、または文字ch でそれぞれ終了する場合、true を返します。

cs がQt::CaseSensitive の場合（デフォルト）、検索は大文字小文字を区別します。

startsWith()も参照 。

この Latin-1 文字列ビューにおいて、インデックス位置from から順に検索して、それぞれstr が示す UTF-16 文字列、l1 が示す Latin-1 文字列、またはch が示す文字が最初に出現するインデックス位置を返します。str 、l1 、c がそれぞれ見つからなければ -1 を返す。

cs がQt::CaseSensitive （デフォルト）の場合、検索は大文字小文字を区別する。

from が -1 の場合、検索は最後の文字から始まり、-2 の場合、最後から次の文字から始まる。

QString::indexOf()も参照 。

この Latin-1 文字列ビューに、str で見た UTF-16 文字列、l1 で見た Latin-1 文字列、ch で見た文字がそれぞれ含まれている場合はtrue を返し、そうでない場合はfalse を返す。

cs がQt::CaseSensitive （デフォルト）の場合、検索は大文字小文字を区別する。

indexOf()、QStringView::contains()、QStringView::indexOf()、QString::indexOf()も参照 。

この Latin-1 文字列ビューにおいて、str が示す UTF-16 文字列、l1 が示す Latin-1 文字列、またはch が示す文字列が最後に出現したインデックスの位置を、それぞれfrom からさかのぼって返します。str 、l1 、ch がそれぞれ見つからなかった場合は -1 を返します。

from が -1 の場合、検索は最後の文字から始まり、-2 の場合、最後から次の文字から始まる。

cs がQt::CaseSensitive （デフォルト）の場合、検索は大文字小文字を区別する。

indexOf()、QStringView::lastIndexOf()、QStringView::indexOf()、QString::indexOf()も参照 。

この関数はlastIndexOf() をオーバーロードしたものである。

この Latin-1 文字列ビューにおいて、str が表示する UTF-16 文字列、またはl1 が表示する Latin-1 文字列が最後に出現するインデックスの位置を返します。それぞれstr またはl1 が見つからない場合は -1 を返す。

cs がQt::CaseSensitive の場合（デフォルト）、検索は大文字小文字を区別します。

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

この文字列ビューで、str が見ている UTF-16 文字列、l1 が見ている Latin-1 文字列、またはch が見ている文字の（重複している可能性のある）出現回数をそれぞれ返します。

cs がQt::CaseSensitive の場合（デフォルト）、検索は大文字小文字を区別します。

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

contains() およびindexOf()も参照してください 。

このQLatin1StringView を、デフォルトでは 10 である基数base を用いて、対応する数値に変換して返します。基数 0 および 2 から 36 までがサポートされており、9 を超える数字には文字が使われます。

base が 0 の場合、基数は以下の規則（この順序）で自動的に決定される：

• "0x"で始まる場合、残りは16進数（ベース16）として読み込まれます。
• "0b"残りは2進数（基数2）として読まれます。
• "0"それ以外は8進数（ベース8）として読みます。
• それ以外は10進数として読み込まれる

変換に失敗した場合は0を返す。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾のスペーシング文字を無視する。

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

このQLatin1StringView を対応する浮動小数点値に変換して返します。

変換がオーバーフローした場合は無限大を返し、その他の理由（例えばアンダーフロー）で変換に失敗した場合は0.0を返します。

ok がnullptr でない場合、失敗は *ok をfalse に設定することで報告され、成功は *ok をtrue に設定することで報告される。

この関数は、先頭と末尾のスペーシング文字を無視します。

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

template <typename... Args> QString QLatin1StringView::arg(Args &&... args) const

この文字列内の%N を、args の対応する引数で置き換えます。引数は位置指定ではありません:args の最初の引数は%N を最も低いN (すべて) で置き換え、args の 2 番目の引数は%N を次に低いN で置き換えます。

Args は、暗黙のうちに 、 、 に変換するものであれば何でも構わない。QString QStringView QLatin1StringView

さらに、以下の型もサポートされている：QChar QLatin1Char 。

QString::arg()も参照のこと 。

[constexpr noexcept(...), since 6.0] template <typename Needle, typename... Flags> auto QLatin1StringView::tokenize(Needle &&sep, Flags... flags) const

sep が出現する箇所で文字列を部分文字列ビューに分割し、それらの文字列の遅延シーケンスを返します。

と同等です。

return QStringTokenizer{std::forward<Needle>(sep), flags...};

ただし、コンパイラで C++17 CTAD（Class Template Argument Deduction）が有効になっていなくても動作します。

sep とflags がどのように相互作用して結果を形成するかについては、QStringTokenizer を参照してください。

QStringTokenizer result = sv.tokenize(sep);

(と書くことができます（テンプレート引数なし）。C++17 CTAD を使用できない場合は、auto 変数にのみ戻り値を格納する必要があります：

auto result = sv.tokenize(sep);

これは、QStringTokenizer のテンプレート引数は、それが返される特定のtokenize() オーバーロードに非常に微妙に依存し、通常はセパレーターに使用される型に対応しないからです。

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

QStringTokenizer およびqTokenize()も参照してください 。

[constexpr noexcept] QLatin1StringView::QLatin1StringView()

nullptr を格納するQLatin1StringViewオブジェクトを構築する。

data()、isEmpty()、isNull() およびDistinction Between Null and Empty Strings も参照 。

[explicit constexpr noexcept, since 6.3] QLatin1StringView::QLatin1StringView(QByteArrayView str)

str のビューとして QLatin1StringView オブジェクトを構築します。

文字列データはコピーされません。呼び出し元は、QLatin1StringView オブジェクトが存在する限り、str が指すデータが削除されたり変更されたりしないことを保証できなければならない。サイズは、ヌル・ターミネータをチェックせずに、そのままstr から取得されます。

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

latin1()も参照してください 。

[explicit noexcept] QLatin1StringView::QLatin1StringView(const QByteArray &str)

str のビューとして QLatin1StringView オブジェクトを構築します。

文字列データはコピーされません。呼び出し元は、QLatin1StringView オブジェクトが存在する限り、str が削除または変更されないことを保証できなければなりません。

latin1()も参照 。

[explicit constexpr noexcept] QLatin1StringView::QLatin1StringView(const char *str)

str を格納する QLatin1StringView オブジェクトを構築する。

文字列データはコピーされない。呼び出し元は、QLatin1StringView オブジェクトが存在する限り、str が削除または変更されないことを保証できなければならない。

latin1()も参照 。

[constexpr noexcept, since 6.4] QLatin1StringView::QLatin1StringView(std::nullptr_t)

nullptr を格納する QLatin1StringView オブジェクトを構築する。

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

data()、isEmpty()、isNull() およびDistinction Between Null and Empty Stringsも参照して ください。

[constexpr] QLatin1StringView::QLatin1StringView(const char *first, const char *last)

長さ (last -first) のfirst を格納する QLatin1StringView オブジェクトを構築します。

[first,last) の範囲は、このLatin-1文字列オブジェクトの有効期間中有効でなければなりません。

nullptr をfirst として渡しても、last がnullptr であれば安全です。

last がfirst より前で、first がnullptr で、last がそうでない場合、またはlast - first > INT_MAX がそうでない場合の動作は未定義です。

[constexpr noexcept] QLatin1StringView::QLatin1StringView(const char *str, qsizetype size)

size とともにstr を格納する QLatin1StringView オブジェクトを構築します。

文字列データはコピーされない。呼び出し元は、QLatin1StringView オブジェクトが存在する限り、str が削除または変更されないことを保証できなければなりません。

latin1()も参照してください 。

[constexpr] QLatin1Char QLatin1StringView::at(qsizetype pos) const

このオブジェクトの位置pos にある文字を返します。

operator[]()も参照のこと 。

[constexpr] QLatin1Char QLatin1StringView::back() const

文字列の最後の文字を返す。at(size() - 1) と同じ。

この関数は STL との互換性のために提供されている。

front()、at()、operator[]()も参照 。

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::begin() const

文字列の最初の文字を指す constSTL 形式のイテレータを返します。

この関数は、STL との互換性のために提供されています。

end()、cbegin()、rbegin()、data()も参照 。

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::cbegin() const

begin() と同じ。

この関数は STL との互換性のために用意されています。

cend()、begin()、crbegin()、data()も 参照。

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::cend() const

end() と同じ。

この関数は STL との互換性のために用意されています。

cbegin()、end()、およびcrend() も参照 。

[constexpr] void QLatin1StringView::chop(qsizetype length)

この文字列をlength 文字分切り捨てます。

*this = left(size() - length) と同じ。

sliced()、first()、last()、chopped()、truncate()、slice()も参照 。

[constexpr] QLatin1StringView QLatin1StringView::chopped(qsizetype length) const

このオブジェクトの先頭から始まる、長さsize() -length の部分文字列を返します。

left(size() - length) と同じ。

sliced()、first()、last()、chop()、truncate()、slice()も参照 。

[noexcept, since 6.5] int QLatin1StringView::compare(QUtf8StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

この文字列ビューをstr と比較し、str より小さい場合は負の整数、str より大きい場合は正の整数、等しい場合は 0 を返す。

cs がQt::CaseSensitive の場合（デフォルト）、比較は大文字小文字を区別します。

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

operator==(),operator<(),operator>()も参照してください 。

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constBegin() const

begin() と同じです。

この関数は、他の Qt コンテナとの互換性のために提供されています。

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

constEnd()、begin()、cbegin()、data()も参照してください 。

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constData() const

このオブジェクトが参照する Latin-1 文字列の開始位置を返します。

この関数は、他の Qt コンテナとの互換性のために提供されています。

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

data()も参照してください 。

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constEnd() const

end() と同じ。

この関数は、他の Qt コンテナとの互換性のために提供されています。

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

constBegin()、end()、cend()、crend()も参照して ください。

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::crbegin() const

rbegin() と同じ。

この関数は STL との互換性のために提供されています。

crend()、rbegin()、cbegin()も 参照。

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::crend() const

rend() と同じ。

この関数は STL との互換性のために用意されています。

crbegin()、rend()、cend() も参照 。

[constexpr noexcept] const char *QLatin1StringView::data() const

このオブジェクトが参照する Latin-1 文字列の開始位置を返します。

[constexpr noexcept, since 6.4] bool QLatin1StringView::empty() const

このオブジェクトが参照する Latin-1 文字列が空（size() == 0 ）かどうかを返します。

この関数はSTLとの互換性のために提供されています。

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

isEmpty(),isNull(),size()も参照してください 。

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::end() const

文字列の最後の文字の直後を指す、STL 形式のイテレータを返します。

この関数は、STLとの互換性のために提供されています。

begin()、cend()、rend()も参照 。

[constexpr, since 6.4] QLatin1Char QLatin1StringView::first() const

文字列の最初の文字を返します。at(0) またはfront() と同じ。

この関数は、他の Qt コンテナとの互換性のために用意されています。

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

last(),front(),back()も参照してください 。

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::first(qsizetype n) const

この文字列ビューの最初のn 文字を含む Latin-1 文字列ビューを返します。

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

last(),startsWith(),chopped(),chop(),truncate(),slice()も参照してください 。

[constexpr] QLatin1Char QLatin1StringView::front() const

文字列の最初の文字を返します。at(0) と同じ。

この関数は STL との互換性のために用意されています。

back()、at()、operator[]()も参照してください 。

[constexpr noexcept] bool QLatin1StringView::isEmpty() const

このオブジェクトが参照する Latin-1 文字列が空文字列 (size() == 0) かどうかを返します。

isNull() およびsize()も参照 。

[constexpr noexcept] bool QLatin1StringView::isNull() const

このオブジェクトが参照する Latin-1 文字列が null (data() == nullptr) かどうかを返します。

isEmpty() およびdata()も参照 。

[constexpr, since 6.4] QLatin1Char QLatin1StringView::last() const

文字列の最後の文字を返します。at(size() - 1) またはback() と同じ。

この関数は、他の Qt コンテナとの互換性のために用意されています。

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

first(),back(),front()も参照してください 。

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::last(qsizetype n) const

この文字列ビューの最後のn 文字を含む Latin-1 文字列ビューを返します。

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

first(),endsWith(),chopped(),chop(),truncate(),slice()も参照してください 。

[noexcept, since 6.3] qsizetype QLatin1StringView::lastIndexOf(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

[constexpr noexcept] const char *QLatin1StringView::latin1() const

このオブジェクトが参照する Latin-1 文字列の開始位置を返します。

[constexpr] QLatin1StringView QLatin1StringView::left(qsizetype length) const

length が範囲外であってはならないことが分かっている場合、新しいコードではfirst() を代わりに使用してください。

この Latin-1 文字列ビューの位置 0 から始まる長さlength の部分文字列を返します。

length がsize() 以上、または 0 未満の場合は、Latin-1 文字列ビュー全体が返されます。

first()、last()、sliced()、startsWith()、chopped()、chop()、truncate()、slice()も参照のこと 。

[constexpr noexcept, since 6.4] qsizetype QLatin1StringView::length() const

size() と同じ。

この関数は、他の Qt コンテナとの互換性のために提供されています。

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

[static constexpr noexcept, since 6.8] qsizetype QLatin1StringView::maxSize()

この関数は、文字列ビューが理論的に表現できる要素の最大数を返します。実際には、システムで利用可能なメモリ量によって制限されるため、もっと少ない数になることがあります。

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

[constexpr noexcept, since 6.8] qsizetype QLatin1StringView::max_size() const

この関数はSTLとの互換性のために提供されています。

maxSize() を返します。

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

[constexpr] QLatin1StringView QLatin1StringView::mid(qsizetype start, qsizetype length = -1) const

この Latin-1 文字列ビューの位置start から始まる長さlength の部分文字列を返します。

start とlength が範囲外であってはならないことがわかっている場合、新しいコードではsliced() を代わりに使ってください。

start がこの文字列ビューの長さを超える場合は、空の Latin-1 文字列ビューを返します。この文字列ビューで使用可能な文字がstart から始まるlength 未満の場合、またはlength が負（デフォルト）の場合、この関数はstart から使用可能なすべての文字を返します。

first()、last()、sliced()、chopped()、chop()、truncate()、slice()も参照 。

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::rbegin() const

文字列の最初の文字を逆順で指す constSTL 形式の逆順イテレータを返します。

この関数は、STL との互換性のために提供されています。

rend()、crbegin()、begin()も参照 。

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::rend() const

STL 形式の逆順イテレータは、文字列の最後の文字の直後を指します。

この関数は、STL との互換性のために用意されています。

rbegin()、crend()、end()も参照 。

[constexpr] QLatin1StringView QLatin1StringView::right(qsizetype length) const

length が範囲外であってはならないことが分かっている場合、新しいコードではlast() を代わりに使用する。

この Latin-1 文字列ビューの位置size() -length から始まる長さlength の部分文字列を返します。

length がsize() 以上、または 0 以下の場合は、Latin-1 文字列ビュー全体が返されます。

first()、last()、sliced()、endsWith()、chopped()、chop()、truncate()、slice()も参照のこと 。

[constexpr noexcept] qsizetype QLatin1StringView::size() const

このオブジェクトが参照する Latin-1 文字列のサイズを返します。

[constexpr, since 6.8] QLatin1StringView &QLatin1StringView::slice(qsizetype pos)

この Latin-1 文字列ビューをpos の位置から開始するように変更します。

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

sliced(),first(),last(),chopped(),chop(),truncate()も参照してください 。

[constexpr, since 6.8] QLatin1StringView &QLatin1StringView::slice(qsizetype pos, qsizetype n)

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

この Latin-1 文字列ビューをpos の位置から開始するように変更し、n 文字用に拡張します。

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

sliced(),first(),last(),chopped(),chop(),truncate()も参照してください 。

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::sliced(qsizetype pos) const

Latin-1 文字列ビューを、この文字列ビューの位置pos から始まり、その終わりまで拡張して返します。

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

first(),last(),chopped(),chop(),truncate(),slice()も参照してください 。

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::sliced(qsizetype pos, qsizetype n) const

この文字列ビューのpos の位置から始まるn 文字を指す Latin-1 文字列ビューを返します。

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

first(),last(),chopped(),chop(),truncate(),slice()も参照してください 。

[since 6.0] QString QLatin1StringView::toString() const

この Latin-1 文字列をQString に変換します。

return QString(*this);

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

[noexcept] QLatin1StringView QLatin1StringView::trimmed() const

先頭と末尾の空白を除去し、結果を返します。

空白文字とは、QChar::isSpace() がtrue を返す文字を指します。これには ASCII 文字 ' \t', ' \n', ' \v', ' \f', ' \r', ' が含まれます。

[constexpr] void QLatin1StringView::truncate(qsizetype length)

この文字列をlength の長さに切り詰めます。

*this = left(length) と同じです。

sliced()、first()、last()、chopped()、chop()も参照のこと 。

[constexpr] QLatin1Char QLatin1StringView::operator[](qsizetype pos) const

このオブジェクトの位置pos にある文字を返します。

at()も参照 。