Map get
Description
Pure function returning the value stored under a key, or null when the key is absent. The value pin follows the map's value shape, so reading a map of arrays yields an array. Pair with Is null? or Default if null to handle a missing key.
When to use
Use Map get to read a value out of a map by key — for example, looking up a cached record or a config value that was collected earlier with Map put. Because it is a pure generic node, its value pin adapts to the map’s value shape: reading a map of scalars yields a scalar, and reading a map of arrays yields an array. If the key might be absent, pair Map get with Is null? to branch, or with Default if null to substitute a fallback value — a null map itself reads as empty, so a lookup against it returns null just like a missing key.
Pins
Input pins
| Pin | Type | Default | Notes |
|---|---|---|---|
| Map | generic{generic} | — | The map to read from. Key and value types resolve at design-time from the connected source; the value shape adapts, so this pin accepts a map of scalars or a map of arrays. A null map reads as empty, so any lookup against it returns null. |
| Key | generic | — | The key to look up. Must match the map's key type. |
Output pins
| Pin | Type | Notes |
|---|---|---|
| Value | generic | The value stored under the key, or null when the key is absent. The pin's shape follows the map's value shape, so it is an array when the map's values are arrays. |
Example
Inside a pipeline that built a map of user records with Map put, look up a specific user by ID. Wire the map local variable into the Map input and the incoming ID into the Key input. Wire the Value output into Default if null with a fallback value so a downstream Log message never receives null when the ID was not found.