Руководства по командной строке

Man » numfmt Manual online — подробная онлайн-документация для страницы руководства numfmt

🌍
numfmt — преобразование чисел в удобочитаемые строки и наоборот

СИНТАКСИС

numfmt [ОПЦИЯ]... [ЧИСЛО]...

ОПИСАНИЕ

Преформатирует ЧИСЛО или числа из стандартного ввода, если они не указаны.

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

--debug
выводит предупреждения об неверных входных данных

-d, --delimiter=X
использует X вместо пробела в качестве разделителя полей

--field=ПОЛЯ
заменяет числа в этих входных полях (по умолчанию = 1); см. ПОЛЯ ниже

--format=ФОРМАТ
использует стиль printf для чисел с плавающей запятой; см. ФОРМАТ ниже для получения подробной информации

--from=ЕДИНИЦА
автоматически масштабирует входные числа до ЕДИНИЦ; по умолчанию — «none»; см. ЕДИНИЦА ниже

--from-unit=N
указывает размер входной единицы (вместо значения по умолчанию 1)

--grouping
использует группировку цифр, определенную в локали, например 1.000.000 (что не имеет эффекта в локали C/POSIX)

--header[=N]
выводит (без преобразования) первые N строк заголовка; если N не указан, значение по умолчанию — 1

--invalid=РЕЖИМ
режим обработки неверных чисел: РЕЖИМ может быть: abort (по умолчанию), fail, warn, ignore

--padding=N
дополняет вывод до N символов; положительное N выравнивает по правому краю; отрицательное N выравнивает по левому краю; дополнение игнорируется, если вывод шире N; по умолчанию автоматически дополняется, если найден пробел

--round=МЕТОД
использует МЕТОД для округления при масштабировании; МЕТОД может быть: up, down, from-zero (по умолчанию), towards-zero, nearest

--suffix=СУФФИКС
добавляет СУФФИКС к выходным числам и допускает необязательный СУФФИКС во входных числах

--to=ЕДИНИЦА
автоматически масштабирует выходные числа до ЕДИНИЦ; см. ЕДИНИЦА ниже

--to-unit=N
размер выходной единицы (вместо значения по умолчанию 1)

-z, --zero-terminated
разделитель строк — NUL, а не новая строка

--help отображает эту справку и выходит

--version
выводит информацию о версии и выходит

Опции ЕДИНИЦА:

none   автомасштабирование не выполняется; суффиксы вызовут ошибку

auto   принимает необязательный одно- или двухбуквенный суффикс: 1K = 1000, 1k = 1000, 1Ki = 1024, 1M = 1000000, 1i = 1048576,

si     принимает необязательный однобуквенный суффикс: 1k = 1000, 1K = 1000, 1M = 1000000, ...

iec    принимает необязательный однобуквенный суффикс: 1K = 1024, 1k = 1024, 1M = 1048576, ...

iec-i  принимает необязательный двухбуквенный суффикс: 1Ki = 1024, 1ki = 1024, 1Mi = 1048576, ...

FIELDS поддерживает диапазоны полей в стиле cut(1):

N      N-е поле, отсчет начинается с 1

N-     от N-го поля до конца строки

N-M    от N-го до M-го поля включительно

-M     от первого до M-го поля включительно

-      все поля

Несколько полей/диапазонов можно разделить запятыми

ФОРМАТ должен подходить для вывода одного аргумента с плавающей запятой '%f'. Необязательная кавычка (%'f) включит опцию --grouping (если она поддерживается текущей локалью). Необязательное значение ширины (%10f) будет дополнять вывод. Необязательное значение ширины с нулями (%010f) будет дополнять число нулями. Необязательные отрицательные значения (%-10f) будут выравнивать по левому краю. Необязательная точность (%.1f) будет переопределять точность, определенную для входных данных.

Статус выхода равен 0, если все входные числа были успешно преобразованы. По умолчанию numfmt остановится при первой ошибке преобразования и вернет статус выхода 2. При использовании --invalid='fail' для каждой ошибки преобразования будет выведено предупреждение, и статус выхода будет равен 2. При использовании --invalid='warn' каждая ошибка преобразования будет диагностироваться, но статус выхода будет равен 0. При использовании --invalid='ignore' ошибки преобразования не будут диагностироваться, и статус выхода будет равен 0.

ПРИМЕРЫ

$ numfmt --to=si 1000

-> "1.0k"

$ numfmt --to=iec 2048

-> "2.0K"

$ numfmt --to=iec-i 4096

-> "4.0Ki"

$ echo 1K | numfmt --from=si

-> "1000"

$ echo 1K | numfmt --from=iec

-> "1024"

$ df -B1 | numfmt --header --field 2-4 --to=si
$ ls -l  | numfmt --header --field 5 --to=iec
$ ls -lh | numfmt --header --field 5 --from=iec --padding=10
$ ls -lh | numfmt --header --field 5 --from=iec --format %10f

АВТОР

Написано Ассафом Гордоном.

СООБЩЕНИЕ ОБ ОШИБКАХ

Онлайн-справка GNU coreutils: [https://www.gnu.org/software/coreutils/] Сообщайте о любых ошибках перевода по адресу [https://translationproject.org/team/]

СМОТРИТЕ ТАКЖЕ

Полная документация [https://www.gnu.org/software/coreutils/numfmt] или доступна локально через: info '(coreutils) numfmt invocation'

Упаковано Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Лицензия GPLv3+: GNU GPL версии 3 или более поздней [https://gnu.org/licenses/gpl.html]. Это свободное программное обеспечение: вы можете изменять и распространять его. Гарантии отсутствуют в той мере, в какой это допускается законом.