QNetworkCookie Class

Member Function Documentation

[explicit] QNetworkCookie::QNetworkCookie(const QByteArray &name = QByteArray(), const QByteArray &value = QByteArray())

Create a new QNetworkCookie object, initializing the cookie name to name and its value to value.

A cookie is only valid if it has a name. However, the value is opaque to the application and being empty may have significance to the remote server.

QNetworkCookie::QNetworkCookie(const QNetworkCookie &other)

Creates a new QNetworkCookie object by copying the contents of other.

QNetworkCookie::~QNetworkCookie()

Destroys this QNetworkCookie object.

QString QNetworkCookie::domain() const

Returns the domain this cookie is associated with. This corresponds to the "domain" field of the cookie string.

Note that the domain here may start with a dot, which is not a valid hostname. However, it means this cookie matches all hostnames ending with that domain name.

See also setDomain().

QDateTime QNetworkCookie::expirationDate() const

Returns the expiration date for this cookie. If this cookie is a session cookie, the QDateTime returned will not be valid. If the date is in the past, this cookie has already expired and should not be sent again back to a remote server.

The expiration date corresponds to the parameters of the "expires" entry in the cookie string.

See also isSessionCookie() and setExpirationDate().

bool QNetworkCookie::hasSameIdentifier(const QNetworkCookie &other) const

Returns true if this cookie has the same identifier tuple as other. The identifier tuple is composed of the name, domain and path.

See also operator==().

bool QNetworkCookie::isHttpOnly() const

Returns true if the "HttpOnly" flag is enabled for this cookie.

A cookie that is "HttpOnly" is only set and retrieved by the network requests and replies; i.e., the HTTP protocol. It is not accessible from scripts running on browsers.

See also isSecure().

bool QNetworkCookie::isSecure() const

Returns true if the "secure" option was specified in the cookie string, false otherwise.

Secure cookies may contain private information and should not be resent over unencrypted connections.

See also setSecure().

bool QNetworkCookie::isSessionCookie() const

Returns true if this cookie is a session cookie. A session cookie is a cookie which has no expiration date, which means it should be discarded when the application's concept of session is over (usually, when the application exits).

See also expirationDate() and setExpirationDate().

QByteArray QNetworkCookie::name() const

Returns the name of this cookie. The only mandatory field of a cookie is its name, without which it is not considered valid.

See also setName() and value().

void QNetworkCookie::normalize(const QUrl &url)

This functions normalizes the path and domain of the cookie if they were previously empty. The url parameter is used to determine the correct domain and path.

[static] QList<QNetworkCookie> QNetworkCookie::parseCookies(const QByteArray &cookieString)

Parses the cookie string cookieString as received from a server response in the "Set-Cookie:" header. If there's a parsing error, this function returns an empty list.

Since the HTTP header can set more than one cookie at the same time, this function returns a QList<QNetworkCookie>, one for each cookie that is parsed.

See also toRawForm().

QString QNetworkCookie::path() const

Returns the path associated with this cookie. This corresponds to the "path" field of the cookie string.

See also setPath().

[since 6.1] QNetworkCookie::SameSite QNetworkCookie::sameSitePolicy() const

Returns the "SameSite" option if specified in the cookie string, SameSite::Default if not present.

This function was introduced in Qt 6.1.

See also setSameSitePolicy().

void QNetworkCookie::setDomain(const QString &domain)

Sets the domain associated with this cookie to be domain.

See also domain().

void QNetworkCookie::setExpirationDate(const QDateTime &date)

Sets the expiration date of this cookie to date. Setting an invalid expiration date to this cookie will mean it's a session cookie.

See also isSessionCookie() and expirationDate().

void QNetworkCookie::setHttpOnly(bool enable)

Sets this cookie's "HttpOnly" flag to enable.

See also isHttpOnly().

void QNetworkCookie::setName(const QByteArray &cookieName)

Sets the name of this cookie to be cookieName. Note that setting a cookie name to an empty QByteArray will make this cookie invalid.

See also name() and value().

void QNetworkCookie::setPath(const QString &path)

Sets the path associated with this cookie to be path.

See also path().

[since 6.1] void QNetworkCookie::setSameSitePolicy(QNetworkCookie::SameSite sameSite)

Sets the "SameSite" option of this cookie to sameSite.

This function was introduced in Qt 6.1.

See also sameSitePolicy().

void QNetworkCookie::setSecure(bool enable)

Sets the secure flag of this cookie to enable.

Secure cookies may contain private information and should not be resent over unencrypted connections.

See also isSecure().

void QNetworkCookie::setValue(const QByteArray &value)

Sets the value of this cookie to be value.

See also value() and name().

void QNetworkCookie::swap(QNetworkCookie &other)

Swaps this cookie with other. This function is very fast and never fails.

QByteArray QNetworkCookie::toRawForm(QNetworkCookie::RawForm form = Full) const

Returns the raw form of this QNetworkCookie. The QByteArray returned by this function is suitable for an HTTP header, either in a server response (the Set-Cookie header) or the client request (the Cookie header). You can choose from one of two formats, using form.

See also parseCookies().

QByteArray QNetworkCookie::value() const

Returns this cookies value, as specified in the cookie string. Note that a cookie is still valid if its value is empty.

Cookie name-value pairs are considered opaque to the application: that is, their values don't mean anything.

See also setValue() and name().

bool QNetworkCookie::operator!=(const QNetworkCookie &other) const

Returns true if this cookie is not equal to other.

See also operator==().

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

Copies the contents of the QNetworkCookie object other to this object.

bool QNetworkCookie::operator==(const QNetworkCookie &other) const

Returns true if this cookie is equal to other. This function only returns true if all fields of the cookie are the same.

However, in some contexts, two cookies of the same name could be considered equal.

See also operator!=() and hasSameIdentifier().