use path

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

Constants

Name Value Description
Sep "/" Path separator constant.

Functions

fn basename

Get the filename part of a path.

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

Parameter Type Description
path str File path
Output Type Description
name str Filename component

Example:

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

fn dirname

Get the directory part of a path.

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

Parameter Type Description
path str File path
Output Type Description
dir str Directory component

Example:

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

fn ext

Get the file extension (including dot).

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

Parameter Type Description
path str File path
Output Type Description
ext str Extension including dot, empty if none

Example:

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

fn has_ext

Check if path has any file extension.

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

Parameter Type Description
path str File path
Output Type Description
result i64 1 if path has an extension, 0 otherwise

Example:

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

fn has_extension

Check if path has a specific extension.

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

Parameter Type Description
path str File path
extension str Extension to check (with or without dot)
Output Type Description
result i64 1 if extension matches, 0 otherwise

Example:

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

fn is_absolute

Check if path is absolute.

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

Parameter Type Description
path str File path
Output Type Description
result i64 1 if absolute, 0 otherwise

Example:

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

fn join

Join two path components.

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

Parameter Type Description
p1 str First path
p2 str Second path
Output Type Description
joined str Joined path

Example:

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

fn normalize

Normalize a path (remove redundant separators).

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

Parameter Type Description
path str File path
Output Type Description
norm str Normalized path

Example:

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

fn parent

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

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

Parameter Type Description
path str File path
Output Type Description
parent str Parent directory

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)

Parameter Type Description
path str File path
Output Type Description
stem str Filename without extension

Example:

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

fn with_ext

Replace or add file extension.

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

Parameter Type Description
path str File path
newext str New extension (with or without dot)
Output Type Description
result str Path with new extension

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"

fn is_relative

Check if path is relative (not absolute).

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

Parameter Type Description
path str File path
Output Type Description
result i64 1 if relative, 0 otherwise

Example:

"home/user" path::is_relative print  // 1
"/home/user" path::is_relative print  // 0

fn depth

Get the depth of a path (number of components).

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

Parameter Type Description
path str File path
Output Type Description
depth i64 Number of path components

Example:

"/home/user/file.txt" path::depth print  // 3

fn starts_with

Check if path starts with a given prefix path.

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

Parameter Type Description
path str File path to check
prefix str Prefix path
Output Type Description
result i64 1 if starts with prefix, 0 otherwise

Example:

"/home/user/file.txt" "/home" path::starts_with print  // 1

fn strip_prefix

Remove a prefix from a path if it exists.

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

Parameter Type Description
path str File path
prefix str Prefix to remove
Output Type Description
result str Path without prefix

Example:

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