Язык fish

Определение псевдонимов

Одно из наиболее распространенных применений функций — небольшое изменение поведения уже существующей команды. Например, можно переопределить команду ls для отображения цветов. Переключатель для включения цвета в системах GNU — --color=auto. Псевдоним для ls может выглядеть так:

function ls
    command ls --color=auto $argv
end

Некоторые важные моменты, которые следует учесть при работе с псевдонимами:

• Всегда добавляйте переменную $argv в список параметров обернутой команды. Это гарантирует, что, если пользователь указывает дополнительные параметры функции, они передаются в исходную команду.
• Если у псевдонима то же имя, что и у алиасируемой команды, необходимо добавить префикс command к вызову программы, чтобы указать fish, что функция не должна вызывать саму себя, а команду с тем же именем. Если вы забудете это сделать, функция будет вызывать сама себя до бесконечности. Обычно fish достаточно умён, чтобы разобраться с этим (что, надеемся, в ваших интересах).

Для удобного создания таких функций можно использовать команду alias. В отличие от других оболочек, это просто создаёт функции — fish не имеет отдельной концепции «псевдонима», мы просто используем это слово для простой функции оборачивания, как это. Команда alias сразу же создает функцию. Рассмотрите возможность использования alias --save или funcsave для сохранения созданной функции в файл автоматической загрузки вместо повторного создания псевдонима каждый раз.

В качестве альтернативы попробуйте сокращения. Это слова, которые расширяются при наборе, а не фактические функции внутри оболочки.

Автоматическая загрузка функций

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

• Автоматически загружаемая функция становится доступной для всех запущенных оболочек.
• Если определение функции изменено, все запущенные оболочки автоматически перезагрузят изменённую версию через некоторое время.
• Улучшается время запуска и использование памяти и т. д.

Когда fish нужно загрузить функцию, он ищет файлы с именем, состоящим из имени функции плюс суффикс .fish, в каталогах, указанных в переменной списка $fish_function_path и загружает первый найденный.

Например, если вы попытаетесь выполнить что-то с именем banana, fish пройдёт по всем каталогам в $fish_function_path, ища файл с именем banana.fish и загрузит первый найденный.

По умолчанию $fish_function_path содержит следующее:

• Каталог для хранения пользовательских функций, обычно ~/.config/fish/functions (управляется переменной среды XDG_CONFIG_HOME)
• Каталог для функций всех пользователей в системе, обычно /etc/fish/functions (на самом деле $__fish_sysconfdir/functions)
• Каталоги, куда другое программное обеспечение может помещать свои собственные функции. Они находятся в каталогах под $__fish_user_data_dir (обычно ~/.local/share/fish, контролируемая переменной среды XDG_DATA_HOME) и в переменной среды XDG_DATA_DIRS, в подкаталоге, названном fish/vendor_functions.d. Значение по умолчанию для XDG_DATA_DIRS обычно /usr/share/fish/vendor_functions.d и /usr/local/share/fish/vendor_functions.d.
• Функции, поставляемые с fish, обычно установлены в /usr/share/fish/functions (на самом деле $__fish_data_dir/functions).

Если вы не уверены, ваши функции, вероятно, находятся в ~/.config/fish/functions.

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

Автоматическая загрузка также не работает для обработчиков событий, так как fish не может знать, что функция должна быть выполнена при возникновении события, пока не загрузит функцию. См. раздел обработчики событий для получения дополнительной информации.

Если файл с правильным именем не определяет функцию, fish не будет читать другие файлы автоматической загрузки, а продолжит попытки найти функцию в встроенных командах и, в конечном счёте, командах. Это позволяет маскировать функции, определённые позже в $fish_function_path, например, если ваш администратор поместил что-то в /etc/fish/functions, которое вы хотите пропустить.

Если вы разрабатываете другую программу и хотите установить для неё fish-функции, установите их в каталог функций «vendor». Поскольку этот путь различается в разных системах, вы можете использовать pkgconfig для его обнаружения с помощью вывода pkg-config --variable functionsdir fish. Ваша система установки должна поддерживать настраиваемый путь для лёгкого изменения пути pkgconfig, так как другим дистрибутивам может потребоваться легко его изменить.

Оператор if

Оператор if выполняет блок команд, если условие истинно.

Как и в других оболочках, но в отличие от типичных языков программирования, условие здесь — это команда. Fish выполняет её, и если она возвращает значение истинности код возврата (то есть 0), то выполняется блок if. Например:

if test -e /etc/os-release
    cat /etc/os-release
end

Здесь используется команда test, чтобы проверить, существует ли файл /etc/os-release. Если он существует, выполняется cat, который выводит его содержимое на экран.

В отличие от других оболочек, команда-условие завершается после выполнения первого задания, здесь нет then. Комбинирующие операторы, такие как and и or, расширяют возможности условия.

if часто используется с командой test, которая может проверять условия:

if test 5 -gt 2
    echo "Yes, 5 is greater than 2"
end

if также может принимать else if с дополнительными условиями и оператор else, который выполняется, когда все другие условия ложны:

if test "$number" -gt 10
   echo Your number was greater than 10
else if test "$number" -gt 5
   echo Your number was greater than 5
else if test "$number" -gt 1
   echo Your number was greater than 1
else
   echo Your number was smaller or equal to 1
end

Ключевое слово not может использоваться для инвертирования статуса:

# Just see if the file contains the string "fish" anywhere.
# This executes the `grep` command, which searches for a string,
# and if it finds it returns a status of 0.
# The `not` then turns 0 into 1 or anything else into 0.
# The `-q` switch stops it from printing any matches.
if not grep -q fish myanimals
    echo "You don't have fish!"
else
    echo "You have fish!"
end

Оператор switch

Команда switch используется для выполнения одного из нескольких блоков команд в зависимости от значения строки. Она может содержать несколько блоков case, которые выполняются при совпадении строки. Они могут содержать подстановки. Например:

switch (uname)
case Linux
    echo Hi Tux!
case Darwin
    echo Hi Hexley!
case DragonFly '*BSD'
    echo Hi Beastie! # this also works for FreeBSD and NetBSD
case '*'
    echo Hi, stranger!
end

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

Комбинирующие операторы (and / or / && / ||)

