QByteArrayView Class

メンバ関数ドキュメント

このバイト配列ビューがそれぞれバイト配列ビューbv または文字ch で始まっている場合はtrue を返し、そうでない場合はfalse を返す。

endsWith()も参照 。

このバイト配列ビューがバイト配列ビューbv または文字ch でそれぞれ終わっている場合はtrue を返し、そうでない場合はfalse を返す。

startsWith()も参照 。

このバイト配列ビューで、bv で表示されるバイト列の先頭、またはch で表示されるバイト列の先頭のインデックス位置をそれぞれ返し、一致するものが見つからない場合は、インデックス位置from.Returns -1 から順に検索する。

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

lastIndexOf() およびcontains()も参照のこと 。

このバイト配列ビューが、bv または文字ch で表示されるバイト列の出現をそれぞれ含んでいる場合はtrue を返し、そうでない場合はfalse を返す。

indexOf() およびlastIndexOf()も参照 。

このバイト配列ビューにおいて、bv で表示されるバイト列の最後の開始位置、またはch で表示されるバイト列の最後の開始位置のどちらかのインデックス位置を、インデックス位置from から後方に検索して返します。

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

一致する文字が見つからなければ-1を返す。

indexOf() およびcontains()も参照の こと。

[constexpr noexcept] QByteArrayView::QByteArrayView()

NULL バイト配列ビューを構築します。

isNull()も参照ください 。

[constexpr noexcept] template <typename Byte> QByteArrayView::QByteArrayView(const Byte *data)

data のバイト配列ビューを構築する。長さは、最初のByte(0) をスキャンすることで決定されます。

data は、このバイト配列ビューオブジェクトの有効期間中有効でなければなりません。

data としてnullptr を渡すと安全であり、NULL バイト配列ビューになります。

このコンストラクタは、data が配列ではなく、Byte が互換性のあるバイト型である場合にのみ、オーバーロードの解決に参加します。

Compatible Byte Typesも参照 。

[constexpr noexcept] template <typename Container, QByteArrayView::if_compatible_container<Container> = true> QByteArrayView::QByteArrayView(const Container &c)

配列のようなコンテナc にバイト配列ビューを構築する。長さとデータはそれぞれstd::size(c) とstd::data(c) で設定する。

コンテナのデータは、このバイト配列ビューオブジェクトの有効期間中有効でなければなりません。

このコンストラクタは、c が互換性のあるバイト型の要素を持つ連続したコンテナである場合、オーバーロードの解決に参加します。

Compatible Byte Typesも参照のこと 。

[noexcept] QByteArrayView::QByteArrayView(const QByteArray &byteArray)

byteArray にバイト配列ビューを構築します。

byteArray.data() のバイト配列ビューを構築します。 このバイト配列ビューは、このバイト配列ビューオブジェクトの有効期間中有効でなければなりません。

バイト配列ビューがNULLになるのは、byteArray.isNull() の場合のみです。

[constexpr noexcept] template <size_t Size> QByteArrayView::QByteArrayView(const char (&)[Size] data)

文字配列data のバイト配列ビューを構築する。このビューは、最初に'\0' が現れるか、Size が現れるか、どちらか早い方まで配列をカバーします。完全な配列が必要な場合は、代わりにfromArray() を使用します。

data は、このバイト配列ビューオブジェクトの有効期間中有効でなければなりません。

fromArrayも参照してください 。

[constexpr noexcept] QByteArrayView::QByteArrayView(std::nullptr_t)

NULL バイト配列ビューを構築します。

isNull()も参照ください 。

[constexpr] template <typename Byte, QByteArrayView::if_compatible_byte<Byte> = true> QByteArrayView::QByteArrayView(const Byte *first, const Byte *last)

first に、長さ (last -first) のバイト配列ビューを構築します。

[first,last) の範囲は、この QByteArrayView の有効期間中有効でなければなりません。

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

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

このコンストラクタは、Byte が互換性のあるバイト型である場合にのみ、オーバーロードの解決に参加します。

Compatible Byte Typesも参照してください 。

[constexpr] template <typename Byte, QByteArrayView::if_compatible_byte<Byte> = true> QByteArrayView::QByteArrayView(const Byte *data, qsizetype len)

len の長さでdata のバイト配列ビューを構築します。

