2020-03-17 10:48:59 +08:00
|
|
|
|
## data\_reader\_t
|
|
|
|
|
|
### 概述
|
|
|
|
|
|
数据读取接口。
|
|
|
|
|
|
|
2021-01-11 08:23:05 +08:00
|
|
|
|
>对可读的媒介，如内存、文件、flash、资源和其它媒介提供一个统一的读取接口。
|
2020-03-17 10:48:59 +08:00
|
|
|
|
----------------------------------
|
|
|
|
|
|
### 函数
|
|
|
|
|
|
<p id="data_reader_t_methods">
|
|
|
|
|
|
|
|
|
|
|
|
| 函数名称 | 说明 |
|
|
|
|
|
|
| -------- | ------------ |
|
|
|
|
|
|
| <a href="#data_reader_t_data_reader_destroy">data\_reader\_destroy</a> | 销毁reader对象。 |
|
|
|
|
|
|
| <a href="#data_reader_t_data_reader_get_size">data\_reader\_get\_size</a> | 获取数据长度。 |
|
|
|
|
|
|
| <a href="#data_reader_t_data_reader_read">data\_reader\_read</a> | 在指定位置读取数据。 |
|
|
|
|
|
|
| <a href="#data_reader_t_data_reader_read_all">data\_reader\_read\_all</a> | 从指定的URL读取全部数据。 |
|
|
|
|
|
|
#### data\_reader\_destroy 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="data_reader_t_data_reader_destroy">销毁reader对象。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
ret_t data_reader_destroy (data_reader_t* reader);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
|
|
|
|
|
|
| reader | data\_reader\_t* | reader对象。 |
|
|
|
|
|
|
#### data\_reader\_get\_size 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="data_reader_t_data_reader_get_size">获取数据长度。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
uint64_t data_reader_get_size (data_reader_t* reader);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | uint64\_t | 返回数据长度。 |
|
|
|
|
|
|
| reader | data\_reader\_t* | reader对象。 |
|
|
|
|
|
|
#### data\_reader\_read 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="data_reader_t_data_reader_read">在指定位置读取数据。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
int32_t data_reader_read (data_reader_t* reader, uint64_t offset, void* data, uint32_t size);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | int32\_t | 返回实际读取数据的长度。 |
|
|
|
|
|
|
| reader | data\_reader\_t* | reader对象。 |
|
|
|
|
|
|
| offset | uint64\_t | 偏移量。 |
|
|
|
|
|
|
| data | void* | 用于读取数据的缓冲区。 |
|
|
|
|
|
|
| size | uint32\_t | 最大读取数据长度。 |
|
|
|
|
|
|
#### data\_reader\_read\_all 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="data_reader_t_data_reader_read_all">从指定的URL读取全部数据。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
void* data_reader_read_all (const char* url, uint32_t* size);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | void* | 返回全部数据，调用者需要调用TKMEM\_FREE释放返回值。 |
|
|
|
|
|
|
| url | const char* | URL。 |
|
|
|
|
|
|
| size | uint32\_t* | 返回数据长度。 |
|
