---
title: "values"
url: https://una-lang.org/en/docs/std/builtin/values/
release: v0.4.0
edition: "0.2 and later"
source: https://github.com/una-lang/una/blob/v0.4.0/docs/std/builtins.json
---

# values

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.2 and later.

## Edition 0.2 and later

```una
m.values() -> List[V]
  where m: Map[K, V]
```

The values of `m`, in the order of their keys, as many as `m.len` (`spec/21 §2`). On a `HashMap`, in the order the keys were first added, in O(n) (`spec/28 §7`).

## Edition 0.5 preview

```una
m.values() -> List[V]
  where m: Map[K, V]
m.values() -> List[V]
  where m: HashMap[K, V]
```

The values of `m`, in the order of their keys, as many as `m.len` (`spec/21 §2`). On a `HashMap`, in the order the keys were first added, in O(n) (`spec/28 §7`).

In editions 0.5. In edition 0.2, 0.3, 0.4: no `HashMap[K, V]` receiver\, since `std.collections` begins in edition 0\.5\: it has no `where m: HashMap[K, V]`.

## Receiver

- `Map[K, V]`: the map `m`
- `HashMap[K, V]`: the hash map `m`

## Returns

`List[V]`: the values of `m`\, in the order of their keys on a `Map` and in the order the keys were first added on a `HashMap`\; as many as `m.len`.

## See also

[`keys`](https://una-lang.org/en/docs/std/builtin/keys/), [`entries`](https://una-lang.org/en/docs/std/builtin/entries/)

## Example

`src/shop.una`

```una
module shop

--- A stock report, from the map's values.
pub main() -> Unit
  uses @console: Console[print]
=
  let stock = empty_map().with(key: "lamp", value: 3).with(key: "desk", value: 1)
  let total = stock.values().sum()
  @console.print("{total} units")
```

`una run .` prints:

```text
4 units
```

## 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).
