Skip to main content

paths

Laurence MorganAbout 1 minData-Type Reference

paths

Structured array for working with $PATH style data

Description

The path type Turns file and directory paths into structured objects.

The root directory (typically /) is counted as a directory. If a path is relative rather than absolute then / will be excluded from outputted string.

Examples

Creating a PATH

» %[/bin, /usr/bin, "$JAVA_HOME/bin"] -> format paths
/bin:/usr/bin:/opt/java/bin

Splitting a PATH

» $PATH -> :paths: format json
[
    "/bin",
    "/usr/bin",
    "/opt/java/bin"
]

Appending to $PATH

As a statement:

» $PATH -> append /sbin -> export PATH
» $PATH
/bin:/usr/bin:/opt/java/bin:/sbin

As an expression:

» $PATH <~ %[ "/sbin" ]
» $PATH
/bin:/usr/bin:/opt/java/bin:/sbin

Supported Hooks

  • Marshal() Supported
  • ReadArray() Each element is a directory branch. Root, /, is treated as it's own element
  • ReadArrayWithType() Same as ReadArray()
  • ReadIndex() Returns a directory branch or filename if last element is a file
  • ReadMap() Not currently supported
  • ReadNotIndex() Supported
  • Unmarshal() Supported
  • WriteArray() Each element is a directory branch

See Also

  • MUREX_EXE: Absolute path to running shell
  • PWD: Current working directory
  • PWDHIST: History of each change to the sessions working directory
  • %[] Array Builder: Quickly generate arrays
  • <~ Assign Or Merge: Merges the right hand value to a variable on the left hand side (expression)
  • path: Structured object for working with file and directory paths

Read more about type hooks


This document was generated from builtins/types/paths/paths_doc.yamlopen in new window.

Last update:
Contributors: Laurence Morgan