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

Синопсис

commandline [OPTIONS] [CMD]

Описание

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

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

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

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

• -C или --cursor устанавливают или получают текущую позицию курсора, а не содержимое буфера. Если аргумент не указан, выводится текущая позиция курсора, в противном случае аргумент интерпретируется как новая позиция курсора. Если одна из опций -j, -p или -t указана, позиция относительна соответствующей подстроке, а не всего буфера командной строки.
• -f или --function заставляет все дополнительные аргументы интерпретироваться как функции ввода и помещает их в очередь, так что они будут прочитаны до любых дополнительных фактических нажатий клавиш. Эта опция не может быть объединена ни с какой другой опцией. Смотрите bind для списка функций ввода.

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

• -a или --append не удаляют текущую командную строку, добавляют указанную строку в конец
• -i или --insert не удаляют текущую командную строку, вставляют указанную строку в текущую позицию курсора
• -r или --replace удаляют текущую командную строку и заменяют ее указанной строкой (по умолчанию)

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

• -b или --current-buffer выбирает всю командную строку, не включая любые отображаемые автопредложения (по умолчанию)
• -j или --current-job выбирает текущую задачу — job здесь представляет собой одну конвейную команду. Она останавливается на логических операторах или терминаторах (;, & или новых строках).
• -p или --current-process выбирает текущий процесс — 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, если командная строка отображает содержимое страничного вывода, например, автодополнение

Пример

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