QVarLengthArray Class

멤버 함수 문서

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

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

배열의 인덱스 위치 i 에 value 를 삽입합니다. i 가 0이면 벡터 앞에 값이 추가됩니다. i 가 size()인 경우 벡터에 값이 추가됩니다.

큰 배열의 경우 이 작업은 인덱스 i 이상의 모든 항목을 메모리에서 한 위치씩 더 이동해야 하므로 속도가 느려질 수 있습니다(선형 시간). 빠른 insert() 함수를 제공하는 컨테이너 클래스를 원한다면 대신 std::list를 사용하세요.

remove()도 참조하세요 .

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

이터레이터 before 가 가리키는 항목 앞에 value 를 삽입합니다. 삽입된 항목을 가리키는 이터레이터를 반환합니다.

[noexcept] QVarLengthArray::QVarLengthArray()

초기 크기가 0인 배열을 생성합니다.

[explicit] QVarLengthArray::QVarLengthArray(qsizetype size)

초기 크기가 size 요소인 배열을 구축합니다.

값 유형이 원시 유형(예: 문자, 정수, 실수)이거나 포인터 유형(예: QWidget *)인 경우 요소는 초기화되지 않습니다. 다른 유형의 경우 요소는 기본적으로 구성된 값으로 초기화됩니다.

QVarLengthArray::QVarLengthArray(std::initializer_list<T> args)

args 에서 제공한 std::initializer_list 로부터 배열을 구축합니다.

template <typename InputIterator, QVarLengthArray<T, Prealloc>::if_input_iterator<InputIterator> = true> QVarLengthArray::QVarLengthArray(InputIterator first, InputIterator last)

이터레이터 범위의 콘텐츠로 배열을 생성합니다 [first, last).

이 생성자는 InputIterator 이 LegacyInputIterator의 요구 사항을 충족하는 경우에만 과부하 해결에 참여합니다.

InputIterator 의 값 유형은 T 로 변환 가능해야 합니다.

[explicit, since 6.4] QVarLengthArray::QVarLengthArray(qsizetype size, const T &v)

v 의 복사본으로 채워진 초기 크기가 size 요소로 구성된 배열을 생성합니다.

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

size() 및 squeeze()도 참조하십시오 .

QVarLengthArray::QVarLengthArray(const QVarLengthArray<T, Prealloc> &other)

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

[noexcept(...), since 6.0] QVarLengthArray::QVarLengthArray(QVarLengthArray<T, Prealloc> &&other)

이동 - other 에서 이 가변 길이 배열을 구성합니다. 이동 후 other 은 비어 있습니다.

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

QVarLengthArray::~QVarLengthArray()

배열을 파괴합니다.

void QVarLengthArray::append(const T &t)

필요한 경우 배열을 확장하여 t 항목을 배열에 추가합니다.

removeLast()도 참조하세요 .

void QVarLengthArray::append(const T *buf, qsizetype size)

buf 에서 참조하는 항목의 size 개수를 이 배열에 추가합니다.

void QVarLengthArray::append(T &&t)

이 함수는 append를 오버로드합니다.

vla.append(std::move(vla[0])); // BUG: passing an object that is already in the container

[since 6.6] QVarLengthArray<T, Prealloc> &QVarLengthArray::assign(std::initializer_list<T> list)

이 컨테이너의 내용을 list 의 요소 복사본으로 바꿉니다.

이 컨테이너의 크기는 list 의 요소 수와 같습니다.

이 함수는 list 의 엘리먼트 수가 컨테이너의 용량을 초과하는 경우에만 메모리를 할당합니다.

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

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

이 컨테이너의 내용을 이터레이터 범위 [first, last]의 요소 복사본으로 바꿉니다.

이 컨테이너의 크기는 범위 [first, last]의 요소 수와 같습니다. 이 함수는 범위의 요소 수가 컨테이너의 용량을 초과하는 경우에만 메모리를 할당합니다.

이 함수 과부하는 InputIterator 이 LegacyInputIterator의 요구 사항을 충족하는 경우에만 과부하 해결에 참여합니다.

인자 중 하나가 *이것에 대한 이터레이터인 경우 동작이 정의되지 않습니다.

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

[since 6.6] QVarLengthArray<T, Prealloc> &QVarLengthArray::assign(qsizetype n, const T &t)

이 컨테이너의 내용을 t 의 n 사본으로 바꿉니다.

이 컨테이너의 크기는 n 과 같습니다. 이 함수는 n 이 컨테이너의 용량을 초과하는 경우에만 메모리를 할당합니다.

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

