index :: path

path.search

file search

доступно с версии: 0.9.4

---

информация

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.

аргументы:

• PATHS list of paths, can be quoted to handle whitespace.
  тип: list
  

методы:

• cancel cancel search process
  

свойства:

• @async Запросить/установить perform async search in separate thread
  тип: bool
  по умолчанию: 1
  

• @sync Запросить/установить alias to @async 0
  тип: alias
  

• @depth Запросить/установить search recursion depth (-1: infinite)
  тип: int
  минимальное значение: -1
  по умолчанию: 0
  

• @paths Запросить/установить user defined search paths
  тип: list
  

• @home Запросить/установить search in home directory
  тип: bool
  по умолчанию: 1
  

• @std Запросить/установить search in PureData standard directory
  тип: bool
  по умолчанию: 1
  

• @nohome Запросить/установить alias to @home 0, do not search in home directory
  тип: alias
  

• @nostd Запросить/установить alias to @std 0, do not search in standard dirs
  тип: alias
  

входы:

• filename
  тип: control

выходы:

• symbol: full filename
  тип: control
• bang: if not found
  тип: control

ключевые слова:

path environment

Смотрите также: [file.size]

Авторы: Serge Poltavsky

Лицензия: GPL3 or later