QStringTokenizer Class

멤버 함수 문서

haystack 문자열을 needle 가 나타나는 모든 위치에서 부분 문자열로 분할하고, 발견된 순서대로 해당 문자열들을 순회할 수 있도록 하는 문자열 토큰화기를 생성합니다. needle 가 haystack 내에서 어디에도 일치하지 않는 경우, haystack 를 포함하는 단일 요소가 생성됩니다.

cs needle 의 일치 여부를 대소문자를 구분하여 처리할지, 구분하지 않고 처리할지 지정합니다.

sb 가 Qt::SkipEmptyParts 인 경우, 빈 항목은 결과에 나타나지 않습니다. 기본적으로 빈 항목은 포함됩니다.

QStringView::split(), QString::split(), Qt::CaseSensitivity 및 Qt::SplitBehavior도 참조하십시오 .

목록의 첫 번째 토큰을 가리키는 STL 스타일의 const 이터레이터를 반환합니다.

end() 및 cend()도 참조하십시오 .

[constexpr noexcept] QStringTokenizer<Haystack, Needle>::sentinel QStringTokenizer::cend() const

end()와 동일합니다.

cbegin() 및 end()도 참조하십시오 .

[constexpr noexcept] QStringTokenizer<Haystack, Needle>::sentinel QStringTokenizer::end() const

목록의 마지막 토큰 다음에 오는 가상의 토큰을 가리키는 STL 스타일의 const 센티넬 을 반환합니다.

begin() 및 cend()도 참조하십시오 .

template <typename LContainer> LContainer QStringTokenizer::toContainer(LContainer &&c = {}) const &

지연 시퀀스를 (일반적으로) ` LContainer` 유형의 임의 접근 컨테이너로 변환합니다.

이 함수는 ` Container `에 이 토큰화기의 ` value_type`와 일치하는 ` value_type `가 있는 경우에만 사용할 수 있습니다.

c 에 대해 이름이 지정된 컨테이너(lvalue)를 전달하면 해당 컨테이너가 채워지고, 이에 대한 참조가 반환됩니다. 임시 컨테이너(rvalue, 기본 인자 포함)를 전달하면 해당 컨테이너가 채워지고, 값으로 반환됩니다.

// assuming tok's value_type is QStringView, then...
auto tok = QStringTokenizer{~~~};
// ... rac1 is a QList:
auto rac1 = tok.toContainer();
// ... rac2 is std::pmr::vector<QStringView>:
auto rac2 = tok.toContainer<std::pmr::vector<QStringView>>();
auto rac3 = QVarLengthArray<QStringView, 12>{};
// appends the token sequence produced by tok to rac3
//  and returns a reference to rac3 (which we ignore here):
tok.toContainer(rac3);

이를 통해 시퀀스를 저장하는 방식에 있어 최대한의 유연성을 확보할 수 있습니다.

template <typename RContainer> RContainer QStringTokenizer::toContainer(RContainer &&c = {}) const &&

지연 시퀀스를 (일반적으로) ` RContainer` 유형의 임의 접근 컨테이너로 변환합니다.

lvalue-this 오버로드에 대한 제약 조건 외에도, 이 rvalue-this 오버로드는 해당 ` QStringTokenizer `가 내부적으로 `haystack`을 저장하지 않는 경우에만 사용할 수 있습니다. 그렇지 않으면 매달린 참조로 가득 찬 컨테이너가 생성될 수 있기 때문입니다:

auto tokens = QStringTokenizer{widget.text(), u','}.toContainer();
// ERROR: cannot call toContainer() on rvalue
// 'tokens' references the data of the copy of widget.text()
// stored inside the QStringTokenizer, which has since been deleted

이를 해결하려면 QStringTokenizer 를 임시 변수에 저장하십시오:

auto tokenizer = QStringTokenizer{widget.text90, u','};
auto tokens = tokenizer.toContainer();
// OK: the copy of widget.text() stored in 'tokenizer' keeps the data
// referenced by 'tokens' alive.

대신 뷰를 전달하여 이 함수가 호출되도록 강제할 수 있습니다:

func(QStringTokenizer{QStringView{widget.text()}, u','}.toContainer());
// OK: compiler keeps widget.text() around until after func() has executed

c 에 이름이 지정된 컨테이너(lvalue)를 전달하면, 해당 컨테이너가 채워지고 이에 대한 참조가 반환됩니다. 임시 컨테이너(rvalue, 기본 인자 포함)를 전달하면, 해당 컨테이너가 채워지고 값으로 반환됩니다.