C++怎么用libcurl获取下载文件名称及大小

发布时间：2023-03-01 17:38:17 作者：iii
来源：亿速云阅读：403

C++怎么用libcurl获取下载文件名称及大小

引言

在C++编程中，使用libcurl库进行网络请求和文件下载是非常常见的操作。libcurl是一个功能强大且易于使用的库，支持多种协议（如HTTP、HTTPS、FTP等），并且提供了丰富的API来处理网络请求。本文将详细介绍如何使用libcurl在C++中获取下载文件的名称和大小。

1. 安装和配置libcurl

在开始编写代码之前，首先需要确保libcurl库已经安装在你的开发环境中。你可以通过以下步骤来安装libcurl：

1.1 在Linux上安装libcurl

在大多数Linux发行版中，你可以使用包管理器来安装libcurl。例如，在Ubuntu上，你可以使用以下命令：

sudo apt-get install libcurl4-openssl-dev

1.2 在Windows上安装libcurl

在Windows上，你可以从libcurl的官方网站下载预编译的库文件，或者使用vcpkg等包管理器来安装。

1.3 在macOS上安装libcurl

在macOS上，你可以使用Homebrew来安装libcurl：

brew install curl

1.4 配置开发环境

安装完成后，确保你的开发环境（如CMake、Makefile或IDE）已经正确配置了libcurl的路径。你需要在编译时链接libcurl库，例如：

g++ -o my_program my_program.cpp -lcurl

2. 使用libcurl进行文件下载

在开始获取文件名称和大小之前，我们先来看一个简单的文件下载示例。

2.1 简单的文件下载示例

以下是一个使用libcurl下载文件的简单示例：

#include <iostream>
#include <curl/curl.h>

size_t write_data(void *ptr, size_t size, size_t nmemb, FILE *stream) {
    size_t written = fwrite(ptr, size, nmemb, stream);
    return written;
}

int main() {
    CURL *curl;
    FILE *fp;
    CURLcode res;
    const char *url = "https://example.com/file.zip";
    const char *outfilename = "file.zip";

    curl = curl_easy_init();
    if (curl) {
        fp = fopen(outfilename, "wb");
        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
        res = curl_easy_perform(curl);
        curl_easy_cleanup(curl);
        fclose(fp);
    }
    return 0;
}

在这个示例中，我们使用curl_easy_init()初始化一个CURL对象，然后设置URL和写入数据的回调函数。最后，我们调用curl_easy_perform()来执行下载操作。

3. 获取下载文件的名称

在下载文件时，我们通常希望获取文件的名称。文件名可以从URL中提取，也可以通过HTTP响应头中的Content-Disposition字段获取。

3.1 从URL中提取文件名

如果URL中包含了文件名，我们可以直接从URL中提取。例如，URL https://example.com/path/to/file.zip 中的文件名是 file.zip。

#include <string>
#include <algorithm>

std::string extract_filename_from_url(const std::string &url) {
    size_t last_slash_pos = url.find_last_of('/');
    if (last_slash_pos == std::string::npos) {
        return "";
    }
    return url.substr(last_slash_pos + 1);
}

int main() {
    std::string url = "https://example.com/path/to/file.zip";
    std::string filename = extract_filename_from_url(url);
    std::cout << "Filename: " << filename << std::endl;
    return 0;
}

3.2 从HTTP响应头中获取文件名

有时，文件名可能包含在HTTP响应头的Content-Disposition字段中。我们可以通过设置CURLOPT_HEADERFUNCTION来捕获响应头，并从中提取文件名。

#include <iostream>
#include <string>
#include <curl/curl.h>

size_t header_callback(void *ptr, size_t size, size_t nmemb, void *userdata) {
    std::string *header = static_cast<std::string*>(userdata);
    header->append(static_cast<char*>(ptr), size * nmemb);
    return size * nmemb;
}

std::string extract_filename_from_header(const std::string &header) {
    size_t pos = header.find("filename=");
    if (pos == std::string::npos) {
        return "";
    }
    size_t start = header.find('"', pos) + 1;
    size_t end = header.find('"', start);
    return header.substr(start, end - start);
}

int main() {
    CURL *curl;
    CURLcode res;
    std::string header_data;
    const char *url = "https://example.com/path/to/file.zip";

    curl = curl_easy_init();
    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HEADERFUNCTION, header_callback);
        curl_easy_setopt(curl, CURLOPT_HEADERDATA, &header_data);
        res = curl_easy_perform(curl);
        if (res == CURLE_OK) {
            std::string filename = extract_filename_from_header(header_data);
            std::cout << "Filename: " << filename << std::endl;
        }
        curl_easy_cleanup(curl);
    }
    return 0;
}

在这个示例中，我们通过header_callback函数捕获HTTP响应头，并从Content-Disposition字段中提取文件名。

4. 获取下载文件的大小

获取下载文件的大小可以通过两种方式实现：一种是通过HTTP响应头中的Content-Length字段获取，另一种是通过libcurl提供的API获取。

4.1 从HTTP响应头中获取文件大小

我们可以通过捕获HTTP响应头中的Content-Length字段来获取文件大小。

#include <iostream>
#include <string>
#include <curl/curl.h>

size_t header_callback(void *ptr, size_t size, size_t nmemb, void *userdata) {
    std::string *header = static_cast<std::string*>(userdata);
    header->append(static_cast<char*>(ptr), size * nmemb);
    return size * nmemb;
}

long extract_content_length_from_header(const std::string &header) {
    size_t pos = header.find("Content-Length: ");
    if (pos == std::string::npos) {
        return -1;
    }
    size_t start = pos + 16; // "Content-Length: "的长度
    size_t end = header.find("\r\n", start);
    std::string content_length_str = header.substr(start, end - start);
    return std::stol(content_length_str);
}

