QByteArray Class

メンバ関数ドキュメント

これは、バイト配列が理論的に保持できる最大要素数を返す。実際には、システムで利用可能なメモリ量によって制限されるため、この数はもっと小さくなります。

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

バイト配列に格納されているデータへのポインタを返します。このポインタを使用して、配列を構成するバイトにアクセスできます。データは'˶0'終端です。

デタッチが起こらず、QByteArray が変更されない限り、ポインタは有効です。

この演算子は主に、const char * を受け付ける関数にバイト配列を渡す場合に便利です。

アプリケーションのコンパイル時にQT_NO_CAST_FROM_BYTEARRAY を定義することで、この演算子を無効にすることができます。

注意:QByteArray には、' \0'を含む任意のバイト値を格納できますが、char * 引数を受け取るほとんどの関数は、最初に遭遇した' \0'でデータが終了すると見 なします。

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

このバイト配列の最初のlen バイトを含むバイト配列を返す。

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

len がsize() より大きい場合は、バイト配列全体が返される。

len が 0 より小さい場合は、空のQByteArray を返す。

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

このバイト配列の最後のlen バイトを含むバイト配列を返す。

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

len がsize() より大きい場合は、バイト配列全体が返される。

len が 0 より小さい場合は、空のQByteArray を返す。

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

このバイト配列から、位置pos から始まるlen バイトを含むバイト配列を返す。

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

len が-1（デフォルト）の場合、またはpos +len >=size()の場合、位置pos からバイト配列の終わりまでのすべてのバイトを含むバイト配列を返す。

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

バイト配列の最初のn バイトを返す。

例

QByteArray x("Pineapple");
QByteArray y = x.first(4);
// y == "Pine"

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

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

バイト配列の最後のn バイトを返す。

例

QByteArray x("Pineapple");
QByteArray y = x.last(5);
// y == "apple"

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

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

pos の位置から始まる、このオブジェクトのn バイトを含むバイト配列を返す。

例

QByteArray x("Five pineapples");
QByteArray y = x.sliced(5, 4);     // y == "pine"
QByteArray z = x.sliced(5);        // z == "pineapples"

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

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

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

このオブジェクトの位置pos から始まり、このオブジェクトの終わりまでのバイトを含むバイト配列を返す。

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

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

このバイト配列の左端size() -len バイトを含むバイト配列を返す。

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

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

options で定義されたオプションを使用して、Base64 配列base64 をデコードする。options がIgnoreBase64DecodingErrors を含む場合 (デフォルト)、入力の有効性はチェックされません。 入力中の無効な文字はスキップされ、それ以降の文字でデコード処理を続行できるようになります。options にAbortOnBase64DecodingErrors が含まれている場合、デコードは最初の無効な文字で停止する。

例えば

void process(const QByteArray &);

if (auto result = QByteArray::fromBase64Encoding(encodedData))
    process(*result);

Base64エンコードされたデータのデコードに使用されるアルゴリズムは、RFC 4648で定義されている。

QByteArrayFromBase64Resultオブジェクトを返し、デコードされたデータと、デコードが成功したかどうかを示すフラグを含む。AbortOnBase64DecodingErrors オプションが渡され、入力データが無効であった場合、 デコードされたデータに何が含まれているかは不明である。

toBase64()も参照 。

[constexpr noexcept] QByteArray::QByteArray()

空のバイト配列を構築します。

isEmpty()も参照 。

QByteArray::QByteArray(const char *data, qsizetype size = -1)

配列data の先頭size バイトを含むバイト配列を構築する。

data が 0 の場合、NULL バイト配列が構築されます。

size が負の場合、data は ' \0' 終端の文字列を指すものと見なされ、その長さは動的に決定されます。

QByteArray は文字列データの深いコピーを作成します。

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

QByteArray::QByteArray(qsizetype size, Qt::Initialization)

未初期化の内容でサイズsize のバイト配列を構築する。

QByteArray::QByteArray(qsizetype size, char ch)

各バイトがch に設定された、サイズsize のバイト配列を構築する。

fill()も参照のこと 。

[noexcept] QByteArray::QByteArray(const QByteArray &other)

other のコピーを構築する。

QByteArrayは暗黙的に共有されるため、この操作には一定の時間がかかる。これにより、関数からQByteArrayを返すのが非常に高速になります。共有インスタンスが変更された場合、それはコピーされ（コピーオンライト）、線形時間がかかります。

operator=()も参照 。

[noexcept] QByteArray::QByteArray(QByteArray &&other)

Move-QByteArrayインスタンスを構築し、other が指していたのと同じオブジェクトを指すようにする。

[noexcept] QByteArray::~QByteArray()

バイト配列を破棄する。

QByteArray &QByteArray::append(const QByteArray &ba)

バイト配列ba をこのバイト配列の末尾に追加する。

例：

QByteArray x("free");
QByteArray y("dom");
x.append(y);
// x == "freedom"

これは、insert(size(),ba) と同じ。

注意:QByteArray は暗黙の共有クラスです。そのため、空のバイト配列に追加した場合、そのバイト配列はba に保持されているデータを共有するだけです。 この場合、データのコピーは行われず、一定の時間がかかります。共有インスタンスが変更された場合、そのインスタンスはコピーされ（コピーオンライト）、線形時間がかかる。

追加先のバイト配列が空でない場合、データのディープコピーが実行され、線形時間がかかる。

append()関数は通常、非常に高速（定数時間）である。これは、QByteArray がデータの末尾に余分な領域を事前に確保するため、毎回配列全体を再割り当てすることなくデータを増やすことができるからである。

operator+=()、prepend()、insert()も参照の こと。

QByteArray &QByteArray::append(QByteArrayView data)

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

このバイト配列にdata を追加する。

QByteArray &QByteArray::append(char ch)

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

ch バイトをこのバイト配列に追加します。

QByteArray &QByteArray::append(const char *str)

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

このバイト配列に '｟0' で終端する文字列str を追加します。

QByteArray &QByteArray::append(const char *str, qsizetype len)

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

str から始まる最初のlen バイトをこのバイト配列に追加し、このバイト配列への参照を返します。追加されるバイトには'˶0'バイトが含まれることがあります。

len が負の場合、str は ' \0' 終端の文字列と見なされ、コピーされる長さはqstrlen() を使用して自動的に決定されます。

len が 0 またはstr が NULL の場合、バイト配列には何も追加されません。len がstr よりも長くないことを確認してください。

QByteArray &QByteArray::append(qsizetype count, char ch)

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

バイトch のコピーcount をこのバイト配列に追加し、このバイト配列への参照を返す。

count が負またはゼロの場合、バイト配列には何も追加されない。

[since 6.6] QByteArray &QByteArray::assign(QByteArrayView v)

このバイト配列の内容をv のコピーで置き換え、このバイト配列への参照を返す。

このバイト配列のサイズはv のサイズに等しくなる。

この関数は、v のサイズがこのバイト配列の容量を超えるか、このバイト配列が共有されている場合にのみ、メモリを確保します。

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

[since 6.6] template <typename InputIterator, QByteArray::if_input_iterator<InputIterator> = true> QByteArray &QByteArray::assign(InputIterator first, InputIterator last)

