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)

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

Для звітування щодо вад скористайтеся

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

Програма column є частиною пакунка util-linux, який можна отримати з