mirror of
https://github.com/yhirose/cpp-httplib.git
synced 2026-08-11 04:41:23 +00:00
0fa4912891
Cookbook body links referenced sibling pages with a bare slug (e.g. `c14-keep-alive`). Under the pretty-URL layout each page lives in its own directory, so these resolve against the page's own directory and 404. Prefix them with `../` to match the convention already used in the tour and llm-app sections. Verified clean with `docs-gen check`.
1.8 KiB
1.8 KiB
title, order, status
| title | order | status |
|---|---|---|
| C08. ファイルを生バイナリとしてPOSTする | 8 | draft |
マルチパートではなく、ファイルの中身をそのままリクエストボディとして送りたいときがあります。S3互換APIへのアップロードや、生の画像データを受け付けるエンドポイントなどです。このときはmake_file_body()を使いましょう。
基本の使い方
httplib::Client cli("https://storage.example.com");
auto [size, provider] = httplib::make_file_body("backup.tar.gz");
if (size == 0) {
std::cerr << "Failed to open file" << std::endl;
return 1;
}
auto res = cli.Put("/bucket/backup.tar.gz", size,
provider, "application/gzip");
make_file_body()はファイルサイズとContentProviderのペアを返します。そのままPost()やPut()に渡せば、ファイルの中身がリクエストボディとしてそのまま送られます。
ContentProviderはファイルをチャンクごとに読み込むので、巨大なファイルでもメモリに全体を載せません。
ファイルが開けなかったとき
make_file_body()は開けなかった場合、sizeを0、providerを空の関数オブジェクトとして返します。そのまま送信するとおかしな結果になるので、必ずsizeをチェックしてください。
Warning:
make_file_body()はContent-Lengthを最初に確定させる必要があるため、ファイルサイズをあらかじめ取得します。送信中にファイルサイズが変わる可能性がある場合は、このAPIには向きません。
マルチパート形式で送りたい場合はC07. ファイルをマルチパートフォームとしてアップロードするを参照してください。