このバイト配列の内容を、イテレータ範囲 [first,last] 内の要素のコピーに置き換え、このバイト配列への参照を返します。

このバイト配列のサイズは、範囲 [first,last] 内の要素数に等しくなります。

この関数は、範囲内の要素数がこのバイト配列の容量を超えるか、このバイト配列が共有されている場合にのみ、メモリを確保します。

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

[since 6.6] QByteArray &QByteArray::assign(qsizetype n, char c)

このバイト配列の内容をc のn コピーで置き換え、このバイト配列への参照を返す。

このバイト配列のサイズはn に等しく、負であってはならない。

この関数は、n がこのバイト配列の容量を超えるか、このバイト配列が共有されている場合にのみ、メモリを割り当てます。

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

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

char QByteArray::at(qsizetype i) const

バイト配列のインデックス位置i にあるバイトを返す。

i は、バイト配列の有効なインデックス位置でなければなりません (すなわち、0 <= < ())。i size

operator[]()も参照 。

char &QByteArray::back()

バイト配列の最後のバイトへの参照を返す。operator[](size() - 1) と同じ。

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

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

char QByteArray::back() const

バイト配列の最後のバイトを返す。at(size() - 1) と同じ。

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

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

QByteArray::iterator QByteArray::begin()

byte-arrayの最初のバイトを指すSTL形式のイテレータを返します。

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

[noexcept] QByteArray::const_iterator QByteArray::begin() const

この関数はbegin()をオーバーロードする。

qsizetype QByteArray::capacity() const

再割り当てを行わずにバイト配列に格納できる最大バイト数を返します。

この関数の唯一の目的は、QByteArray'のメモリ使用量を微調整する手段を提供することです。一般に、この関数を呼び出す必要はほとんどないだろう。バイト配列のバイト数を知りたい場合は、size() を呼び出す。

reserve() およびsqueeze()も参照の こと。

[noexcept] QByteArray::const_iterator QByteArray::cbegin() const

byte-arrayの最初のバイトを指すSTL形式のイテレータを返します。

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

[noexcept] QByteArray::const_iterator QByteArray::cend() const

byte-arrayの最後のバイトの直後を指す、STL形式のイテレータを返します。

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

void QByteArray::chop(qsizetype n)

バイト配列の末尾からn バイトを削除する。

n がsize() より大きい場合、結果は空のバイト配列となる。

例：

QByteArray ba("STARTTLS\r\n");
ba.chop(2);                 // ba == "STARTTLS"

truncate()、resize()、first()も参照 。

void QByteArray::clear()

バイト配列の内容をクリアして null にする。

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

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

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

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

operator== およびCharacter Caseも参照してください 。

[noexcept] QByteArray::const_iterator QByteArray::constBegin() const

byte-arrayの最初のバイトを指すSTL形式のイテレータを返します。

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

[noexcept] const char *QByteArray::constData() const

バイト配列に格納されている const 型データへのポインタを返します。このポインタを使用して、配列を構成するバイトにアクセスできます。QByteArray オブジェクトが未加工データから作成されていない限り、データは ' \0' 終端です。

デタッチが起こらず、QByteArray が変更されない限り、ポインタは有効なままです。

この関数は、const char * を受け取る関数にバイト配列を渡すのに便利です。

注意:QByteArray には ' \0' を含む任意のバイト値を格納することができますが、char * 引数を受け取るほとんどの関数は、最初に遭遇した ' \0' でデータが終了すると見なします。

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

[noexcept] QByteArray::const_iterator QByteArray::constEnd() const

byte-arrayの最後のバイトの直後を指す、STL形式のイテレータを返します。

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

[since 6.0] bool QByteArray::contains(QByteArrayView bv) const

このバイト配列がbv で見たバイト列を含んでいる場合はtrue を返し、そうでない場合はfalse を返します。

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

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

bool QByteArray::contains(char ch) const

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

バイト配列がバイトch を含む場合はtrue を返し、そうでない場合はfalse を返します。

[since 6.0] qsizetype QByteArray::count(QByteArrayView bv) const

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

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

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

qsizetype QByteArray::count(char ch) const

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

バイト配列中のバイトch の出現回数を返す。

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

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

byte-arrayの最初のバイトを逆順に指す、STL形式の逆順イテレータを返します。

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

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

byte-arrayの最後のバイトの直後を指す、 constSTL形式の逆順イテレータを返します。

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

char *QByteArray::data()

バイト配列に格納されているデータへのポインタを返します。このポインタを使用して、配列を構成するバイトにアクセスし、変更することができます。データは'˶0'終端です。つまり、返されたポインタに続いてアクセスできるバイト数は'˶0'終端を含めてsize()+1です。

例

QByteArray ba("Hello world");
char *data = ba.data();
while (*data) {
    cout << "[" << *data << "]" << endl;
    ++data;
}

例：デタッチが起こらず、QByteArray が変更されない限り、ポインタは有効です。

読み取り専用アクセスでは、constData() の方がディープコピーが発生しないため高速です。

この関数は主に、const char * を受け付ける関数にバイト配列を渡すのに便利である。

次の例では、data()が返すchar*のコピーを作成しますが、末尾の'˶0'用のバイトを 割り当てていないため、ヒープが破損してクラッシュを引き起こします：

QString tmp = "test";
QByteArray text = tmp.toLocal8Bit();
char *data = new char[text.size()];
strcpy(data, text.data());
delete [] data;

これは正しい容量を割り当てます：

QString tmp = "test";
QByteArray text = tmp.toLocal8Bit();
char *data = new char[text.size() + 1];
strcpy(data, text.data());
delete [] data;

注:QByteArray は ' \0' を含む任意のバイト値を格納できますが、char * 引数を取るほとんどの関数は、最初に出会った ' \0' でデータが終了すると仮定します。

constData() およびoperator[]()も参照してください 。

[noexcept] const char *QByteArray::data() const

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

QByteArray::iterator QByteArray::end()

byte-arrayの最後のバイトの直後を指すSTL形式のイテレータを返します。

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

[noexcept] QByteArray::const_iterator QByteArray::end() const

この関数は end() をオーバーロードする。

[since 6.0] bool QByteArray::endsWith(QByteArrayView bv) const

このバイト配列がbv で見たバイト列で終わっていればtrue を返し、そうでなければfalse を返す。

例

QByteArray url("http://qt-project.org/doc/qt-5.0/qtdoc/index.html");
if (url.endsWith(".html"))
    ...

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

startsWith() およびlast()も参照してください 。

bool QByteArray::endsWith(char ch) const

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

このバイト配列がバイトch で終わっていればtrue を返し、そうでなければfalse を返す。

[since 6.1] QByteArray::iterator QByteArray::erase(QByteArray::const_iterator first, QByteArray::const_iterator last)

バイト配列から半角範囲 [first,last ] 内の文字を削除します。消去前のlast で参照される文字へのイテレータを返します。

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

[since 6.5] QByteArray::iterator QByteArray::erase(QByteArray::const_iterator it)

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

バイト配列からit で示される文字を削除します。消去された文字の直後の文字へのイテレータを返します。

