method

Uuid.parse

Uuid.parse(s) -> string

Normalises an untrusted string: if s is a well-formed UUID it returns the same value in canonical lowercase form; if it is not, it returns the nil UUID. This never faults on garbage, so it is safe to call on data that arrived from a file, a network peer, or a mod. When you need to *reject* bad input rather than fold it to nil, gate on Uuid.is_valid first.

Parsing accepts either case and yields the lowercase canonical form, which is what the rest of the library produces — so a parsed ID compares equal (with ==) to a freshly generated one of the same value.

Parameters

sthe string to validate and normalise

Example

program Parse {
  entry {
    let id = Uuid.parse("550E8400-E29B-41D4-A716-446655440000")
    print(id[0..8])                          # 550e8400 — lowercased
    if Uuid.parse("nope") == Uuid.nil() { print(1) }
  }
}

← All symbols