path.md

Standard Library: Path (std/path.zc)

Path provides cross-platform file path manipulation utilities. It wraps a String and handles separators (slash vs backslash) intelligently, though currently biased towards Unix defaults pending full Windows support integration.

Usage

import "std/path.zc"

fn main() {
    let p = Path::new("/home/user");
    let full_path = p.join("docs/file.txt");
    
    println "Full path: {full_path.c_str()}";
    
    if (full_path.extension().is_some()) {
        println "Extension: {full_path.extension().unwrap()}";
    }
}

Structure

struct Path {
    str: String;
}

Methods

Construction

Method	Signature	Description
new	Path::new(s: char*) -> Path	Creates a new Path from a C string.
from_string	Path::from_string(s: String) -> Path	Creates a Path taking ownership of a String.

Manipulation

Method	Signature	Description
join	join(self, other: char*) -> Path	Joins the current path with other using the correct separator. Returns a new Path.
clone	clone(self) -> Path	Creates a deep copy of the Path.

Parsing

Method	Signature	Description
extension	extension(self) -> Option<String>	Returns the file extension (without the dot), or None if no extension.
file_name	file_name(self) -> Option<String>	Returns the last component of the path.
parent	parent(self) -> Option<Path>	Returns the path without its final component.

Access

Method	Signature	Description
c_str	c_str(self) -> char*	Returns a pointer to the underlying C string.