table of contents
NUMFMT(1) | Команды пользователя | NUMFMT(1) |
ИМЯ¶
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; по умолчанию дополнение происходит автоматически, если во входных данных присутствуют пробелы
- --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, 1Mi = 1048576,
- si
- принимать необязательный суффикс из одной буквы:
- 1k = 1000, 1K = 1000, 1M = 1000000, ...
- iec
- принимать необязательный суффикс из одной буквы:
- 1K = 1024, 1k = 1024, 1M = 1048576, ...
- iec-i
- принимать необязательный суффикс из двух букв:
- 1Ki = 1024, 1ki = 1024, 1Mi = 1048576, ...
ПОЛЯ поддерживают диапазоны полей в стиле 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
АВТОРЫ¶
Программа написана Ассафом Гордоном (Assaf Gordon).
ИНФОРМАЦИЯ ОБ ОШИБКАХ¶
Онлайн-справка
GNU coreutils: <https://www.gnu.org/software/coreutils/>
Сообщайте
обо всех
ошибках
перевода
по адресу
<https://translationproject.org/team/ru.html>
АВТОРСКИЕ ПРАВА¶
Copyright © 2024 Free Software Foundation, Inc.
Лицензия GPLv3+: GNU
GPL версии 3
или выше
<https://gnu.org/licenses/gpl.ru.html>.
Это
свободное
программное
обеспечение:
вы можете
изменять и
распространять
его. Не
предоставляется
НИКАКИХ
ГАРАНТИЙ в
той мере, в
которой
это
разрешено
законом.
СМОТРИТЕ ТАКЖЕ¶
Полная
документация
на <https://www.gnu.org/software/coreutils/numfmt>,
также
доступна
локально
посредством
info '(coreutils) numfmt invocation'
ПЕРЕВОД¶
Русский перевод этой страницы руководства разработал Андрей Догадкин <adogadkin@outlook.com>
Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.
апрель 2024 г. | GNU coreutils 9.5 |