Home / Docs / Standard library / Prelude

chars

Release v0.4.0Edition 0.2 and later

A function of the prelude, in scope in every module. Edition 0.2 and later.

una
pub chars(t: Text) -> List[Text]
  ensures result.len == t.len

One text of length 1 per scalar value of t, in order (spec/22 §2).

Parameters

Returns

List[Text]: one text of length 1 per scalar value of t, in order; as many as t.len.

See also

bytes, slice

Cost

Time O(b) (ADR 0070), where:

Example

src/shop.unauna
module shop

--- The characters of a product name, one by one: `é` is one scalar value.
pub main() -> Unit
  uses @console: Console[print]
=
  let letters = "Café".chars()
  @console.print(join(letters, separator: "|"))
  @console.print("{letters.len} characters")

una run . prints:

Output
C|a|f|é
4 characters

Specification

Generated from the standard modules of una v0.4.0 (docs/std/listing.json, which is not part of the specification). The specification governs: spec/14 §1.