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()も参照 。

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

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

startsWith()も参照 。

この Latin-1 文字列ビューにおいて、str が示す UTF-16 文字列、l1 が示す Latin-1 文字列、またはch が示す文字が、それぞれインデックス位置from から前方に検索して最初に出現するインデックス位置を返す。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()も参照 。

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

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

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

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

この関数は、lastIndexOf （）をオーバーロードする。

str で見た UTF-16 文字列、またはl1 で見た Latin-1 文字列が、それぞれ最後に出現した 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 を、base を基本として対応する数値に変換して返す。Aは10、Bは11といった具合です。

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 より大きい場合は正の整数を、等しい場合はゼロを返します。

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)

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

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

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

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

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

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

この関数は 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()も参照 。