Для простых проверок можно использовать комбинирующие операторы. and или && выполняют вторую команду, если первая успешно завершилась, в то время как or или || выполняют её, если первая завершилась неудачно. Например:

# $XDG_CONFIG_HOME is a standard place to store configuration.
# If it's not set applications should use ~/.config.
set -q XDG_CONFIG_HOME; and set -l configdir $XDG_CONFIG_HOME
or set -l configdir ~/.config

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

Сравните:

if sleep 2; and false
    echo 'How did I get here? This should be impossible'
end

и:

if false; and sleep 2
    echo 'How did I get here? This should be impossible'
end

Они выполняют в основном одно и то же, но первый вариант занимает на 2 секунды больше, потому что команда sleep всегда должна быть выполнена.

Или в случае, когда требуется прерывание:

if command -sq foo; and foo

Если бы эта цепочка продолжилась после выяснения того, что команды «foo» не существует, она попыталась бы выполнить foo и получила бы ошибку, потому что она не найдена!

Комбинирующие операторы работают пошагово, поэтому не рекомендуется создавать длинные цепочки, потому что они могут привести к нежелательным результатам. Подумайте о:

test -e /etc/my.config
or echo "OH NO WE NEED A CONFIG FILE"
and return 1

Это приведет к выполнению return 1 и в случае успеха test. Это происходит потому, что Fish выполняет test -e /etc/my.config, устанавливает $status в 0, затем пропускает echo, $status остается 0, и затем выполняет return 1 , поскольку $status всё ещё равен 0.

Если вам нужны более сложные условия или вы хотите выполнить несколько действий после неудачи, воспользуйтесь оператором if. В этом случае это было бы:

if not test -e /etc/my.config
    echo "OH NO WE NEED A CONFIG FILE"
    return 1
end

Подстановки шаблонов («Глоббинговые» подстановки)

Когда параметр содержит незаключённый * звездочку (или «звёздочку») или ? вопросительный знак, fish использует их как подстановки шаблонов для сопоставления файлов.

• * соответствует любому числу символов (включая ноль) в имени файла, кроме /.
• ** соответствует любому количеству символов (включая ноль), а также спускается в подкаталоги. Если ** является отдельным сегментом, этот сегмент может соответствовать нулю раз для совместимости с другими оболочками.
• ? может соответствовать любому одиночному символу, кроме /. Эта функция устарела и может быть отключена через qmark-noglob флаг функции, поэтому ? будет просто обычным символом.

Сопоставления с подстановками шаблонов сортируются без учёта регистра. При сортировке сопоставлений, содержащих числа, они сортируются естественным образом, так что строки ‘1’, ‘5’ и ‘12’ будут отсортированы как 1, 5, 12.

Скрытые файлы (где имя начинается с точки) не учитываются при подстановке шаблонов, если в строке подстановки шаблона нет точки в соответствующем месте.

Примеры:

• a* соответствует любым файлам, начинающимся с «a», в текущем каталоге.
• ** соответствует любым файлам и каталогам в текущем каталоге и всех его подкаталогах.
• ~/.* соответствует всем скрытым файлам (также известным как «dotfiles») и каталогам в вашем домашнем каталоге.

Для большинства команд, если ни одна подстановка шаблона не удается, команда не выполняется, $status устанавливается в ненулевое значение и выводится предупреждение. Это поведение аналогично тому, что делает bash с shopt -s failglob. Есть исключения, а именно set и path, перезаписывающие переменные в перезаписи, count и for. Их подстановки шаблонов вместо этого будут расширяться до нуля аргументов (так что команда их вообще не увидит), как и в shopt -s nullglob в bash.

Примеры:

# List the .foo files, or warns if there aren't any.
ls *.foo

# List the .foo files, if any.
set foos *.foo
if count $foos >/dev/null
    ls $foos
end

В отличие от bash (по умолчанию), fish не будет передавать буквальный символ подстановки шаблона, если совпадений не найдено, поэтому для команды, подобной apt install, которая выполняет сопоставление сама, вам нужно добавить кавычки:

apt install "ncurses-*"

Расширение переменных

Одним из важнейших расширений в fish является «расширение переменных». Это замена знака доллара ($) за которым следует имя переменной, на _значение_ этой переменной.

В простейшем случае это выглядит примерно так:

echo $HOME

что заменит $HOME на домашний каталог текущего пользователя и передаст его в echo, который затем выведет его.

Некоторые переменные, такие как $HOME, уже заданы, потому что fish устанавливает их по умолчанию или потому, что родительский процесс fish передал их fish при его запуске. Вы можете определить свои собственные переменные, задав их с помощью set:

set my_directory /home/cooluser/mystuff
ls $my_directory
# shows the contents of /home/cooluser/mystuff

Дополнительные сведения о работе с настройкой переменных см. в разделе Переменные оболочки и последующих разделах.

Иногда переменная не имеет значения, потому что она не определена или пуста, и она расширяется до ничего:

echo $nonexistentvariable
# Prints no output.

Чтобы отделить имя переменной от текста, вы можете заключить переменную в двойные кавычки или фигурные скобки:

set WORD cat
echo The plural of $WORD is "$WORD"s
# Prints "The plural of cat is cats" because $WORD is set to "cat".
echo The plural of $WORD is {$WORD}s
# ditto

Без кавычек или фигурных скобок fish попытается расширить переменную с именем $WORDs, которая может не существовать.

Последний синтаксис {$WORD} является специальным случаем расширения фигурных скобок.

Если $WORD здесь не определена или является пустым списком, «s» не выводится. Однако она выводится, если $WORD — пустая строка (например, после set WORD "").

Дополнительные сведения о переменных оболочки см. в разделе Переменные оболочки.

> set foo one\nthing
> echo $foo
one
thing
> printf '|%s|\n' $foo
|one
thing|

set -l foo one two three
test -n $foo
# prints an error that it got too many arguments, because it was executed like
test -n one two three

test -n "$foo"
# works, because it was executed like
test -n "one two three"

set foo a b c
set a 10; set b 20; set c 30
for i in (seq (count $$foo))
    echo $$foo[$i]
end

# Output is:
# 10
# 20
# 30

Подстановка команд

