Man page - column(1)

Packages contains this manual

Package: bsdextrautils
apt-get install bsdextrautils

Manuals in package:

Documentations in package:

bsdextrautils

Available languages:

en ja uk ro

Manual

COLUMN

НАЗВА
КОРОТКИЙ ОПИС
ОПИС
ПАРАМЕТРИ
СЕРЕДОВИЩЕ
ЖУРНАЛ
ВАДИ
ПРИКЛАДИ
ТАКОЖ ПЕРЕГЛЯНЬТЕ
ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ
ДОСТУП ДО ПРОГРАМИ

НАЗВА

column - стовпчасті списки

КОРОТКИЙ ОПИС

column [параметри] [ файл ...]

ОПИС

Утиліта column форматує введені дані в кілька стовпців. Підтримує три режими:

стовпці знаходяться перед рядками

Це типовий режим (потрібен для зворотної сумісності).

розміщувати рядки перед стовпцями

Цей режим вмикається параметрами -x, --fillrows

створити таблицю

Визначає кількість стовпців, які містять вхідні дані і створює таблицю. Цей режим вмикається параметрами -t, --table . Виведення вирівнюється до ширини терміналу в інтерактивному режимі і до 80 знаків у неінтерактивному режимі (детальніше дивіться --output-width ). Нетипового форматування можна досягти шляхом використання різноманітних параметрів --table-\ *.

Вхідні дані отримуються з файлу або в іншому випадку зі стандартного буфера вводу. Порожні рядки ігноруються, а всі неправильні багатобайтові послідовності перекодовуються згідно умов x<hex>.

ПАРАМЕТРИ

Аргумент стовпці для параметрів --table-\ * - це розділений комами список наданих користувачем назв стовпців, визначених за допомогою --table-column назва1 , назва2 ,... , індексів стовпців, за вхідними даними, починаючи з 1, або назв, які визначено атрибутом --table-columns . Можна змішувати назви і індекси. Особливий заповнювач «0» (наприклад, -R0) можна використовувати для визначення всіх стовпців, «-1» (наприклад, -R -1) для визначення останнього видимого стовпчика. Можна використовувати діапазони, наприклад, «1-5», при посиланні на стовпчики за індексами.

-J, --json

Використовуйте формат виведення JSON для друку таблиць, параметр B←-table-columns> є обовʼязковим і --table-name рекомендується.

-c, --output-width ширина

Виведення форматується із шириною, вказаною як кількість знаків. Оригінальна назва цього параметра - --columns ; ця назва вийшла із вжитку починаючи від v2.30. Зверніть увагу, що вхідні дані довші за ширину типово не обрізаються. Типовим значенням є ширина терміналу і 80 знаків у неінтерактивному режимі. Заголовки стовпців ніколи не обрізаються.

The placeholder "unlimited" (or 0) can be used to prevent restricting output width. This is recommended for example when redirecting output to a file.

-d, --table-noheadings

Не друкувати заголовок. Цей параметр дозволяє використовувати надані користувачем назви стовпців у командному рядку, але зберігає заголовок прихованим під час виведення таблиці.

-o, --output-separator рядок

Роздільник стовпців для виведення таблицею (типово два пробіли).

-s, --separator рядок

Можливі роздільники елементів виведення (типово пробіл).

-S, --use-spaces число

When not in table mode, use whitespaces instead of tabulators to align the columns. This option specifies the minimum number of whitespaces that separate two columns.

-t, --table

Визначає кількість стовпців із вхідними даними і створює таблицю. Типово стовпці розділяються пробілами або знаком вказаним у параметрі B←-output-separator>. Табличне виведення зручне для красивого відображення.

-C, --table-column атрибути

Define a column with a comma separated list of column attributes. This option can be used more than once, every use defines a single column. Attributes replace some of --table- options. For example, --table-column name=FOO,right defines a column where text is aligned to right. The option is mutually exclusive to --table-columns .

Підтримувані атрибути:

name=рядок

Назва стовпчика.

trunc

Обрізати, якщо потрібно, текст стовпчика. Те саме, що і --table-truncate .

right

Вирівнює текст праворуч. Те саме, що і --table-right .

width=число

