mirror of
https://github.com/yhirose/cpp-httplib.git
synced 2026-10-09 12:53:18 +00:00
885ed54b10
Drop the spaces between Japanese text and inline code or alphanumerics in the tour and the few other pages that still had them, and reword sentences that read awkwardly. The client compression page now lists Zstd alongside zlib and Brotli.
2.6 KiB
2.6 KiB
title, order, status
| title | order | status |
|---|---|---|
| C17. エラーコードをハンドリングする | 17 | draft |
cli.Get()やcli.Post()はResult型を返します。リクエストが失敗したとき（サーバーに到達できなかった、タイムアウトしたなど）、返り値は「falsy」になります。詳しい原因を知りたい場合はResult::error()を使います。
基本の判定
httplib::Client cli("http://localhost:8080");
auto res = cli.Get("/api/data");
if (res) {
// リクエストが送れて、レスポンスも受け取れた
std::cout << "status: " << res->status << std::endl;
} else {
// ネットワーク層で失敗した
std::cerr << "error: " << httplib::to_string(res.error()) << std::endl;
}
if (res)で成功・失敗を判定し、失敗時はres.error()でhttplib::Error列挙値を取り出せます。to_string()に渡すと人間が読める文字列になります。
代表的なエラー
| 値 | 意味 |
|---|---|
Error::Connection |
サーバーに接続できなかった |
Error::ConnectionTimeout |
接続タイムアウト（set_connection_timeout） |
Error::Read / Error::Write |
送受信中のエラー。set_read_timeoutやset_max_timeoutによるタイムアウトもError::Readになる |
Error::Timeout |
stream::Get()やSSEClientで、ボディの読み取りがタイムアウトした |
Error::ExceedRedirectCount |
リダイレクト回数が上限を超えた |
Error::SSLConnection |
TLSハンドシェイクに失敗 |
Error::SSLServerVerification |
サーバー証明書の検証に失敗 |
Error::Canceled |
進捗コールバックからfalseが返された |
ステータスコードとの使い分け
resがtruthyでも、HTTPステータスコードが4xxや5xxのこともあります。この2つは別物です。
auto res = cli.Get("/api/data");
if (!res) {
// ネットワークエラー（そもそもレスポンスを受け取れていない）
std::cerr << "network error: " << httplib::to_string(res.error()) << std::endl;
return 1;
}
if (res->status >= 400) {
// HTTPエラー（レスポンスは受け取った）
std::cerr << "http error: " << res->status << std::endl;
return 1;
}
// 正常系
std::cout << res->body << std::endl;
ネットワーク層のエラーはres.error()、HTTPのエラーはres->status、と頭の中で分けておきましょう。
SSL関連のエラーをさらに詳しく調べたい場合はC18. SSLエラーをハンドリングするを参照してください。