QByteArray ba = "abcdefg";
auto it = ba.erase(ba.cbegin()); // ba is now "bcdefg" and it points to "b"

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

QByteArray &QByteArray::fill(char ch, qsizetype size = -1)

バイト配列の各バイトをch に設定します。size が -1 以外（デフォルト）の場合、バイト配列はあらかじめサイズsize にリサイズされます。

例：

QByteArray ba("Istambul");
ba.fill('o');
// ba == "oooooooo"

ba.fill('X', 2);
// ba == "XX"

resize()も参照のこと 。

[static] QByteArray QByteArray::fromBase64(const QByteArray &base64, QByteArray::Base64Options options = Base64Encoding)

options で定義されたオプションを使用して、Base64配列base64 をデコードしたコピーを返す。options がIgnoreBase64DecodingErrors を含む場合 (デフォルト)、入力の有効性はチェックされない。 入力中の無効な文字はスキップされ、それ以降の文字でデコード処理を続行できるようになる。options にAbortOnBase64DecodingErrors が含まれている場合、デコードは最初の無効な文字で停止する。

例えば

QByteArray text = QByteArray::fromBase64("UXQgaXMgZ3JlYXQh");
text.data();            // returns "Qt is great!"

QByteArray::fromBase64("PHA+SGVsbG8/PC9wPg==", QByteArray::Base64Encoding); // returns "<p>Hello?</p>"
QByteArray::fromBase64("PHA-SGVsbG8_PC9wPg==", QByteArray::Base64UrlEncoding); // returns "<p>Hello?</p>"

Base64エンコードされたデータのデコードに使われるアルゴリズムは、RFC 4648で定義されている。

デコードされたデータを返すか、AbortOnBase64DecodingErrors オプションが渡され、入力データが無効だった場合は空のバイト配列を返す。

toBase64() およびfromBase64Encoding()も参照のこと 。

[static] QByteArray QByteArray::fromCFData(CFDataRef data)

CFDatadata のコピーを含む新しいQByteArray を構築する。

fromRawCFData(),fromRawData(),toRawCFData(),toCFData()も参照 。

[static, since 6.5] QByteArray QByteArray::fromEcmaUint8Array(emscripten::val uint8array)

Uint8Arrayuint8array のコピーを含む新しいQByteArray を構築します。

この関数は、C++ コードからアドレス指定できない JavaScript データバッファから、QByteArray が所有するヒープメモリにデータを転送します。この関数が戻り、コピーが作成されると、Uint8Array を解放することができます。

引数uint8array は Uint8Array オブジェクトを参照する emscripten::val でなければなりません：

emscripten::val uint8array = emscripten::val::global("g_uint8array");
QByteArray byteArray = QByteArray::fromEcmaUint8Array(uint8array);

Uint8Array のサイズがQByteArray の最大容量を超える場合、またはuint8array の引数が Uint8Array 型でない場合、この関数は nullQByteArray を返します。

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

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

[static] QByteArray QByteArray::fromHex(const QByteArray &hexEncoded)

16進エンコードされた配列hexEncoded をデコードして返す。入力の有効性はチェックされない。入力中の無効な文字はスキップされ、 それ以降の文字でデコード処理を続けることができる。

例えば

QByteArray text = QByteArray::fromHex("517420697320677265617421");
text.data();            // returns "Qt is great!"

toHex()も参照 。

[static] QByteArray QByteArray::fromNSData(const NSData *data)

NSDatadata のコピーを含む新しいQByteArray を構築する。

fromRawNSData()、fromRawData()、toNSData()、toRawNSData()も参照 。

[static] QByteArray QByteArray::fromPercentEncoding(const QByteArray &input, char percent = '%')

URI/URL 形式のパーセントエンコーディングからinput をデコードする。

デコードされたテキストを含むバイト配列を返す。percent パラメータでは、'%' とは異なる文字 (たとえば '_' や '=') をエスケープ文字として使うことができる。percentDecoded （パーセント）。

例えば

QByteArrayテキスト QByteArray::fromPercentEncoding("Qt%20is%20great%33")；qDebug("%s", text.data());      // reports "Qt is great!"

percentDecoded()も参照のこと 。

[static] QByteArray QByteArray::fromRawCFData(CFDataRef data)

CFDatadata のバイトを使用するQByteArray を構築する。

data のバイトはコピーされない。

呼び出し元は、このQByteArray オブジェクトが存在する限り、CFData が削除または変更されないことを保証する。

fromCFData()、fromRawData()、toRawCFData()、toCFData()も参照 。

[static] QByteArray QByteArray::fromRawData(const char *data, qsizetype size)

data 配列の最初のsize バイトを使用するQByteArray を構築する。バイトはコピーされない。QByteArray にはdata ポインタが格納される。呼び出し元は、このQByteArray と、変更されていないそのコピーが存在する限り、data が削除されたり変更されたりしないことを保証する。言い換えると、QByteArray は暗黙の共有クラスであり、この関数が返すインスタンスにはdata ポインタが含まれるため、呼び出し元は、返されたQByteArray とそのコピーが存在する限り、data を削除したり、直接変更したりしてはならない。ただし、QByteArray はdata の所有権を持たないため、QByteArray のデストラクタは、data を参照する最後のQByteArray が破棄されても、生のdata を削除することはありません。

その後、返されたQByteArray の内容や、そこから作成されたコピーを変更しようとすると、変更する前にdata 配列のディープコピーが作成される。これにより、生のdata 配列自体がQByteArray によって変更されることはない。

以下は、QByteArray に生データをコピーすることなく、QDataStream を使ってメモリ上の生データからデータを読み取る方法の例である：

 static const char mydata[] = {
    '\x00', '\x00', '\x03', '\x84', '\x78', '\x9c', '\x3b', '\x76',
    '\xec', '\x18', '\xc3', '\x31', '\x0a', '\xf1', '\xcc', '\x99',
    ...
    '\x6d', '\x5b'
};

QByteArray data = QByteArray::fromRawData(mydata, sizeof(mydata));
QDataStream in(&data, QIODevice::ReadOnly);
...

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

[static] QByteArray QByteArray::fromRawNSData(const NSData *data)

NSDatadata のバイトを使用するQByteArray を構築する。

data のバイトはコピーされない。

呼び出し元は、このQByteArray オブジェクトが存在する限り、 NSData が削除または変更されないことを保証する。

fromNSData()、fromRawData()、toRawNSData()、toNSData()も参照のこと 。

[static] QByteArray QByteArray::fromStdString(const std::string &str)

str 文字列のコピーをQByteArray として返す。

toStdString() およびQString::fromStdString()も参照 。

char &QByteArray::front()

バイト配列の最初のバイトへの参照を返す。operator[](0) と同じ。

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

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

char QByteArray::front() const

バイト配列の先頭バイトを返す。at(0) と同じ。

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

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

[since 6.0] qsizetype QByteArray::indexOf(QByteArrayView bv, qsizetype from = 0) const

このバイト配列で、bv が見ているバイト列の、インデックス位置from から前方を検索して、最初に出現するバイト列のインデックス位置を返す。一致しない場合は-1を返す。