[data,len) の範囲は、この QByteArrayView の有効期間中有効でなければなりません。

data としてnullptr を渡しても、len が 0 の場合は安全であり、NULL バイト配列ビューになります。

len が負の場合、または正の場合、data がnullptr の場合の動作は未定義です。

このコンストラクタは、Byte が互換性のあるバイト型である場合にのみ、オーバーロードの解決に参加します。

Compatible Byte Typesも参照のこと 。

[constexpr] char QByteArrayView::at(qsizetype n) const

このバイト配列ビューの位置n にある文字を返す。

n が負またはsize() より小さくない場合、動作は未定義。

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

[constexpr] char QByteArrayView::back() const

バイト配列ビューの最後のバイトを返します。

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

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

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

バイト配列ビューの最初のバイトを指す、STL 形式のイテレータを返します。

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

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

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

begin() と同じ。

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

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

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

end() と同じ。

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

cbegin(),end(),crend()も参照 。

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

このバイト配列ビューをlength 文字で切り捨てる。

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

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

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

このバイト配列ビューの最後のlength バイトを除いたコピーを返す。言い換えると、このオブジェクトの先頭からsize() -length の長さのバイト配列ビューを返します。

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

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

[noexcept, since 6.2] int QByteArrayView::compare(QByteArrayView bv, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

このQByteArrayView のソートが、QByteArrayView bv の前か、同じ位置か、後かに応じて、ゼロより小さいか、等しいか、大きいかの整数を返す。比較は大文字小文字の区別cs に従って行われます。

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

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

[constexpr noexcept] QByteArrayView::const_pointer QByteArrayView::constData() const

バイト配列ビューの最初のバイトへの constchar ポインタを返します。

data()、begin()、end()も参照 。

[noexcept] qsizetype QByteArrayView::count(QByteArrayView bv) const

このバイト配列ビューでbv が見ているバイト列の（重複している可能性のある）出現回数を返す。

contains() およびindexOf()も参照 。

[noexcept] qsizetype QByteArrayView::count(char ch) const

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

このバイト配列ビューにおける bytech の出現回数を返します。

contains() およびindexOf()も参照 。

[constexpr noexcept] QByteArrayView::const_reverse_iterator QByteArrayView::crbegin() const

rbegin() と同じ。

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

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

[constexpr noexcept] QByteArrayView::const_reverse_iterator QByteArrayView::crend() const

rend() と同じ。

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

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

[constexpr noexcept] QByteArrayView::const_pointer QByteArrayView::data() const

バイト配列ビューの最初のバイトへの constchar ポインタを返します。

begin() およびend()も参照 。

[constexpr noexcept] bool QByteArrayView::empty() const

このバイト配列ビューが空の場合、つまりsize() == 0 の場合はtrue を返します。

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

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

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

バイト配列ビューの最後のバイトの直後を指すSTL 形式のイテレータを返します。

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

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

[constexpr] QByteArrayView QByteArrayView::first(qsizetype n) const

このバイト配列ビューの最初のn バイトを指すバイト配列ビューを返します。sliced(0, n) に相当する。

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

[static constexpr noexcept] template <typename Byte, size_t Size> QByteArrayView QByteArrayView::fromArray(const Byte (&)[Size] data)

配列リテラルdata に対してバイト配列ビューを構築します。ビューは配列全体をカバーします。このビューには、char 配列リテラルの末尾のヌル終端子も含まれます。ヌル終端文字をビューに含めたくない場合は、chop() で終端文字を削除します。あるいは、コンストラクタのオーバーロードで char 配列リテラルを指定することもできます。

この関数は、互換性のあるバイト型の任意の配列リテラルで動作します。

Compatible Byte Types およびQByteArrayViewも参照のこと 。

[constexpr] char QByteArrayView::front() const

バイト配列ビューの最初のバイトを返します。

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

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

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

このバイト配列ビューが空の場合、つまりsize() == 0 の場合はtrue を返す。

empty(),isNull(),size()も参照 。

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

このバイト配列ビューが NULL の場合はtrue を、つまりdata() == nullptr を返します。

empty(),isEmpty(),size()も参照 。

[noexcept, since 6.3] bool QByteArrayView::isValidUtf8() const

このバイト配列ビューが有効な UTF-8 エンコードされたデータを含んでいる場合はtrue を、そうでない場合はfalse を返します。

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

[constexpr] QByteArrayView QByteArrayView::last(qsizetype n) const

このバイト配列ビューの最後のn バイトを指すバイト配列ビューを返す。

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

[noexcept, since 6.2] qsizetype QByteArrayView::lastIndexOf(QByteArrayView bv) const

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

このバイト配列ビューの末尾から後方へ検索して、bv によって表示されるバイト列の最後の出現の開始のインデックス位置を返します。一致しない場合は -1 を返します。

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

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

[constexpr noexcept] qsizetype QByteArrayView::length() const

size() と同じ。

empty()、isEmpty()、isNull()、size()も参照の こと。

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

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

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

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

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

maxSize() を返します。

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

[constexpr noexcept] QByteArrayView::const_reverse_iterator QByteArrayView::rbegin() const

バイト配列ビューの最初のバイトを逆順で指す、STL 形式の逆順イテレータを返します。

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

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

[constexpr noexcept] QByteArrayView::const_reverse_iterator QByteArrayView::rend() const

STL 形式の逆順イテレータで、バイト配列ビューの最後のバイトから逆順に1つ前のバイトを指すものを返します。

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

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

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

このバイト配列ビューのバイト数を返します。

empty()、isEmpty() およびisNull()も参照 。

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

このバイト配列ビューをpos の位置から開始するように変更し、n バイト分拡張する。

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

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

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

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

このバイト配列ビューをpos の位置から開始し、その終わりまで拡張するように変更します。

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

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

[constexpr] QByteArrayView QByteArrayView::sliced(qsizetype pos) const

このオブジェクトの位置pos から始まり、その終わりまで続くバイト配列ビューを返します。

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

[constexpr] QByteArrayView QByteArrayView::sliced(qsizetype pos, qsizetype n) const

pos の位置から始まる、このバイト配列ビューのn バイトを指すバイト配列ビューを返す。

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

QByteArray QByteArrayView::toByteArray() const

このバイト配列ビューのデータのディープコピーをQByteArray として返します。

このバイト配列ビューが NULL の場合のみ、戻り値は NULLQByteArray となります。

[since 6.3] double QByteArrayView::toDouble(bool *ok = nullptr) const

このバイト配列のビューをdouble 値に変換して返します。

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

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

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

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

[since 6.3] float QByteArrayView::toFloat(bool *ok = nullptr) const

このバイト配列のビューをfloat 値に変換して返します。

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

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

QByteArrayView string("1234.56 Volt");
bool ok;
float a = str.toFloat(&ok);       // a == 0, ok == false
a = string.first(7).toFloat(&ok); // a == 1234.56, ok == true

この関数は、先頭と末尾の空白を無視します。

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

[since 6.3] int QByteArrayView::toInt(bool *ok = nullptr, int base = 10) const

このバイト配列のビューを、base を基数としてint に変換して返す。基数 0 および 2 から 36 までがサポートされており、9 を超える桁にはアルファベットを使用します。

base バイト配列のビューが "0x "で始まる場合、残りは16進数（基数16）として読み込まれる。そうでない場合、"0 "で始まる場合、残りは8進数（基数8）として読み込まれる。

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

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

QByteArrayView str("FF");
bool ok;
int hex = str.toInt(&ok, 16);     // hex == 255, ok == true
int dec = str.toInt(&ok, 10);     // dec == 0, ok == false

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

[since 6.3] long QByteArrayView::toLong(bool *ok = nullptr, int base = 10) const

このバイト配列のビューを、base を基数としてlong int に変換して返す。9を超える数字にはアルファベットを使用し、Aは10、Bは11といった具合です。

base バイト配列のビューが "0x "で始まる場合、残りは16進数（基数16）として読み込まれる。そうでない場合、"0 "で始まる場合、残りは8進数（基数8）として読み込まれる。

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

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

QByteArrayView str("FF");
bool ok;
long hex = str.toLong(&ok, 16);   // hex == 255, ok == true
long dec = str.toLong(&ok, 10);   // dec == 0, ok == false

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

[since 6.3] qlonglong QByteArrayView::toLongLong(bool *ok = nullptr, int base = 10) const

このバイト配列のビューを、base を基数としてlong long に変換して返す。基数 0 および 2 から 36 までがサポートされ、9 を超える数字にはアルファベットを使用します。

base バイト配列ビューが "0x "で始まっている場合、残りは16進数（基数16）として読み込まれる。そうでない場合、"0 "で始まっている場合、残りは8進数（基数8）として読み込まれ、そうでない場合は10進数として読み込まれる。

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

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

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

[since 6.3] short QByteArrayView::toShort(bool *ok = nullptr, int base = 10) const

このバイト配列のビューを、base を基数としてshort に変換して返す。基数 0 および 2 から 36 までがサポートされ、9 を超える数字にはアルファベットを使用します。

base バイト配列ビューが "0x "で始まっている場合、残りは16進数（基数16）として読み込まれる。そうでない場合、"0 "で始まっている場合、残りは8進数（基数8）として読み込まれ、そうでない場合は10進数として読み込まれる。

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

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

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

[since 6.3] uint QByteArrayView::toUInt(bool *ok = nullptr, int base = 10) const

このバイト配列のビューを、base を基数としてunsigned int に変換して返す。基数 0 および 2 から 36 までがサポートされており、9 を超える桁にはアルファベットを使用します。

base バイト配列ビューが "0x "で始まっている場合、残りは16進数（基数16）として読み込まれる。そうでない場合、"0 "で始まっている場合、残りは8進数（基数8）として読み込まれ、そうでない場合は10進数として読み込まれる。

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

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

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

[since 6.3] ulong QByteArrayView::toULong(bool *ok = nullptr, int base = 10) const

このバイト配列のビューを、base を基数としてunsigned long int に変換して返す。基数 0 および 2 から 36 までがサポートされており、9 を超える桁にはアルファベットを使用します。

base バイト配列ビューが "0x "で始まっている場合、残りは16進数（基数16）として読み込まれる。そうでない場合、"0 "で始まっている場合、残りは8進数（基数8）として読み込まれ、そうでない場合は10進数として読み込まれる。

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

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

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

[since 6.3] qulonglong QByteArrayView::toULongLong(bool *ok = nullptr, int base = 10) const

このバイト配列のビューを、base を基数としてunsigned long long に変換して返す。基数 0 および 2 から 36 までがサポートされており、9 を超える桁にはアルファベットを使用します。

base バイト配列ビューが "0x "で始まっている場合、残りは16進数（基数16）として読み込まれる。そうでない場合、"0 "で始まっている場合、残りは8進数（基数8）として読み込まれ、そうでない場合は10進数として読み込まれる。

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

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

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

[since 6.3] ushort QByteArrayView::toUShort(bool *ok = nullptr, int base = 10) const

このバイト配列のビューを、base を基数としてunsigned short に変換して返す。基数 0 および 2 から 36 までがサポートされており、9 を超える桁にはアルファベットを使用します。

base バイト配列ビューが "0x "で始まっている場合、残りは16進数（基数16）として読み込まれる。そうでない場合、"0 "で始まっている場合、残りは8進数（基数8）として読み込まれ、そうでない場合は10進数として読み込まれる。

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

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

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

[noexcept, since 6.3] QByteArrayView QByteArrayView::trimmed() const

このバイト配列ビューの先頭と末尾からスペーシング文字を取り除いたコピーを返します。

スペーシング文字は、標準 C++isspace() 関数が C ロケールでtrue を返す文字です。これらは、ASCII 文字のタブ ' \t'、改行 ' \n'、キャリッジリターン ' \r'、垂直タブ '˶v'、フォームフィード '˶f'、スペース ' です。

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

QChar::SpecialCharacter とSpacing Charactersも参照してください 。

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

このバイト配列ビューをlength の長さに切り詰めます。

*this = first(length) と同じ。

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

[constexpr noexcept, since 6.7] std::string_view QByteArrayView::operator std::string_view() const

このQByteArrayView オブジェクトをstd::string_view オブジェクトに変換します。返されるビューは、このビューと同じデータポインタと長さを持ちます。

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

[constexpr] char QByteArrayView::operator[](qsizetype n) const

このバイト配列ビューの位置n にある文字を返す。

n が負またはsize() より小さくない場合、動作は未定義。

at()、front()、back()も参照 。