'\" t
.\"     Title: column
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-09-22
.\"    Manual: Polecenia użytkownika
.\"    Source: util-linux 2.41.2
.\"  Language: English
.\"
.TH "COLUMN" "1" "2025-09-22" "util\-linux 2.41.2" "Polecenia użytkownika"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAZWA"
column \- tworzy kolumny z list
.SH "SKŁADNIA"
.sp
\fBcolumn\fP [opcje] [\fIplik\fP ...]
.SH "OPIS"
.sp
Narzędzie \fBcolumn\fP formatuje swoje wejście tworząc kilka kolumn. Obsługuje trzy tryby:
.sp
\fBwypełnia kolumny przed wierszami\fP
.RS 4
Jest to domyślny tryb (wymagany ze względu na kompatybilność wsteczną).
.RE
.sp
\fBwypełnia wiersze przed kolumnami\fP
.RS 4
Ten tryb włącza się opcją \fB\-x, \-\-fillrows\fP.
.RE
.sp
\fBtworzy tabelę\fP
.RS 4
Ustala liczbę kolumn jaką zawiera wejście i tworzy tabelę. Ten tryb włącza się opcją \fB\-t, \-\-table\fP. Wyjście jest wyrównywane do szerokości terminala w trybie interaktywnym i do 80 kolumn w trybie nieinteraktywnym (więcej szczegółów w opisie opcji \fB\-\-output\-width\fP). Tabelę można dodatkowo sformatować poszczególnymi opcjami \fB\-\-table\-\(rs\fP*.
.RE
.sp
Wejście jest przyjmowane z \fIpliku\fP lub ze standardowego wejścia. Puste wiersze są ignorowane, a wszelkie nieprawidłowe sekwencje wielobajtowe są kodowane za pomocą konwencji x<hex> (liczby szesnastkowej).
.SH "OPCJE"
.sp
Argument \fIkolumny\fP w przypadku opcji \fB\-\-table\-\(rs\fP* jest listą nadanych przez użytkownika nazw indeksów kolumn, rozdzielonych przecinkiem, definiowanych jako \fB\-\-table\-column \fInazwa1\fP,\fInazwa2\fP,...\fP, w kolejności w jakiej pojawiają się na wejściu, poczynając od 1, albo też nazw, definiowanych przez atrybut \fB\-\-table\-columns\fP. Można mieszać nazwy i indeksy. Aby podać wszystkie kolumny można skorzystać ze specjalnego symbolu zastępczego "0" (np. \-R0), a aby określić ostatnią widoczną kolumnę, można skorzystać z symbolu "\-1" (np. \-R \-1). Przy adresowaniu kolumn indeksami, można korzystać z zakresów takich jak "1\-5".
.sp
\fB\-J, \-\-json\fP
.RS 4
Używa formatu wyjściowego JSON do wypisania tabeli. Wymagana jest opcja \fB\-\-table\-columns\fP, a opcja \fB\-\-table\-name\fP jest zalecana.
.RE
.sp
\fB\-c, \-\-output\-width\fP \fIszerokość\fP
.RS 4
Wyjście jest formatowane do szerokości określonej liczbą znaków. Pierwotna nazwa tej opcji brzmiała \fB\-\-columns\fP; nazwa ta jest przestarzała od wersji v2.30. Proszę zauważyć, że wejście dłuższe niż \fIszerokość\fP nie jest domyślnie przycinane. Domyślna jest szerokość terminala lub 80 kolumn w trybie nieinteraktywnym. Nagłówki kolumn nigdy nie są przycinane.
.sp
Aby zapobiec ograniczaniu szerokości wyjścia, można użyć symbolu zastępczy "unlimited" (lub 0). Zaleca się takie postępowanie np. przy przekierowywaniu wyjścia do pliku.
.RE
.sp
\fB\-d, \-\-table\-noheadings\fP
.RS 4
Pomija wypisywanie nagłówka. Opcja pozwala na korzystanie z nazw nadanych przez użytkownika w wierszu poleceń, ale ukrywa nagłówek przy wypisywaniu tabeli.
.RE
.sp
\fB\-o, \-\-output\-separator\fP \fIłańcuch\fP
.RS 4
Separator kolumn w wyjściu tabeli (domyślnie to dwie spacje).
.RE
.sp
\fB\-s, \-\-separator\fP \fIseparatory\fP
.RS 4
Możliwe separatory pozycji wejściowych (domyślnie to spacja).
.RE
.sp
\fB\-S, \-\-use\-spaces\fP \fIliczba\fP
.RS 4
W trybie innym niż tabeli, korzysta ze spacji zamiast tabulatorów do wyrównania kolumn. Opcja określa minimalną liczbę spacji, która oddziela dwie kolumny.
.RE
.sp
\fB\-t, \-\-table\fP
.RS 4
Ustala liczbę kolumn jaką zawiera wejście i tworzy tabelę. Kolumny są domyślnie rozdzielone spacją lub znakami podanymi opcją \fB\-\-output\-separator\fP. Wyjście tabelaryczne jest przydatne do ładnego drukowania (pretty\-printing).
.RE
.sp
\fB\-C, \-\-table\-column\fP \fIatrybuty\fP
.RS 4
Definiuje kolumnę z jej listą atrybutów (separatorem jest przecinek). Opcji można użyć wielokrotnie, każda zdefiniuje pojedynczą kolumnę. Atrybuty zastępują niektóre z opcji \fB\-\-table\-\fP. Przykładowo \fB\-\-table\-column name=FOO,right\fP definiuje kolumnę, której tekst jest wyrównywany do prawej strony. Opcja wzajemnie wyklucza się z \fB\-\-table\-columns\fP.
.sp
Obsługiwane są następujące atrybuty:
.sp
\fBname=łańcuch\fP
.RS 4
Nazwa kolumny.
.RE
.sp
\fBtrunc\fP
.RS 4
Przycina tekst kolumny, jeśli to konieczne. Równoważne \fB\-\-table\-truncate\fP.
.RE
.sp
\fBright\fP
.RS 4
Wyrównuje tekst do prawej strony. Równoważne \fB\-\-table\-right\fP.
.RE
.sp
\fBwidth=liczba\fP
.RS 4
Szerokość kolumny. Jest to tylko wskazówka. Aby ją wymusić, należy zdefiniować również atrybut \fBstrictwidth\fP.
.RE
.sp
\fBstrictwidth\fP
.RS 4
Interpretuje ściśle ustawienie szerokości kolumny \fBwidth=\fP.
.RE
.sp
\fBnoextreme\fP
.RS 4
Ignoruje nadzwyczaj długą szerokość komórki. Więcej szczegółów w opisie opcji \fB\-\-table\-noextreme\fP.
.RE
.sp
\fBwrap\fP
.RS 4
Pozwala na korzystanie z wielowierszowej komórki dla długich tekstów, jeśli to konieczne. Więcej szczegółów w opisie opcji \fB\-\-table\-wrap\fP.
.RE
.sp
\fBhide\fP
.RS 4
Nie wypisuje kolumny. Więcej szczegółów w opisie opcji \fB\-\-table\-hide\fP.
.RE
.sp
\fBjson=typ\fP
.RS 4
Definiuje typ wyjście JSON. Obsługiwanymi typami są: string (łańcuch), number (liczba) i boolean (wartość logiczna).
.RE
.RE
.sp
\fB\-N, \-\-table\-columns\fP \fInazwy\fP
.RS 4
Określa nazwy kolumn za pomocą listy (separatorem jest przecinek). Nazwy są stosowane w nagłówku tabeli oraz do wskazywania kolumn w argumentach opcji. Zob. też \fB\-\-table\-column\fP.
.RE
.sp
\fB\-l, \-\-table\-columns\-limit\fP \fIliczba\fP
.RS 4
Określa maksymalną liczbę kolumn wejściowych. Ostatnia kolumna będzie zawierała wszystkie pozostałe dane, jeśli limit jest mniejszy niż liczba kolumn w danych wejściowych.
.RE
.sp
\fB\-R, \-\-table\-right\fP \fIkolumny\fP
.RS 4
Wyrównuje tekst do prawej strony w podanych kolumnach.
.RE
.sp
\fB\-T, \-\-table\-truncate\fP \fIkolumny\fP
.RS 4
Określa kolumny, w których tekst może zostać przycięty gdy to konieczne, w przeciwnym przypadku bardzo długie wpisy w tabeli mogą zajmować wiele wierszy.
.RE
.sp
\fB\-E, \-\-table\-noextreme\fP \fIkolumny\fP
.RS 4
Określa kolumny, w których można zignorować bardzo długie (dłuższe niż przeciętne) komórki przy obliczaniu szerokości kolumny. Opcja ta wpływa na obliczanie szerokości i formatowania tabeli, natomiast nie ma wpływu na wypisywany tekst.
.sp
Opcja domyślnie jest stosowana do ostatniej widocznej kolumny.
.RE
.sp
\fB\-e, \-\-table\-header\-repeat\fP
.RS 4
Wypisuje wiersz nagłówka na każdej stronie.
.RE
.sp
\fB\-W, \-\-table\-wrap\fP \fIkolumny\fP
.RS 4
Określa kolumny, w których dla długiego tekstu mogą być użyte komórki wielowierszowe.
.RE
.sp
\fB\-H, \-\-table\-hide\fP \fIkolumny\fP
.RS 4
Nie wypisuje podanych kolumn. Specjalny symbol "\-" służy do ukrycie wszystkich nienazwanych kolumn (zob. \fB\-\-table\-columns\fP).
.RE
.sp
\fB\-O, \-\-table\-order\fP \fIkolumny\fP
.RS 4
Określa kolejność kolumn wyjściowych.
.RE
.sp
\fB\-n, \-\-table\-name\fP \fInazwa\fP
.RS 4
Określa nazwę tabeli, użytą w wyjściu JSON. Domyślną jest "table".
.RE
.sp
\fB\-m, \-\-table\-maxout\fP
.RS 4
Wypełnia całe dostępne miejsce na wyjściu.
.RE
.sp
\fB\-L, \-\-keep\-empty\-lines\fP
.RS 4
Zachowuje wiersze składające się wyłącznie z białych znaków w wejściu. Domyślnie całkowicie puste wiersze są ignorowane. Pierwotna nazwa tej opcji brzmiała \fB\-\-table\-empty\-lines\fP, lecz została uznana za przestarzałą, ponieważ sprawiała wrażenie, że działała tylko w trybie tabelarycznym.
.RE
.sp
\fB\-r, \-\-tree\fP \fIkolumna\fP
.RS 4
Określa kolumnę do stosowania w trybie drzewiastym. Proszę zauważyć, że zapętlone zależności oraz inne problemy w relacji dziecko\-rodzic są po cichu ignorowane.
.RE
.sp
\fB\-i, \-\-tree\-id\fP \fIkolumna\fP
.RS 4
Określa kolumnę zawierającą unikalny identyfikator dziecka każdego wiersza, dla relacji dziecko\-rodzic.
.RE
.sp
\fB\-p, \-\-tree\-parent\fP \fIkolumna\fP
.RS 4
Określa kolumnę zawierającą identyfikator rodzica każdego wiersza, dla relacji dziecko\-rodzic.
.RE
.sp
\fB\-x, \-\-fillrows\fP
.RS 4
Wypełnia wiersze przed wypełnianiem kolumn.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "ŚRODOWISKO"
.sp
Zmienna środowiskowa \fBCOLUMNS\fP służy do określenia rozmiaru ekranu, jeśli inne informacje nie są dostępne.
.SH "HISTORIA"
.sp
Polecenie \fBcolumn\fP pojawiło się w 4.3BSD\-Reno.
.SH "USTERKI"
.sp
Wersja 2.23 zmieniła działanie opcji \fB\-s\fP na niezachłanne np.:
.sp
.if n .RS 4
.nf
.fam C
printf "a:b:c\(rsn1::3\(rsn" | column \-t \-s \*(Aq:\*(Aq
.fam
.fi
.if n .RE
.sp
Stare wyjście:
.sp
.if n .RS 4
.nf
.fam C
a\&  b\&  c
1\&  3
.fam
.fi
.if n .RE
.sp
Obecne wyjście (od util\-linux 2.23):
.sp
.if n .RS 4
.nf
.fam C
a\&  b\&  c
1\&     3
.fam
.fi
.if n .RE
.sp
Historyczne wersje narzędzie wskazywały, że domyślnie "wiersze są wypełniane przed kolumnami", a opcja \fB\-x\fP to odwraca. Takie sformułowanie nie było jednak zgodne z faktycznym zachowaniem, dlatego zostało poprawione (zob. wyżej). Inne implementacje \fBcolumn\fP mogą wciąż korzystać ze starszej dokumentacji, lecz ich zachowanie powinno być identyczne.
.SH "PRZYKŁADY"
.sp
Wypisuje fstab z wierszem nagłówka oraz wyrównuje liczby do prawej strony:
.sp
.if n .RS 4
.nf
.fam C
sed \*(Aqs/#.*//\*(Aq /etc/fstab | column \-\-table \-\-table\-columns SOURCE,TARGET,TYPE,OPTIONS,FREQ,PASS \-\-table\-right FREQ,PASS
.fam
.fi
.if n .RE
.sp
Wypisuje fstab i ukrywa nienazwane kolumny:
.sp
.if n .RS 4
.nf
.fam C
sed \*(Aqs/#.*//\*(Aq /etc/fstab | column \-\-table \-\-table\-columns SOURCE,TARGET,TYPE \-\-table\-hide \-
.fam
.fi
.if n .RE
.sp
Wypisuje drzewo:
.sp
.if n .RS 4
.nf
.fam C
echo \-e \*(Aq1 0 A\(rsn2 1 AA\(rsn3 1 AB\(rsn4 2 AAA\(rsn5 2 AAB\*(Aq | column \-\-tree\-id 1 \-\-tree\-parent 2 \-\-tree 3
1\&  0\&  A
2\&  1\&  |\-AA
4\&  2\&  | |\-AAA
5\&  2\&  | `\-AAB
3\&  1\&  `\-AB
.fam
.fi
.if n .RE
.SH "ZOBACZ TAKŻE"
.sp
\fBcolrm\fP(1), \fBls\fP(1), \fBpaste\fP(1), \fBsort\fP(1)
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBcolumn\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."