Column width. It’s used only as a hint. To force it, specify the strictwidth attribute as well.

strictwidth

Strictly follow column width= setting.

noextreme

Ignore unusually long cell width. See --table-noextreme for more details.

wrap

Дозволити використання багаторядкової комірки для довгих фрагментів тексту, якщо потрібно. Див. докладніший опис у --table-wrap .

hide

Не виводити стовпчик. Див. докладніший опис у --table-hide .

json=тип

Визначити тип стовпчика для виведення до JSON. Підтримуваними типами є string, number та boolean.

-N, --table-columns назви

Визначає розділений комами список назв як назви стовпців. Назви використовуються як заголовок таблиці або для адресування стовпців в аргументах параметрів. Див. також --table-column .

-l, --table-columns-limit число

Визначає максимальну кількість вхідних стовпців. Якщо обмеження менше ніж кількість стовпців у вхідних даних, то останній стовпець міститиме решту даних рядка.

-R, --table-right стовпчики

Вирівнює текст праворуч у вказаних стовпцях.

-T, --table-truncate стовпчики

Визначає стовпці, у яких дані за необхідності можуть скорочуватися, в іншому випадку дуже довгі записи таблиці можуть друкуватися у кілька рядків.

-E, --table-noextreme стовпчики

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

Цей параметр типово використовують для останнього видимого стовпця.

-e, --table-header-repeat

Друкувати рядок заголовку для кожної сторінки.

-W, --table-wrap позиція

Визначає стовпці, в яких за необхідності можна використовувати багаторядкові комірки для довгого тексту.

-H, --table-hide стовпчики

Не друкувати вказані стовпці. Особливий заповнювач «-» може використовуватися для приховування всіх неназваних стовпців (див. --table-columns ).

-O, --table-order стовпчики

Вказати порядок виведення стовпців.

-n, --table-name назва

Визначає назву таблиці для виведення JSON. Типово «table».

-m, --table-maxout

Fill all available space on output.

-L, --keep-empty-lines

Зберігає порожні рядки у вхідних даних. Типово, порожні рядки ігноруються. Оригінальна назва цього параметра - --table-empty-lines , але станом на зараз виходить із вжитку, оскільки створює хибне враження, що застосовується лише до режиму таблиці.

-r, --tree поз

Вказує стовпцям використовувати деревоподібне виведення. Зверніть увагу, що кругові залежності та інші аномалії у звʼязках між нащадками і родичами тихо ігноруються.

-i, --tree-id поз

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

-p, --tree-parent поз

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

-x, --fillrows

Розміщувати рядки перед стовпцями.

-h , --help

Вивести текст довідки і завершити роботу.

-V , --version

Показати дані щодо версії і завершити роботу.

СЕРЕДОВИЩЕ

Змінна середовища COLUMNS використовується для визначення розміру екрана, якщо інша інформація відсутня.

ЖУРНАЛ

Команда column появилася в 4.3BSD-Reno.

ВАДИ

Версія 2.23 змінює параметр -s , який був не точним, наприклад:

printf "a:b:c\n1::3\n" | column -t -s ':'

Застаріле виведення:

a b c
1 3

Нове виведення (з util-linux 2.23):

a b c
1 3

Історичні версії цього інструменту вказували, що типово «рядки знаходяться перед стовпцями», а параметр -x може обертати цей порядок. Це формулювання не відображало реальну поведінку і з того часу було виправлено (дивіться вище). Інші реалізації column можуть продовжувати використовувати стару документацію, але поведінка має бути ідентична в будь-якому випадку.

ПРИКЛАДИ

Вивести fstab із рядком заголовка і вирівняти числа праворуч:

sed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE,OPTIONS,FREQ,PASS --table-right FREQ,PASS

Вивести fstab і сховати неназвані стовпці:

sed 's/#.*//' /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE --table-hide -

Надрукувати дерево:

ТАКОЖ ПЕРЕГЛЯНЬТЕ

colrm (1), ls (1), paste (1), sort (1)

ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ

Для звітування щодо вад скористайтеся системою стеження за вадами <https://github.com/util-linux/util-linux/issues>

ДОСТУП ДО ПРОГРАМИ

Програма column є частиною пакунка util-linux, який можна отримати з архіву ядра Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.