QUrlQuery Class

Documentación de las funciones miembro

QUrlQuery::QUrlQuery()

Construye un objeto QUrlQuery vacío. Se puede establecer una consulta posteriormente llamando a setQuery() o se pueden añadir elementos utilizando addQueryItem().

Véase también setQuery() y addQueryItem().

[explicit] QUrlQuery::QUrlQuery(const QString &queryString)

Construye un objeto QUrlQuery y analiza la cadena de consulta queryString, utilizando los delimitadores de consulta predeterminados. Para analizar una cadena de consulta utilizando otros delimitadores, primero debe establecerlos utilizando setQueryDelimiters() y luego establecer la consulta con setQuery().

[explicit] QUrlQuery::QUrlQuery(const QUrl &url)

Construye un objeto QUrlQuery y analiza la cadena de consulta que se encuentra en la URL url, utilizando los delimitadores de consulta predeterminados. Para analizar una cadena de consulta utilizando otros delimitadores, primero debe definirlos con setQueryDelimiters() y luego definir la consulta con setQuery().

Véase también QUrl::query().

QUrlQuery::QUrlQuery(std::initializer_list<std::pair<QString, QString>> list)

Construye un objeto QUrlQuery a partir del par clave/valor list.

QUrlQuery::QUrlQuery(const QUrlQuery &other)

Copia el contenido del objeto other QUrlQuery, incluidos los delimitadores de la consulta.

[noexcept, since 6.5] QUrlQuery::QUrlQuery(QUrlQuery &&other)

Mueve el contenido del objeto other QUrlQuery, incluyendo los delimitadores de la consulta.

Esta función se introdujo en Qt 6.5.

[noexcept] QUrlQuery::~QUrlQuery()

Destruye este objeto QUrlQuery.

void QUrlQuery::addQueryItem(const QString &key, const QString &value)

Añade el par key = value al final de la cadena de consulta de la URL. Este método no sobrescribe los elementos existentes que puedan existir con la misma clave.

Véase también hasQueryItem() y queryItemValue().

