List Filesystem Objects (f)

Lists or filters file system objects (eg files)

Description

f lists or filters lists of file system objects, such as files, directories, etc. f provides a quick way to output file system items that confirm to specific criteria.

You define this criteria by using +flags (eg +s for all symlinks) and optionally then restricting that criteria with -flags (eg -x to remove all executable items). All flags supported as + are also supported as a -.

By default f will return no results. You need to include +flags.

Output is a JSON array as this format preserves whitespace in file names.

Usage

f options -> <stdout>

<stdin> -> f options -> <stdout>

Examples

Return only directories

f +d

Mixing inclusion and exclusions

Return file and directories but exclude symlinks:

f +fd -s

As a method

Filter out files in a list (eg created by g) using conditions set by f:

g '*.go' -> f +f

rx '\.(txt|md)' -> f +fw

Flags

Detail

+ flags are always matched first. Then the - flags are used to filter out any matches from the + flags.

Synonyms

See Also


This document was generated from builtins/core/io/f_doc.yaml.

This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.

Last built on Tue Dec 10 22:56:57 UTC 2024 against commit 60f05a260f05a227caf73dd5b3478e3cb3f4bb24e46745b.

Current version is 6.4.1005 (develop) which has been verified against tests cases.