QByteArray Class

멤버 함수 문서

이 함수는 바이트 배열이 이론적으로 보유할 수 있는 최대 요소 수를 반환합니다. 실제로는 시스템에서 사용할 수 있는 메모리 양에 의해 제한되어 이보다 훨씬 적을 수 있습니다.

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

바이트 배열에 저장된 데이터에 대한 포인터를 반환합니다. 이 포인터는 배열을 구성하는 바이트에 액세스하는 데 사용할 수 있습니다. 데이터는 '\0'으로 종료됩니다.

분리되지 않고 QByteArray 이 수정되지 않는 한 포인터는 유효하게 유지됩니다.

이 연산자는 주로 const char * 를 받는 함수에 바이트 배열을 전달할 때 유용합니다.

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_BYTEARRAY 을 정의하여 이 연산자를 비활성화할 수 있습니다.

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

constData()도 참조하세요 .

이 바이트 배열의 첫 번째 len 바이트가 포함된 바이트 배열을 반환합니다.

len 이 범위를 벗어날 수 없다는 것을 알고 있다면 새 코드에서 first() 대신 더 빠른 ()을 사용하세요.

len 이 size()보다 크면 전체 바이트 배열이 반환됩니다.

len 이 0보다 작으면 빈 QByteArray 을 반환합니다.

first(), last(), startsWith(), chopped(), chop() 및 truncate()도 참조하세요 .

이 바이트 배열의 마지막 len 바이트가 포함된 바이트 배열을 반환합니다.

len 이 범위를 벗어날 수 없다는 것을 알고 있다면 새 코드에서 last() 대신 더 빠르므로 이 값을 사용하세요.

len 가 size()보다 크면 전체 바이트 배열이 반환됩니다.

len 이 0보다 작으면 빈 QByteArray 을 반환합니다.

endsWith(), last(), first(), sliced(), chopped(), chop(), truncate(), slice()도 참조하세요 .

위치 pos 부터 시작하여 이 바이트 배열에서 len 바이트가 포함된 바이트 배열을 반환합니다.

pos 및 len 이 범위를 벗어날 수 없다는 것을 알고 있다면 새 코드에서 sliced()를 사용하는 것이 더 빠릅니다.

len 가 -1(기본값)이거나 pos + len >= size()인 경우 위치 pos 부터 시작하여 바이트 배열의 끝까지 모든 바이트가 포함된 바이트 배열을 반환합니다.

first(), last(), sliced(), chopped(), chop(), truncate() 및 slice()도 참조하세요 .

바이트 배열의 첫 번째 n 바이트를 반환합니다.

예제:

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

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

last(), sliced(), startsWith(), chopped(), chop(), truncate() 및 slice()도 참조하세요 .

바이트 배열의 마지막 n 바이트를 반환합니다.

예제:

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

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

first(), sliced(), endsWith(), chopped(), chop(), truncate() 및 slice()도 참조하세요 .

위치 pos 에서 시작하는 이 객체의 n 바이트가 포함된 바이트 배열을 반환합니다.

예제:

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

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

first(), last(), chopped(), chop(), truncate() 및 slice()도 참조하십시오 .

이 함수는 오버로드된 함수입니다.

이 객체의 pos 위치에서 시작하여 이 객체의 끝까지 확장되는 바이트가 포함된 바이트 배열을 반환합니다.

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

first(), last(), chopped(), chop(), truncate() 및 slice()도 참조하세요 .

이 바이트 배열의 가장 왼쪽에 size() - len 바이트가 포함된 바이트 배열을 반환합니다.

endsWith(), first(), last(), sliced(), chop(), truncate() 및 slice()도 참조하세요 .

이 함수는 오버로드된 함수입니다.

options 에 정의된 옵션을 사용하여 Base64 배열 base64 을 디코딩합니다. options 에 IgnoreBase64DecodingErrors (기본값)이 포함된 경우 입력의 유효성을 검사하지 않고 입력의 유효하지 않은 문자를 건너뛰고 다음 문자로 디코딩 프로세스를 계속할 수 있도록 합니다. options 에 AbortOnBase64DecodingErrors 이 포함되어 있으면 첫 번째 유효하지 않은 문자에서 디코딩이 중지됩니다.

