# 分页和排序

## 分页和排序

### 分页

使用 `limit` 和 `offset` 来控制分页数据：

* `limit` 指定该请求返回的结果个数
* `offset` 偏移量，指定该请求返回的结果的起始位置

默认 `limit` 为 `20`, `offset` 为 `0`，我们也可以手动指定 `limit` 和 `offset` 来控制。例如，每页展示 `100` 条数据，需要获取第 `5` 页的数据，将 `limit` 设置为 `100`、`offset` 设置为 `400` 即可。`limit` 最大可设置为 1000。

```
let query = Query()
query.limit = 10
query.offset = 0
table.find(query: query) { (listResult, error) in
                    
}
```

```
BaaSQuery *query = [[BaaSQuery alloc] init];
query.offset = 10;
query.limit = 0;
[table findWithQuery:query completion:^(BaaSRecordList * _Nullable listResult, NSError * _Nullable error) {

}];
```

**参数说明**

| 参数    | 类型    | 必填 | 说明                                                                           |
| ----- | ----- | -- | ---------------------------------------------------------------------------- |
| query | Query | N  | 查询条件，详见[数据表 - 查询](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/query) |

**返回结果**

| 名称         | 类型         | 说明                                                                               |
| ---------- | ---------- | -------------------------------------------------------------------------------- |
| listResult | RecordList | 结果列表，详见 [数据类型](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/data-type) 章节 |
| error      | NSError    | 错误信息，参考[错误处理和错误码](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/error-code)       |

> **info** 通过 **RecordList** 类型的 `next` 和 `previous` 属性来判断下一页或上一页是否有数据。若 `next` 为 `null`，表示当前为最后一页；若 `previous` 为 `null`，表示当前为第一页。

### 排序

使用 `orderBy` 来控制使用升序或降序获取数据列表，设置需要排序的字段名，升序为字段名，降序在字段名前加 '-'。

```
let query = Query()
// 升序
query.orderBy = ['created_at']

// 降序
query.orderBy = ['-created_at']

// 多重排序
query.orderBy = ['created_at', 'created_by']

table.find(query: query) { (listResult, error) in
                    
}
```

```
BaaSQuery *query = [[BaaSQuery alloc] init];
// 升序
query.orderBy = @[@"created_at"];

// 降序
query.orderBy = @[@"-created_at"];

// 多重排序
query.orderBy = @[@"created_at", @"created_by"];

[table findWithQuery:query completion:^(BaaSRecordList * _Nullable listResult, NSError * _Nullable error) {

}];
```

**参数说明**

| 参数    | 类型    | 必填 | 说明                                                                           |
| ----- | ----- | -- | ---------------------------------------------------------------------------- |
| query | Query | N  | 查询条件，详见[数据表 - 查询](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/query) |

**返回结果**

| 名称         | 类型         | 说明                                                                          |
| ---------- | ---------- | --------------------------------------------------------------------------- |
| listResult | RecordList | 详见 [数据类型](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/schema/data-type) 章节 |
| error      | NSError    | 错误信息，参考[错误处理和错误码](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/error-code)  |

## 获取记录总数

在获取一组记录时，返回的结果默认不包含记录总量（`total_count`)，需要返回记录总量可以通过 Query 的 returnTotalCount(Bool) 设置。

```
let query = Query()
query.returnTotalCount = true // 结果包含 total_count 字段
table.find(query: query) { (listResult, error) in
                    
}
```

```
BaaSQuery *query = [[BaaSQuery alloc] init];
query.returnTotalCount = YES; // 结果包含 total_count 字段
[table findWithQuery:query completion:^(BaaSRecordList * _Nullable listResult, NSError * _Nullable error) {

}];
```