commandline - установка или получение текущего буфера командной строки

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

commandline [OPTIONS] [CMD]

Описание

commandline может использоваться для установки или получения текущего содержимого буфера командной строки.

Без параметров, commandline возвращает текущее значение командной строки.

При указании CMD, буфер командной строки очищается и заменяется содержимым CMD.

Доступны следующие опции:

-C или --cursor

Установить или получить текущую позицию курсора, а не содержимое буфера. Если аргумент не задан, выводится текущая позиция курсора, в противном случае аргумент интерпретируется как новая позиция курсора. Если одна из опций -j, -p или -t задана, позиция относительна соответствующей подстроки, а не всего буфера командной строки.

-B или --selection-start

Получить текущую позицию начала выделения в буфере.

-E или --selection-end

Получить текущую позицию конца выделения в буфере.

-f или --function

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

-h или --help

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

Следующие опции изменяют способ, которым commandline обновляет буфер командной строки:

-a или --append

Не удалять текущую командную строку, добавить указанную строку в конец.

-i или --insert

Не удалять текущую командную строку, вставить указанную строку в текущую позицию курсора.

-r или --replace

Удалить текущую командную строку и заменить ее указанной строкой (по умолчанию).

Следующие опции изменяют ту часть командной строки, которая выводится или обновляется:

-b или --current-buffer

Выбрать всю командную строку, не включая отображаемую автозамену (по умолчанию).

-j или --current-job

Выбрать текущую задачу — здесь задача — это одна конвейная линия. Останавливается на логических операторах или терминаторах (;, & и новые строки).

-p или --current-process

Выбрать текущий процесс — здесь процесс — это одна команда. Останавливается на логических операторах, терминаторах и конвейерных символах.

-s или --current-selection

Выбрать текущее выделение.

-t или --current-token

Выбрать текущий токен.

Следующие опции изменяют способ, которым commandline отображает текущий буфер командной строки:

-c или --cut-at-cursor

Выводить только выделение до текущей позиции курсора.

-o или --tokenize

Разбивать выделение на токены и отображать один токен типа строка в строке.

Если commandline вызывается во время вызова для завершения заданной строки с помощью complete -C STRING, commandline будет рассматривать указанную строку как текущее содержимое командной строки.

Следующие опции выводят метаданные о состоянии командной строки:

-L или --line

Вывести строку, на которой находится курсор, при этом самая верхняя строка начинается с 1.

-S или --search-mode

Принимает значение true, если командная строка выполняет поиск по истории.

-P или --paging-mode

Принимает значение true, если командная строка отображает содержимое пейджера, например, завершения по вводу.

--paging-full-mode

Принимает значение true, если командная строка отображает содержимое пейджера, например, завершения по вводу и все строки отображаются (сообщение «<n> еще строк» не отображается).

--is-valid

Возвращает true, когда командная строка синтаксически верна и полна. В этом случае она будет выполнена при вызове функции привязки execute. Если командная строка неполна, возвращает 2, если ошибочна, возвращает 1.

Пример

commandline -j $history[3] заменяет задачу под курсором третьим элементом из истории командной строки.

Если командная строка содержит

>_ echo $flounder >&2 | less; and echo $catfish

(с курсором на «o» в «flounder»)

echo $flounder >& — первый процесс, less — второй и and echo $catfish — третий.

echo $flounder >&2 | less — первая задача, and echo $catfish — вторая.

$flounder — текущий токен.

Дополнительные примеры:

>_ commandline -t
$flounder
>_ commandline -ct
$fl
>_ commandline -b # or just commandline
echo $flounder >&2 | less; and echo $catfish
>_ commandline -p
echo $flounder >&2
>_ commandline -j
echo $flounder >&2 | less