QNetworkCookie Class

メンバー関数ドキュメント

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

新しい QNetworkCookie オブジェクトを作成し、クッキー名をname に、値をvalue に初期化します。

クッキーは名前を持つ場合のみ有効です。ただし、値はアプリケーショ ンには不透明であり、空であることがリモート・サーバに とって重要である場合があります。

QNetworkCookie::QNetworkCookie(const QNetworkCookie &other)

other の内容をコピーして、新しい QNetworkCookie オブジェクトを作成します。

[noexcept] QNetworkCookie::~QNetworkCookie()

このQNetworkCookie オブジェクトを破棄します。

QString QNetworkCookie::domain() const

このクッキーに関連付けられているドメインを返します。これはクッキー文字列の「domain」フィールドに対応します。

ここでのドメインはドットで始まるかもしれず、有効なホスト名ではないことに注意してください。しかし、このクッキーはそのドメイン名で終わるすべてのホスト名にマッチすることを意味します。

setDomain()も参照してください 。

QDateTime QNetworkCookie::expirationDate() const

このクッキーの有効期限を返します。このクッキーがセッション・クッキーである場合、返されるQDateTime は有効ではありません。この日付が過去のものである場合、このクッキーはすでに有効期限が切れており、リモート・サーバに再送信すべきではありません。

有効期限はクッキー文字列の「expires」エントリのパラメータに対応する。

isSessionCookie()およびsetExpirationDate()も参照 。

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

このクッキーがother と同じ識別子タプルを持つ場合、true を返す。識別子タプルは名前、ドメイン、パスで構成される。

operator==()も参照 。

bool QNetworkCookie::isHttpOnly() const

このクッキーで「HttpOnly」フラグが有効になっている場合、true を返す。

HttpOnly "であるクッキーは、ネットワーク・リクエストとリプライ、すなわちHTTPプロトコルの みによって設定され、取得される。ブラウザ上で動作するスクリプトからはアクセスできません。

isSecure()も参照のこと 。

bool QNetworkCookie::isSecure() const

クッキー文字列に「secure」オプションが指定されていればtrue 、そうでなければfalseを返します。

セキュアなクッキーは個人情報を含んでいる可能性があり、暗号化されていない接続で再送信すべきではありません。

setSecure()も参照 。

bool QNetworkCookie::isSessionCookie() const

このクッキーがセッション・クッキーである場合、true を返します。セッション・クッキーとは有効期限のないクッキーのことで、アプリケーションのセッションの概念が終わったとき(通常、アプリケーションが終了したとき)に破棄されるべきものです。

expirationDate() およびsetExpirationDate()も参照してください 。

QByteArray QNetworkCookie::name() const

このクッキーの名前を返します。クッキーの唯一の必須フィールドはその名前で、これがないと有効とはみなされません。

setName() およびvalue() も参照して ください。

void QNetworkCookie::normalize(const QUrl &url)

この関数はクッキーのパスとドメインを正規化します。url パラメータは、正しいドメインとパスを決定するために使用されます。

[static] QList<QNetworkCookie> QNetworkCookie::parseCookies(QByteArrayView cookieString)

Set-Cookie: "ヘッダ内のサーバ・レスポンスから受け取ったクッキー文字列cookieString を解析する。解析エラーの場合、この関数は空のリストを返します。

HTTP ヘッダは同時に複数のクッキーを設定できるので、この関数はQList<QNetworkCookie> を返します。

toRawForm()も参照してください 。

QString QNetworkCookie::path() const

このクッキーに関連付けられたパスを返します。これは Cookie 文字列の "path" フィールドに対応します。

setPath()も参照 。

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

クッキー文字列で指定されていれば "SameSite" オプションを、なければSameSite::Default を返します。

この関数は Qt 6.1 で導入されました。

setSameSitePolicy() も参照して ください。

void QNetworkCookie::setDomain(const QString &domain)

このクッキーに関連付けられたドメインをdomain に設定します。

domain() も参照して ください。

void QNetworkCookie::setExpirationDate(const QDateTime &date)

このクッキーの有効期限をdate に設定します。 このクッキーに無効な有効期限を設定すると、それがセッション・クッキーであることを意味します。

isSessionCookie() およびexpirationDate() も参照して ください。

void QNetworkCookie::setHttpOnly(bool enable)

このクッキーの「HttpOnly」フラグをenable に設定します。

isHttpOnly() も参照して ください。

void QNetworkCookie::setName(const QByteArray &cookieName)

このクッキーの名前をcookieName に設定します。クッキー名を空のQByteArray に設定すると、このクッキーは無効になることに注意してください。

name() およびvalue() も参照して ください。

void QNetworkCookie::setPath(const QString &path)

このクッキーに関連付けられたパスをpath に設定します。

path()も参照して ください。

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

このクッキーの "SameSite" オプションをsameSite に設定します。

この関数は Qt 6.1 で導入されました。

sameSitePolicy()も参照して ください。

void QNetworkCookie::setSecure(bool enable)

このクッキーの secure フラグをenable に設定します。

セキュアなクッキーは個人情報を含んでいる可能性があり、暗号化されていない接続で再送信されるべきではありません。

isSecure() も参照して ください。

void QNetworkCookie::setValue(const QByteArray &value)

このクッキーの値をvalue に設定します。

value() およびname() も参照して ください。

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

このクッキーをother と交換します。この関数は非常に高速で、失敗することはありません。

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

このQNetworkCookie の生の形式を返します。この関数によって返されるQByteArray は、サーバ応答 (Set-Cookie ヘッダ) またはクライアント・リクエスト (Cookie ヘッダ) の HTTP ヘッダに適しています。form を使用して、2つの形式のどちらかを選択できます。

parseCookies()も参照してください 。

QByteArray QNetworkCookie::value() const

Cookie文字列で指定された、このCookieの値を返します。クッキーの値が空でも、クッキーは有効であることに注意してください。

クッキーの名前と値のペアは、アプリケーションにとって不透明とみなされます。

setValue() およびname()も参照してください 。

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

このクッキーがother と等しくない場合、true を返します。

operator==()も参照して ください。

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

QNetworkCookie オブジェクトother の内容をこのオブジェクトにコピーします。

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

このクッキーがother と等しい場合、true を返します。 この関数は、クッキーのすべてのフィールドが同じ場合にのみtrue を返します。

しかし文脈によっては、同じ名前の 2 つのクッキーが等しいとみなされることもあります。

operator!=() とhasSameIdentifier()も参照してください 。