예를 들어

void process(const QByteArray &);

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

Base64로 인코딩된 데이터를 디코딩하는 데 사용되는 알고리즘은 RFC 4648에 정의되어 있습니다.

디코딩된 데이터와 디코딩 성공 여부를 알려주는 플래그가 포함된 QByteArrayFromBase64Result 객체를 반환합니다. AbortOnBase64DecodingErrors 옵션이 전달되었고 입력 데이터가 유효하지 않은 경우, 디코딩된 데이터에 포함된 내용은 지정되지 않습니다.

toBase64()도 참조하세요 .

[constexpr noexcept] QByteArray::QByteArray()

빈 바이트 배열을 구축합니다.

isEmpty()도 참조하세요 .

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

data 배열의 첫 번째 size 바이트를 포함하는 바이트 배열을 구축합니다.

data 가 0이면 널 바이트 배열이 구성됩니다.

size 이 음수이면 data 은 '\0'으로 끝나는 문자열을 가리키는 것으로 간주하고 그 길이가 동적으로 결정됩니다.

QByteArray는 문자열 데이터의 딥 카피를 만듭니다.

fromRawData()도 참조하세요 .

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

초기화되지 않은 콘텐츠로 size 크기의 바이트 배열을 구축합니다.

QByteArray::QByteArray(qsizetype size, char ch)

모든 바이트가 ch 로 설정된 크기 size 의 바이트 배열을 구성합니다.

fill()도 참조하세요 .

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

other 의 복사본을 생성합니다.

이 작업은 암시적으로 공유되므로 시간이 일정하게 걸립니다. 따라서 함수에서 QByteArray를 반환하는 속도가 매우 빠릅니다. 공유 인스턴스가 수정되면 복사(쓰기 시 복사)되므로 선형적인 시간이 걸립니다.

operator=()도 참조하세요 .

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

Move - QByteArray 인스턴스를 생성하여 other 가 가리키던 것과 동일한 객체를 가리키도록 합니다.

[noexcept] QByteArray::~QByteArray()

바이트 배열을 파괴합니다.

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

이 바이트 배열의 끝에 ba 바이트 배열을 추가합니다.

예시:

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

삽입(size(), ba)과 동일합니다.

참고: QByteArray 은 암시적으로 공유되는 클래스입니다. 따라서 빈 바이트 배열에 추가하면 바이트 배열은 ba 에 있는 데이터를 공유할 뿐입니다. 이 경우 데이터 복사가 수행되지 않으므로 시간이 계속 걸립니다. 공유 인스턴스가 수정되면 복사(쓰기 시 복사)가 이루어지며 시간이 선형적으로 소요됩니다.

추가되는 바이트 배열이 비어 있지 않으면 데이터의 딥 카피가 수행되며 선형적인 시간이 소요됩니다.

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)의 요소 수와 같습니다.

이 함수는 범위의 요소 수가 이 바이트 배열의 용량을 초과하거나 이 바이트 배열이 공유되는 경우에만 메모리를 할당합니다.

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

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

이 바이트 배열의 내용을 c 의 n 복사본으로 바꾸고 이 바이트 배열에 대한 참조를 반환합니다.

이 바이트 배열의 크기는 n 과 같으며, 음수가 아니어야 합니다.

이 함수는 n 가 이 바이트 배열의 용량을 초과하거나 이 바이트 배열이 공유되는 경우에만 메모리를 할당합니다.

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

fill()도 참조하십시오 .

char QByteArray::at(qsizetype i) const

바이트 배열의 인덱스 위치 i 에 있는 바이트열을 반환합니다.

i 는 바이트 배열에서 유효한 인덱스 위치여야 합니다(즉, 0 <= i < size()).

operator[]()도 참조하세요 .

char &QByteArray::back()

