Scroll to navigation

COLUMN(1) Команди користувача COLUMN(1)

НАЗВА

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

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

column [options] [file ...]

ОПИС

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

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

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

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

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

table

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

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

ПАРАМЕТРИ

Аргумент стовпці для параметрів --table-* - це розділений комами список назв стовпців, який визначається --table-columns, назвами, що визначаються --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) is possible to use to not restrict output width. This is recommended for example when output to the files rather than on terminal.

-d, --table-noheadings

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

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

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

-s, --separator рядок

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

-t, --table

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

-C, --table-column властивості

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

У поточній версії поточними підтримуваними атрибутами є такі:

name=рядок

Вказує назву стовпчика.

trunc

The column text can be truncated when necessary. The same as --table-truncate.

right

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

width=число

Specifies column width. The width is used as a hint only. The width is strictly followed only when strictwidth attribute is used too.

strictwidth

Strictly follow column width= setting.

noextreme

Specify columns where is possible to ignore unusually long cells. 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 поз

Визначає стовпець з ID рядка для створення звʼязку нащадок-родич.

-p, --tree-parent поз

Вказати стовпець з ID родича для створення звʼязку нащадок-родич.

-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 -

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

echo -e '1 0 A\n2 1 AA\n3 1 AB\n4 2 AAA\n5 2 AAB' | column --tree-id 1 --tree-parent 2 --tree 3
1  0  A
2  1  |-AA
4  2  | |-AAA
5  2  | `-AAB
3  1  `-AB

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

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/>.

2024-08-05 util-linux 2.40.2