Home / Docs / Standard library / Prelude
slice
A function of the prelude, in scope in every module. Edition 0.2 and later.
pub slice(t: Text, start: Int, end: Int) -> Text
requires 0 <= start and start <= end and end <= t.len
ensures result.len == end - startThe scalar values of t from position start up to, not including, end (spec/22 §2).
Parameters
t: the textstart: the scalar position, from 0, of the first scalar value to takeend: the scalar position after the last scalar value to take
Returns
Text: the scalar values of t from start up to, not including, end; its length is end - start.
Requires
0 <= start and start <= end and end <= t.len: the positions are in order and insidet
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
Cost
Time O(result), after the index is built once (ADR 0070), where:
result: the length of the result in UTF-8 bytes- index: on a text that is not all ASCII, the byte offset of every 64th scalar value, its checkpoints: built in O(b) by the first call that needs a position and kept with the value, so at most once per value; an ASCII text needs none (spec/22 §6)
Example
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:
LAMP
CAFÉ
GIFTCARDSpecification
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.