curl を C に変換

Q: libcurlとは何ですか？

libcurlは、curlコマンドラインツールの背後にあるCライブラリです。25以上のプロトコルをサポートする、現存する中で最もポータブルで広く導入されているHTTPクライアントライブラリです。何千ものアプリケーションや組み込みシステムで使用されています。システムのパッケージマネージャーで追加するか、静的にリンクしてください。curl2codeは、easyインターフェースを使用したlibcurlのCコードを生成します。

Q: libcurlのeasyインターフェースとmultiインターフェース、どちらを使うべきですか？

easyインターフェース (curl_easy_*) は、単一の同期転送用で、シンプルかつ直感的です。multiインターフェース (curl_multi_*) は、単一スレッドでの非ブロッキング並行転送を可能にします。スクリプトやシンプルなツールにはeasyを、高性能なアプリケーションにはmultiを使用してください。より高レベルなCファミリー言語については、curl to Rustを参照してください。

Q: libcurlで認証を処理するにはどうすればよいですか？

Bearer認証の場合：curl_slist_append(headers, "Authorization: Bearer token")でカスタムヘッダーを設定します。Basic認証の場合：curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass")を使用します。libcurlはBasic認証の資格情報を自動的にエンコードします。curl2codeは、-uおよびヘッダーフラグを正しいC API呼び出しに変換します。

Q: libcurlでマルチパートフォームデータを送信するにはどうすればよいですか？

MIME API（libcurl 7.56以降）を使用します：curl_mime_init()でmime構造体を作成し、各フィールドにcurl_mime_addpart()を使用し、ファイルアップロードにはcurl_mime_name()とcurl_mime_filedata()を使用します。CURLOPT_MIMEPOSTで設定し、curl_mime_free()で解放します。

Q: libcurlでエラーを処理するにはどうすればよいですか？

すべてのcurl_easy_*関数はCURLcodeを返します。CURLE_OKと比較して確認してください。人間が読めるメッセージを取得するにはcurl_easy_strerror(code)を使用します。詳細なエラー文字列を取得するにはCURLOPT_ERRORBUFFERを設定します。HTTPステータスはcurl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code)で取得します。

Q: libcurlでメモリを管理するにはどうすればよいですか？

ハンドルを使い終わったら、必ずcurl_easy_cleanup()を呼び出してください。ヘッダーリストはcurl_slist_free_all()で、MIME構造体はcurl_mime_free()で解放します。書き込みコールバックについては、独自のバッファ割り当てを管理してください。プログラム終了時に一度curl_global_cleanup()を呼び出します。リソースの解放を怠るとメモリリークの原因になります。

Q: libcurlでタイムアウトを設定するにはどうすればよいですか？

接続タイムアウトにはCURLOPT_CONNECTTIMEOUTを、総転送時間にはCURLOPT_TIMEOUTを設定します（どちらも秒単位）。ミリ秒単位の精度が必要な場合は、CURLOPT_CONNECTTIMEOUT_MSおよびCURLOPT_TIMEOUT_MSを使用します。これらはcurl CLIが--connect-timeoutおよび--max-timeで使用するオプションと全く同じです。

Q: libcurlでプロキシを構成するにはどうすればよいですか？

CURLOPT_PROXYにプロキシURLを設定します：curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080")。SOCKS5の場合は、CURLOPT_PROXYTYPEをCURLPROXY_SOCKS5に設定します。プロキシ認証にはCURLOPT_PROXYUSERPWDを使用します。libcurlはhttp_proxy環境変数も尊重します。

Q: CでJSONボディを含むPOSTリクエストを送信する方法は？

curl2codeを使用して、curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URLのようなcurlのPOSTコマンドをCに変換します。生成されたコードではcurl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string)を使用します。curl2codeはJSONコンテンツを含む-d/--dataフラグを自動的に検出し、libcurlのコードに適切なContent-Typeヘッダーを設定します。

Q: CでBearerトークン認証を追加する方法は？

curl -H "Authorization: Bearer YOUR_TOKEN" URLをcurl2codeに渡すと、認証ヘッダーstruct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN")を含むlibcurlのコードが生成されます。curl2codeは-H "Authorization: Bearer ..."と--oauth2-bearerフラグの両方からBearerトークンを検出します。Basic authの場合は、-u user:passを使用してください。

curl2code は、libcurl を使用して curl コマンドを C コードに変換します。変換は完全なプライバシー保護のため、WebAssembly を介してブラウザ内で実行されます。Rust については、curl to Rust 変換ツールをご確認ください。Go については、curl to Go をご覧ください。以下に、適切なメモリ管理を含んだ実用的な C 言語の例を示します。

