Home / Docs / Standard library / Built-in methods

keys

Release v0.4.0Edition 0.2 and later

A built-in method, resolved by the type of its receiver (spec/14 §2). Edition 0.2 and later.

Edition 0.2 and later

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

The keys of m, in key order, 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.keys() -> List[K]
  where m: Map[K, V]
m.keys() -> List[K]
  where m: HashMap[K, V]

The keys of m, in key order, 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

Returns

List[K]: the keys of m, in ascending key order on a Map and in the order they were first added on a HashMap; as many as m.len.

See also

values, entries

Example

src/shop.unauna
module shop

--- A stock report, from the map's keys.
pub main() -> Unit
  uses @console: Console[print]
=
  let stock = empty_map().with(key: "lamp", value: 3).with(key: "desk", value: 1)
  @console.print(join(stock.keys(), separator: ", "))

una run . prints:

Output
desk, lamp

Specification

Generated from una v0.4.0 (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.