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

Синопсис

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