int main() {
    CURL *curl;
    CURLcode res;
    std::string header_data;
    const char *url = "https://example.com/path/to/file.zip";

    curl = curl_easy_init();
    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HEADERFUNCTION, header_callback);
        curl_easy_setopt(curl, CURLOPT_HEADERDATA, &header_data);
        res = curl_easy_perform(curl);
        if (res == CURLE_OK) {
            long content_length = extract_content_length_from_header(header_data);
            if (content_length != -1) {
                std::cout << "Content-Length: " << content_length << " bytes" << std::endl;
            } else {
                std::cout << "Content-Length not found in header" << std::endl;
            }
        }
        curl_easy_cleanup(curl);
    }
    return 0;
}

4.2 使用libcurl API获取文件大小

libcurl提供了一个方便的API来获取文件大小，即curl_easy_getinfo()函数。我们可以使用CURLINFO_CONTENT_LENGTH_DOWNLOAD选项来获取文件大小。

#include <iostream>
#include <curl/curl.h>

int main() {
    CURL *curl;
    CURLcode res;
    const char *url = "https://example.com/path/to/file.zip";

    curl = curl_easy_init();
    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, url);
        res = curl_easy_perform(curl);
        if (res == CURLE_OK) {
            double content_length;
            curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD, &content_length);
            if (content_length != -1) {
                std::cout << "Content-Length: " << content_length << " bytes" << std::endl;
            } else {
                std::cout << "Content-Length not available" << std::endl;
            }
        }
        curl_easy_cleanup(curl);
    }
    return 0;
}

在这个示例中，我们使用curl_easy_getinfo()函数获取文件大小，并将其打印出来。

5. 综合示例：获取文件名和大小

结合前面的内容，我们可以编写一个综合示例，同时获取下载文件的名称和大小。

#include <iostream>
#include <string>
#include <curl/curl.h>

size_t write_data(void *ptr, size_t size, size_t nmemb, FILE *stream) {
    size_t written = fwrite(ptr, size, nmemb, stream);
    return written;
}

size_t header_callback(void *ptr, size_t size, size_t nmemb, void *userdata) {
    std::string *header = static_cast<std::string*>(userdata);
    header->append(static_cast<char*>(ptr), size * nmemb);
    return size * nmemb;
}

std::string extract_filename_from_header(const std::string &header) {
    size_t pos = header.find("filename=");
    if (pos == std::string::npos) {
        return "";
    }
    size_t start = header.find('"', pos) + 1;
    size_t end = header.find('"', start);
    return header.substr(start, end - start);
}

int main() {
    CURL *curl;
    FILE *fp;
    CURLcode res;
    std::string header_data;
    const char *url = "https://example.com/path/to/file.zip";

    curl = curl_easy_init();
    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HEADERFUNCTION, header_callback);
        curl_easy_setopt(curl, CURLOPT_HEADERDATA, &header_data);
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_data);

        std::string filename = extract_filename_from_header(header_data);
        if (filename.empty()) {
            filename = "downloaded_file";
        }
        fp = fopen(filename.c_str(), "wb");
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);

        res = curl_easy_perform(curl);
        if (res == CURLE_OK) {
            double content_length;
            curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD, &content_length);
            if (content_length != -1) {
                std::cout << "Filename: " << filename << std::endl;
                std::cout << "Content-Length: " << content_length << " bytes" << std::endl;
            } else {
                std::cout << "Content-Length not available" << std::endl;
            }
        }
        curl_easy_cleanup(curl);
        fclose(fp);
    }
    return 0;
}

在这个综合示例中，我们同时获取了下载文件的名称和大小，并将其保存到本地文件中。

6. 错误处理和调试

在实际应用中，错误处理和调试是非常重要的。libcurl提供了丰富的错误码和调试信息，可以帮助我们更好地处理异常情况。

6.1 错误处理

在每次调用libcurl函数后，都应该检查返回值以确保操作成功。例如：

res = curl_easy_perform(curl);
if (res != CURLE_OK) {
    std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
}

6.2 调试信息

libcurl还提供了调试选项，可以通过设置CURLOPT_VERBOSE来启用详细的调试信息输出。

curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);

启用调试信息后，libcurl会将详细的请求和响应信息输出到标准错误流（stderr），这对于调试网络请求非常有帮助。

7. 总结

本文详细介绍了如何使用libcurl在C++中获取下载文件的名称和大小。我们首先介绍了libcurl的安装和配置，然后通过示例代码展示了如何从URL和HTTP响应头中提取文件名，以及如何获取文件大小。最后，我们提供了一个综合示例，展示了如何同时获取文件名和大小，并保存下载的文件。

通过本文的学习，你应该能够在C++项目中熟练使用libcurl进行文件下载，并获取相关的文件信息。希望本文对你有所帮助，祝你在C++编程中取得更多进展！

C++怎么用libcurl获取下载文件名称及大小

C++怎么用libcurl获取下载文件名称及大小

引言

1. 安装和配置libcurl

1.1 在Linux上安装libcurl

1.2 在Windows上安装libcurl

1.3 在macOS上安装libcurl

1.4 配置开发环境

2. 使用libcurl进行文件下载

2.1 简单的文件下载示例

3. 获取下载文件的名称

3.1 从URL中提取文件名

3.2 从HTTP响应头中获取文件名

4. 获取下载文件的大小

4.1 从HTTP响应头中获取文件大小

4.2 使用libcurl API获取文件大小

5. 综合示例：获取文件名和大小

6. 错误处理和调试

6.1 错误处理

6.2 调试信息

7. 总结

相关阅读