例

QByteArray x("sticky question");
QByteArrayView y("sti");
x.indexOf(y);               // returns 0
x.indexOf(y, 1);            // returns 10
x.indexOf(y, 10);           // returns 10
x.indexOf(y, 11);           // returns -1

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

lastIndexOf(),contains(),count()も参照してください 。

qsizetype QByteArray::indexOf(char ch, qsizetype from = 0) const

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

インデックス位置from から前方を検索して、このバイト配列で最初に出現するバイトch の開始のインデックス位置を返します。一致しない場合は -1 を返します。

例：

QByteArray ba("ABCBA");
ba.indexOf("B");            // returns 1
ba.indexOf("B", 1);         // returns 1
ba.indexOf("B", 2);         // returns 3
ba.indexOf("X");            // returns -1

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

[since 6.0] QByteArray &QByteArray::insert(qsizetype i, QByteArrayView data)

インデックス位置i にdata を挿入し、このバイト配列への参照を返す。

例

QByteArray ba("Meal");
ba.insert(1, QByteArrayView("ontr"));
// ba == "Montreal"

例：大きなバイト配列の場合、この操作は遅い（線形時間）ことがある。なぜなら、インデックスi 以上のすべてのバイトを、メモリ上で少なくとも1つ先の位置に移動する必要があるからである。

この配列は、挿入に対応して大きくなる。i が配列の終端を超えている場合、配列はまずスペース文字で拡張され、このi に到達します。

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

append(),prepend(),replace(),remove()も参照してください 。

QByteArray &QByteArray::insert(qsizetype i, const QByteArray &data)

インデックス位置i にdata を挿入し、このバイト配列への参照を返す。

この配列は、挿入に合わせて拡張される。i が配列の終端を超えている場合、配列はまずスペース文字で拡張され、i に到達する。

append()、prepend()、replace()、remove()も参照のこと 。

QByteArray &QByteArray::insert(qsizetype i, const char *s)

インデックス位置i にs を挿入し、このバイト配列への参照を返す。

この配列は、挿入に合わせて拡張される。i が配列の終端を超えている場合、配列はまずスペース文字で拡張され、i に到達する。

この関数は以下と等価である。insert(i, QByteArrayView(s))

append()、prepend()、replace()、remove()も参照のこと 。

QByteArray &QByteArray::insert(qsizetype i, char ch)

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

バイト配列のインデックス位置i にバイトch を挿入する。

この配列は挿入に合わせて拡張される。i が配列の終端を超えている場合、配列はまずスペース文字で拡張され、このi に到達します。

QByteArray &QByteArray::insert(qsizetype i, const char *data, qsizetype len)

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

バイト配列のi の位置に、data から始まるlen バイトを挿入します。

この配列は、挿入に合わせて拡張される。i が配列の終端を超えている場合、配列はまずスペース文字で拡張され、i に到達する。

QByteArray &QByteArray::insert(qsizetype i, qsizetype count, char ch)

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

バイト配列のインデックス位置i に、バイトch のコピーcount を挿入する。

この配列は、挿入に合わせて拡張される。i が配列の終端を超えている場合、配列はまずスペース文字で拡張され、i に到達する。

[noexcept] bool QByteArray::isEmpty() const

バイト配列のサイズが0の場合はtrue を返し、それ以外の場合はfalse を返す。

例：

QByteArray().isEmpty();         // returns true
QByteArray("").isEmpty();       // returns true
QByteArray("abc").isEmpty();    // returns false

size()も参照のこと 。

bool QByteArray::isLower() const

このバイト配列が小文字の場合、つまりtoLower() の折りたたみと同じ場合はtrue を返す。

これは、バイト配列が小文字のみを含むという意味ではなく、 ASCII の大文字を含まないという意味であることに注意。

isUpper() およびtoLower()も参照の こと。

[noexcept] bool QByteArray::isNull() const

このバイト配列が NULL の場合はtrue を返し、それ以外の場合はfalse を返す。

例を示します：

QByteArray().isNull();          // returns true
QByteArray("").isNull();        // returns false
QByteArray("abc").isNull();     // returns false

Qtは歴史的な理由から、NULLバイト配列と空のバイト配列を区別しています。ほとんどのアプリケーションで重要なのは、バイト配列にデータが含まれているかどうかであり、これはisEmpty() を使って判断することができます。

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

bool QByteArray::isUpper() const

このバイト配列が大文字の場合、つまりtoUpper() の折りたたみと同じ場合はtrue を返す。

これは、バイト配列が大文字のみを含むという意味ではなく、 ASCII の小文字を含まないという意味であることに注意。

isLower() およびtoUpper()も参照の こと。

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

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

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

[since 6.0] qsizetype QByteArray::lastIndexOf(QByteArrayView bv, qsizetype from) const

このバイト配列において、bv で表示されるバイト列の最後の出現の開始のインデックス位置を、インデックス位置from から後方に検索して返す。

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

一致しない場合は-1を返す。

例

QByteArray x("crazy azimuths");
QByteArrayView y("az");
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

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

indexOf(),contains(),count()も参照してください 。

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

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

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

例

QByteArray x("crazy azimuths");
QByteArrayView y("az");
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

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

indexOf(),contains(),count()も参照してください 。

qsizetype QByteArray::lastIndexOf(char ch, qsizetype from = -1) const

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

インデックス位置from から後方に検索して、このバイト配列内で最後に出現したバイトch の開始のインデックス位置を返します。from が -1（デフォルト）の場合、検索は最後のバイト（インデックスsize() - 1）から始まります。一致しない場合は -1 を返します。

例：

QByteArray ba("ABCBA");
ba.lastIndexOf("B");        // returns 3
ba.lastIndexOf("B", 3);     // returns 3
ba.lastIndexOf("B", 2);     // returns 1
ba.lastIndexOf("X");        // returns -1

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

QByteArray QByteArray::leftJustified(qsizetype width, char fill = ' ', bool truncate = false) const

fill バイトでパディングされたこのバイト配列を含む、サイズwidth のバイト配列を返す。

truncate が偽で、バイト配列のsize() がwidth より大きい場合、返されるバイト配列はこのバイト配列のコピーである。

truncate が真で、バイト配列のsize() がwidth よりも大きい場合、バイト配列のコピー内の位置width 以降のバイトは削除され、コピーが返される。

例：

QByteArray x("apple");
QByteArray y = x.leftJustified(8, '.');   // y == "apple..."

rightJustified()も参照のこと 。

[noexcept] qsizetype QByteArray::length() const

size() と同じ。

[static] QByteArray QByteArray::number(int n, int base = 10)

整数n をテキストとして表すバイト配列を返します。

n を表す文字列を含むバイト配列を、指定されたbase （デフォルトでは 10）を用いて返します。2 から 36 までの基数をサポートし、9 を超える数字にはアルファベットを使用します。

例

int n = 63;
QByteArray::number(n);              // returns "63"
QByteArray::number(n, 16);          // returns "3f"
QByteArray::number(n, 16).toUpper();  // returns "3F"

setNum() およびtoInt()も参照の こと。

[static] QByteArray QByteArray::number(long n, int base = 10)

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

