Home / Docs / Standard library / Prelude

slice

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 slice(t: Text, start: Int, end: Int) -> Text
  requires 0 <= start and start <= end and end <= t.len
  ensures result.len == end - start

The scalar values of t from position start up to, not including, end (spec/22 §2).

Parameters

Returns

Text: the scalar values of t from start up to, not including, end; its length is end - start.

Requires

Each condition under requires is an obligation at every call, which una check proves (spec/12 §3): it reports U5001 when the condition is refuted and U5002 when it is unknown (spec/12 §6), and una run, una test and una build refuse a package with an obligation that is not proved (spec/22 §2).

See also

find, chars

Cost

Time O(result), after the index is built once (ADR 0070), where:

Example

src/shop.unauna
module shop

--- The range of an SKU, the part before its dash. `find` gives a position that `slice` is
--- proved to accept.
range_of(sku: Text) -> Text
=
  when sku.find(text: "-")
    is Some(at) -> sku.slice(start: 0, end: at)
    is None -> sku

pub main() -> Unit
  uses @console: Console[print]
=
  @console.print(range_of("LAMP-01"))
  @console.print(range_of("CAFÉ-01"))
  @console.print(range_of("GIFTCARD"))

una run . prints:

Output
LAMP
CAFÉ
GIFTCARD

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.