Подстановка команды — это расширение, которое использует выходные данные одной команды в качестве аргументов для другой. Например:

echo (pwd)

Это выполняет команду pwd, берёт её вывод (точнее, то, что она вывела в стандартный поток вывода «stdout») и использует его в качестве аргументов для команды echo. Таким образом, внутренняя команда (pwd) выполняется первой и должна завершиться до запуска внешней команды.

Если внутренняя команда выводит несколько строк, fish будет использовать каждую отдельную строку как отдельный аргумент для внешней команды. В отличие от других оболочек, значение $IFS не используется [4], fish выполняет разделение по символам новой строки.

Подстановка команды также может быть записана с помощью знака доллара, как outercommand $(innercommand). Этот вариант также разрешён внутри двойных кавычек. При использовании двойных кавычек вывод команды не разбивается на строки, но пустые строки в конце всё равно удаляются.

Если вывод направлен в string split или string split0 как последний шаг, эти разделения используются так, как они появляются, вместо разделения строк.

Код возврата последней выполненной подстановки команды доступен в переменной status, если подстановка происходит в контексте команды set (следовательно, if set -l (something) проверяет, вернула ли something значение true).

Чтобы использовать только некоторые строки вывода, обратитесь к разделам срезов.

Примеры:

# Outputs 'image.png'.
echo (basename image.jpg .jpg).png

# Convert all JPEG files in the current directory to the
# PNG format using the 'convert' program.
for i in *.jpg; convert $i (basename $i .jpg).png; end

# Set the ``data`` variable to the contents of 'data.txt'
# without splitting it into a list.
set data "$(cat data.txt)"

# Set ``$data`` to the contents of data, splitting on NUL-bytes.
set data (cat data | string split0)

Иногда нужно передать вывод одной команды другой команде, которая принимает только файлы. Если это только один файл, то его можно обычно передать через канал, как:

grep fish myanimallist1 | wc -l

но если вам нужны несколько файлов или команда не считывает данные со стандартного ввода, полезна «подстановка процесса». Другие оболочки позволяют это сделать с помощью foo <(bar) <(baz), а fish использует команду psub:

# Compare just the lines containing "fish" in two files:
diff -u (grep fish myanimallist1 | psub) (grep fish myanimallist2 | psub)

Это создаёт временный файл, сохраняет в нём вывод команды и выводит имя файла, чтобы он был передан внешней команде.

В fish есть лимит по умолчанию в 100 МБ на данные, которые будут считаны в подстановке команды. Если этот лимит будет достигнут, команда (вся, а не только подстановка команды — внешняя команда вообще не будет выполнена) завершится с ошибкой, и $status будет установлено в значение 122. Это делается для того, чтобы подстановки команд не привели к исчерпанию памяти системы, так как у вашей операционной системы обычно гораздо меньший лимит, поэтому чтение большего объёма будет бесполезным и вредным. Этот лимит можно настроить с помощью переменной fish_read_limit (0 означает отсутствие лимита). Этот лимит также влияет на команду read.

Расширение фигурных скобок

Фигурные скобки могут использоваться для записи списков, разделённых запятыми. Они будут расширены, и каждый элемент станет новым параметром со присоединённой к нему окружающей строкой. Это полезно для экономии набора текста и для отделения имени переменной от окружающего текста.

Примеры:

> echo input.{c,h,txt}
input.c input.h input.txt

# Move all files with the suffix '.c' or '.h' to the subdirectory src.
> mv *.{c,h} src/

# Make a copy of `file` at `file.bak`.
> cp file{,.bak}

> set -l dogs hot cool cute "good "
> echo {$dogs}dog
hotdog cooldog cutedog good dog

Если между фигурными скобками нет «,» или расширения переменной, они не будут расширены:

# This {} isn't special
> echo foo-{}
foo-{}
# This passes "HEAD@{2}" to git
> git reset --hard HEAD@{2}
> echo {{a,b}}
{a} {b} # because the inner brace pair is expanded, but the outer isn't.

Если после расширения между фигурными скобками ничего нет, аргумент будет удалён (см. раздел декартова произведения):

> echo foo-{$undefinedvar}
# Output is an empty line, just like a bare `echo`.

Если между фигурной скобкой и запятой или двумя запятыми ничего нет, это интерпретируется как пустой элемент:

> echo {,,/usr}/bin
/bin /bin /usr/bin

Чтобы использовать «,» как элемент, кавычки или экранирование его.

Объединение списков (Декартово произведение)

Когда списки расширяются с присоединёнными к ним другими частями, они расширяются с этими частями всё ещё присоединёнными. Даже если два списка присоединены друг к другу, они расширяются во всех комбинациях. Это называется «декартовым произведением» (как в математике), и работает в основном так же, как расширение фигурных скобок.

Примеры:

# Brace expansion is the most familiar:
# All elements in the brace combine with the parts outside of the braces
>_ echo {good,bad}" apples"
good apples bad apples

# The same thing happens with variable expansion.
>_ set -l a x y z
>_ set -l b 1 2 3

# $a is {x,y,z}, $b is {1,2,3},
# so this is `echo {x,y,z}{1,2,3}`
>_ echo $a$b
x1 y1 z1 x2 y2 z2 x3 y3 z3

# Same thing if something is between the lists
>_ echo $a"-"$b
x-1 y-1 z-1 x-2 y-2 z-2 x-3 y-3 z-3

# Or a brace expansion and a variable
>_ echo {x,y,z}$b
x1 y1 z1 x2 y2 z2 x3 y3 z3

# A combined brace-variable expansion
>_ echo {$b}word
1word 2word 3word

# Special case: If $c has no elements, this expands to nothing
>_ echo {$c}word
# Output is an empty line

Иногда это может быть нежелательно, особенно потому, что токены могут исчезнуть после расширения. В таких случаях следует использовать двойные кавычки для переменных — echo "$c"word.

Это также происходит после подстановки команд. Чтобы предотвратить исчезновение токенов, заставьте внутреннюю команду возвращать конечную новую строку или сохраните вывод в переменной и поставьте двойные кавычки.

Например:

>_ set b 1 2 3
>_ echo (echo x)$b
x1 x2 x3
>_ echo (printf '%s' '')banana
# the printf prints nothing, so this is nothing times "banana",
# which is nothing.
>_ echo (printf '%s\n' '')banana
# the printf prints a newline,
# so the command substitution expands to an empty string,
# so this is `''banana`
banana

