use path

File path manipulation functions. POSIX-style paths with forward slash separator.

Constants

Functions

fn basename

Get the filename part of a path.

Signature: (path:str -- name:str)

Example:

"/home/user/file.txt" path::basename  // "file.txt"

fn dirname

Get the directory part of a path.

Signature: (path:str -- dir:str)

Example:

"/home/user/file.txt" path::dirname  // "/home/user"

fn ext

Get the file extension (including dot).

Signature: (path:str -- ext:str)

Example:

"file.txt" path::ext  // ".txt"

fn has_ext

Check if path has a specific extension.

Signature: (path:str ext:str -- result:i64)

Example:

"file.txt" ".txt" path::has_ext print  // 1
"file.txt" "txt" path::has_ext print   // 1
"file.qd" ".txt" path::has_ext print   // 0

fn is_absolute

Check if path is absolute.

Signature: (path:str -- result:i64)

Example:

"/home/user" path::is_absolute  // 1

fn join

Join two path components.

Signature: (p1:str p2:str -- joined:str)

Example:

"/home" "user" path::join  // "/home/user"

fn normalize

Normalize a path (remove redundant separators).

Signature: (path:str -- norm:str)

Example:

"/home//user/" path::normalize  // "/home/user"

fn parent

Get the parent directory of a path (alias for dirname).

Signature: (path:str -- parent:str)

Example:

"/home/user/file.txt" path::parent print  // "/home/user"
"/home/user" path::parent print           // "/home"

fn stem

Get filename without extension.

Signature: (path:str -- stem:str)

Example:

"file.txt" path::stem  // "file"

fn with_ext

Replace or add file extension.

Signature: (path:str newext:str -- result:str)

Example:

"file.txt" ".qd" path::with_ext print   // "file.qd"
"file.txt" "md" path::with_ext print    // "file.md"
"/home/user/test.c" ".h" path::with_ext print  // "/home/user/test.h"