QByteArray Class

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

[constexpr noexcept] QByteArray::QByteArray()

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

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

[explicit, since 6.8] QByteArray::QByteArray(QByteArrayView v)

バイト配列ビューのデータで初期化されたバイト配列を生成します。

v がnullである場合に限り、QByteArrayもnullになります。

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

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 buffer(123, Qt::Uninitialized);

QByteArray::QByteArray(qsizetype size, char ch)

サイズがsize のバイト配列を構築し、各バイトをch に設定します。

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

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

other のコピーを作成します。

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

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

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

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 が負の数または 0 の場合、バイト配列には何も追加されません。

[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) 内の要素数と同じになります。

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

制約

InputIterator がLegacyInputIterator の要件を満たしている場合にのみ、オーバーロードの解決に関与します。

この関数は 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 i は、バイト配列内の有効なインデックス位置である必要があります（つまり、0 <= < ())。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()

バイト配列の先頭バイトを指すSTL形式のイテレータを返します。

関連項目： constBegin() およびend()。

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

qsizetype QByteArray::capacity() const

バイト配列に再割り当てを強制することなく格納できる最大バイト数を返します。

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

関連項目： reserve() およびsqueeze()。

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

バイト配列の最初のバイトを指す、STL スタイルのconstイテレータを返します。

関連項目： begin() およびcend()。

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

バイト配列の最後のバイトの直後を指す、STL スタイルのconstイテレータを返します。

関連項目： cbegin() およびend()。

void QByteArray::chop(qsizetype n)

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

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

例:

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

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

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

関連項目： endsWith()、first()、last()、sliced()、chop()、truncate()、およびslice()。

void QByteArray::clear()

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

resize() およびisNull()も参照してください 。

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

このQByteArray が、QByteArrayView bv の前、同じ位置、または後にソートされるかによって、0未満、0以上、または0より大きい整数を返します。比較は、大文字と小文字の区別cs に従って行われます。

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

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

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

バイト配列の最初のバイトを指す、STL スタイルのconstイテレータを返します。

関連項目： begin() およびconstEnd()。

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

バイト配列に格納されている定数データへのポインタを返します。このポインタを使用すると、配列を構成するバイトにアクセスできます。QByteArray オブジェクトが生データから作成された場合を除き、データは「\0 」で終了します。

このポインタは、detachが発生せず、かつQByteArray が変更されない限り、有効なままです。

この関数は、主に `const char *` を受け入れる関数にバイト配列を渡す際に役立ちます。

注：QByteArray は、「\0 」を含むあらゆるバイト値を格納できますが、char * 引数を受け取るほとんどの関数は、データが最初に遭遇した「\0 」で終了すると想定しています。

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

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

バイト配列の最後のバイトの直後を指す、STL スタイルのconstイテレータを返します。

関連項目: 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

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

関連項目: begin(),rbegin(), およびrend()。

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

バイト配列の最後のバイトの直後の位置を指す、STL 形式の定数逆イテレータを、逆順で返します。

関連項目： 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()

バイト配列の最後のバイトの直後を指す、STL スタイルのイテレータを返します。

関連項目： begin() およびconstEnd()。

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

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

バイト配列の先頭n バイトを返します。

例：

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

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

関連項目： last()、sliced()、startsWith()、chopped()、chop()、truncate()、およびslice()。

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

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

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

CFData `data` のコピーを含む新しい `QByteArray ` を作成します。

fromRawCFData()、fromRawData()、toRawCFData()、およびtoCFData()も参照してください 。

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

Uint8Array `uint8array` のコピーを含む新しい `QByteArray ` を生成します。

この関数は、C++コードからはアドレス指定できないJavaScriptデータバッファから、QByteArray が所有するヒープメモリへデータを転送します。この関数が戻り、コピーが完了したら、Uint8Arrayを解放しても構いません。

uint8array 引数は、Uint8Arrayオブジェクトを参照するemscripten::valでなければなりません。例えば、グローバルなJavaScript変数から取得したものなどです：

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

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

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

NSData `data` のコピーを含む、新しい `QByteArray ` を作成します。

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

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

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