const T &QVarLengthArray::at(qsizetype i) const

인덱스 위치 i 에 있는 항목에 대한 참조를 반환합니다.

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

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

T &QVarLengthArray::back()

last()와 동일합니다. STL 호환성을 위해 제공됩니다.

const T &QVarLengthArray::back() const

과부하가 걸린 기능입니다.

QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::begin()

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

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

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::begin() const

과부하가 걸린 기능입니다.

qsizetype QVarLengthArray::capacity() const

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

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

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

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::cbegin() const

배열의 첫 번째 항목을 가리키는 상수 STL 스타일 이터레이터를 반환합니다.

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

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::cend() const

배열의 마지막 항목 뒤에 있는 가상의 항목을 가리키는 상수 STL 스타일 이터레이터를 반환합니다.

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

void QVarLengthArray::clear()

배열에서 모든 요소를 제거합니다.

resize(0)과 동일합니다.

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::constBegin() const

배열의 첫 번째 항목을 가리키는 상수 STL 스타일 이터레이터를 반환합니다.

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

const T *QVarLengthArray::constData() const

배열에 저장된 데이터에 대한 상수 포인터를 반환합니다. 이 포인터는 배열의 항목에 액세스하는 데 사용할 수 있습니다. 배열이 재할당되지 않는 한 포인터는 유효하게 유지됩니다.

이 함수는 일반 C++ 배열을 받아들이는 함수에 배열을 전달할 때 주로 유용합니다.

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

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::constEnd() const

배열의 마지막 항목 뒤에 있는 가상의 항목을 가리키는 상수 STL 스타일 이터레이터를 반환합니다.

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

template <typename AT = T> bool QVarLengthArray::contains(const AT &value) const

배열에 value 이 포함되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수를 사용하려면 값 유형에 operator==() 의 구현이 있어야 합니다.

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

qsizetype QVarLengthArray::count() const

size()와 동일합니다.

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

QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::crbegin() const

가변 길이 배열의 첫 번째 항목을 역순으로 가리키는 상수 STL 스타일 리버스 이터레이터를 반환합니다.

begin(), rbegin() 및 rend()도 참조하세요 .

QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::crend() const

가변 길이 배열의 마지막 항목을 역순으로 지나쳐서 하나를 가리키는 상수 STL 스타일 역이터레이터를 반환합니다.

end(), rend() 및 rbegin()도 참조하세요 .

T *QVarLengthArray::data()

배열에 저장된 데이터에 대한 포인터를 반환합니다. 포인터는 배열의 항목에 액세스하고 수정하는 데 사용할 수 있습니다.

예시:

QVarLengthArray<int> array(10);
int *data = array.data();
for (int i = 0; i < 10; ++i)
    data[i] = 2 * i;

배열이 재할당되지 않는 한 포인터는 유효합니다.

이 함수는 주로 일반 C++ 배열을 받아들이는 함수에 배열을 전달할 때 유용합니다.

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

const T *QVarLengthArray::data() const

과부하가 걸린 기능입니다.

[since 6.3] template <typename... Args> QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::emplace(QVarLengthArray<T, Prealloc>::const_iterator pos, Args &&... args)

이터레이터 pos 가 가리키는 항목 앞에 항목을 삽입하고 args 을 생성자에게 전달합니다.

삽입된 항목을 가리키는 이터레이터를 반환합니다.

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

[since 6.3] template <typename... Args> T &QVarLengthArray::emplace_back(Args &&... args)

이 QVarLengthArray 뒤에 항목을 삽입하고 args 을 생성자에게 전달합니다.

삽입된 항목에 대한 참조를 반환합니다.

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

bool QVarLengthArray::empty() const

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

isEmpty()와 동일합니다. STL 호환성을 위해 제공됩니다.

QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::end()

배열의 마지막 항목 뒤에 있는 가상의 항목을 가리키는 STL 스타일 이터레이터를 반환합니다.

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

QVarLengthArray<T, Prealloc>::const_iterator QVarLengthArray::end() const

과부하가 걸린 기능입니다.

QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::erase(QVarLengthArray<T, Prealloc>::const_iterator pos)

반복자 pos 가 가리키는 항목을 벡터에서 제거하고 반복자를 벡터의 다음 항목( end()일 수 있음)으로 반환합니다.

insert() 및 remove()도 참조하세요 .

QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::erase(QVarLengthArray<T, Prealloc>::const_iterator begin, QVarLengthArray<T, Prealloc>::const_iterator end)

