COLUMN(1)

Команди користувача

COLUMN(1)

НАЗВА

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 -

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

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

2025-03-29

util-linux 2.41