---
title: ListBuilder
url: https://www.fastly.com/documentation/reference/compute/sdks/cpp/fastly/kv_store/class.ListBuilder/
---

**Kind:** Class  
**Module:** [kv_store](https://www.fastly.com/documentation/reference/compute/sdks/cpp/fastly/kv_store/)  
**Package:** compute-sdk-cpp 0.7.0  
**Source:** https://github.com/fastly/compute-sdk-cpp/blob/ff911e47be2f319e83a9cde960d2c3c5db534280/include/fastly/kv_store.h#L251

Include `fastly/kv_store.h` to use this class.

## Methods

### cursor

**Source:** https://github.com/fastly/compute-sdk-cpp/blob/ff911e47be2f319e83a9cde960d2c3c5db534280/include/fastly/kv_store.h#L260

```cpp
ListBuilder fastly::kv_store::ListBuilder::cursor(const std::string &cursor) &&
```

Change the cursor of the request.

**Parameters**

- `cursor`: `const std::string &`

**Returns**

`ListBuilder`

### eventual_consistency

**Source:** https://github.com/fastly/compute-sdk-cpp/blob/ff911e47be2f319e83a9cde960d2c3c5db534280/include/fastly/kv_store.h#L257

```cpp
ListBuilder fastly::kv_store::ListBuilder::eventual_consistency() &&
```

Rather than read data from the primary data source, which is slower but strongly consistent (strong, the default), instead read a local copy if available, which offers higher speed and may be a few seconds out of date (eventual).

**Returns**

`ListBuilder`

### execute

**Source:** https://github.com/fastly/compute-sdk-cpp/blob/ff911e47be2f319e83a9cde960d2c3c5db534280/include/fastly/kv_store.h#L269

```cpp
expected<ListPage> fastly::kv_store::ListBuilder::execute() &&
```

Initiate and wait on a list of values in the KV Store.

**Returns**

`expected<ListPage>`

### execute_async

**Source:** https://github.com/fastly/compute-sdk-cpp/blob/ff911e47be2f319e83a9cde960d2c3c5db534280/include/fastly/kv_store.h#L276

```cpp
expected<PendingListHandle> fastly::kv_store::ListBuilder::execute_async() const
```

Initiate async list of values in the KV Store.

**Returns**

`expected<PendingListHandle>`

### iter

**Source:** https://github.com/fastly/compute-sdk-cpp/blob/ff911e47be2f319e83a9cde960d2c3c5db534280/include/fastly/kv_store.h#L273

```cpp
ListResponse fastly::kv_store::ListBuilder::iter() &&
```

Produce a new [`ListResponse`](https://www.fastly.com/documentation/reference/compute/sdks/cpp/fastly/kv_store/class.ListResponse/), which can be used as an iterator for chunked list operations.

**Returns**

`ListResponse`

### limit

**Source:** https://github.com/fastly/compute-sdk-cpp/blob/ff911e47be2f319e83a9cde960d2c3c5db534280/include/fastly/kv_store.h#L263

```cpp
ListBuilder fastly::kv_store::ListBuilder::limit(std::uint32_t limit) &&
```

Set the maximum number of items included in the response.

**Parameters**

- `limit`: `std::uint32_t`

**Returns**

`ListBuilder`

### prefix

**Source:** https://github.com/fastly/compute-sdk-cpp/blob/ff911e47be2f319e83a9cde960d2c3c5db534280/include/fastly/kv_store.h#L266

```cpp
ListBuilder fastly::kv_store::ListBuilder::prefix(const std::string &prefix) &&
```

Set the prefix match for items to include in the resultset.

**Parameters**

- `prefix`: `const std::string &`

**Returns**

`ListBuilder`