toLong()も参照 。

[static] QByteArray QByteArray::number(qlonglong n, int base = 10)

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

toLongLong()も参照 。

[static] QByteArray QByteArray::number(qulonglong n, int base = 10)

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

toULongLong()も参照 。

[static] QByteArray QByteArray::number(uint n, int base = 10)

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

toUInt()も参照 。

[static] QByteArray QByteArray::number(ulong n, int base = 10)

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

toULong()も参照 。

[static] QByteArray QByteArray::number(double n, char format = 'g', int precision = 6)

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

浮動小数点数n をテキストとして表すバイト配列を返す。

n を表す文字列を含むバイト配列を返します。format とprecision は、QString::number と同じ意味（double, char, int）です。例えば

QByteArray ba = QByteArray::number(12.3456, 'E', 3);
// ba == 1.235E+01

toDouble() およびQLocale::FloatingPointPrecisionOptionも参照のこと 。

[since 6.4] QByteArray QByteArray::percentDecoded(char percent = '%') const

URI/URL 形式のパーセントエンコーディングをデコードする。

デコードされたテキストを含むバイト配列を返す。percent パラメータでは、エスケープ文字として '%' 以外の文字 (たとえば '_' や '=') を使用できます。

例えば、以下のようになる：

QByteArray encoded("Qt%20is%20great%33");
QByteArray decoded = encoded.percentDecoded(); // Set to "Qt is great!"

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

toPercentEncoding() およびQUrl::fromPercentEncoding()も参照してください 。

QByteArray &QByteArray::prepend(QByteArrayView ba)

バイト配列ビューba をこのバイト配列にプリペンドし、このバイト配列への参照を返す。

この操作は通常非常に高速（一定時間）です。これは、QByteArray がデータの先頭に余分な領域を事前確保するため、毎回配列全体を再割り当てすることなく成長できるからです。

例

QByteArray x("ship");
QByteArray y("air");
x.prepend(y);
// x == "airship"

これは insert(0,ba) と同じである。

append() およびinsert()も参照のこと 。

QByteArray &QByteArray::prepend(char ch)

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

バイトch をこのバイト配列に追加します。

QByteArray &QByteArray::prepend(const QByteArray &ba)

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

このバイト配列にba を付加する。

QByteArray &QByteArray::prepend(const char *str)

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

このバイト配列に ' \0' で終端する文字列str を追加します。

QByteArray &QByteArray::prepend(const char *str, qsizetype len)

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

str から始まるlen バイトをこのバイト配列に追加します。プリペンドされるバイトには'˶0'バイトが含まれることがあります。

QByteArray &QByteArray::prepend(qsizetype count, char ch)

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

このバイト配列にch のcount コピーを追加する。

void QByteArray::push_back(const QByteArray &other)

この関数は STL との互換性のために用意されている。append(other) と同等です。

[since 6.0] void QByteArray::push_back(QByteArrayView str)

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

append(str) と同じです。

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

void QByteArray::push_back(char ch)

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

append(ch) と同じ。

void QByteArray::push_back(const char *str)

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

append(str) と同じ。

void QByteArray::push_front(const QByteArray &other)

この関数は STL との互換性のために提供されている。prepend(other) と同等です。

[since 6.0] void QByteArray::push_front(QByteArrayView str)

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

prepend(str) と同じです。

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

void QByteArray::push_front(char ch)

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

prepend(ch) と同じ。

void QByteArray::push_front(const char *str)

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

prepend(str) と同じ。

QByteArray::reverse_iterator QByteArray::rbegin()

byte-arrayの先頭バイトを指すSTL形式の逆順イテレータを返します。

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

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

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

QByteArray &QByteArray::remove(qsizetype pos, qsizetype len)

インデックス位置pos から始まる配列からlen バイトを削除し、その配列への参照を返す。

pos が範囲外の場合、何も起こらない。pos は有効だが、pos +len が配列のサイズより大きい場合、配列はpos の位置で切り捨てられる。

例

QByteArray ba("Montreal");
ba.remove(1, 4);
// ba == "Meal"

要素を削除しても配列の容量は維持され、割り当てられたメモリの量は減らない。余分な容量を削除し、できるだけ多くのメモリを解放するには、配列のサイズを最後に変更した後にsqueeze() をコールする。

insert()、replace()、squeeze()も参照のこと 。

[since 6.5] QByteArray &QByteArray::removeAt(qsizetype pos)

インデックスpos の文字を削除する。pos が範囲外の場合（つまりpos >=size() ）、この関数は何もしません。

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

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

[since 6.5] QByteArray &QByteArray::removeFirst()

バイト配列の最初の文字を削除する。バイト配列が空の場合、この関数は何もしません。

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

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

[since 6.1] template <typename Predicate> QByteArray &QByteArray::removeIf(Predicate pred)

述語pred が真を返すすべてのバイトをバイト配列から削除します。バイト配列への参照を返します。

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

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

[since 6.5] QByteArray &QByteArray::removeLast()

バイト配列の最後の文字を削除する。バイト配列が空の場合、この関数は何もしません。

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

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

QByteArray::reverse_iterator QByteArray::rend()

byte-arrayの最後のバイトの直後を指すSTL形式の逆順イテレータを返します。

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

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

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

QByteArray QByteArray::repeated(qsizetype times) const

このバイト配列のコピーを、指定されたtimes の数だけ繰り返して返す。

times が 1 未満の場合は、空のバイト配列が返される。

例

QByteArray ba("ab");
ba.repeated(4);             // returns "abababab"

QByteArray &QByteArray::replace(qsizetype pos, qsizetype len, QByteArrayView after)

インデックス位置pos からのlen バイトをバイト配列after で置き換え、このバイト配列への参照を返します。

例：

QByteArray x("Say yes!");
QByteArray y("no");
x.replace(4, 3, y);
// x == "Say no!"

insert() およびremove()も参照 。

[since 6.0] QByteArray &QByteArray::replace(QByteArrayView before, QByteArrayView after)

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

バイト配列before をバイト配列after で置き換えます。

例

QByteArray ba("colour behaviour flavour neighbour");
ba.replace(QByteArray("ou"), QByteArray("o"));
// ba == "color behavior flavor neighbor"

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

QByteArray &QByteArray::replace(char before, QByteArrayView after)

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

バイトbefore をバイト配列after で置き換えます。

QByteArray &QByteArray::replace(char before, char after)

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

バイトbefore をバイトafter で置き換える。

QByteArray &QByteArray::replace(const char *before, qsizetype bsize, const char *after, qsizetype asize)

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

before で始まるbsize バイトをafter で始まるasize バイトで置き換えます。文字列のサイズはbsize とasize で与えられるので、' \0'バイトを含んでいてもよく、' \0'終端である必要はありません。

QByteArray &QByteArray::replace(qsizetype pos, qsizetype len, const char *after, qsizetype alen)

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

インデックス位置pos からのlen バイトを、位置after から始まるalen バイトで置き換えます。挿入されるバイトには'˶0'バイトが含まれることがあります。

void QByteArray::reserve(qsizetype size)

少なくともsize バイト分のメモリを確保しようとする。

