---
title: "update"
url: https://una-lang.org/en/docs/std/builtin/update/
release: v0.4.0
edition: "0.5 preview"
source: https://github.com/una-lang/una/blob/v0.4.0/docs/std/builtins.json
---

# update

A built-in method, resolved by the type of its receiver ([`spec/14 §2`](https://una-lang.org/en/docs/spec/14-standard-library/#s2)). Edition 0.5 preview.

```una
edit m.update(key: K, initial: V, change: fn(V) -> V) -> Unit
  where m: Map[K, V]
edit m.update(key: K, initial: V, change: fn(V) -> V) -> Unit
  where m: HashMap[K, V]
```

Updates `m` in place, written `edit m.update(...)`: sets `key` to `change(v)`, where `v` is its value, or `initial` when `m` has no `key`. `change` is called exactly once, and when it fails, `m` keeps its value from before the call (`spec/21 §2`). On a `HashMap`, the same in O(|k|) expected, amortized (`spec/28 §7`).

## Specification

- [`spec/21 §2`](https://una-lang.org/en/docs/spec/21-maps/#s2)
- `spec/28 §7`

Generated from una v0.4.0 ([`docs/std/builtins.json`](https://github.com/una-lang/una/blob/5fec93d88932b333feec25e589355a2cb34c37b5/docs/std/builtins.json), which is not part of the specification): built-in methods have no declaration, so una writes these signature lines and tests each against its checker. The specification governs: [`spec/14 §2`](https://una-lang.org/en/docs/spec/14-standard-library/#s2).
