首页

获取文件基本信息

    本SDK提供ufile_head方法用于获取文件基本信息，完整代码详见 Github 。

    ufile_head调用的 US3 API 为HEADFile, 具体参见HEADFileAPI文档。

    方法原型

    1

    struct ufile_error ufile_head(const char* bucket_name, const char *key, struct ufile_file_info *info)

    参数说明

    • bucket_name： 待查找文件所在的存储空间
    • key: 待查找文件在存储空间里的名称

    示例

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

    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

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

const char* bucket_name = "your bucket name";
const char* key = "your file key";

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;
    }

    // 获取文件基本信息
    struct ufile_file_info file_info;
    error = ufile_head(bucket_name, key, &file_info);
    if UFILE_HAS_ERROR(error.code) {
        printf("调用 head 失败，错误信息为：%s\n", error.message);
    }else{
        printf("文件基本信息为: size=%lld,etag=%s,mime-type=%s\n", file_info.bytes_len, file_info.etag, file_info.mime_type);
    }
    ufile_free_file_info(file_info);
    // 释放初始化SDK时分配的内存
    ufile_sdk_cleanup();
    return 0;
}