std.path

pure path string ops; reads / and , writes SEP; builders take an *Arena

SEP

pub SEP :: 92u8

separator written by join and normalize

is_sep

pub is_sep :: fn(c: u8) -> bool

either separator

basename

pub basename :: fn(p: []const u8) -> []const u8

after the last separator; p if none, “” on a trailing separator

dirname

pub dirname :: fn(p: []const u8) -> []const u8

up to the last separator, trailing ones trimmed; “.” if none; a lone root stays

parent

pub parent :: fn(p: []const u8) -> []const u8

alias of dirname

extension

pub extension :: fn(p: []const u8) -> []const u8

includes the dot (“.txt”); “” if none; “.gitignore” has none

stem

pub stem :: fn(p: []const u8) -> []const u8

basename minus extension

is_absolute

pub is_absolute :: fn(p: []const u8) -> bool

leading separator, \ UNC prefix, or X: drive

is_relative

pub is_relative :: fn(p: []const u8) -> bool

has_extension

pub has_extension :: fn(p: []const u8, want: []const u8) -> bool

leading dot in want optional

join

pub join :: fn(a: *Arena, x: []const u8, y: []const u8) -> []const u8

one SEP between; extra separators collapsed; an absolute y wins

join3

pub join3 :: fn(a: *Arena, x: []const u8, y: []const u8, z: []const u8) -> []const u8

with_extension

pub with_extension :: fn(a: *Arena, p: []const u8, new_ext: []const u8) -> []const u8

leading dot optional; “” removes the extension

normalize

pub normalize :: fn(a: *Arena, p: []const u8) -> []const u8

lexical clean-up: drops ., doubled seps and x/..; writes SEP; empty -> “.” no disk access, so .. past a symlink is lexical; leading .. kept, root .. dropped