QFormDataPartBuilder Class

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

[constexpr noexcept default] QFormDataPartBuilder::QFormDataPartBuilder()

QFormDataPartBuilder のインスタンスをデフォルトコンストラクタで生成します。

[implicit] QFormDataPartBuilder::QFormDataPartBuilder(const QFormDataPartBuilder &other)

other のコピーを作成します。このオブジェクトは、関連付けられているQFormDataBuilder が破棄されない限り有効です。

コピーのデータは共有されています（浅いコピー）：一方を変更すると、もう一方も変更されます。

QFormDataPartBuilder foo()
{
    QFormDataBuilder builder;
    auto qfdpb1 = builder.part("First"_L1);
    auto qfdpb2 = qfdpb1; // this creates a shallow copy

    qfdpb2.setBodyDevice(&image, "cutecat.jpg"); // qfdpb1 is also modified

    return qfdbp2;  // invalid, builder is destroyed at the end of the scope
}

[noexcept implicit] QFormDataPartBuilder::QFormDataPartBuilder(QFormDataPartBuilder &&other)

QFormDataPartBuilderのインスタンスをMoveコンストラクタで生成し、other が指していたのと同じオブジェクトを指すようにします。

[noexcept implicit] QFormDataPartBuilder::~QFormDataPartBuilder()

QFormDataPartBuilder オブジェクトを破棄します。

QFormDataPartBuilder QFormDataPartBuilder::setBody(QByteArrayView data, QAnyStringView fileName = {}, QAnyStringView mimeType = {})

data をこの MIME パートの本文として設定し、指定されている場合は、fileName をコンテンツ・ディスポジション・ヘッダーのファイル名パラメータとして設定します。

mimeType が指定されていない（空）場合、QFormDataPartBuilder はQMimeDatabase を使用してdata の MIME タイプを自動検出しようとします。

その後、setBodyDevice() が呼び出されると、ボディは破棄され、代わりにデバイスが使用されます。

大量のデータ (画像など) の場合、内部でデータをコピーしないsetBodyDevice() を使用することをお勧めします。

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

QFormDataPartBuilder QFormDataPartBuilder::setBodyDevice(QIODevice *body, QAnyStringView fileName = {}, QAnyStringView mimeType = {})

body をこのパートのボディデバイスとして設定し、fileName をコンテンツ・ディスポジション・ヘッダーのファイル名パラメータとして設定します。

mimeType が指定されていない（空）場合、QFormDataPartBuilder はQMimeDatabase を使用してbody の MIME タイプを自動検出しようとします。

その後、setBody() を呼び出すと、ボディデバイスは破棄され、代わりにsetBody() によって設定されたデータが使用されます。

データ量が多い場合は、setBody() よりもこのメソッドを使用することをお勧めします。このメソッドを使用すると、コンテンツがコピーされることなく、デバイスから直接読み込まれるためです。

body は開かれており、読み取り可能でなければなりません。QFormDataPartBuilder はbody の所有権を取得しないため、必要に応じてデバイスを閉じて破棄する必要があります。

setBody() およびQHttpPart::setBodyDevice()も参照してください 。

QFormDataPartBuilder QFormDataPartBuilder::setHeaders(const QHttpHeaders &headers)

headers で指定されたヘッダーを設定します。

[implicit] QFormDataPartBuilder &QFormDataPartBuilder::operator=(QFormDataPartBuilder &&other)

other をこのQFormDataPartBuilder インスタンスに割り当てます。

[implicit] QFormDataPartBuilder &QFormDataPartBuilder::operator=(const QFormDataPartBuilder &other)

other をQFormDataPartBuilder に代入し、このQFormDataPartBuilder への参照を返します。このオブジェクトは、関連付けられたQFormDataBuilder が破棄されない限り有効です。

コピーされたデータは共有されます（浅いコピー）：一方を変更すると、もう一方も変更されます。

QFormDataPartBuilder foo()
{
    QFormDataBuilder builder;
    auto qfdpb1 = builder.part("First"_L1);
    auto qfdpb2 = qfdpb1; // this creates a shallow copy

    qfdpb2.setBodyDevice(&image, "cutecat.jpg"); // qfdpb1 is also modified

    return qfdbp2;  // invalid, builder is destroyed at the end of the scope
}