QStringTokenizer Class

Documentación de las funciones miembro

Construye un tokenizador de cadenas que divide la cadena haystack en subcadenas dondequiera que aparezca needle, y permite iterar sobre esas cadenas a medida que se encuentran. Si needle no coincide en ninguna parte con haystack, se produce un único elemento que contiene haystack.

cs especifica si needle debe coincidir con mayúsculas o minúsculas.

Si sb es Qt::SkipEmptyParts, las entradas vacías no aparecen en el resultado. Por defecto, se incluyen las entradas vacías.

Véase también QStringView::split(), QString::split(), Qt::CaseSensitivity, y Qt::SplitBehavior.

Devuelve un iterador const de estilo STL que apunta al primer token de la lista.

Véase también end() y cend().

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

Igual que end().

Véase también cbegin() y end().

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

Devuelve un centinela const de estilo STL que apunta al token imaginario después del último token de la lista.

Véase también begin() y cend().

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

Convierte la secuencia perezosa en un contenedor (típicamente) de acceso aleatorio de tipo LContainer.

Esta función sólo está disponible si Container tiene un value_type que coincida con el value_type de este tokenizador.

Si pasas un contenedor con nombre (un lvalue) para c, entonces ese contenedor se llena, y se devuelve una referencia a él. Si se pasa un contenedor temporal (un rvalue, incluido el argumento por defecto), entonces ese contenedor se llena y se devuelve por valor.

// 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);

Esto le da la máxima flexibilidad en cómo desea que se almacene la secuencia.

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

Convierte la secuencia perezosa en un contenedor (típicamente) de acceso aleatorio del tipo RContainer.

Además de las restricciones de la sobrecarga lvalue-this, esta sobrecarga rvalue-this sólo está disponible cuando este QStringTokenizer no almacena el pajar internamente, ya que esto podría crear un contenedor lleno de referencias colgantes:

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

Para solucionarlo, almacene el QStringTokenizer en un temporal:

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.

Puede forzar la existencia de esta función pasando una vista en su lugar:

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

Si pasas un contenedor con nombre (un lvalue)para c, entonces ese contenedor se llena, y se devuelve una referencia a él. Si pasa un contenedor temporal (un rvalue, incluido el argumento por defecto), entonces ese contenedor se llena, y se devuelve por valor.