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

바이트 배열의 마지막 바이트 바로 다음을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

참조: ` 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보다 작거나, 같거나, 큰 정수를 반환합니다. 비교는 대소문자 구분 설정 cs 에 따라 수행됩니다.

이 함수는 Qt 6.0에서 도입되었습니다.

operator== 및 Character Case도 참조하십시오 .

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

바이트 배열의 첫 번째 바이트를 가리키는 const STL 스타일의 이터레이터를 반환합니다.

참조: ` begin()` 및 ` constEnd()`.

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

바이트 배열에 저장된 const 데이터에 대한 포인터를 반환합니다. 이 포인터를 사용하여 배열을 구성하는 바이트에 접근할 수 있습니다. QByteArray 객체가 원시 데이터로부터 생성된 경우가 아닌 한, 데이터는 '\0'로 종료됩니다.

이 포인터는 detach가 발생하지 않고 QByteArray 이 수정되지 않는 한 유효합니다.

이 함수는 주로 ' const char *'을 매개변수로 받는 함수에 바이트 배열을 전달할 때 유용합니다.

참고: QByteArray 는 '\0'을 포함한 모든 바이트 값을 저장할 수 있지만, char * 인자를 받는 대부분의 함수는 데이터가 처음 발견되는 '\0'에서 끝난다고 가정합니다.

data(), operator[](), fromRawData()도 참조하십시오 .

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

바이트 배열의 마지막 바이트 바로 다음을 가리키는 const 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

바이트 배열의 첫 번째 바이트를 역순으로 가리키는 const STL 스타일의 역방향 이터레이터를 반환합니다.

참조: ` begin()`, ` rbegin()`, ` rend()`.

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

바이트 배열의 마지막 바이트 바로 뒤를 가리키는, 역순의 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;
}

포인터는 분리(detach)가 발생하지 않고 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 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)

data 의 복사본을 포함하는 새로운 QByteArray 객체를 생성합니다.

fromRawNSData(), fromRawData(), toNSData() 및 toRawNSData()도 참조하십시오 .

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

URI/URL 형식의 퍼센트 인코딩으로 표현된 input 를 디코딩합니다.

디코딩된 텍스트를 포함하는 바이트 배열을 반환합니다. percent 매개변수를 사용하면 '%' 대신 다른 문자(예: '_' 또는 '=')를 이스케이프 문자로 지정할 수 있습니다. input.percentDecoded(percent)와 동일합니다.

예:

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 에 대한 소유권을 가지지 않으므로, data 를 참조하는 마지막 QByteArray 가 소멸되더라도 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)

data 의 바이트를 사용하는 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 및 그 이상의 모든 바이트를 메모리 내에서 최소 한 칸씩 더 이동시켜야 하므로 속도가 느릴 수 있습니다(선형 시간).

이 배열은 삽입을 수용하기 위해 확장됩니다. 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 XML은 역사적인 이유로 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이면 그에서 한 칸 앞의 문자로부터 시작하며, 이와 같은 방식으로 진행됩니다.

일치하는 항목이 없으면 -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 는 기본적으로 null로 종료되지만, 일부 경우(예: fromRawData() 사용 시) 데이터가 반드시 \0 문자로 끝나는 것은 아니며, 이는 null로 종료된 문자열을 기대하는 메서드(예: C API)를 호출할 때 문제가 될 수 있습니다.

이 함수는 Qt 6.10에서 도입되었습니다.

nullTerminated(), fromRawData() 및 setRawData()도 참조하십시오 .

이 바이트 배열의 복사본을 반환하며, 이 복사본은 항상 null로 종료됩니다. 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 를 텍스트로 나타내는 바이트 배열을 반환합니다.

n 를 나타내는 문자열을 포함하는 바이트 배열을 반환하며, 이때 format 및 precision 는 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)

len 인덱스 위치 pos 에서 시작하여 바이트를 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 라는 부동소수점 숫자를 텍스트로 표현합니다.

이 함수는 주어진 ` format ` 및 ` precision `(` QLocale::toString`(double, char, int)와 동일한 의미)를 사용하여 이 바이트 배열을 ` n`을 나타내는 문자열로 설정하고, 이 바이트 배열에 대한 참조를 반환합니다.

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 는 딥 복사(deep copy) 가 생성되지 않는 한 해당 바이트를 자동으로 추가하지 않습니다.

예시:

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

int base 를 사용하여 변환된 바이트 배열을 반환하며, 여기서 base는 로, 기본값은 10입니다. 기수 0과 2부터 36까지 지원되며, 9를 초과하는 숫자는 문자로 표기됩니다. A는 10, B는 11과 같이 이어집니다.

base 가 0인 경우, 다음 규칙에 따라 기수가 자동으로 결정됩니다. 바이트 배열이 "0x"로 시작하면 16진수(기수 16)로 간주됩니다. 그렇지 않은 경우, "0b"로 시작하면 이진수(기수 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 의 int로 변환된 바이트 배열을 반환하며, 이때 기수(base)는 로 설정됩니다(기본값은 10입니다). 기수 0과 2부터 36까지 지원되며, 9를 초과하는 숫자는 문자로 표기됩니다(A는 10, B는 11 등).

base 가 0인 경우, 다음 규칙에 따라 기수가 자동으로 결정됩니다. 바이트 배열이 "0x"로 시작하면 16진수(기수 16)로 간주됩니다; 그렇지 않은 경우, "0b"로 시작하면 이진수(기수 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

long long base 를 사용하여 변환된 바이트 배열을 반환합니다. 여기서 base는 이며, 기본값은 10입니다. 기수 0과 2부터 36까지 지원되며, 9를 초과하는 숫자는 문자로 표시됩니다. A는 10, B는 11 등을 의미합니다.

base 가 0인 경우, 다음 규칙에 따라 기수가 자동으로 결정됩니다. 바이트 배열이 "0x"로 시작하면 16진수(기수 16)로 간주됩니다. 그렇지 않은 경우, "0b"로 시작하면 이진수(기수 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 를 사용하여 변환된 바이트 배열을 반환합니다. 여기서 base는 이며, 기본값은 10입니다. 기수 0과 2부터 36까지 지원되며, 9를 초과하는 숫자는 문자로 표기됩니다(A는 10, B는 11 등).

base 가 0인 경우, 다음 규칙에 따라 기수가 자동으로 결정됩니다. 바이트 배열이 "0x"로 시작하면 16진수(기수 16)로 간주됩니다. 그렇지 않은 경우, "0b"로 시작하면 이진수(기수 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

unsigned int base 를 사용하여 변환된 바이트 배열을 반환합니다. 여기서 base는 이며, 기본값은 10입니다. 기수 0과 2부터 36까지 지원되며, 9를 초과하는 자릿수에는 문자가 사용됩니다. A는 10, B는 11을 나타내는 식입니다.

base 가 0인 경우, 다음 규칙에 따라 기수가 자동으로 결정됩니다. 바이트 배열이 "0x"로 시작하면 16진수(기수 16)로 간주됩니다. 그렇지 않은 경우, "0b"로 시작하면 이진수(기수 2)로 간주하고; 그렇지 않은 경우, "0"으로 시작하면 8진수(기수 8)로 간주하며; 그 외의 경우에는 10진수로 간주합니다.

변환에 실패하면 0을 반환합니다.

ok 가 nullptr 가 아닌 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

number()도 참조하십시오 .

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

unsigned long int base 를 사용하여 바이트 배열을 변환한 값을 반환합니다. 여기서 base 는 기본적으로 10입니다. 기수 0과 2부터 36까지 지원되며, 9를 초과하는 숫자는 문자로 표기됩니다(A는 10, B는 11 등).

base 가 0인 경우, 다음 규칙에 따라 기수가 자동으로 결정됩니다. 바이트 배열이 "0x"로 시작하면 16진수(기수 16)로 간주됩니다. 그렇지 않은 경우, "0b"로 시작하면 이진수(기수 2)로 간주됩니다; 그렇지 않은 경우, "0"으로 시작하면 8진수(기수 8)로 간주됩니다; 그 외의 경우에는 10진수로 간주됩니다.

변환에 실패하면 0을 반환합니다.

ok 가 nullptr 가 아닌 경우, *ok 를 false 로 설정하여 실패를 알리고, *ok 를 true 로 설정하여 성공을 알립니다.

number()도 참조하십시오 .

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

unsigned long long base 를 사용하여 변환된 바이트 배열을 반환합니다. 여기서 base 는 기본적으로 10입니다. 기수 0 및 2부터 36까지 지원되며, 9를 초과하는 숫자는 문자로 표시됩니다. A는 10, B는 11을 나타내며, 이와 같은 방식으로 이어집니다.

base 가 0인 경우, 다음 규칙에 따라 기수가 자동으로 결정됩니다. 바이트 배열이 "0x"로 시작하면 16진수(기수 16)로 간주됩니다; 그렇지 않은 경우, "0b"로 시작하면 이진수(기수 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 를 사용하여 변환된 바이트 배열을 반환합니다. 여기서 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 는 null로 종료되는 문자열을 가리키는 것으로 간주되며, 그 길이는 동적으로 결정됩니다.

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)과 동일합니다.