デコードされたテキストを含むバイト配列を返します。percent パラメータを使用すると、エスケープ文字として「%」以外の文字（例えば「_」や「=」など）を指定できます。input.percentDecoded （パーセント）と同等です。

例：

QByteArray text=QByteArray::fromPercentEncoding("Qt%20is%20great%33");
qDebug("%s", text.data());      // reports "Qt is great!"

「percentDecoded()」も参照してください 。

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

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

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

CFData `data` のバイトを使用する `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()、nullTerminate()、およびnullTerminated()も参照してください 。

[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

このバイト配列内で、バイトch が最初に現れる位置のインデックスを、インデックス位置from から前方へ検索して返します。一致する箇所が見つからない場合は-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 に到達するまで、配列はスペース文字で拡張されます。

[constexpr 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 で導入されました。

バイト配列の末尾n バイトを返します。

例:

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

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

関連項目： first()、sliced()、endsWith()、chopped()、chop()、truncate()、およびslice()。

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

このバイト配列において、bv によって処理されたバイトシーケンスの最後の出現箇所の先頭位置を、インデックス位置from から逆方向に検索して返します。

from が -1 の場合は最後の文字から、-2 の場合は最後から 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

このバイト配列内で、バイトch が最後に現れる位置のインデックスを、インデックス位置from から逆方向に検索して返します。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()も参照してください 。

このバイト配列の先頭len バイトを含むバイト配列を返します。

len が範囲外になることがないことが分かっている場合は、新しいコードではfirst()を使用してください。こちらの方が高速です。

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

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

関連項目： first()、last()、startsWith()、chopped()、chop()、およびtruncate()。

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

width のサイズのバイト配列を返します。このバイト配列には、fill バイトでパディングされた元のバイト配列が含まれます。

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

truncate がtrueで、バイト配列のsize()がwidth より大きい場合、位置width 以降のバイト配列のコピーからバイトが削除され、そのコピーが返されます。

例：

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

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

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

size() と同じです。

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

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

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

pos およびlen が範囲外になることがないことが分かっている場合は、新しいコードではsliced() を使用してください。こちらの方が高速です。

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

first()、last()、sliced()、chopped()、chop()、truncate()、およびslice()も参照してください 。

[since 6.10] QByteArray &QByteArray::nullTerminate()

このバイト配列のデータがヌル終端されていない場合、このメソッドはデータのディープコピーを作成し、ヌル終端にします。

QByteArray はデフォルトでヌル終端されていますが、場合によっては（例：fromRawData()を使用する場合など）、データが必ずしも\0 文字で終わるとは限らず、ヌル終端された文字列を期待するメソッド（例：C API）を呼び出す際に問題となる可能性があります。

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

nullTerminated()、fromRawData()、およびsetRawData()も参照してください 。

このバイト配列の、常にヌル終端されたコピーを返します。nullTerminate() を参照してください。

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

nullTerminate()、fromRawData()、およびsetRawData()も参照してください 。

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

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

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

例：

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 ` をテキストとして表すバイト配列を返します。

指定されたformat およびprecision を用いて、n を表す文字列を含むバイト配列を返します。これらの引数の意味は、QLocale::toString （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()`。

[since 6.11] QByteArray QByteArray::percentDecoded(char percent = '%') &&

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

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

バイト配列の最初のバイトを指す、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 ` が `true` を返すすべてのバイトを削除します。バイト配列への参照を返します。

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

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

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

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

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

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

QByteArray::reverse_iterator QByteArray::rend()

バイト配列の最後のバイトの直後を指す、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()も参照してください 。

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

len が範囲外になることがないことが分かっている場合は、新しいコードではlast()を使用してください。こちらの方が高速です。

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

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

関連項目： endsWith()、last()、first()、sliced()、chopped()、chop()、truncate()、およびslice()。

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

width のサイズのバイト配列を返します。この配列には、fill のバイトに続いて、このバイト配列が含まれます。

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

truncate がtrueで、バイト配列のサイズが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を超える数字にはアルファベットが使用されます。Aは10、Bは11というように続きます。

