'\" t
.\"     Title: scols-filter
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: Formaty plików i konwencje
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "SCOLS\-FILTER" "5" "2026-09-02" "util\-linux 2.42.3" "Formaty plików i konwencje"
.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"
scols-filter \- składnia wyrażeń filtrów libsmartcols
.SH "SKŁADNIA"
.sp
.if n .RS 4
.nf
.fam C
wyraż: param
      | ( wyraż )
      | wyraż && wyraż | wyraż AND wyraż
      | wyraż || wyraż | wyraż OR wyraż
      | !wyraż\&         | NOT wyraż
      | wyraż == wyraż | wyraż EQ wyraż
      | wyraż != wyraż | wyraż NE wyraż
      | wyraż >= wyraż | wyraż GE wyraż
      | wyraż <= wyraż | wyraż LE wyraż
      | wyraż >\&  wyraż | wyraż GT wyraż
      | wyraż <\&  wyraż | wyraż LT wyraż
      | wyraż =~ łańcuch
      | wyraż !~ łańcuch

param: l\-całk
      | l\-zmprz
      | łańcuch
      | wart\-log
      | uchwyt

l\-całk: [0\-9]*
      | [0\-9]*[KMGTPEZY]
      | [0\-9]*[KMGTPEZY]iB

l\-zmprz: l\-całk.l\-całk

wart\-log: "true" | "false" | "TRUE" | "FALSE"

łańcuch: "[^\(rsn\(rs"]*" | \*(Aq[^\(rsn\(rs\*(Aq]*\*(Aq

uchwyt: [a\-zA\-Z][a\-zA\-Z_.%:/\(rs\-0\-9]*
.fam
.fi
.if n .RE
.SH "OPIS"
.sp
Wyrażenie filtra można stosować w aplikacji połączonej z libsmartcols do filtrowania danych wyjściowych. Aplikacja może zastosować filtry przed zebraniem wszystkich danych do wyjścia, aby zmniejszyć wykorzystanie zasobów i poprawić wydajność. Czyni to filtr scols efektywniejszym od korzystania z programu \fBgrep\fP(1) na pełnym wyjściu. Na przykład
.sp
.if n .RS 4
.nf
.fam C
 lsblk \-\-output NAME,LABEL,FSTYPE \-\-filter \*(AqNAME=="sda1"\*(Aq
.fam
.fi
.if n .RE
.sp
pomaga \fBlsblk\fP(1) nie odczytywać etykiet LABEL ze wszystkich urządzeń blokowych z udevd lub libblkid, lecz odczytać je jedynie dla urządzenia sda1.
.sp
Filtr można też stosować wobec kolumn, których nie używa się w wyjściu.
.SH "UWAGI DOTYCZĄCE SKŁADNI"
.sp
Wyrażenie składa się z uchwytów, param(etrów) i operatorów.
.sp
Aktualnie obsługiwanym typem `uchwyt`u jest jedynie nazwa kolumny. Nazwę trzeba podać bez cudzysłowów. Przed nadaniem wartości, aplikacji przypisuje nazwy kolumn w danym wyrażeniu do kolumn wyjściowych tabeli i przypisuje typ danych kolumny do uchwytu. Domyślnym typem jest "łańcuch".
.sp
\f(CRparam\fP służy do bezpośredniej reprezentacji wartości. Obecnie obsługiwane są liczby całkowite, liczby zmiennoprzecinkowe, łańcuchy i wartości logiczne.
.sp
Operator działa z jednym lub dwoma operandami. Operator oczekuje określonego typu danych swych operandów. Przekazanie nieoczekiwanego typu danych operatorowi spowoduje wystąpienie błędu składni. Biblioteka może rzutować pomiędzy typami danych, preferowanym jest zawsze typ określony przez \f(CRparam\fP, a w przypadku wyrażenia z liczbą oraz liczbą zmiennoprzecinkową, preferowana jest liczba zmiennoprzecinkowa.
.sp
Operatorami przyjmującymi dwa operandy są: \f(CRand\fP, \f(CRor\fP, \f(CReq\fP, \f(CRne\fP, \f(CRle\fP, \f(CRlt\fP, \f(CRge\fP, \f(CRgt\fP, \f(CR=~\fP, \f(CR!~\fP. Operatory nazwane alfabetycznie mają aliasy w stylu języka C: \f(CR&&\fP, \f(CR||\fP, \f(CR==\fP, \f(CR!=\fP, \f(CR<\fP, \f(CR\(lA\fP, \f(CR>=\fP i \f(CR>\fP.
.sp
\f(CR!\fP jest jedynym operatorem przyjmującym jeden operand. Jeśli nie poda się operatora, wyrażenie jest prawdziwe, gdy param(etr) lub uchwyt są niepuste. Na przykład \fB\-\-filter NAME\fP zwróci wiersze, gdzie NAME jest niepusta.
.sp
\f(CR=~\fP i \f(CR!~\fP służą do dopasowywania wyrażeń regularnych; jeśli łańcuch po prawej stronie zostanie dopasowany (albo nie zostanie dopasowany, w przypadku \f(CR!~\fP, do wyrażenia regularnego po lewej stronie), wynik jest prawdziwy. Prawa strona operandu musi być dosłownym łańcuchem.
.sp
Kolejność operatorów jest następująca: \f(CRor\fP, \f(CRand\fP oraz \f(CReq\fP, \f(CRne\fP, \f(CRle\fP, \f(CRgt\fP, \f(CRge\fP, \f(CR=~\fP, \f(CR!~\fP, \f(CRnot\fP.
.SH "OGRANICZENIA"
.sp
W wartościach typu \f(CRl\-zmprz\fP i \f(CRl\-całk\fP silnik filtra obsługuje jedynie liczby nieujemne. \f(CRl\-całk\fP jest 64\-bitową liczbą bez znaku, a \f(CRl\-zmprz\fP liczbą typu long double. Po \f(CRl\-całk\fP może występować jeden z przyrostków oznaczających wielokrotność: KiB, GiB, TiB, PiB, EiB, ZiB i YiB (cząstka "iB" jest opcjonalna, tzn. "K" ma takie samo znaczenie jak "KiB").
.SH "AUTORZY"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.sp
Na podstawie pierwotnej implementacji autorstwa \c
.MTO "yamato\(atredhat.com" "Masatake YAMATO" "."
.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
Biblioteka \fBlibsmartcols\fP jest częścią pakietu util\-linux od wersji 2.25. Można go pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."