首页

简单下载

    本SDK提供ufile_download方法用于从US3的存储空间下载小文件到本地，大文件(1G以上)请使用分片下载，完整代码详见 Github 。

    ufile_download调用的 US3 API 为GetFile, 具体参见GetFile API文档。

    方法原型

    1

    struct ufile_error ufile_download(const char *bucket_name, const char *key, FILE *file, size_t *return_size)

    参数说明

    • bucket_name： 待下载文件所在的存储空间的名称
    • key: 待下载文件在存储空间里的名称
    • file_path: 文件下载到本地后的路径

    示例

    执行该示例请先配置UFILE_*相关环境变量并赋予bucket_name、key和file_path有效值。

    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

    #include "../lib/api.h"
#include <stdio.h>
#include <stdlib.h>

const char* bucket_name = "your bucket name";
const char* key = "your file key";
const char* file_path = "your local file to be downloaded";

int main(int argc, char *argv[]){
    // 读取配置初始化SDK
    struct ufile_config cfg;
    cfg.public_key = getenv("UFILE_PUBLIC_KEY");
    cfg.private_key = getenv("UFILE_PRIVATE_KEY");
    cfg.bucket_host = getenv("UFILE_BUCKET_HOST");
    cfg.file_host = getenv("UFILE_FILE_HOST");
    struct ufile_error error;
    error = ufile_sdk_initialize(cfg, 0);
    if(UFILE_HAS_ERROR(error.code)){
        printf("初始化 sdk 失败，错误信息为：%s\n", error.message);
        return 1;
    }
	// 创建本地文件
    FILE *fp = fopen(file_path, "wb");
    if (fp == NULL){
        fprintf(stderr, "打开文件失败, 错误信息为: %s\n", strerror(errno));
        return 1;
    }
    // 下载文件
    error = ufile_download(bucket_name, key, fp, NULL);
    if UFILE_HAS_ERROR(error.code){
        printf("调用 download 失败，错误信息为:%s\n", error.message);
        ufile_sdk_cleanup();
        return 1;
    }
    fclose(fp);
    
    // 释放初始化SDK时分配的内存
    ufile_sdk_cleanup();
    return 0;
}