ブラウザから curl をコピーする方法

1
デベロッパーツールを開く
F12 キーを押すか、Ctrl+Shift+Iを使用してブラウザのデベロッパーツールを開きます。
2
ネットワークタブに移動
ネットワークタブをクリックし、HTTP リクエストをトリガーするアクションを実行します。
3
cURL としてコピー
リクエストを右クリック → コピー → cURL としてコピー を選択します。その後、上に貼り付けてください。

C のコード例

1シンプルな GET リクエスト

curl コマンド

curl https://api.example.com/users

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/users");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;

  return (int)ret;
}

2JSON ボディを含む POST

curl コマンド

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "Content-Type: application/json");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/users");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"name\":\"John\",\"email\":\"john@example.com\"}");
  curl_easy_setopt(hnd, CURLOPT_POSTFIELDSIZE_LARGE, (curl_off_t)42);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

3Bearer トークンを使用したリクエスト

curl コマンド

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "Authorization: Bearer token123");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/me");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

4マルチパートフォームのアップロード

curl コマンド

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  curl_mime *mime1;
  curl_mimepart *part1;

  mime1 = NULL;

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/upload");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  mime1 = curl_mime_init(hnd);
  part1 = curl_mime_addpart(mime1);
  curl_mime_filedata(part1, "document.pdf");
  curl_mime_name(part1, "file");
  part1 = curl_mime_addpart(mime1);
  curl_mime_data(part1, "My file", CURL_ZERO_TERMINATED);
  curl_mime_name(part1, "description");
  curl_easy_setopt(hnd, CURLOPT_MIMEPOST, mime1);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_mime_free(mime1);
  mime1 = NULL;

  return (int)ret;
}

5カスタムヘッダー

curl コマンド

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

C · libcurl

#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;
  CURL *hnd;
  struct curl_slist *headers;

  headers = NULL;
  headers = curl_slist_append(headers, "X-API-Key: abc123");
  headers = curl_slist_append(headers, "Accept: application/json");
  headers = curl_slist_append(headers, "X-Request-ID: req-456");

  hnd = curl_easy_init();
  curl_easy_setopt(hnd, CURLOPT_BUFFERSIZE, 102400L);
  curl_easy_setopt(hnd, CURLOPT_URL, "https://api.example.com/data");
  curl_easy_setopt(hnd, CURLOPT_NOPROGRESS, 1L);
  curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(hnd, CURLOPT_USERAGENT, "curl/8.2.1");
  curl_easy_setopt(hnd, CURLOPT_MAXREDIRS, 50L);
  curl_easy_setopt(hnd, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_2TLS);
  curl_easy_setopt(hnd, CURLOPT_FTP_SKIP_PASV_IP, 1L);
  curl_easy_setopt(hnd, CURLOPT_TCP_KEEPALIVE, 1L);

  ret = curl_easy_perform(hnd);

  curl_easy_cleanup(hnd);
  hnd = NULL;
  curl_slist_free_all(headers);
  headers = NULL;

  return (int)ret;
}

よくある質問

libcurlとは何ですか？

libcurlは、curlコマンドラインツールの背後にあるCライブラリです。25以上のプロトコルをサポートする、現存する中で最もポータブルで広く導入されているHTTPクライアントライブラリです。何千ものアプリケーションや組み込みシステムで使用されています。システムのパッケージマネージャーで追加するか、静的にリンクしてください。curl2codeは、easyインターフェースを使用したlibcurlのCコードを生成します。

libcurlのeasyインターフェースとmultiインターフェース、どちらを使うべきですか？

easyインターフェース (curl_easy_*) は、単一の同期転送用で、シンプルかつ直感的です。multiインターフェース (curl_multi_*) は、単一スレッドでの非ブロッキング並行転送を可能にします。スクリプトやシンプルなツールにはeasyを、高性能なアプリケーションにはmultiを使用してください。より高レベルなCファミリー言語については、curl to Rustを参照してください。

libcurlで認証を処理するにはどうすればよいですか？

Bearer認証の場合：curl_slist_append(headers, "Authorization: Bearer token")でカスタムヘッダーを設定します。Basic認証の場合：curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass")を使用します。libcurlはBasic認証の資格情報を自動的にエンコードします。curl2codeは、-uおよびヘッダーフラグを正しいC API呼び出しに変換します。

