find
for filters
Searches terms in the input.
Signature
> find ...rest --regex --ignore-case --multiline --dotall --invert
Parameters
...rest
: terms to search--regex {string}
: regex to match with--ignore-case
(-i)
: case-insensitive regex mode; equivalent to (?i)--multiline
(-m)
: multi-line regex mode: ^ and $ match begin/end of line; equivalent to (?m)--dotall
(-s)
: dotall regex mode: allow a dot . to match newlines \n; equivalent to (?s)--invert
(-v)
: invert the match
Examples
Search for multiple terms in a command output
> ls | find toml md sh
Search for a term in a string
> 'Cargo.toml' | find toml
Cargo.toml
Search a number or a file size in a list of numbers
> [1 5 3kb 4 3Mb] | find 5 3kb
╭───┬─────────╮
│ 0 │ 5 │
│ 1 │ 2.9 KiB │
╰───┴─────────╯
Search a char in a list of string
> [moe larry curly] | find l
╭───┬───────╮
│ 0 │ larry │
│ 1 │ curly │
╰───┴───────╯
Find using regex
> [abc bde arc abf] | find --regex "ab"
╭───┬─────╮
│ 0 │ abc │
│ 1 │ abf │
╰───┴─────╯
Find using regex case insensitive
> [aBc bde Arc abf] | find --regex "ab" -i
╭───┬─────╮
│ 0 │ aBc │
│ 1 │ abf │
╰───┴─────╯
Find value in records
> [[version name]; [0.1.0 nushell] [0.1.1 fish] [0.2.0 zsh]] | find -r "nu"
╭───┬─────────┬─────────╮
│ # │ version │ name │
├───┼─────────┼─────────┤
│ 0 │ 0.1.0 │ nushell │
╰───┴─────────┴─────────╯