File system path abstractions for ZZ

Add this to your zz.toml file:

[dependencies]
path = "*"

[repos]
path = "git+ssh://[email protected]/zzmodules/path.git"

using path

An immutable structure that wraps a char * that is treated as a file path.

Path struct constructor from a given char * pathspec.

using path

new p = path::from(".");

ParentPath (Path) struct constructor from a given child Path pointer.

using path

new p = path::from("/home/user");
new parent = path::parent(&p);

Returns the length in bytes for the Path string.

using log
using path

new p = path::from(".");
log::info("%lu", p.length()); // 1

Returns a char * string of this Path.

using log
using path

new p = path::from("./zz.toml");
log::info("%s", p.cstr()); // "./zz.toml"

Returns an Ancestors struct that implements an iterator interface that will traverse all ancestors in this Path, including itself.

using log
using path

new p = path::from("/home/user/projects/project/zz.toml");
let mut ancestors = p.ancestors();

while !ancestors.ended {
  let ancestor = ancestors.next();
  log::info("%s", ancestor.cstr());
}

Returns a char * that represents the "extension" part of a Path string. This function will return an empty string if an extension cannot be found.

using log
using path

new p = path::from("zz.toml");
log::info("%s", p.extension()); // ".toml"

Returns true if the Path is an absolute path, otherwise false.

using log
using path

new p = path::from("/files/zz.toml");
if p.is_absolute() {
  log::info("%s is an absolute path", p.cstr());
}

Returns true if the Path is a relative path, the opposite of an absolute path, otherwise false.

using log
using path

new p = path::from("./zz.toml");
if p.is_relative() {
  log::info("%s is a relative path", p.cstr());
}

Returns true if the path is the root path.

using log
using path

new p = path::from("/"); // or "c:\\"
if p.is_root() {
  log::info("%s is the root path", p.cstr());
}

Returns true if the path contains the root path in it.

using log
using path

new p = path::from("/users"); // or "c:\\Users"
if p.has_root() {
  log::info("%s has the root path", p.cstr());
}

Converts this Path to a PathBufferBox , a container for a PathBuffer+ with a fixed size of path::MAX_PATH_BUFFER_BYTES.

using log
using path

new p = path::from("/home");
let buffer = p.to_path_buffer();
buffer.push("users");
log::info("%s", buffer.cstr()); // "/home/users"

Implements display() to return a safe, nullterm char *.

using log
using path

new p = path::from("./zz.toml");
log::info("%s", p.display()); // "./zz.toml"

A mutable tail sized structure for path building. The maximum tail size of this struct can ba path::MAX_PATH_BUFFER_BYTES.

PathBuffer+ constructor from an initial char * pathspec.

using path

new+1024 b = path::buffer(".");

PathBufferBox (PathBuffer+) constructor from an initial char * pathspec that is * canonicalized. An err::Err+ mut error must be given to catch system errors that may occur during normalization (getcwd(), realpath()) or canonicalization (realpath()).

using err
using path

new+1024 mut error = err::make();
new b = path::canonicalize("../path/to/resolve", &error);

if error.check() {
  // canonicalization failed, check error trace
}

A tail sized String+ container for building the underlying path string.

A Path with a pointer to the underlying memory in the PathBuffer+ string container.

Normalizes the current pathspec for a PathBuffer+. An err::Err+ mut error must be given to catch system * errors that may occur during normalization (getcwd(), realpath()).

using err
using path

new+1024 mut error = err::make();
new+1024 b = path::buffer("/home/../path/dir");

b.normalize(&error);

if error.check() {
  // normalization failed, check error trace
}

Returns the length in bytes for the PathBuffer+ string.

Returns a char * string of this PathBuffer+.

Returns an immutable Path that represents this PathBuffer+

using path


new+1024 b = path::buffer(".");
let p = b.as_path();

Returns a immutable Path * that represents a pointer to this PathBuffer+ as a Path type.

using path

new+1024 b = path::buffer(".");
let p = b.as_path_ptr();

Push a char * pathspec component to the buffer returning true upon success, otherwise false.

using log
using path

new+1024 b = path::path_buffer();
b.push("path");
b.push("to");
b.push("file");
log::info("%s", b.display()); // "/path/to/file"

Pops a pathspec component from the buffer returning true upon success, otherwise false.

using log
using path

new+1024 b = path::path_buffer();
b.push("path");
b.push("to");
b.push("file");
b.pop();
log::info("%s", b.display()); // "/path/to"

Appends a PathBuffer+ components to this PathBuffer+ returning true upon success, otherwise false.

using log
using path

new+1024 b = path::path_buffer();
new+1024 joined = path::buffer("/home");
b.push("path");
b.push("to");
b.push("file");

log::info("%s", b.display()); // "/path/to/file"
joined.append(&b);

log::info("%s", joined.display()); // "/home/path/to/file"

Clears the buffer.

using log
using path

new+1024 b = path::path_buffer();
b.push("path");
b.push("to");
b.push("file");
b.clear();
log::info("%s", b.display()); // ""

Returns an Ancestors struct that implements an iterator interface that will traverse all ancestors in this PathBuffer+, at this moment in time, including itself.

Returns a char * that represents the "extension" part of the PathBuffer+ string. This function will return an empty string if an extension cannot be found.

Returns true if the PathBuffer+ is an absolute path, otherwise false.

Returns true if the PathBuffer+ is a relative path, the opposite of an absolute path, otherwise false.

Returns true if the PathBuffer+ is the root path.

Returns true if the PathBuffer+ contains the root path in it.

Implements display() to return a safe, nullterm char *.

A structure that implements an iterator interface to represent the eventual ancestors of a path.

let mut ancestors = p.ancestors();

while !ancestors.ended {
  let ancestor = ancestors.next();
  // `ancestor` is a `Path` type
}

A boolean to indicate if the Ancestors iterator has reached the end of the path tree.

Return a Path struct with a pointer to the next ancestors path.

Implements display() to return a safe, nullterm char *.

Get the operating system specific path separator as a char *. On Windows, this will be "\\", otherwise "/".

Get the operating system specific path separator character., On Windows, this will be '\\', otherwise '/'.

Get the operating system specific PATH delimiter as a char *. On Windows, this will be ";", otherwise ":".

Get the operating system specific PATH delimiter character. On Windows, this will be ';', otherwise ':'.

MIT