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 Wed Jul 2 22:12:32 UTC 2025 against commit bb72b6fbb72b6fdd502f835172d7d06207ba4ec2c70886c.

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