index :: path

path.search

file search

available since version: 0.9.4

---

information

Searches file by name in user specified or PureData system paths. Outputs first found file. Search order: 1. user defined paths (@path property), 2. current patch directory, 3. PureData system path, 4. home directory. Absolute paths processed before relative. Home directory can be specified with '~' symbol. Note: by default search request is performed asynchronously, so a delay will occured between input and output.

arguments:

• PATHS list of paths, can be quoted to handle whitespace.
  type: list
  

methods:

• cancel cancel search process
  

properties:

• @async Get/set perform async search in separate thread
  type: bool
  default: 1
  

• @sync Get/set alias to @async 0
  type: alias
  

• @depth Get/set search recursion depth (-1: infinite)
  type: int
  min value: -1
  default: 0
  

• @paths Get/set user defined search paths
  type: list
  

• @home Get/set search in home directory
  type: bool
  default: 1
  

• @std Get/set search in PureData standard directory
  type: bool
  default: 1
  

• @nohome Get/set alias to @home 0, do not search in home directory
  type: alias
  

• @nostd Get/set alias to @std 0, do not search in standard dirs
  type: alias
  

inlets:

• filename
  type: control

outlets:

• symbol: full filename
  type: control
• bang: if not found
  type: control

keywords:

path environment

See also: [file.size]

Authors: Serge Poltavsky

License: GPL3 or later