과부하가 걸린 함수입니다.

begin 에서 end 까지의 모든 항목을 제거합니다. 호출 전에 end 이 참조한 것과 동일한 항목에 대한 이터레이터를 반환합니다.

T &QVarLengthArray::first()

배열의 첫 번째 항목에 대한 참조를 반환합니다. 배열은 비어 있지 않아야 합니다. 배열이 비어 있을 수 있는 경우 이 함수를 호출하기 전에 isEmpty()를 확인하세요.

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

const T &QVarLengthArray::first() const

과부하가 걸린 기능입니다.

T &QVarLengthArray::front()

first()와 동일합니다. STL 호환성을 위해 제공됩니다.

const T &QVarLengthArray::front() const

과부하가 걸린 기능입니다.

template <typename AT = T> qsizetype QVarLengthArray::indexOf(const AT &value, qsizetype from = 0) const

인덱스 위치 from 에서 앞으로 검색하여 배열에서 value 이 처음 나오는 인덱스 위치를 반환합니다. 일치하는 항목이 없으면 -1을 반환합니다.

이 함수를 사용하려면 값 유형이 operator==() 로 구현되어야 합니다.

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

QVarLengthArray<T, Prealloc>::iterator QVarLengthArray::insert(QVarLengthArray<T, Prealloc>::const_iterator before, qsizetype count, const T &value)

이터레이터 before 가 가리키는 항목 앞에 value 의 count 복사본을 삽입합니다. 삽입된 항목 중 첫 번째 항목을 가리키는 이터레이터를 반환합니다.

void QVarLengthArray::insert(qsizetype i, qsizetype count, const T &value)

이것은 과부하된 함수입니다.

벡터의 인덱스 위치 i 에 value 의 count 복사본을 삽입합니다.

bool QVarLengthArray::isEmpty() const

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

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

T &QVarLengthArray::last()

배열의 마지막 항목에 대한 참조를 반환합니다. 배열은 비어 있지 않아야 합니다. 배열이 비어 있을 수 있는 경우 이 함수를 호출하기 전에 isEmpty()를 확인하세요.

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

const T &QVarLengthArray::last() const

과부하가 걸린 기능입니다.

template <typename AT = T> qsizetype QVarLengthArray::lastIndexOf(const AT &value, qsizetype from = -1) const

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

이 함수를 사용하려면 값 유형이 operator==() 로 구현되어야 합니다.

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

qsizetype QVarLengthArray::length() const

size()와 동일합니다.

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

void QVarLengthArray::pop_back()

removeLast()와 동일합니다. STL 호환성을 위해 제공됩니다.

void QVarLengthArray::push_back(const T &t)

필요한 경우 배열을 확장하여 t 항목을 배열에 추가합니다. STL 호환성을 위해 제공됩니다.

void QVarLengthArray::push_back(T &&t)

이 함수는 push_back을 오버로드합니다.

vla.push_back(std::move(vla[0])); // BUG: passing an object that is already in the container

QVarLengthArray<T, Prealloc>::reverse_iterator QVarLengthArray::rbegin()

가변 길이 배열의 첫 번째 항목을 역순으로 가리키는 STL 스타일 역이터레이터를 반환합니다.

begin(), crbegin() 및 rend()도 참조하세요 .

QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::rbegin() const

과부하가 걸린 기능입니다.

void QVarLengthArray::remove(qsizetype i, qsizetype count = 1)

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

인덱스 위치 i 부터 시작하여 배열의 중간에서 count 요소를 제거합니다.

insert() 및 replace()도 참조하세요 .

[since 6.1] template <typename AT = T> qsizetype QVarLengthArray::removeAll(const AT &t)

배열에서 t 와 비교되는 모든 요소를 제거합니다. 제거된 요소가 있으면 그 수를 반환합니다.

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

removeOne()도 참조하십시오 .

[since 6.1] template <typename Predicate> qsizetype QVarLengthArray::removeIf(Predicate pred)

pred 술어가 참을 반환하는 모든 요소를 배열에서 제거합니다. 제거된 엘리먼트가 있으면 그 수를 반환합니다.

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

removeAll()도 참조하세요 .

void QVarLengthArray::removeLast()

배열의 크기를 1씩 줄입니다. 할당된 크기는 변경되지 않습니다.

append()도 참조하세요 .

[since 6.1] template <typename AT = T> bool QVarLengthArray::removeOne(const AT &t)

배열에서 t 과 비교되는 첫 번째 요소를 제거합니다. 요소가 실제로 제거되었는지 여부를 반환합니다.

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

