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)

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

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

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

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