Uuid

1 min read

Import: import system.uuid;

Read the usage guide for examples and common tasks. This reference lists the public declarations for this part of the library. See Reading API signatures for parameter and result notation.

Uuid

A 16-byte UUID value; assignment copies bits without allocation or reference counting.

public struct Uuid: Equatable<Uuid>, Comparable<Uuid>

v4

Generates a version-4 UUID from the secure random source, preserving entropy failures.

public static fun v4(): Result<Uuid, UuidError>

from_bytes

Copies exactly 16 bytes in network order into a UUID value.

public static fun from_bytes(bytes: byte[]): Result<Uuid, UuidError>

to_bytes

Returns an independent 16-byte array in network order.

public fun to_bytes(): byte[]

parse

Parses the canonical 36-character form, such as 123e4567-e89b-12d3-a456-426614174000. Hexadecimal digits may be upper- or lowercase. Fails with ParseError (code EPARSE) for any other length, separator, or digit.

public static fun parse(text: string): Result<Uuid, ParseError>

is_valid

Tests canonical UUID syntax without generating entropy.

public static fun is_valid(text: string): bool

equals

Compares all 128 bits, independent of storage identity.

public fun equals(borrow other: Uuid): bool

compare

Orders UUIDs lexicographically by their unsigned network-order bytes.

public fun compare(other: Uuid): int

hash_code

Folds all bits into a stable hash for maps and sets without formatting text.

public override fun hash_code(): int

to_string

Returns canonical lowercase text; formatting is the only string allocation.

public override fun to_string(): string