removeAll()도 참조하세요 .

QVarLengthArray<T, Prealloc>::reverse_iterator QVarLengthArray::rend()

가변 길이 배열의 마지막 항목을 역순으로 지나가는 항목을 가리키는 STL 스타일 역이터레이터를 반환합니다.

end(), crend() 및 rbegin()도 참조하세요 .

QVarLengthArray<T, Prealloc>::const_reverse_iterator QVarLengthArray::rend() const

과부하가 걸린 기능입니다.

void QVarLengthArray::replace(qsizetype i, const T &value)

인덱스 위치 i 의 항목을 value 로 바꿉니다.

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

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

void QVarLengthArray::reserve(qsizetype size)

최소 size 요소에 대한 메모리 할당을 시도합니다. 배열이 얼마나 커질 수 있는지 미리 알고 있다면 이 함수를 호출할 수 있으며 resize()를 자주 호출하면 더 나은 성능을 얻을 수 있습니다. size 이 과소평가된 경우 최악의 경우 QVarLengthArray 이 약간 느려질 수 있습니다.

이 함수의 유일한 목적은 QVarLengthArray 의 메모리 사용량을 미세 조정할 수 있는 수단을 제공하는 것입니다. 일반적으로 이 함수를 호출할 필요는 거의 없습니다. 배열의 크기를 변경하려면 resize()를 호출하세요.

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

void QVarLengthArray::resize(qsizetype size)

배열의 크기를 size 으로 설정합니다. size 이 현재 크기보다 크면 요소가 끝에 추가됩니다. size 이 현재 크기보다 작으면 끝에서 요소가 제거됩니다.

값 유형이 기본 유형(예: 문자, 정수, 실수)이거나 포인터 유형(예: QWidget *)인 경우 새 요소는 초기화되지 않습니다. 다른 유형의 경우 요소는 기본적으로 구성된 값으로 초기화됩니다.

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

[since 6.4] void QVarLengthArray::resize(qsizetype size, const T &v)

배열의 크기를 size 로 설정합니다. size 이 현재 크기보다 크면 v 의 복사본이 끝에 추가됩니다. size 이 현재 크기보다 작으면 끝에서 요소가 제거됩니다.

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

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

void QVarLengthArray::shrink_to_fit()

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

qsizetype QVarLengthArray::size() const

배열의 요소 수를 반환합니다.

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

void QVarLengthArray::squeeze()

항목을 저장하는 데 필요하지 않은 메모리를 해제합니다. 컨테이너가 스택 할당에 저장 공간을 맞출 수 있으면 힙 할당을 해제하고 요소를 다시 스택으로 복사합니다.

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

reserve(), capacity(), resize()도 참조하세요 .

T QVarLengthArray::value(qsizetype i) const

인덱스 위치 i 의 값을 반환합니다.

i 인덱스가 범위를 벗어난 경우 이 함수는 기본적으로 구성된 값을 반환합니다. i 가 범위 내에 있다고 확신하는 경우 at() 대신 약간 더 빠른 값을 사용할 수 있습니다.

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

T QVarLengthArray::value(qsizetype i, const T &defaultValue) const

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

i 인덱스가 범위를 벗어난 경우 이 함수는 defaultValue 을 반환합니다.

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator+=(const T &value)

value 을 배열에 추가하고 이 벡터에 대한 참조를 반환합니다.

append() 및 operator<<()도 참조하세요 .

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator+=(T &&value)

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

append() 및 operator<<()도 참조하세요 .

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator<<(const T &value)

value 을 배열에 추가하고 이 벡터에 대한 참조를 반환합니다.

append() 및 operator+=()도 참조하세요 .

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator<<(T &&value)

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

append() 및 operator+=()도 참조하세요 .

[noexcept(...), since 6.0] QVarLengthArray<T, Prealloc> &QVarLengthArray::operator=(QVarLengthArray<T, Prealloc> &&other)

이동 - other 을 이 배열에 할당하고 이 배열에 대한 참조를 반환합니다. 이동 후 other 은 비어 있습니다.

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

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator=(const QVarLengthArray<T, Prealloc> &other)

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

QVarLengthArray<T, Prealloc> &QVarLengthArray::operator=(std::initializer_list<T> list)

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

T &QVarLengthArray::operator[](qsizetype i)

인덱스 위치 i 에 있는 항목에 대한 참조를 반환합니다.

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

data() 및 at()도 참조하세요 .

const T &QVarLengthArray::operator[](qsizetype i) const

과부하가 걸린 기능입니다.