path relative-to

Get a path as relative to another path.

Signature

> path relative-to (path) --columns

Parameters

  • path: Parent shared with the input path
  • --columns {table}: Optionally operate by column path

Notes

Can be used only when the input and the argument paths are either both
absolute or both relative. The argument path needs to be a parent of the input
path.

Examples

Find a relative path from two absolute paths

> '/home/viking' | path relative-to '/home'

Find a relative path from two absolute paths in a column

> ls ~ | path relative-to ~ -c [ name ]

Find a relative path from two relative paths

> 'eggs/bacon/sausage/spam' | path relative-to 'eggs/bacon/sausage'