例：

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 ` をテキストとして表現します。

このバイト配列を、n を表す文字列に設定します。この際、format およびprecision が指定されます（QLocale::toString(double, char, int) と同様の意味を持ちます）。そして、このバイト配列への参照を返します。

toDouble() およびQLocale::FloatingPointPrecisionOptionも参照してください 。

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

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

このバイト配列を、n を表す文字列に設定します。この際、format およびprecision が指定されます（これらはQLocale::toString(double, char, int) と同様の意味を持ちます）。そして、このバイト配列への参照を返します。

toFloat() およびQLocale::FloatingPointPrecisionOptionも参照してください 。

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

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

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

fromRawData()、data()、constData()、nullTerminate()、およびnullTerminated()も参照してください 。

void QByteArray::shrink_to_fit()

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

QByteArray QByteArray::simplified() const

このバイト配列のコピーを返します。このコピーでは、先頭と末尾から区切り文字が削除され、内部の区切り文字の各シーケンスが単一のスペースに置き換えられています。

ここでいう空白文字とは、Cロケールにおいて標準C++のisspace() 関数が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 。

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

このオブジェクトの、位置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()。

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 hello("<p>Hello?</p>");
hello.toBase64(QByteArray::Base64Encoding | QByteArray::OmitTrailingEquals);      // returns "PHA+SGVsbG8/PC9wPg"
hello.toBase64(QByteArray::Base64Encoding);                                       // returns "PHA+SGVsbG8/PC9wPg=="
hello.toBase64(QByteArray::Base64UrlEncoding);                                    // returns "PHA-SGVsbG8_PC9wPg=="
hello.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 = string.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 で導入されました。

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

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 = string.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 に変換したものを返します。ここで、基数は で指定され、デフォルトは 10 です。基数 0 および 2 から 36 までがサポートされており、9 を超える数字にはアルファベットが使用されます。A は 10、B は 11 というように続きます。

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

long base の整数に変換されたバイト配列を返します。基数は で指定され、デフォルトは10です。基数0および2から36までがサポートされており、9を超える数字にはアルファベットが使用されます。Aは10、Bは11というように続きます。

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 に変換したものを返します。ここで、 はデフォルトで 10 です。基数 0 および 2 から 36 までがサポートされており、9 より大きい数字にはアルファベットが使用されます。A は 10、B は 11 というように続きます。

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 文字は常にエンコードされます。

例：

QByteArray text= "{怪しい文字列？}";
QByteArray ba=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

short base を使用して、ベース （デフォルトは10）に変換されたバイト配列を返します。ベース0および2から36までがサポートされており、9を超える数字にはアルファベットが使用されます。Aは10、Bは11というように続きます。

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オブジェクトを返します。

この演算子は、主に `QByteArray ` を `std::string` オブジェクトを受け取る関数に渡す際に役立ちます。

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

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

base を使用して、バイタ配列をunsigned int に変換したものを返します。ここで、 はデフォルトで 10 です。基数 0 および 2 から 36 までがサポートされており、9 を超える数字にはアルファベットが使用されます。A は 10、B は 11 というように続きます。

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 に変換したものを返します。ここで、base はデフォルトで 10 です。基数 0 および 2 から 36 までがサポートされており、9 より大きい数字にはアルファベットが使用されます。A は 10、B は 11 というように続きます。

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 に変換したものを返します。ここで、 はデフォルトで 10 です。基数 0 および 2 から 36 までがサポートされており、9 を超える数字にはアルファベットが使用されます。A は 10、B は 11 というように続きます。

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

unsigned short base を使用して、基数 （デフォルトは 10）に変換されたバイト配列を返します。基数 0 および 2 から 36 までがサポートされており、9 を超える数字にはアルファベットが使用されます。A は 10、B は 11 というように続きます。

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ロケールにおいて標準C++のisspace() 関数が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()も参照してください 。

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

detachが発生せず、QByteArray が変更されない限り、このポインタは有効です。

この演算子は、主に `const char *` を受け取る関数にバイト配列を渡す際に役立ちます。

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

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

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

[noexcept, since 6.10] QByteArray::operator std::string_view() const

この `QByteArray ` オブジェクトを `std::string_view ` オブジェクトに変換します。返される文字列ビューは、バイト配列全体をカバーします。

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

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)

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 i は、バイト配列内の有効なインデックス位置でなければなりません（つまり、0 <= < ())。size

例:

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

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

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

(i) と同様です。