QStringList QUrlQuery::allQueryItemValues(const QString &key, QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Devuelve la lista de valores de cadena de consulta cuya clave es igual a key de la URL, utilizando las opciones especificadas en encoding para codificar el valor devuelto. Si no se encuentra la clave key, esta función devuelve una lista vacía.

Véase también queryItemValue() y addQueryItem().

void QUrlQuery::clear()

Borra este objeto QUrlQuery eliminando todos los pares clave-valor almacenados actualmente. Si se han modificado los delimitadores de la consulta, esta función los dejará con sus valores modificados.

Véase también isEmpty() y setQueryDelimiters().

[static constexpr noexcept] char16_t QUrlQuery::defaultQueryPairDelimiter()

Devuelve el carácter por defecto para separar pares clave-valor entre sí, un ampersand ("&").

Véase también setQueryDelimiters(), queryPairDelimiter(), y defaultQueryValueDelimiter().

[static constexpr noexcept] char16_t QUrlQuery::defaultQueryValueDelimiter()

Devuelve el carácter por defecto para separar claves de valores en la consulta, un signo igual ("=").

Véase también setQueryDelimiters(), queryValueDelimiter(), y defaultQueryPairDelimiter().

bool QUrlQuery::hasQueryItem(const QString &key) const

Devuelve true si hay un par de cadenas de consulta cuya clave es igual a key de la URL.

Véase también addQueryItem() y queryItemValue().

bool QUrlQuery::isEmpty() const

Devuelve true si este objeto QUrlQuery no contiene pares clave-valor, como después de haber sido construido por defecto o después de analizar una cadena de consulta vacía.

Véase también setQuery() y clear().

QString QUrlQuery::query(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Devuelve la cadena de consulta reconstruida, formada a partir de los pares clave-valor almacenados actualmente en este objeto QUrlQuery y separados por los delimitadores de consulta elegidos para este objeto. Las claves y los valores se codifican utilizando las opciones dadas por el parámetro encoding.

Para esta función, el único delimitador ambiguo es la almohadilla ("#"), ya que en las URL se utiliza para separar la cadena de consulta del fragmento que puede ir a continuación.

El orden de los pares clave-valor en la cadena devuelta es exactamente el mismo que en la consulta original.

Véase también setQuery(), QUrl::setQuery(), QUrl::fragment(), y Codificación.

QString QUrlQuery::queryItemValue(const QString &key, QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Devuelve el valor de consulta asociado a la clave key de la URL, utilizando las opciones especificadas en encoding para codificar el valor devuelto. Si no se encuentra la clave key, esta función devuelve una cadena vacía. Si necesita distinguir entre un valor vacío y una clave inexistente, debe comprobar primero la presencia de la clave utilizando hasQueryItem().

Si la clave key está definida de forma múltiple, esta función devolverá la primera que se encuentre, en el orden en que estaban presentes en la cadena de consulta o se añadieron utilizando addQueryItem().

Véase también addQueryItem(), allQueryItemValues() y Codificación.

QList<std::pair<QString, QString>> QUrlQuery::queryItems(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Devuelve la cadena de consulta de la URL, como un mapa de claves y valores, utilizando las opciones especificadas en encoding para codificar los elementos. El orden de los elementos es el mismo que el que se encuentra en la cadena de consulta o el establecido con setQueryItems().

Véase también setQueryItems() y Codificación.

QChar QUrlQuery::queryPairDelimiter() const

Devuelve el carácter utilizado para delimitar entre pares clave-valor al reconstruir la cadena de consulta en query() o al analizarla en setQuery().

Véase también setQueryDelimiters() y queryValueDelimiter().

QChar QUrlQuery::queryValueDelimiter() const

Devuelve el carácter utilizado para delimitar entre claves y valores al reconstruir la cadena de consulta en query() o al analizarla en setQuery().

Véase también setQueryDelimiters() y queryPairDelimiter().

void QUrlQuery::removeAllQueryItems(const QString &key)

Elimina de la URL todos los pares de cadenas de consulta cuya clave sea igual a key.

Véase también removeQueryItem().

void QUrlQuery::removeQueryItem(const QString &key)

Elimina de la URL el par de cadenas de consulta cuya clave es igual a key. Si hay varios elementos con una clave igual a key, elimina el primer elemento en el orden en que estaban presentes en la cadena de consulta o se añadieron con addQueryItem().

Véase también removeAllQueryItems().

void QUrlQuery::setQuery(const QString &queryString)

Analiza la cadena de consulta en queryString y establece los elementos internos a los valores encontrados allí. Si se han especificado delimitadores con setQueryDelimiters(), esta función los utilizará en lugar de los delimitadores predeterminados para analizar la cadena.

Véase también query().

void QUrlQuery::setQueryDelimiters(QChar valueDelimiter, QChar pairDelimiter)

Establece los caracteres utilizados para delimitar entre claves y valores, y entre pares clave-valor en la cadena de consulta de la URL. El delimitador de valores por defecto es '=' y el delimitador de pares por defecto es '&'.

valueDelimiter se utilizará para separar claves de valores, y pairDelimiter se utilizará para separar pares clave-valor. Cualquier aparición de estos caracteres delimitadores en la representación codificada de las claves y los valores de la cadena de consulta se codifica en porcentaje cuando se devuelve en query().

Si valueDelimiter está configurado como ',' y pairDelimiter como ';', la cadena de consulta anterior se representaría así:

 http://www.example.com/cgi-bin/drawgraph.cgi?type,pie;color,green

sub-delims    = "!" / "$" / "&" / "'" / "(" / ")"
              / "*" / "+" / "," / ";" / "="

El uso de otros caracteres no está soportado y puede resultar en un comportamiento inesperado. Este método no verifica que se haya pasado un delimitador válido.

Véase también queryValueDelimiter() y queryPairDelimiter().

void QUrlQuery::setQueryItems(const QList<std::pair<QString, QString>> &query)

Establece los elementos de este objeto QUrlQuery en query. Se conserva el orden de los elementos en query.

Véase también queryItems() y isEmpty().

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

Intercambia esta instancia de consulta URL con other. Esta operación es muy rápida y nunca falla.

QString QUrlQuery::toString(QUrl::ComponentFormattingOptions encoding = QUrl::PrettyDecoded) const

Devuelve este QUrlQuery como un QString. encoding puede utilizarse para especificar la codificación de la cadena URL del valor devuelto.

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

Mover-asigna other a esta instancia QUrlQuery.

QUrlQuery &QUrlQuery::operator=(const QUrlQuery &other)

Copia el contenido del objeto other QUrlQuery , incluidos los delimitadores de la consulta.