バイト配列がどれくらいのサイズになるかを事前に知っていれば、この関数を呼び出すことができ、resize() を頻繁に呼び出せば、パフォーマンスが向上する可能性が高い。

どのくらいの容量が必要になるか疑問な場合は、size のような上限値を使用するか、厳密な上限値を使用するとこれよりもはるかに大きくなる場合は、最も可能性の高いサイズの高い推定値を使用する方が通常はよい。size が過小評価である場合、予約されたサイズを超えると配列は必要に応じて大きくなり、過大評価よりも大きな割り当てが行われる可能性があります。

この関数の唯一の目的は、QByteArray のメモリ使用量を微調整する手段を提供することである。通常、この関数を呼び出す必要はほとんどない。

squeeze() およびcapacity()も参照 。

void QByteArray::resize(qsizetype size)

バイト配列のサイズをsize バイトに設定する。

size が現在のサイズより大きい場合、バイト配列はsize バイトに拡張され、余分なバイトが最後に追加される。新しいバイトは初期化されない。

size が現在のサイズより小さい場合、位置size を超えるバイトはバイト配列から除外される。

size()、truncate()、squeeze()も参照の こと。

[since 6.4] void QByteArray::resize(qsizetype newSize, char c)

バイト配列のサイズをnewSize バイトに設定する。

newSize が現在のサイズより大きい場合、バイト配列はnewSize バイトに拡張され、余分なバイトが最後に追加される。新しいバイトはc に初期化される。

newSize が現在のサイズより小さい場合、位置newSize を超えるバイトはバイト配列から除外される。

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

size(),truncate(),squeeze()も参照してください 。

[since 6.8] void QByteArray::resizeForOverwrite(qsizetype size)

バイト配列をsize バイトにリサイズする。バイト配列のサイズが大きくなると、新しいバイトは初期化されない。

動作はresize(size) と同じです。

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

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

QByteArray QByteArray::rightJustified(qsizetype width, char fill = ' ', bool truncate = false) const

このバイト配列に続くfill バイトを含む、サイズwidth のバイト配列を返す。

truncate が偽で、バイト配列のサイズがwidth より大きい場合、返されるバイト配列はこのバイト配列のコピーである。

truncate が真で、バイト配列のサイズがwidth より大きい場合、返されるバイト配列はwidth の位置で切り捨てられる。

例：

QByteArray x("apple");
QByteArray y = x.rightJustified(8, '.');    // y == "...apple"

leftJustified()も参照のこと 。

QByteArray &QByteArray::setNum(int n, int base = 10)

整数n をテキストとして表現する。

このバイト配列を、base （デフォルトは10）を基数としてn を表す文字列に設定し、このバイト配列への参照を返す。2 から 36 までの基数をサポートし、9 以降の数字にはアルファベットを使用します。

例

QByteArray ba;
int n = 63;
ba.setNum(n);           // ba == "63"
ba.setNum(n, 16);       // ba == "3f"

number() およびtoInt()も参照の こと。

QByteArray &QByteArray::setNum(long n, int base = 10)

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

toLong()も参照 。

QByteArray &QByteArray::setNum(qlonglong n, int base = 10)

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

toLongLong()も参照 。

QByteArray &QByteArray::setNum(qulonglong n, int base = 10)

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

toULongLong()も参照 。

QByteArray &QByteArray::setNum(short n, int base = 10)

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

toShort()も参照 。

QByteArray &QByteArray::setNum(uint n, int base = 10)

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

toUInt()も参照 。

QByteArray &QByteArray::setNum(ulong n, int base = 10)

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

toULong()も参照 。

QByteArray &QByteArray::setNum(ushort n, int base = 10)

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

toUShort()も参照 。

QByteArray &QByteArray::setNum(double n, char format = 'g', int precision = 6)

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

浮動小数点数n をテキストとして表現する。

このバイト配列を、与えられたformat とprecision （QString::number （double、char、int）と同じ意味を持つ）で、n を表す文字列に設定し、このバイト配列への参照を返します。

toDouble() およびQLocale::FloatingPointPrecisionOptionも参照のこと 。

QByteArray &QByteArray::setNum(float n, char format = 'g', int precision = 6)

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

浮動小数点数n をテキストとして表現する。

このバイト配列をn を表す文字列に設定し、与えられたformat とprecision （QString::number （double、char、int）と同じ意味）を指定し、このバイト配列への参照を返します。

toFloat()も参照 。

QByteArray &QByteArray::setRawData(const char *data, qsizetype size)

data 配列の最初のsize バイトを使用するようにQByteArray をリセットする。バイトはコピーされない。QByteArray にはdata ポインタが格納される。呼び出し元は、このQByteArray と、変更されていないそのコピーが存在する限り、data が削除されたり変更されたりしないことを保証する。

この関数は、fromRawData() の代わりに使用して、既存のQByteArray オブジェクトを再利用し、メモリの再割り当てを節約することができる。

fromRawData()、data()、constData()も参照 。

void QByteArray::shrink_to_fit()

この関数は STL との互換性のために提供されている。squeeze() と同等です。

QByteArray QByteArray::simplified() const

このバイト配列の先頭と末尾からスペーシング文字を削除し、内部スペーシング文字の各シーケンスを 1 つのスペースに置き換えたコピーを返します。

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

例

QByteArray ba("  lots\t of\nwhitespace\r\n ");
ba = ba.simplified();
// ba == "lots of whitespace";

trimmed()、QChar::SpecialCharacter 、Spacing Charactersも参照してください 。

[noexcept] qsizetype QByteArray::size() const

このバイト配列のバイト数を返す。

バイト配列の最後のバイトは size() - 1 の位置にあります。また、QByteArray は size() の位置のバイトが常に ' \0' であることを保証するので、data() とconstData() の返り値を ' \0' 終端の文字列を期待する関数の引数として使用できます。QByteArray オブジェクトが、末尾の'˶0'終端バイトを含まないraw data から作成された場合、ディープコピーが作成されない限り、QByteArray は自動的にそれを追加しません。

例：

QByteArray ba("Hello");
qsizetype n = ba.size();    // n == 5
ba.data()[0];               // returns 'H'
ba.data()[4];               // returns 'o'
ba.data()[5];               // returns '\0'

isEmpty() およびresize()も参照のこと 。

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

このバイト配列をpos の位置から開始するように変更し、n バイト分拡張して、このバイト配列への参照を返す。

例

QByteArray x = "Five pineapples"_ba;
x.slice(5);     // x == "pineapples"
x.slice(4, 3);  // x == "app"

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

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

[since 6.8] QByteArray &QByteArray::slice(qsizetype pos)

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

このバイト配列をpos の位置から開始し、末尾まで拡張するように変更し、このバイト配列への参照を返します。

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

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

QList<QByteArray> QByteArray::split(char sep) const

バイト配列を、sep が出現する箇所でサブ配列に分割し、そのリストを返す。sep がバイト配列のどこにもマッチしない場合、 split() はこのバイト配列を含む単一要素のリストを返す。

void QByteArray::squeeze()

配列のデータ格納に不要なメモリを解放する。

