---
title: "Quick reference"
description: "Quick reference for Aerospike Go client CDT Map and List operations, return types, and context helper functions."
---

# Quick reference

> For the complete documentation index see: [llms.txt](https://aerospike.com/docs/llms.txt)
> 
> All documentation pages available in markdown.

### Operation summary

#### Map operations

| Operation | Description | Use case |
| --- | --- | --- |
| `MapPutOp` | Put single key-value | Update one field |
| `MapPutItemsOp` | Put multiple key-values | Initialize or bulk update |
| `MapGetByKeyOp` | Get value by key | **Most common: retrieve value** |
| `MapGetByKeyListOp` | Get multiple values | Batch retrieval |
| `MapGetByKeyRangeOp` | Get by key range | Range queries |
| `MapIncrementOp` | Increment value | Counters, scores |
| `MapDecrementOp` | Decrement value | Inventory, counters |
| `MapRemoveByKeyOp` | Remove by key | Delete field |
| `MapSizeOp` | Get map size | Count items |

#### List operations

| Operation | Description | Use case |
| --- | --- | --- |
| `ListAppendOp` | Append items | Add to end |
| `ListInsertOp` | Insert at index | Add at position |
| `ListGetOp` | Get by index | Retrieve item |
| `ListGetRangeOp` | Get range | Get multiple items |
| `ListPopOp` | Pop item | Queue processing |
| `ListRemoveOp` | Remove by index | Delete item |
| `ListSizeOp` | Get list size | Count items |

### Return type quick reference

#### Map return types

-   `VALUE`: The actual value (most common)
-   `KEY`: The key itself
-   `KEY_VALUE`: Both key and value as MapPair
-   `INDEX`: Index position (ordered maps)
-   `RANK`: Rank by value
-   `COUNT`: Number of items (1 or 0)
-   `EXISTS`: Boolean existence check

#### List return types

-   `VALUE`: The actual value
-   `INDEX`: Index position(s)
-   `RANK`: Rank by value
-   `COUNT`: Number of items
-   `EXISTS`: Boolean existence check

### Context helper functions

The following are commonly used context helper functions for navigating nested CDT structures. There are additional helper functions available beyond these basic ones:

-   `CtxMapKey(key)`: Navigate to map by key
-   `CtxListIndex(index)`: Navigate to list by index
-   `CtxMapRank(rank)`: Navigate to map by rank
-   `CtxListRank(rank)`: Navigate to list by rank

For a complete list of all available context helper functions, refer to the [API documentation](https://pkg.go.dev/github.com/aerospike/aerospike-client-go/v8#CDTContext).