Home / Docs / Standard library / Prelude

split

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 split(t: Text, on: Text) -> List[Text]
  requires on.len > 0
  ensures result.len >= 1

The parts of t between the non-overlapping occurrences of on, left to right (spec/22 §2).

Parameters

Returns

List[Text]: the parts of t between the non-overlapping occurrences of on, left to right, empty parts included; at least one part.

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

join, find

Cost

Time O(b + m), two-way search (ADR 0070), where:

Example

src/shop.unauna
module shop

--- The fields of an order line: SKU, quantity, price in cents.
pub main() -> Unit
  uses @console: Console[print]
=
  for field in "CAFÉ-01,2,1999".split(on: ",")
    @console.print(field)

una run . prints:

Output
CAFÉ-01
2
1999

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.