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

Краткое описание

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, смотрите Функции.