функции - функции печати или удаления

Синопсис

functions [-a | --all] [-n | --names]
functions [-D | --details] [-v] FUNCTION
functions -c OLDNAME NEWNAME
functions -d DESCRIPTION FUNCTION
functions [-e | -q] FUNCTION ...

Описание

functions печатает или удаляет функции.

Доступны следующие параметры:

-a или --all

Выводит список всех функций, даже тех, имена которых начинаются с нижнего подчеркивания.

-c или --copy OLDNAME NEWNAME

Создаёт новую функцию с именем NEWNAME, используя определение функции OLDNAME.

-d или --description DESCRIPTION

Изменяет описание этой функции.

-e или --erase

Приводит к удалению указанных функций. Это также означает, что функция не будет загружаться автоматически в текущем сеансе. Используйте funcsave для удаления сохранённой копии.

-D или --details

Сообщает имя файла, где указанная функция определена или может загружаться автоматически, stdin если функция была определена интерактивно или в командной строке или с помощью стандартного ввода, - если функция была создана с помощью source, и n/a если функция недоступна. (Функции, созданные с помощью alias, вернут -, потому что alias использует source внутри.) Если также задан параметр --verbose, то выводятся пять строк:

• путь к файлу, как уже описано,
• autoloaded, not-autoloaded или n/a,
• номер строки в файле или ноль, если не применимо,
• scope-shadowing если функция затеняет переменные в вызывающей функции (обычный случай, если она не была определена с помощью --no-scope-shadowing), иначе no-scope-shadowing, или n/a если функция не определена,
• описание функции с минимальными экранированиями, чтобы оно было в одной строке, или n/a если функция не определена или у неё нет описания.

Не следует предполагать, что будет выведено только пять строк, так как в будущем мы можем добавить дополнительную информацию в вывод.

--no-details

Отключает вывод пути к файлу функции, поэтому будет выведено только определение.

-n или --names

Выводит имена всех определённых функций.

-q или --query

Проверяет, существуют ли указанные функции.

-v или --verbose

Делает некоторые выводы более подробными.

-H или --handlers

Показывает все обработчики событий.

-t или --handlers-type TYPE

Показывает все обработчики событий, соответствующие заданному TYPE.

-h или --help

Отображает справку по использованию данной команды.

По умолчанию functions, при вызове без аргументов, печатает имена всех определённых функций. Если не указан параметр -a, функции, начинающиеся с нижнего подчеркивания, не включаются в вывод.

Если указаны любые параметры, не являющиеся параметрами командной строки, печатается определение указанных функций.

Копирование функции с помощью -c копирует только тело функции и не прикрепляет уведомления об событиях от исходной функции.

Описание только одной функции может быть изменено в одном вызове functions -d.

Код возврата functions — количество функций, указанных в списке аргументов, которые не существуют, что может использоваться совместно с параметром -q.

Примеры

functions -n
# Displays a list of currently-defined functions

functions -c foo bar
# Copies the 'foo' function to a new function called 'bar'

functions -e bar
# Erases the function ``bar``

См. также

Для более подробного объяснения того, как функции работают в fish, см. Функции.