Это может быть очень полезно. Например, если вы хотите пройтись по всем файлам во всех каталогах в PATH, используйте

for file in $PATH/*

Поскольку PATH представляет собой список, это расширяется до всех файлов во всех каталогах в нём. И если в PATH нет каталогов, правильным ответом здесь будет расширение до нулевых файлов.

Срезы

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

# Make $var a list of four elements
set var one two three four
# Print the second:
echo $var[2]
# prints "two"
# or print the first three:
echo $var[1..3]
# prints "one two three"

В квадратных скобках индексов fish понимает диапазоны, записанные как a..b («a» и «b» — это индексы). Они расширяются в последовательность индексов от a до b (поэтому a a+1 a+2 ... b), возрастающие, если b больше, и убывающие, если a больше. Также можно использовать отрицательные индексы — они берутся с конца списка, поэтому -1 — это последний элемент, а -2 — элемент перед ним. Если индекс не существует, диапазон ограничен следующим возможным индексом.

Если список содержит 5 элементов, индексы варьируются от 1 до 5, поэтому диапазон 2..16 будет охватывать только элементы с 2-го по 5-ый.

Если конец отрицателен, диапазон всегда возрастает, поэтому 2..-2 будет охватывать элементы с 2-го по 4-ый, а 2..-16 не будет охватывать ничего, так как нет способа перейти от второго элемента к несуществующему, увеличивая индекс. Если начало отрицательно, диапазон всегда убывает, поэтому -2..1 будет охватывать элементы с 4-го по 1-ый, а -16..2 не будет охватывать ничего, так как нет способа перейти от несуществующего элемента ко второму, уменьшая индекс.

Пропущенный начальный индекс в диапазоне по умолчанию равен 1. Это допускается, если диапазон является первым выражением индекса в последовательности. Аналогично, пропущенный конечный индекс по умолчанию равен -1 для последнего индекса в последовательности.

Также возможно использование нескольких диапазонов, разделённых пробелами.

Некоторые примеры:

echo (seq 10)[1 2 3]
# Prints: 1 2 3

# Limit the command substitution output
echo (seq 10)[2..5]
# Uses elements from 2 to 5
# Output is: 2 3 4 5

echo (seq 10)[7..]
# Prints: 7 8 9 10

# Use overlapping ranges:
echo (seq 10)[2..5 1..3]
# Takes elements from 2 to 5 and then elements from 1 to 3
# Output is: 2 3 4 5 1 2 3

# Reverse output
echo (seq 10)[-1..1]
# Uses elements from the last output line to
# the first one in reverse direction
# Output is: 10 9 8 7 6 5 4 3 2 1

# The command substitution has only one line,
# so these will result in empty output:
echo (echo one)[2..-1]
echo (echo one)[-3..1]

То же самое работает при установке или расширении переменных:

# Reverse path variable
set PATH $PATH[-1..1]
# or
set PATH[-1..1] $PATH

# Use only n last items of the PATH
set n -3
echo $PATH[$n..-1]

Переменные могут использоваться как индексы для расширения переменных, например:

set index 2
set letters a b c d
echo $letters[$index] # returns 'b'

Однако использование переменных в качестве индексов для подстановки команд в настоящее время не поддерживается, поэтому:

echo (seq 5)[$index] # This won't work

set sequence (seq 5) # It needs to be written on two lines like this.
echo $sequence[$index] # returns '2'

При использовании косвенного расширения переменных с несколькими $ ($$name) необходимо указать все индексы до переменной, которую вы хотите разрезать:

> set -l list 1 2 3 4 5
> set -l name list
> echo $$name[1]
1 2 3 4 5
> echo $$name[1..-1][1..3] # or $$name[1][1..3], since $name only has one element.
1 2 3

Расширение домашнего каталога

Символ ~ (тильда) в начале параметра, за которым следует имя пользователя, расширяется до домашнего каталога указанного пользователя. Одиночная ~, или ~, за которой следует обратный слэш, расширяется до домашнего каталога владельца процесса:

ls ~/Music # lists my music directory

echo ~root # prints root's home directory, probably "/root"

Объединение различных расширений

Все вышеперечисленные расширения могут быть объединены. Если несколько расширений приводят к более чем одному параметру, создаются все возможные комбинации.

При объединении нескольких расширений параметров расширения выполняются в следующем порядке:

• Подстановки команд
• Расширения переменных
• Расширение в квадратных скобках
• Расширение с подстановкой шаблонов

Расширения выполняются справа налево, вложенные расширения в квадратных скобках выполняются изнутри наружу.

Пример:

Если в текущем каталоге находятся файлы ‘foo’ и ‘bar’, команда echo a(ls){1,2,3} выведет abar1 abar2 abar3 afoo1 afoo2 afoo3.

Область действия переменных

В fish существуют четыре типа переменных: универсальные, глобальные, переменные функций и локальные переменные.

• Универсальные переменные общие для всех сеансов fish, которые пользователь запускает на одном компьютере. Они хранятся на диске и сохраняются даже после перезагрузки.
• Глобальные переменные специфичны для текущего сеанса fish. Их можно удалить, явно запросив set -e.
• Переменные функций специфичны для выполняемой в данный момент функции. Они удаляются («выходят из области видимости») по завершении текущей функции. Вне функции они не выходят из области видимости.
• Локальные переменные специфичны для текущего блока команд и автоматически удаляются, когда конкретный блок выходит из области видимости. Блок команд — это последовательность команд, которая начинается с одной из команд for, while, if, function, begin или switch, и заканчивается командой end. Вне блока это то же самое, что область действия функции.

Переменные могут быть явно заданы как универсальные с помощью переключателя -U или --universal, глобальные с -g или --global, привязанные к функции с -f или --function и локальные для текущего блока с -l или --local. Правила области действия при создании или обновлении переменной следующие:

• Когда задаётся область действия, она используется. Если переменная с тем же именем существует в другой области действия, эта переменная не будет изменена.
• Когда область действия не задана, но переменная с этим именем существует, будет модифицирована переменная с наименьшей областью действия. Область действия не будет изменена.
• Когда область действия не задана и переменная с этим именем не существует, переменная создаётся в области действия функции, если внутри функции, или в глобальной области действия, если функция не выполняется.

Может быть много переменных с одинаковым именем, но разной областью действия. Когда вы используете переменную, будет использоваться переменная с наименьшей областью действия с этим именем. Если существует локальная переменная, она будет использоваться вместо глобальной или универсальной переменной с тем же именем.

Пример:

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

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

function something
    set -l file /path/to/my/file
    if not test -e "$file"
        set file /path/to/my/otherfile
    end
end

# or

function something
    if test -e /path/to/my/file
        set -f file /path/to/my/file
    else
        set -f file /path/to/my/otherfile
    end
end

Если вы хотите установить что-то в config.fish или установить что-то в функции и иметь его доступным для остальной части сеанса, глобальная область действия — хороший выбор:

# Don't shorten the working directory in the prompt
set -g fish_prompt_pwd_dir_length 0

# Set my preferred cursor style:
function setcursors
   set -g fish_cursor_default block
   set -g fish_cursor_insert line
   set -g fish_cursor_visual underscore
end

# Set my language
set -gx LANG de_DE.UTF-8

Если вы хотите установить некоторые настройки, универсальные переменные — неплохой вариант:

# Typically you'd run this interactively, fish takes care of keeping it.
set -U fish_color_autosuggestion 555

Вот пример локальных и привязанных к функции переменных:

function test-scopes
    begin
        # This is a nice local scope where all variables will die
        set -l pirate 'There be treasure in them thar hills'
        set -f captain Space, the final frontier
        # If no variable of that name was defined, it is function-local.
        set gnu "In the beginning there was nothing, which exploded"
    end

    echo $pirate
    # This will not output anything, since the pirate was local
    echo $captain
    # This will output the good Captain's speech since $captain had function-scope.
    echo $gnu
    # Will output Sir Terry's wisdom.
end

Когда функция вызывает другую, локальные переменные недоступны:

function shiver
    set phrase 'Shiver me timbers'
end

function avast
    set --local phrase 'Avast, mateys'
    # Calling the shiver function here can not
    # change any variables in the local scope
    # so phrase remains as we set it here.
    shiver
    echo $phrase
end
avast

# Outputs "Avast, mateys"

В случае сомнений используйте переменные области действия функций. Когда вам нужно сделать переменную доступной везде, сделайте её глобальной. Когда вам нужно постоянно хранить конфигурацию, сделайте её универсальной. Когда вы хотите использовать переменную только в небольшом блоке, сделайте её локальной.

Переопределение переменных для одной команды

Если вы хотите переопределить переменную для одной команды, вы можете использовать операторы «var=val» перед командой:

# Call git status on another directory
# (can also be done via `git -C somerepo status`)
GIT_DIR=somerepo git status

В отличие от других оболочек, fish сначала установит переменную, а затем выполнит другие расширения в строке, поэтому:

set foo banana
foo=gagaga echo $foo # prints gagaga, while in other shells it might print "banana"

Несколько элементов могут быть заданы в расширении фигурных скобок:

# Call bash with a reasonable default path.
PATH={/usr,}/{s,}bin bash

Или с помощью подстановки шаблонов:

# Run vlc on all mp3 files in the current directory
# If no file exists it will still be run with no arguments
mp3s=*.mp3 vlc $mp3s

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

Этот синтаксис поддерживается с fish 3.1.

Универсальные переменные

Универсальные переменные — это переменные, которые общие для всех сеансов fish пользователя на компьютере. Fish хранит многие свои параметры конфигурации в виде универсальных переменных. Это означает, что для изменения настроек fish вам нужно лишь один раз изменить значение переменной, и оно будет автоматически обновлено для всех сеансов и сохранится при перезагрузке компьютера и входа/выхода.

Чтобы увидеть универсальные переменные в действии, запустите два сеанса fish рядом, и выполните следующую команду в одном из них set fish_color_cwd blue. Так как fish_color_cwd — это универсальная переменная, цвет отображения текущего каталога в приглашении мгновенно изменится на синий в обоих терминалах.

Универсальные переменные хранятся в файле .config/fish/fish_variables. Не редактируйте этот файл напрямую, так как ваши изменения могут быть перезаписаны. Редактируйте переменные через скрипты fish или используя fish интерактивно.

Не добавляйте в универсальные переменные в config.fish, потому что эти переменные будут становиться длиннее с каждым новым экземпляром оболочки. Вместо этого просто установите их один раз в командной строке.

Экспорт переменных

Переменные в fish могут быть экспортированы, поэтому они будут унаследованы любыми командами, запущенными fish. В частности, это необходимо для переменных, используемых для настройки внешних команд, таких как PAGER или GOPATH, а также для переменных, содержащих общие системные настройки, такие как PATH или LANGUAGE. Если внешней команде нужна переменная, она должна быть экспортирована. Экспортированные переменные также часто называют «переменными среды».

Это также относится к fish — при запуске он получает переменные среды от своего родителя (обычно терминала). Обычно это включает системную конфигурацию, такую как PATH и переменные локали.

Переменные могут быть явно настроены как экспортируемые с помощью переключателя -x или --export, или не экспортируемые с помощью переключателя -u или --unexport. Правила экспорта при установке переменной похожи на правила области действия переменных — при передаче параметра он уважается, в противном случае используется существующее состояние переменной. Если параметр не передан, и переменная ещё не существовала, она не экспортируется.

В качестве соглашения об именах, экспортированные переменные — заглавные, а не экспортированные — строчные.

Например:

set -gx ANDROID_HOME ~/.android # /opt/android-sdk
set -gx CDPATH . ~ (test -e ~/Videos; and echo ~/Videos)
set -gx EDITOR emacs -nw
set -gx GOPATH ~/dev/go
set -gx GTK2_RC_FILES "$XDG_CONFIG_HOME/gtk-2.0/gtkrc"
set -gx LESSHISTFILE "-"

Примечание: Экспорт — это не область действия, а дополнительное состояние. Обычно имеет смысл делать экспортированные переменные глобальными, но локальные экспортированные переменные могут быть полезны, если вам нужно что-то более конкретное, чем переопределения. Они копируются в функции, поэтому функция не может изменить их снаружи, и по-прежнему доступны командам. Глобальные переменные доступны функциям, независимо от того, экспортируются они или нет.

Списки

Рыба может хранить список (или «массив», если хотите) нескольких строк внутри переменной:

> set mylist first second third
> printf '%s\n' $mylist # prints each element on its own line
first
second
third

Для доступа к одному элементу списка используйте индекс элемента в квадратных скобках, например:

echo $PATH[3]

Индексы списков в рыбе начинаются с 1, а не с 0, как в других языках. Это связано с тем, что требуется меньше вычитаний 1, и многие распространённые утилиты Unix, такие как seq работают лучше с ним (seq 5 печатает от 1 до 5, а не от 0 до 5). Неверный индекс игнорируется, не возвращая никакого значения (даже не пустой строки, просто вообще никакого аргумента).

Если вы не используете квадратные скобки, все элементы списка будут переданы команде как отдельные элементы. Это означает, что вы можете перебирать список с помощью for:

for i in $PATH
    echo $i is in the path
end

Это перебирает каждую директорию в PATH по отдельности и печатает строку, говорящую, что она находится в пути.

Чтобы создать переменную smurf, содержащую элементы blue и small, просто напишите:

set smurf blue small

Также можно устанавливать или удалять отдельные элементы списка:

# Set smurf to be a list with the elements 'blue' and 'small'
set smurf blue small

# Change the second element of smurf to 'evil'
set smurf[2] evil

# Erase the first element
set -e smurf[1]

# Output 'evil'
echo $smurf

Если вы указываете отрицательный индекс при расширении или присваивании переменной списка, индекс будет взят с конца списка. Например, индекс -1 — это последний элемент списка:

> set fruit apple orange banana
> echo $fruit[-1]
banana

> echo $fruit[-2..-1]
orange
banana

> echo $fruit[-1..1] # reverses the list
banana
orange
apple

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

Все списки одномерные и не могут содержать другие списки, хотя можно имитировать вложенные списки с помощью разыменования — см. расширение переменной.

Когда список экспортируется как переменная среды, он разделяется пробелами или двоеточиями, в зависимости от того, является ли это переменной пути:

> set -x smurf blue small
> set -x smurf_PATH forest mushroom
> env | grep smurf
smurf=blue small
smurf_PATH=forest:mushroom

Рыба автоматически создает списки из всех переменных среды, имена которых оканчиваются на PATH (например, PATH, CDPATH или MANPATH), разбивая их по двоеточиям. Другие переменные не разбиваются автоматически.

Списки можно проверить с помощью команд count или contains:

> count $smurf
2

> contains blue $smurf
# blue was found, so it exits with status 0
# (without printing anything)

> echo $status
0

> contains -i blue $smurf
1

Прекрасно в списках то, что они передаются командам по одному элементу как один аргумент, поэтому, после того как вы установили свой список, вы можете просто передать его:

set -l grep_args -r "my string"
grep $grep_args . # will run the same as `grep -r "my string"` .

В отличие от других оболочек, рыба не выполняет «разделение слов» — элементы списка остаются неизменными, даже если они содержат пробелы или табуляции.

Обработка аргументов

Важным списком является $argv, который содержит аргументы функции или скрипта. Например:

function myfunction
    echo $argv[1]
    echo $argv[3]
end

Эта функция принимает все полученные аргументы и печатает первый и третий:

> myfunction first second third
first
third

> myfunction apple cucumber banana
apple
banana

Это относится к позиционным аргументам, но утилиты командной строки часто получают различные опции и флаги, и $argv будет содержать их, перемешанные с позиционными аргументами. Типичная обработка аргументов Unix допускает короткие опции (-h, также сгруппированные, как в ls -lah ), длинные опции (--help) и допускает, чтобы эти опции принимали аргументы (--color=auto или --position anywhere или complete -C"git " ), а также разделитель -- для обозначения конца опций. Обработка всего этого вручную сложна и подвержена ошибкам.

Более надёжный подход к обработке опций — argparse, который проверяет определённые опции и помещает их в различные переменные, оставляя только позиционные аргументы в $argv. Вот простой пример:

function mybetterfunction
    # We tell argparse about -h/--help and -s/--second - these are short and long forms of the same option.
    # The "--" here is mandatory, it tells it from where to read the arguments.
    argparse h/help s/second -- $argv
    # exit if argparse failed because it found an option it didn't recognize - it will print an error
    or return

    # If -h or --help is given, we print a little help text and return
    if set -ql _flag_help
        echo "mybetterfunction [-h|--help] [-s|--second] [ARGUMENT ...]"
        return 0
    end

    # If -s or --second is given, we print the second argument,
    # not the first and third.
    # (this is also available as _flag_s because of the short version)
    if set -ql _flag_second
        echo $argv[2]
    else
        echo $argv[1]
        echo $argv[3]
    end
end

Опции будут удалены из $argv, поэтому $argv[2] теперь является вторым позиционным аргументом:

> mybetterfunction first -s second third
second

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

Переменные PATH

Переменные PATH — это специальный тип переменных, используемых для поддержки списков путей, разделенных двоеточиями, включая PATH, CDPATH, MANPATH, PYTHONPATH, и т. д. Все переменные, оканчивающиеся на «PATH» (регистрозависимые), по умолчанию становятся переменными PATH.

Переменные PATH ведут себя как обычные списки, за исключением того, что они неявно объединяются и разбиваются по двоеточиям.

set MYPATH 1 2 3
echo "$MYPATH"
# 1:2:3
set MYPATH "$MYPATH:4:5"
echo $MYPATH
# 1 2 3 4 5
echo "$MYPATH"
# 1:2:3:4:5

Переменные PATH также будут экспортироваться в формате с двоеточиями, поэтому set -x MYPATH 1 2 3 будут видимы внешним командам как 1:2:3.

> set -gx MYPATH /bin /usr/bin /sbin
> env | grep MYPATH
MYPATH=/bin:/usr/bin:/sbin

Это для совместимости с другими инструментами. Unix не имеет переменных с несколькими элементами, ближайшая аналогия — списки с двоеточиями, такие как PATH. По понятным причинам, это означает, что ни один элемент не может содержать :.

Переменные могут быть помечены или отмечены как переменные PATH с помощью опций --path и --unpath для set.

Специальные переменные

Вы можете изменить настройки fish, изменив значения определённых переменных.

PATH

Список каталогов, в которых следует искать команды. Это общая переменная Unix, используемая также и другими инструментами.

CDPATH

Список каталогов, в которых встроенная команда cd ищет новый каталог.

Переменные локали

Переменные локали LANG, LC_ALL, LC_COLLATE, LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC и LANG устанавливают языковые параметры для оболочки и подпрограмм. Более подробную информацию см. в разделе Переменные локали.

Переменные цвета

Несколько переменных, начинающихся с префиксов fish_color и fish_pager_color. Более подробную информацию см. в Переменные для изменения цветов выделения.

fish_term24bit

Если это значение равно 1, fish будет считать, что терминал понимает 24-битные цветовые последовательности RGB и не будет переводить их в палитру из 256 или 16 цветов. Часто это определяется автоматически.

fish_term256

Если это значение равно 1, fish будет считать, что терминал понимает 256 цветов, и не будет переводить соответствующие цвета в палитру из 16 цветов. Обычно это определяется автоматически.

fish_ambiguous_width

управляет вычисленной шириной символов с неоднозначной шириной. Это значение следует установить в 1, если ваш терминал отображает такие символы как символы одинарной ширины (обычно), или 2, если двойной ширины.

fish_emoji_width

управляет тем, считает ли fish, что эмодзи отображаются как 2 ячейки или 1 ячейка в ширину. Это необходимо, потому что правильное значение изменилось с 1 на 2 в Unicode 9, и некоторые терминалы могут не знать об этом. Установите это значение, если вы видите графические артефакты, связанные с эмодзи (или другими «специальными» символами). Обычно это значение определяется автоматически.

fish_autosuggestion_enabled

управляет включением/выключением Автозаполнения. Установите значение 0 для отключения, любое другое значение для включения. По умолчанию они включены.

fish_handle_reflow

определяет, должен ли fish пытаться перерисовать командную строку при изменении размера терминала. В терминалах, которые перестраивают текст, это следует отключить. Установите значение 1 для включения, любое другое значение для отключения.

fish_key_bindings

имя функции, которая настраивает сочетания клавиш для редактора командной строки.

fish_escape_delay_ms

устанавливает, сколько времени fish ожидает нажатия другой клавиши после получения escape-символа, чтобы отличить нажатие клавиши escape от начала последовательности escape. Значение по умолчанию составляет 30 мс. Увеличение значения увеличивает задержку, но позволяет нажать escape вместо alt для сочетаний alt+символ. Более подробную информацию см. в главе документации bind.

fish_sequence_key_delay_ms

устанавливает, сколько времени fish ожидает нажатия другой клавиши после получения клавиши, которая является частью более длинной последовательности, для уточнения. Например, если вы привязали \cx\ce к открытию редактора, fish будет ожидать в течение этого времени в миллисекундах, чтобы увидеть ctrl-e после ctrl-x. Если время истекает, он обработает это как ctrl-x (по умолчанию это скопирует текущую командную строку в буфер обмена). См. также Последовательности клавиш.

fish_complete_path

определяет, где fish ищет завершение. При попытке завершения команды fish ищет файлы в каталогах в этой переменной.

fish_cursor_selection_mode

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

fish_function_path

определяет, где fish ищет функции. Когда fish автозагружает функцию, он будет искать файлы в этих каталогах.

fish_greeting

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

fish_history

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

fish_trace

если установлено и не пустое, заставит fish выводить команды перед их выполнением, подобно set -x в bash. Трассировка выводится в путь, заданный параметром --debug-output для fish или переменной FISH_DEBUG_OUTPUT. По умолчанию выводится в stderr.

FISH_DEBUG

Управляет категориями отладки, которые fish включает для вывода, аналогично параметру --debug.

FISH_DEBUG_OUTPUT

Указывает файл для вывода отладочной информации.

fish_user_paths

список каталогов, добавляемых перед PATH. Это может быть универсальная переменная.

umask

текущая маска создания файлов. Предпочтительный способ изменения переменной umask — через функцию umask. Попытка установить umask в неверное значение всегда завершится неудачей.

BROWSER

ваш предпочтительный веб-браузер. Если эта переменная установлена, fish будет использовать указанный браузер вместо системного по умолчанию для отображения документации fish.

Fish также предоставляет дополнительную информацию через значения определённых переменных среды. Большинство из этих переменных являются только для чтения, и их значение нельзя изменить с помощью set.

_

имя выполняемой в данный момент команды (хотя это устарело, и предпочтительнее использовать status current-command).

argv

список аргументов для оболочки или функции. argv определена только при вызове функции или если fish был вызван со списком аргументов, например fish myscript.fish foo bar. Эту переменную можно изменить.

CMD_DURATION

время выполнения последней команды в миллисекундах.

COLUMNS и LINES

текущие размеры терминала по высоте и ширине. Эти значения используются fish только если операционная система не сообщает размеры терминала. В этом случае обе переменные должны быть установлены, в противном случае используется значение по умолчанию 80x24. Они обновляются при изменении размера окна.

fish_kill_signal

сигнал, который завершил последнюю фоновую задачу, или 0, если задача завершилась нормально.

fish_killring

список записей в кольце обмена fish(кольце обмена) вырезанного текста.

fish_read_limit

сколько байтов будет обрабатывать fish с помощью команды read или в подстановке команд.

fish_pid

идентификатор процесса (PID) оболочки.

history

список последних введённых команд.

HOME

домашний каталог пользователя. Эта переменная может быть изменена.

hostname

имя хоста машины.

IFS

внутренний разделитель полей, используемый для разделения слов с помощью встроенной команды read. Установка этой переменной в пустую строку также отключит разделение строк в подстановке команд. Эта переменная может быть изменена.

last_pid

идентификатор процесса (PID) последнего фонового процесса.

PWD

текущий рабочий каталог.

pipestatus

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

SHLVL

уровень вложенности оболочек. Fish увеличивает это значение в интерактивных оболочках, в противном случае просто передаёт его.

status

код завершения последней завершившейся фоновой задачи. Если задача завершилась по сигналу, код завершения будет равен 128 плюс номер сигнала.

status_generation

счётчик «поколения» $status. Он будет инкрементироваться только тогда, когда предыдущая команда сгенерировала явное значение кода завершения. (Например, фоновые задачи не будут увеличивать это значение).

TERM

тип текущего терминала. Когда fish пытается определить, как работает терминал — сколько он поддерживает цветов, какие последовательности он отправляет для клавиш и других вещей — он смотрит на эту переменную и соответствующую информацию в базе данных terminfo (см. man terminfo).

Примечание: обычно его не нужно менять, так как терминал устанавливает его в правильное значение.

USER

текущее имя пользователя. Эта переменная может быть изменена.

EUID

текущий эффективный идентификатор пользователя, установленный fish при запуске. Эта переменная может быть изменена.

version

версия запущенного fish (также доступна как FISH_VERSION для обратной совместимости).

В соответствии с соглашением, имена переменных с заглавными буквами обычно используются для экспортируемых переменных, в то время как переменные со строчными буквами не экспортируются. (CMD_DURATION является исключением по историческим причинам). Это правило не навязывается fish, но хорошая практика — использовать регистр для различения экспортируемых и неэкспортируемых переменных.

Fish также использует некоторые переменные внутри, обычно начинающиеся с __fish. Это внутренние переменные, и их обычно не нужно изменять напрямую.

Переменная статуса

Всякий раз, когда процесс завершается, программе, которая его запустила (обычно оболочке), возвращается код завершения. Этот код завершения — целое число, которое указывает вызывающему приложению, как прошла выполнение команды. В общем случае, код завершения 0 означает, что команда выполнилась без проблем, а ненулевой код завершения означает, что возникла проблема.

Fish сохраняет код завершения последнего завершившегося процесса в переменной status.

Если fish сталкивается с проблемой при выполнении команды, переменная статуса также может быть установлена в определённое значение:

• 0 — обычно код завершения команд, если они успешно выполнили запрошенную операцию.
• 1 — обычно код завершения команд, если они не смогли выполнить запрошенную операцию.
• 121 — обычно код завершения команд, если им были переданы неверные аргументы.
• 123 означает, что команда не была выполнена, потому что имя команды содержало недопустимые символы.
• 124 означает, что команда не была выполнена, потому что ни один из шаблонов в команде не дал совпадений.
• 125 означает, что хотя исполняемый файл с указанным именем был найден, операционная система не смогла запустить команду.
• 126 означает, что хотя файл с указанным именем был найден, он не был исполняемым.
• 127 означает, что ни функция, ни встроенная команда, ни команда с заданным именем не были найдены.

Если процесс завершается по сигналу, код завершения будет равен 128 плюс номер сигнала.

Статус можно инвертировать с помощью not (или !), что полезно в условии. Это преобразует статус 0 в 1, а любой ненулевой статус в 0.

Также есть $pipestatus, который представляет собой список всех значений status процессов в цепочке команд. Отличие заключается в том, что not применяется к $status, но не к $pipestatus, так как теряется информация.

Например:

not cat file | grep -q fish
echo status is: $status pipestatus is $pipestatus

Здесь $status отражает статус grep, который возвращает 0, если что-то найдено, отрицается not (т.е. 1, если найдено, 0 в противном случае). $pipestatus отражает статус cat (который возвращает ненулевое значение, например, когда файл не может быть найден) и grep, без инверсии.

Таким образом, если оба cat и grep выполнились успешно, $status будет 1 из-за not, а $pipestatus будет 0 и 0.

Первый процесс может завершиться неудачно, а второй — успешно. Один из распространённых примеров — когда вторая программа завершается слишком рано.

Например, если у вас есть цепочка команд:

cat file1 file2 | head -n 50

Это скажет cat напечатать два файла, “file1” и “file2”, один за другим, а head затем напечатает только первые 50 строк. В этом случае вы часто увидите такую последовательность:

> cat file1 file2 | head -n 50
# 50 lines of output
> echo $pipestatus
141 0

Здесь «141» означает, что cat был убит сигналом номер 13 (128 + 13 == 141) — сигнал SIGPIPE. Вы также можете использовать fish_kill_signal, чтобы увидеть номер сигнала. Это происходит потому, что он всё ещё работал, а затем head закрыл канал, поэтому cat получил сигнал, который не игнорировал, и поэтому он умер.

Будет ли cat здесь видеть SIGPIPE, зависит от длины файла и того, сколько он записывает за раз, поэтому вы можете увидеть pipestatus «0 0», в зависимости от реализации. Это общая проблема Unix, а не проблема, специфичная для fish. Некоторые оболочки имеют функцию «pipefail», которая обозначит цепочку команд как неудачную, если один из процессов в ней завершился неудачно, и это большая проблема с ней.

Локальные переменные

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

LANG

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

Значение LANG используется для каждой категории, если не установлена переменная для этой категории или переменная LC_ALL. Поэтому, обычно, достаточно установить только LANG.

Пример значения: en_US.UTF-8 для американской версии английского языка и кодировки UTF-8 или de_AT.UTF-8 для австрийской версии немецкого языка и кодировки UTF-8. Ваша операционная система может иметь команду locale, которую можно вызвать как locale -a, чтобы увидеть список определенных локалей.

Рекомендуется использовать кодировку UTF-8.

LC_ALL

Переопределяет переменную среды LANG и значения других переменных LC_*. Если она установлена, другие переменные не используются.

Обычно следует использовать другие переменные. Используйте LC_ALL только когда нужно переопределить что-либо.

LC_COLLATE

Определяет правила эквивалентности регистров и алфавитного порядка (сортировка).

LC_CTYPE

Определяет правила классификации, такие как тип символа (буква, цифра и т. д.). Самое важное, она определяет кодировку текста — какие числа соответствуют каким символам. В современных системах, обычно, это значение, заканчивающееся на «UTF-8».

LC_MESSAGES

LC_MESSAGES определяет язык, на котором отображаются сообщения.

LC_MONETARY

Определяет валюту, её форматирование и используемые символы.

LC_NUMERIC

Устанавливает локаль для форматирования чисел.

LC_TIME

Устанавливает локаль для форматирования дат и времени.