この関数の唯一の目的は、QByteArray のメモリ使用量を微調整する手段を提供することである。一般に、この関数を呼び出す必要はほとんどない。

reserve() およびcapacity()も参照 。

[since 6.0] bool QByteArray::startsWith(QByteArrayView bv) const

このバイト配列がbv で見たバイト列で始まっていればtrue を返し、そうでなければfalse を返す。

例

QByteArray url("ftp://ftp.qt-project.org/");
if (url.startsWith("ftp:"))
    ...

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

endsWith() およびfirst()も参照してください 。

bool QByteArray::startsWith(char ch) const

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

このバイト配列がバイトch で始まっていればtrue を返し、そうでなければfalse を返す。

[noexcept] void QByteArray::swap(QByteArray &other)

このバイト配列をother と入れ替える。この操作は非常に高速で、失敗することはない。

QByteArray QByteArray::toBase64(QByteArray::Base64Options options = Base64Encoding) const

オプションoptions を使ってエンコードしたバイト配列のコピーを返す。

QByteArray text("Qt is great!");
text.toBase64();        // returns "UXQgaXMgZ3JlYXQh"

QByteArray text("<p>Hello?</p>");
text.toBase64(QByteArray::Base64Encoding | QByteArray::OmitTrailingEquals);      // returns "PHA+SGVsbG8/PC9wPg"
text.toBase64(QByteArray::Base64Encoding);                                       // returns "PHA+SGVsbG8/PC9wPg=="
text.toBase64(QByteArray::Base64UrlEncoding);                                    // returns "PHA-SGVsbG8_PC9wPg=="
text.toBase64(QByteArray::Base64UrlEncoding | QByteArray::OmitTrailingEquals);   // returns "PHA-SGVsbG8_PC9wPg"

Base64エンコードされたデータのエンコードに使われるアルゴリズムはRFC 4648 で定義されています。

fromBase64()も参照 。

CFDataRef QByteArray::toCFData() const

QByteArray から CFData を作成します。

呼び出し元は CFData オブジェクトを所有し、それを解放する責任があります。

toRawCFData(),fromCFData(),fromRawCFData(),fromRawData()も参照 。

double QByteArray::toDouble(bool *ok = nullptr) const

double 値に変換されたバイト配列を返す。

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

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

QByteArray string("1234.56");
bool ok;
double a = string.toDouble(&ok);   // a == 1234.56, ok == true

string = "1234.56 Volt";
a = str.toDouble(&ok);             // a == 0, ok == false

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

number()も参照のこと 。

[since 6.5] emscripten::val QByteArray::toEcmaUint8Array()

QByteArray から Uint8Array を作成します。

この関数は、QByteArray が所有するヒープメモリから JavaScript データバッファにデータを転送します。この関数は ArrayBuffer を確保してコピーし、そのバッファへの Uint8Array ビューを返します。

JavaScriptオブジェクトはデータのコピーを所有し、このQByteArray 、コピー後に安全に削除することができます。

QByteArray byteArray = "test";
emscripten::val uint8array = byteArray.toEcmaUint8Array();

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

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

float QByteArray::toFloat(bool *ok = nullptr) const

float 値に変換されたバイト配列を返す。

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

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

QByteArray string("1234.56");
bool ok;
float a = string.toFloat(&ok);    // a == 1234.56, ok == true

string = "1234.56 Volt";
a = str.toFloat(&ok);              // a == 0, ok == false

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

number()も参照のこと 。

QByteArray QByteArray::toHex(char separator = '\0') const

バイト配列を 16 進エンコードしたものを返す。

16 進エンコードでは、0 ～ 9 の数字と a ～ f の文字が使用されます。

separator が ' \0' でない場合、16 進バイトの間に区切り文字が挿入されます。

例

QByteArray macAddress = QByteArray::fromHex("123456abcdef");
macAddress.toHex(':'); // returns "12:34:56:ab:cd:ef"
macAddress.toHex(0);   // returns "123456abcdef"

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

int QByteArray::toInt(bool *ok = nullptr, int base = 10) const

base を基数としてint に変換されたバイト配列を返す。Aは10、Bは11というように、9を超える数字にはアルファベットを使用します。

base が0の場合、塩基は以下のルールで自動的に決定される：バイト配列が "0x "で始まる場合、16進数（基数16）であると仮定され、そうでない場合、"0b "で始まる場合、2進数（基数2）であると仮定され、そうでない場合、"0 "で始まる場合、8進数（基数8）であると仮定され、そうでない場合、10進数であると仮定される。

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

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

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

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

long QByteArray::toLong(bool *ok = nullptr, int base = 10) const

base を基数としてlong int に変換したバイト配列を返す。Aは10、Bは11というように、9を超える数字にはアルファベットを使用します。

base が0の場合、塩基は以下のルールで自動的に決定される：バイト配列が "0x "で始まる場合、16進数（基数16）であると仮定され、そうでない場合、"0b "で始まる場合、2進数（基数2）であると仮定され、そうでない場合、"0 "で始まる場合、8進数（基数8）であると仮定され、そうでない場合、10進数であると仮定される。

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

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

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

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

qlonglong QByteArray::toLongLong(bool *ok = nullptr, int base = 10) const

base を基数としてlong long に変換されたバイト配列を返す。Aは10、Bは11というように、9を超える数字にはアルファベットを使用します。

base が0の場合、塩基は以下のルールで自動的に決定される：バイト配列が "0x "で始まる場合、16進数（基数16）であると仮定され、そうでない場合、"0b "で始まる場合、2進数（基数2）であると仮定され、そうでない場合、"0 "で始まる場合、8進数（基数8）であると仮定され、そうでない場合、10進数であると仮定される。

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

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

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

QByteArray QByteArray::toLower() const

ASCIIの大文字を小文字に変換したバイト配列のコピーを返す。

例：

QByteArray x("Qt by THE QT COMPANY");
QByteArray y = x.toLower();
// y == "qt by the qt company"

isLower()、toUpper() およびCharacter Caseも参照 。

NSData *QByteArray::toNSData() const

QByteArray から NSData を作成する。

NSData オブジェクトは自動解放される。

fromNSData()、fromRawNSData()、fromRawData() およびtoRawNSData()も参照してください 。

QByteArray QByteArray::toPercentEncoding(const QByteArray &exclude = QByteArray(), const QByteArray &include = QByteArray(), char percent = '%') const

このバイト配列のURI/URL形式のパーセントエンコードされたコピーを返します。percent パラメータを使用すると、デフォルトの '%' 文字を別の文字に置き換えることができます。

デフォルトでは、この関数は以下のいずれでもないすべてのバイトをエンコードします：

ALPHA（"a "から "z"、"A "から "Z"）／DIGIT（0から9）／"-"／"./ "_" / "~"

バイトがエンコードされないようにするには、exclude に渡します。バイトを強制的にエンコードさせるには、include に渡します。percent キャラクタは常にエンコードされます。

例

QByteArraytext= "{あやしい文字列?}"；QByteArrayba=text.toPercentEncoding("{}", "s")；qDebug("%s", ba.constData());
// "{a fi%73hy %73tring%3F}" を表示