libcurlでマルチパートフォームデータを送信するにはどうすればよいですか？

MIME API（libcurl 7.56以降）を使用します：curl_mime_init()でmime構造体を作成し、各フィールドにcurl_mime_addpart()を使用し、ファイルアップロードにはcurl_mime_name()とcurl_mime_filedata()を使用します。CURLOPT_MIMEPOSTで設定し、curl_mime_free()で解放します。

libcurlでエラーを処理するにはどうすればよいですか？

すべてのcurl_easy_*関数はCURLcodeを返します。CURLE_OKと比較して確認してください。人間が読めるメッセージを取得するにはcurl_easy_strerror(code)を使用します。詳細なエラー文字列を取得するにはCURLOPT_ERRORBUFFERを設定します。HTTPステータスはcurl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code)で取得します。

libcurlでメモリを管理するにはどうすればよいですか？

ハンドルを使い終わったら、必ずcurl_easy_cleanup()を呼び出してください。ヘッダーリストはcurl_slist_free_all()で、MIME構造体はcurl_mime_free()で解放します。書き込みコールバックについては、独自のバッファ割り当てを管理してください。プログラム終了時に一度curl_global_cleanup()を呼び出します。リソースの解放を怠るとメモリリークの原因になります。

libcurlでタイムアウトを設定するにはどうすればよいですか？

接続タイムアウトにはCURLOPT_CONNECTTIMEOUTを、総転送時間にはCURLOPT_TIMEOUTを設定します（どちらも秒単位）。ミリ秒単位の精度が必要な場合は、CURLOPT_CONNECTTIMEOUT_MSおよびCURLOPT_TIMEOUT_MSを使用します。これらはcurl CLIが--connect-timeoutおよび--max-timeで使用するオプションと全く同じです。

libcurlでプロキシを構成するにはどうすればよいですか？

CURLOPT_PROXYにプロキシURLを設定します：curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:8080")。SOCKS5の場合は、CURLOPT_PROXYTYPEをCURLPROXY_SOCKS5に設定します。プロキシ認証にはCURLOPT_PROXYUSERPWDを使用します。libcurlはhttp_proxy環境変数も尊重します。

CでJSONボディを含むPOSTリクエストを送信する方法は？

curl2codeを使用して、curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URLのようなcurlのPOSTコマンドをCに変換します。生成されたコードではcurl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_string)を使用します。curl2codeはJSONコンテンツを含む-d/--dataフラグを自動的に検出し、libcurlのコードに適切なContent-Typeヘッダーを設定します。

CでBearerトークン認証を追加する方法は？

curl -H "Authorization: Bearer YOUR_TOKEN" URLをcurl2codeに渡すと、認証ヘッダーstruct curl_slist *headers = curl_slist_append(NULL, "Authorization: Bearer TOKEN")を含むlibcurlのコードが生成されます。curl2codeは-H "Authorization: Bearer ..."と--oauth2-bearerフラグの両方からBearerトークンを検出します。Basic authの場合は、-u user:passを使用してください。

CでContent-Typeヘッダーを設定する方法は？

curl2codeはcurl -H "Content-Type: application/json" URLを、適切なヘッダーcurl_slist_append(headers, "Content-Type: application/json")を含むlibcurlのコードに変換します。-dデータの場合、curlはデフォルトでapplication/x-www-form-urlencodedを使用し、-Fフォームアップロードの場合はmultipart/form-dataを使用します。curl2codeはそれぞれを正しいlibcurl APIにマッピングします。

便利なリンク

libcurl ドキュメント

curl.se

標準ライブラリリファレンス

curl.se

curl man ページ

curl.se

curl ガイド

curl エラーコード

curl の終了コードを検索 — 原因、修正方法、デバッグのヒント。

curl でファイルをダウンロード

-o、-O でファイルを保存、リダイレクトの追跡、ダウンロードの再開など。

SSL、TLS、プロキシ

証明書、TLS バージョン、HTTP/SOCKS プロキシ、カスタム DNS の設定。

ブラウザから curl をコピーする方法

C のコード例

1シンプルな GET リクエスト

2JSON ボディを含む POST

3Bearer トークンを使用したリクエスト

4マルチパートフォームのアップロード

5カスタムヘッダー

よくある質問

便利なリンク

curl ガイド

curl を他の言語に変換

C のコード例

1シンプルな GET リクエスト

2JSON ボディを含む POST

3Bearer トークンを使用したリクエスト

4マルチパートフォームのアップロード

5カスタムヘッダー