바이트 배열의 마지막 바이트에 대한 참조를 반환합니다. operator[](size() - 1) 와 동일합니다.

이 함수는 STL 호환성을 위해 제공됩니다.

front(), at() 및 operator[]()도 참조하세요 .

char QByteArray::back() const

바이트 배열의 마지막 바이트를 반환합니다. at(size() - 1) 와 동일합니다.

이 함수는 STL 호환성을 위해 제공됩니다.

front(), at() 및 operator[]()도 참조하세요 .

QByteArray::iterator QByteArray::begin()

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

constBegin() 및 end()도 참조하세요 .

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

이 함수는 start()를 오버로드합니다.

qsizetype QByteArray::capacity() const

강제 재할당 없이 바이트 배열에 저장할 수 있는 최대 바이트 수를 반환합니다.

이 함수의 유일한 목적은 QByteArray 의 메모리 사용량을 미세 조정할 수 있는 수단을 제공하는 것입니다. 일반적으로 이 함수를 호출할 필요는 거의 없습니다. 바이트 배열에 몇 바이트가 있는지 알고 싶으면 size()를 호출하세요.

reserve() 및 squeeze()도 참조하세요 .

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

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

begin() 및 cend()도 참조하세요 .

[noexcept] QByteArray::const_iterator QByteArray::cend() 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()도 참조하세요 .

void QByteArray::clear()

바이트 배열의 내용을 지우고 널로 만듭니다.

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

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

begin() 및 constEnd()도 참조하세요 .

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

바이트 배열에 저장된 const 데이터에 대한 포인터를 반환합니다. 이 포인터는 배열을 구성하는 바이트에 액세스하는 데 사용할 수 있습니다. QByteArray 객체가 원시 데이터로 생성되지 않은 경우 데이터는 '\0'으로 종료됩니다.

분리되지 않고 QByteArray 이 수정되지 않는 한 포인터는 유효하게 유지됩니다.

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

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

data(), operator[]() 및 fromRawData()도 참조하세요 .

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

바이트 배열의 마지막 바이트 바로 뒤를 가리키는 상수 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

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

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

이 함수는 end()를 오버로드합니다.

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

이 바이트 배열이 bv 에서 본 바이트 시퀀스로 끝나면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

예제:

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

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

startsWith() 및 last()도 참조하십시오 .

bool QByteArray::endsWith(char ch) const

이 함수는 오버로드된 함수입니다.

이 바이트 배열이 바이트 ch 로 끝나면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

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

바이트 배열에서 반개방 범위의 문자[ first, last ]를 제거합니다. 지우기 전에 last 가 참조한 문자에 대한 이터레이터를 반환합니다.

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

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

이 함수는 오버로드된 함수입니다.

it 로 표시된 문자를 바이트 배열에서 제거합니다. 지워진 문자 바로 뒤에 있는 문자에 대한 이터레이터를 반환합니다.

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

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

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

바이트 배열의 모든 바이트를 ch 로 설정합니다. size 이 -1(기본값)과 다른 경우, 바이트 배열의 크기가 미리 size 크기로 조정됩니다.

예시:

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

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

resize()도 참조하세요 .

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

options 에 정의된 옵션을 사용하여 Base64 배열 base64 의 디코딩된 사본을 반환합니다. options 에 IgnoreBase64DecodingErrors (기본값)이 포함된 경우 입력의 유효성을 검사하지 않고 입력의 유효하지 않은 문자를 건너뛰고 다음 문자로 디코딩 프로세스를 계속할 수 있습니다. options 에 AbortOnBase64DecodingErrors 이 포함되어 있으면 첫 번째 유효하지 않은 문자에서 디코딩이 중지됩니다.

예를 들어

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

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

Base64로 인코딩된 데이터를 디코딩하는 데 사용되는 알고리즘은 RFC 4648에 정의되어 있습니다.

디코딩된 데이터를 반환하거나 AbortOnBase64DecodingErrors 옵션이 전달되었고 입력 데이터가 유효하지 않은 경우 빈 바이트 배열을 반환합니다.