16進エンコーディングでは、0～9の数字とA～Fの大文字が使われる。

fromPercentEncoding() およびQUrl::toPercentEncoding()も参照のこと 。

CFDataRef QByteArray::toRawCFData() const

QByteArray のバイトを使用する CFData を構築する。

QByteArray のバイトはコピーされません。

呼び出し元は、この CFData オブジェクトが存在する限り、QByteArray が削除されたり変更されたりしないことを保証します。

toCFData()、fromRawCFData()、fromCFData()、fromRawData()も参照 。

NSData *QByteArray::toRawNSData() const

QByteArray のバイトを使用する NSData を構築する。

QByteArray のバイトはコピーされない。

呼び出し元は、この NSData オブジェクトが存在する限り、QByteArray が削除または変更されないことを保証する。

fromRawNSData()、fromNSData()、fromRawData()、toNSData()も参照 。

short QByteArray::toShort(bool *ok = nullptr, int base = 10) const

base を基数としてshort に変換されたバイト配列を返す。Aは10、Bは11というように、9を超える数字にはアルファベットを使用します。

base が0の場合、塩基は以下のルールで自動的に決定される：バイト配列が "0x "で始まる場合、16進数（基数16）であると仮定され、そうでない場合、"0b "で始まる場合、2進数（基数2）であると仮定され、そうでない場合、"0 "で始まる場合、8進数（基数8）であると仮定され、そうでない場合、10進数であると仮定される。

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

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

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

std::string QByteArray::toStdString() const

このQByteArray に含まれるデータを std::string オブジェクトとして返す。

この演算子は、std::string オブジェクトを受け取る関数にQByteArray を渡すのに便利です。

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

uint QByteArray::toUInt(bool *ok = nullptr, int base = 10) const

base を基数としてunsigned int に変換されたバイト配列を返す。Aは10、Bは11というように、9を超える数字にはアルファベットを使用します。

base が0の場合、塩基は以下のルールで自動的に決定される：バイト配列が "0x "で始まる場合、16進数（基数16）であると仮定され、そうでない場合、"0b "で始まる場合、2進数（基数2）であると仮定され、そうでない場合、"0 "で始まる場合、8進数（基数8）であると仮定され、そうでない場合、10進数であると仮定される。

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

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

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

ulong QByteArray::toULong(bool *ok = nullptr, int base = 10) const

base を基数としてunsigned long int に変換されたバイト配列を返す。Aは10、Bは11というように、9を超える数字にはアルファベットを使用します。

base が0の場合、塩基は以下のルールで自動的に決定される：バイト配列が "0x "で始まる場合、16進数（基数16）であると仮定され、そうでない場合、"0b "で始まる場合、2進数（基数2）であると仮定され、そうでない場合、"0 "で始まる場合、8進数（基数8）であると仮定され、そうでない場合、10進数であると仮定される。

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

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

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

qulonglong QByteArray::toULongLong(bool *ok = nullptr, int base = 10) const

base を基数としてunsigned long long に変換されたバイト配列を返す。Aは10、Bは11というように、9を超える数字にはアルファベットを使用します。

base が0の場合、塩基は以下のルールで自動的に決定される：バイト配列が "0x "で始まる場合、16進数（基数16）であると仮定され、そうでない場合、"0b "で始まる場合、2進数（基数2）であると仮定され、そうでない場合、"0 "で始まる場合、8進数（基数8）であると仮定され、そうでない場合、10進数であると仮定される。

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

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

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

ushort QByteArray::toUShort(bool *ok = nullptr, int base = 10) const

base を基数としてunsigned short に変換されたバイト配列を返す。Aは10、Bは11というように、9を超える数字にはアルファベットを使用します。

base が0の場合、塩基は以下のルールで自動的に決定される：バイト配列が "0x "で始まる場合、16進数（基数16）であると仮定され、そうでない場合、"0b "で始まる場合、2進数（基数2）であると仮定され、そうでない場合、"0 "で始まる場合、8進数（基数8）であると仮定され、そうでない場合、10進数であると仮定される。

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

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

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

QByteArray QByteArray::toUpper() const

ASCIIの小文字を大文字に変換したバイト配列のコピーを返す。

例：

QByteArray x("Qt by THE QT COMPANY");
QByteArray y = x.toUpper();
// y == "QT BY THE QT COMPANY"

isUpper()、toLower() およびCharacter Caseも参照 。

QByteArray QByteArray::trimmed() const

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

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

例

QByteArray ba("  lots\t of\nwhitespace\r\n ");
ba = ba.trimmed();
// ba == "lots\t of\nwhitespace";

例:simplified() と異なり、trimmed() は内部スペースを変更しません。

simplified()、QChar::SpecialCharacter 、およびSpacing Charactersも参照してください 。

void QByteArray::truncate(qsizetype pos)

バイト配列をインデックス位置pos で切り捨てる。

pos が配列の終端を超えている場合は、何も起こらない。

例：

QByteArray ba("Stockholm");
ba.truncate(5);             // ba == "Stock"

chop()、resize()、first()も参照 。

QByteArray &QByteArray::operator+=(const QByteArray &ba)

バイト配列ba をこのバイト配列の末尾に追加し、このバイト配列への参照を返します。

例

QByteArray x("free");
QByteArray y("dom");
x += y;
// x == "freedom"

注意:QByteArray は暗黙の共有クラスです。したがって、空のバイト配列に追加した場合、そのバイト配列はba に保持されているデータを共有するだけです。 この場合、データのコピーは行われず、一定の時間がかかります。共有インスタンスが変更された場合、そのインスタンスはコピーされ（コピーオンライト）、線形時間がかかる。

追加されるバイト配列が空でない場合、データのディープコピーが実行され、線形時間がかかる。

QByteArray 、データの末尾に余分な領域があらかじめ割り当てられているため、追記操作のたびに再割り当てすることなくデータを増やすことができる。

append() およびprepend()も参照の こと。

QByteArray &QByteArray::operator+=(char ch)

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

バイトch をこのバイト配列の最後に追加し、このバイト配列への参照を返します。

QByteArray &QByteArray::operator+=(const char *str)

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

バイト配列の末尾に'˶0'終端の文字列str を追加し、このバイト配列への参照を返します。

[noexcept] QByteArray &QByteArray::operator=(QByteArray &&other)

Move-other をこのQByteArray インスタンスに割り当てる。

[noexcept] QByteArray &QByteArray::operator=(const QByteArray &other)

このバイト配列にother を代入し、このバイト配列への参照を返す。

QByteArray &QByteArray::operator=(const char *str)

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

このバイト配列にstr を代入する。

str はヌル終端文字列を指すと仮定され、その長さは動的に決定されます。

char &QByteArray::operator[](qsizetype i)

インデックス位置i のバイトを変更可能な参照として返す。

i は、バイト配列の有効なインデックス位置でなければなりません (すなわち、0 <= < ())。i size

例：

QByteArray ba("Hello, world");
cout << ba[0]; // prints H
ba[7] = 'W';
// ba == "Hello, World"

at()も参照のこと 。

char QByteArray::operator[](qsizetype i) const

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

at(i) と同じ。