# fs/glob
Find files whose basename matches a glob pattern (`*` and `?`).
## Syntax
[fs/glob $path $pattern ?$options]
## Parameters
- `$path` — root directory to search
- `$pattern` — glob pattern (`*` matches any run of chars, `?` matches one) matched against each filename
- `$options` — optional `%{ :recurse bool }` map (default `false`); also accepts the `--recurse` flag
## Examples
[fs/glob "src" "*.zig"] [fs/glob "." "*.md" %{ :recurse true }] [fs/glob "." "*.zig" --recurse]
## Returns
`%Ok` wrapping a vector of `%{ :path dir :file name }` maps; `%Err` on failure.
## See Also
`fs/list`, `fs/readdir`, `fs/walk`