toBase64() 및 fromBase64Encoding()도 참조하세요 .

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

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이어야 합니다:

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 매개변수를 사용하면 '%'가 아닌 다른 문자(예: '_' 또는 '=')를 이스케이프 문자로 사용할 수 있습니다. 입력과 동일합니다.percentDecoded(퍼센트).

예를 들어

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

percentDecoded()도 참조하세요 .

[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()도 참조하세요 .

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

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

이 함수는 오버로드된 함수입니다.

data 에서 시작하는 len 바이트를 바이트 배열의 위치 i 에 삽입합니다.

이 배열은 삽입을 수용하기 위해 커집니다. i 이 배열의 끝을 넘어가면 배열은 먼저 공백 문자로 확장되어 i 에 도달합니다.

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

이 함수는 오버로드된 함수입니다.

바이트 배열의 인덱스 위치 i 에 바이트 ch 의 사본 count 을 삽입합니다.

이 배열은 삽입을 수용하기 위해 커집니다. i 이 배열의 끝을 넘어가면 배열은 먼저 공백 문자로 확장되어 i 에 도달합니다.

[noexcept] bool QByteArray::isEmpty() const

바이트 배열의 크기가 0이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

예제:

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

size()도 참조하세요 .

bool QByteArray::isLower() const

이 바이트 배열이 소문자인 경우, 즉 toLower() 접기와 동일한 경우 true 을 반환합니다.

이는 바이트 배열에 소문자만 포함되어 있다는 뜻이 아니라 ASCII 대문자가 포함되어 있지 않다는 의미입니다.

isUpper() 및 toLower()도 참조하세요 .

[noexcept] bool QByteArray::isNull() const

이 바이트 배열이 null이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

예제:

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

Qt는 역사적인 이유로 널 바이트 배열과 빈 바이트 배열을 구분합니다. 대부분의 응용 프로그램에서 중요한 것은 바이트 배열에 데이터가 포함되어 있는지 여부이며, 이는 isEmpty()를 사용하여 확인할 수 있습니다.

isEmpty()도 참조하세요 .

bool QByteArray::isUpper() const

이 바이트 배열이 대문자인 경우, 즉 toUpper() 접기와 동일한 경우 true 을 반환합니다.

이는 바이트 배열에 대문자만 포함되어 있다는 뜻이 아니라 ASCII 소문자가 포함되어 있지 않다는 의미입니다.

isLower() 및 toUpper()도 참조하세요 .

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

이 바이트 배열에 유효한 UTF-8 인코딩된 데이터가 포함되어 있으면 true, 그렇지 않으면 false 을 반환합니다.

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

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

이 바이트 배열에서 bv 에서 본 바이트 시퀀스의 마지막 발생 시작 부분의 인덱스 위치를 반환하며, 인덱스 위치 from 부터 역방향으로 검색합니다.

from 이 -1이면 마지막 문자에서 검색을 시작하고, -2이면 마지막 문자 다음에서 검색하는 식으로 검색합니다.

일치하는 항목이 없으면 -1을 반환합니다.

예:

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

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

indexOf(), contains() 및 count()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

이 바이트 배열에서 bv 에서 마지막으로 조회한 바이트 시퀀스의 시작 부분의 인덱스 위치를 바이트 배열의 끝에서 역순으로 검색하여 반환합니다. 일치하는 항목이 없으면 -1을 반환합니다.

예제:

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

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

indexOf(), contains() 및 count()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

인덱스 위치 from 에서 역방향으로 검색하여 이 바이트 배열에서 마지막으로 발생한 바이트 ch 의 시작 부분의 인덱스 위치를 반환합니다. from 이 -1(기본값)이면 마지막 바이트(인덱스 size() - 1)에서 검색이 시작됩니다. 일치하는 항목이 없으면 -1을 반환합니다.

예시:

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

indexOf() 및 contains()도 참조하세요 .

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

fill 바이트가 추가된 이 바이트 배열을 포함하는 width 크기의 바이트 배열을 반환합니다.

truncate 이 거짓이고 바이트 배열의 size()이 width 보다 크면 반환되는 바이트 배열은 이 바이트 배열의 복사본입니다.

truncate 이 참이고 바이트 배열의 size()이 width 보다 크면 위치 width 이후의 바이트 배열 사본에서 바이트가 제거되고 사본이 반환됩니다.

예시:

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

rightJustified()도 참조하세요 .

[noexcept] qsizetype QByteArray::length() const

size()와 동일합니다.

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

정숫값 n 을 텍스트로 나타내는 바이트 배열을 반환합니다.

지정된 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, QString::number 와 동일한 의미의 문자열(double, char, int)이 포함된 바이트 배열을 반환합니다. 예를 들어

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

toDouble() 및 QLocale::FloatingPointPrecisionOption도 참조하세요 .

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

URI/URL 스타일의 퍼센트 인코딩을 디코딩합니다.

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

예를 들어

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

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

toPercentEncoding() 및 QUrl::fromPercentEncoding()도 참조하십시오 .

QByteArray &QByteArray::prepend(QByteArrayView ba)

바이트 배열 보기 ba 를 이 바이트 배열에 추가하고 이 바이트 배열에 대한 참조를 반환합니다.

이 작업은 일반적으로 매우 빠릅니다(일정한 시간). QByteArray 데이터의 시작 부분에 추가 공간을 미리 할당하므로 매번 전체 배열을 재할당하지 않고도 늘릴 수 있기 때문입니다.

예시:

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

삽입(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 술어가 참을 반환하는 모든 바이트를 바이트 배열에서 제거합니다. 바이트 배열에 대한 참조를 반환합니다.

이 함수는 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 바이트의 모든 항목을 asize 에서 시작하는 after 바이트의 모든 항목으로 바꿉니다. 문자열의 크기는 bsize 및 asize 으로 지정되므로 '\0' 바이트를 포함할 수 있으며 '\0'으로 끝날 필요는 없습니다.

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

이 함수는 오버로드된 함수입니다.

인덱스 위치 pos 의 len 바이트를 위치 after 에서 시작하는 alen 바이트로 바꿉니다. 삽입되는 바이트에는 '\0' 바이트가 포함될 수 있습니다.

void QByteArray::reserve(qsizetype size)

최소 size 바이트에 대한 메모리 할당을 시도합니다.

바이트 배열의 크기를 미리 알고 있다면 이 함수를 호출할 수 있으며 resize()를 자주 호출하면 더 나은 성능을 얻을 수 있습니다.

얼마나 많은 공간이 필요한지 확실하지 않은 경우 일반적으로 size 와 같은 상한을 사용하거나 엄격한 상한이 이보다 훨씬 클 경우 가장 가능성이 높은 예상 크기를 사용하는 것이 좋습니다. size 이 과소 추정치인 경우 예약된 크기를 초과하면 배열이 필요에 따라 커지므로 최상의 과대 추정치보다 더 큰 할당을 초래할 수 있으며 이를 트리거하는 작업 속도가 느려질 수 있습니다.

이 함수의 유일한 목적은 QByteArray 의 메모리 사용량을 미세 조정할 수 있는 수단을 제공하는 것입니다. 일반적으로 이 함수를 호출할 필요는 거의 없습니다.

squeeze() 및 capacity()도 참조하세요 .

void QByteArray::resize(qsizetype size)

바이트 배열의 크기를 size 바이트로 설정합니다.

size 이 현재 크기보다 크면 바이트 배열이 확장되어 size 바이트가 되고 끝에 여분의 바이트가 추가됩니다. 새 바이트는 초기화되지 않습니다.

size 이 현재 크기보다 작으면 size 위치 이후의 바이트는 바이트 배열에서 제외됩니다.

size(), truncate() 및 squeeze()도 참조하세요 .

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

바이트 배열의 크기를 newSize 바이트로 설정합니다.

newSize 이 현재 크기보다 크면 바이트 배열이 확장되어 newSize 바이트가 되고 끝에 여분의 바이트가 추가됩니다. 새 바이트는 c 으로 초기화됩니다.

newSize 이 현재 크기보다 작으면 newSize 위치 이후의 바이트는 바이트 배열에서 제외됩니다.

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

size(), truncate() 및 squeeze()도 참조하세요 .

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

바이트 배열의 크기를 size 바이트로 조정합니다. 바이트 배열의 크기가 커지면 새 바이트가 초기화되지 않습니다.

동작은 resize(size) 와 동일합니다.

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

resize()도 참조하십시오 .

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

fill 바이트 다음에 이 바이트 배열이 포함된 width 크기의 바이트 배열을 반환합니다.

truncate 이 거짓이고 바이트 배열의 크기가 width 보다 크면 반환되는 바이트 배열은 이 바이트 배열의 복사본입니다.

truncate 이 참이고 바이트 배열의 크기가 width 보다 크면 결과 바이트 배열은 width 위치에서 잘립니다.

예시:

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

leftJustified()도 참조하세요 .

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

n 정수를 텍스트로 표현합니다.

이 바이트 배열을 기본값 base (기본값 10)의 n 을 나타내는 문자열로 설정하고 이 바이트 배열에 대한 참조를 반환합니다. 베이스 2부터 36까지 지원되며, 9를 초과하는 숫자는 문자를 사용합니다(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 ( QString::number(double, char, int)와 동일한 의미)와 함께 n 를 나타내는 문자열로 설정하고 이 바이트 배열에 대한 참조를 반환합니다.

toDouble() 및 QLocale::FloatingPointPrecisionOption도 참조하세요 .

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

이것은 오버로드된 함수입니다.

부동 소수점 숫자 n 를 텍스트로 표현합니다.

이 바이트 배열을 format 및 precision ( QString::number(double, char, int)와 동일한 의미)와 함께 n 를 나타내는 문자열로 설정하고 이 바이트 배열에 대한 참조를 반환합니다.

toFloat()도 참조하세요 .

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

data 배열의 첫 번째 size 바이트를 사용하도록 QByteArray 을 재설정합니다. 바이트는 복사되지 않습니다. QByteArray 에는 data 포인터가 포함됩니다. 호출자는 이 QByteArray 및 수정되지 않은 복사본이 존재하는 한 data 이 삭제되거나 수정되지 않음을 보장합니다.

이 함수는 fromRawData() 대신 기존 QByteArray 객체를 재사용하여 메모리 재할당을 절약하는 데 사용할 수 있습니다.

fromRawData(), data() 및 constData()도 참조하세요 .

void QByteArray::shrink_to_fit()

이 기능은 STL 호환성을 위해 제공됩니다. squeeze ()와 동일합니다.

QByteArray QByteArray::simplified() const

시작과 끝에서 공백 문자가 제거되고 내부 공백 문자의 각 시퀀스가 단일 공백으로 대체된 이 바이트 배열의 복사본을 반환합니다.

간격 문자는 표준 C++ isspace() 함수가 C 로캘에서 true 을 반환하는 문자로, ASCII 문자 표 '\t', 줄 바꿈 '\n', 캐리지 리턴 '\r', 세로 표 '\v', 폼 피드 '\f', 공백 ' ' 등이 해당됩니다.

예시:

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

trimmed(), QChar::SpecialCharacter, Spacing Characters 를참조하세요 .

[noexcept] qsizetype QByteArray::size() const

이 바이트 배열의 바이트 수를 반환합니다.

바이트 배열의 마지막 바이트는 size() - 1 위치에 있습니다. 또한 QByteArray 는 size()의 바이트가 항상 '\0'이므로 data() 및 constData()의 반환 값을 '\0'으로 끝나는 문자열을 예상하는 함수에 대한 인수로 사용할 수 있습니다. QByteArray 객체가 '\0'으로 끝나는 바이트가 포함되지 않은 raw data 에서 생성된 경우, QByteArray 는 딥 카피가 생성되지 않는 한 자동으로 해당 바이트가 추가되지 않습니다.

예시:

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

isEmpty() 및 resize()도 참조하세요 .

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

이 바이트 배열을 pos 위치에서 시작하여 n 바이트까지 확장하도록 수정하고 이 바이트 배열에 대한 참조를 반환합니다.

예제:

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

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

sliced(), first(), last(), chopped(), chop() 및 truncate()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

이 바이트 배열을 pos 위치에서 시작하여 끝까지 확장되도록 수정하고 이 바이트 배열에 대한 참조를 반환합니다.

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

sliced(), first(), last(), chopped(), chop() 및 truncate()도 참조하십시오 .

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

sep 이 발생하는 모든 곳에서 바이트 배열을 하위 배열로 분할하고 해당 배열의 목록을 반환합니다. sep 이 바이트 배열의 어느 곳과도 일치하지 않으면 split()은 이 바이트 배열을 포함하는 단일 엘리먼트 목록을 반환합니다.

void QByteArray::squeeze()

배열의 데이터를 저장하는 데 필요하지 않은 메모리를 해제합니다.

이 함수의 유일한 목적은 QByteArray 의 메모리 사용량을 미세 조정할 수 있는 수단을 제공하는 것입니다. 일반적으로 이 함수를 호출할 필요는 거의 없습니다.

reserve() 및 capacity()도 참조하세요 .

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

이 바이트 배열이 bv 에서 본 바이트 시퀀스로 시작하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

예제:

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

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

endsWith() 및 first()도 참조하십시오 .

bool QByteArray::startsWith(char ch) const

이 함수는 오버로드된 함수입니다.

이 바이트 배열이 바이트 ch 로 시작하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

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

이 바이트 배열을 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

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

옵션을 사용하여 인코딩된 바이트 배열의 복사본을 반환합니다 options.

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

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

Base64로 인코딩된 데이터를 인코딩하는 데 사용되는 알고리즘은 RFC 4648에 정의되어 있습니다.

fromBase64()도 참조하세요 .

CFDataRef QByteArray::toCFData() const

QByteArray 에서 CFData를 생성합니다.

호출자는 CFData 객체를 소유하며 이를 릴리스할 책임이 있습니다.

toRawCFData(), fromCFData(), fromRawCFData() 및 fromRawData()도 참조하세요 .

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

double 값으로 변환된 바이트 배열을 반환합니다.

변환이 오버플로되면 무한대를 반환하고, 다른 이유(예: 언더플로)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

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

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

이 함수는 선행 및 후행 공백을 무시합니다.

number()도 참조하세요 .

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

QByteArray 에서 Uint8Array를 생성합니다.

이 함수는 QByteArray 가 소유한 힙 메모리에서 자바스크립트 데이터 버퍼로 데이터를 전송합니다. 이 함수는 ArrayBuffer에 할당 및 복사한 후 해당 버퍼에 Uint8Array 뷰를 반환합니다.

JavaScript 객체는 데이터의 복사본을 소유하며, 이 QByteArray 은 복사 후 안전하게 삭제할 수 있습니다.

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

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

toEcmaUint8Array()도 참조하세요 .

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

float 값으로 변환된 바이트 배열을 반환합니다.

변환이 오버플로되면 무한대를 반환하고, 다른 이유(예: 언더플로)로 변환에 실패하면 0.0을 반환합니다.

ok 가 nullptr 이 아닌 경우 실패는 *ok 를 false 로 설정하여 보고하고 성공은 *ok 를 true 로 설정하여 보고합니다.

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

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

이 함수는 선행 및 후행 공백을 무시합니다.

number()도 참조하세요 .

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

바이트 배열의 16진법으로 인코딩된 사본을 반환합니다.

16진수 인코딩은 숫자 0-9와 문자 a-f를 사용합니다.

separator 이 '\0'이 아닌 경우 16진수 바이트 사이에 구분 문자가 삽입됩니다.

예:

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

fromHex()도 참조하세요 .

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

기본값은 10인 base 을 사용하여 int 으로 변환된 바이트 배열을 반환합니다. 베이스 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

기본값은 10인 기본값 base 을 사용하여 long int로 변환된 바이트 배열을 반환합니다. 베이스 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

기본값은 10인 base 을 사용하여 long long 으로 변환된 바이트 배열을 반환합니다. 베이스 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 매개변수를 사용하면 기본 '%' 문자를 다른 문자로 재정의할 수 있습니다.

기본적으로 이 함수는 다음 중 하나가 아닌 모든 바이트를 인코딩합니다:

알파벳("a"~"z", "A"~"Z") / 숫자(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

기본값은 10인 base 을 사용하여 short 으로 변환된 바이트 배열을 반환합니다. 베이스 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

기본값은 10인 base 을 사용하여 unsigned int 으로 변환된 바이트 배열을 반환합니다. 베이스 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

기본값은 10인 base 을 사용하여 unsigned long int 으로 변환된 바이트 배열을 반환합니다. 베이스 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

기본값은 10인 base 을 사용하여 unsigned long long 으로 변환된 바이트 배열을 반환합니다. 베이스 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

기본값은 10인 base 을 사용하여 unsigned short 으로 변환된 바이트 배열을 반환합니다. 베이스 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++ isspace() 함수가 C 로캘에서 true 을 반환하는 문자로, ASCII 문자 표 '\t', 줄 바꿈 '\n', 캐리지 리턴 '\r', 세로 표 '\v', 폼 피드 '\f', 공백 ' ' 등이 해당됩니다.

예:

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

simplified()와 달리 trimmed()는 내부 공백을 변경하지 않습니다.

simplified(), QChar::SpecialCharacter, Spacing Characters 를참조하세요 .

void QByteArray::truncate(qsizetype pos)

인덱스 위치 pos 에서 바이트 배열을 잘라냅니다.

pos 이 배열의 끝을 넘어가면 아무 일도 일어나지 않습니다.

예시:

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

chop(), resize(), first()도 참조하세요 .

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

이 바이트 배열의 끝에 ba 바이트 배열을 추가하고 이 바이트 배열에 대한 참조를 반환합니다.

예시:

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

참고: QByteArray 은 암시적으로 공유되는 클래스입니다. 따라서 빈 바이트 배열에 추가하면 바이트 배열은 ba 에 있는 데이터를 공유할 뿐입니다. 이 경우 데이터 복사가 수행되지 않으므로 시간이 계속 걸립니다. 공유 인스턴스가 수정되면 복사(쓰기 시 복사)가 이루어지며 시간이 선형적으로 소요됩니다.

추가되는 바이트 배열이 비어 있지 않으면 데이터의 딥 카피가 수행되며 선형적인 시간이 소요됩니다.

QByteArray 은 데이터 끝에 여분의 공간을 미리 할당하여 각 추가 작업에 대해 재할당하지 않고도 데이터를 늘릴 수 있으므로 이 작업은 일반적으로 할당 오버헤드에 영향을 받지 않습니다.

append() 및 prepend()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

이 바이트 배열의 끝에 ch 바이트값을 추가하고 이 바이트 배열에 대한 참조를 반환합니다.

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

이 함수는 오버로드된 함수입니다.

이 바이트 배열의 끝에 '\0'으로 끝나는 문자열 str 을 추가하고 이 바이트 배열에 대한 참조를 반환합니다.

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

이동-이 other 인스턴스를 QByteArray 인스턴스에 할당합니다.

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

이 바이트 배열에 other 을 할당하고 이 바이트 배열에 대한 참조를 반환합니다.

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

이 함수는 오버로드된 함수입니다.

이 바이트 배열에 str 을 할당합니다.

str 는 널로 끝나는 문자열을 가리키는 것으로 가정하며, 그 길이는 동적으로 결정됩니다.

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

수정 가능한 참조로 인덱스 위치 i 의 바이트를 반환합니다.

i 는 바이트 배열에서 유효한 인덱스 위치여야 합니다(즉, 0 <= i < size()).

예시:

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

at()도 참조하세요 .

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

이 함수는 과부하된 함수입니다.

at(i)와 동일합니다.