QLatin1StringView Class

メンバ関数のドキュメント

[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)

first を格納し、長さが (last -first) である QLatin1StringView オブジェクトを生成します。

[first,last) の範囲は、このLatin-1文字列オブジェクトの存続期間中、有効なままである必要があります。

last もnullptr である場合、first としてnullptr を渡すことは安全であり、その結果、Latin-1 文字列は null になります。

last がfirst より先にある場合、first がnullptr であるのに対しlast がそうでない場合、またはlast - first > INT_MAX である場合、挙動は未定義となります。

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

`str ` を `size` で格納する `QLatin1StringView` オブジェクトを生成します。

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

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

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

この文字列中の「%N 」を、「args 」からの対応する引数に置き換えます。引数は位置依存ではありません。args の最初の引数は、%N を最も低いN （すべて）に置き換え、args の2番目の引数は、%N を次に低いN に置き換える、というように続きます。

Args QAnyStringView へ暗黙的に変換可能なものであれば、どのようなものでも構成可能です。

QString::arg()も参照してください 。

[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

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

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

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

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

operator==()、operator<()、およびoperator>()も参照してください 。

[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()も参照してください 。

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

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

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

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

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

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

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

[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 スタイルのconstイテレータを返します。

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

begin()、cend()、およびrend()も参照してください 。

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

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

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

[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[]()。

インデックス位置from から前方へ検索し、str で参照される UTF-16 文字列、l1 で参照される Latin-1 文字列、またはch で参照される文字が、この Latin-1 文字列ビュー内で最初に現れる位置のインデックスを返します。str 、l1 、またはc がそれぞれ見つからない場合は -1 を返します。

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

from が -1 の場合、検索は最後の文字から開始されます。-2 の場合は、最後から 2 番目の文字から開始されます。

QString::indexOf()も参照してください 。

[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()。

インデックス位置from から逆方向に検索し、str で指定された UTF-16 文字列、l1 で指定された Latin-1 文字列、またはch で指定された文字が、この Latin-1 文字列ビュー内で最後に現れる位置のインデックスを返します。str 、l1 、またはch がそれぞれ見つからない場合は -1 を返します。

from が-1の場合、検索は最後の文字から開始されます。-2の場合は最後から2番目の文字から開始され、以下同様です。

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

indexOf()、QStringView::lastIndexOf()、QStringView::indexOf()、およびQString::indexOf()も参照してください 。

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

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

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

[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

文字列の最初の文字を逆順に指す、STL スタイルのconst リバースイテレータを返します。

この関数は、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

この文字列ビューの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()。

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

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

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

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

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

ok がnullptr でない場合、*ok をfalse に設定して失敗を報告し、*ok をtrue に設定して成功を報告します。

この関数は、先頭および末尾の空白文字を無視します。

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

このQLatin1StringView を、基数base （デフォルトは10）を用いて対応する数値に変換したものを返します。基数0および2から36までがサポートされており、9を超える桁にはアルファベットが使用されます。Aは10、Bは11というように続きます。

base が 0 の場合、Latin-1 文字列ビューが次のように始まる場合、以下のルール（この順序で）に従って基数が自動的に決定されます：

• "0x"、残りの部分は16進数（基数16）として読み込まれます
• "0b"、残りの部分は2進数（基数2）として読み取られます
• "0"、残りの部分は8進数（基数8）として読み取られます
• それ以外の場合は10進数として読み取られます

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

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

この関数は、先頭および末尾の空白文字を無視します。

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

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

このLatin-1文字列をQString に変換します。以下と同等です。

return QString(*this);

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

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

[since 6.9] QByteArray QLatin1StringView::toUtf8() const

文字列のUTF-8表現をQByteArray として返します。この関数は、まずQString に変換するよりも効率的です。

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

toString() およびQString::toUtf8()も参照してください 。

[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) が有効になっていなくても動作します。

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

QStringTokenizer result = sv.tokenize(sep);

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

auto result = sv.tokenize(sep);

これは、QStringTokenizer のテンプレート引数が、それが返される特定のtokenize()のオーバーロードに対して非常に微妙な依存関係を持っており、通常、区切り文字に使用される型とは一致しないためです。

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

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

[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()も参照してください 。