'\" t
.\"     Title: scols-filter
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-21
.\"    Manual: Filformat och konventioner
.\"    Source: util-linux 2.42.4
.\"  Language: English
.\"
.TH "SCOLS\-FILTER" "5" "2026-09-21" "util\-linux 2.42.4" "Filformat och konventioner"
.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 "NAMN"
scols-filter \- syntax för libsmartcols filteruttryck
.SH "SYNTAX"
.sp
.if n .RS 4
.nf
.fam C
expr: param
      | ( expr )
      | expr && expr | expr AND expr
      | expr || expr | expr OR expr
      | !expr\&        | NOT expr
      | expr == expr | expr EQ expr
      | expr != expr | expr NE expr
      | expr >= expr | expr GE expr
      | expr <= expr | expr LE expr
      | expr >\&  expr | expr GT expr
      | expr <\&  expr | expr LT expr
      | expr =~ string
      | expr !~ string

param: integer
      | float
      | string
      | boolean
      | holder

integer: [0\-9]*
      | [0\-9]*[KMGTPEZY]
      | [0\-9]*[KMGTPEZY]iB

float: integer.integer

boolean: "true" | "false" | "TRUE" | "FALSE"

string: "[^\(rsn\(rs"]*" | \*(Aq[^\(rsn\(rs\*(Aq]*\*(Aq

holder: [a\-zA\-Z][a\-zA\-Z_.%:/\(rs\-0\-9]*
.fam
.fi
.if n .RE
.SH "BESKRIVNING"
.sp
Filteruttrycket kan användas av program som är länkade med libsmartcols för att filtrera utdata. Programmet kan använda filtret innan det samlar in alla data för utmatningen för att minska resursåtgången och förbättra prestandan. Detta gör scols\-filter effektivare än \fBgrep\fP(1) på hela utmatningen. Till exempel
.sp
.if n .RS 4
.nf
.fam C
 lsblk \-\-output NAME,LABEL,FSTYPE \-\-filter \*(AqNAME=="sda1"\*(Aq
.fam
.fi
.if n .RE
.sp
hjälper \fBlsblk\fP(1) att endast läsa LABEL från udevd eller libblkid för enheten sda1, i stället för för alla blockenheter.
.sp
Filtret kan också användas för kolumner som inte används i utdata.
.SH "SYNTAXANTECKNINGAR"
.sp
Ett uttryck består av holders, params och operatorer.
.sp
Den enda typ av \f(CRholder\fP som för närvarande stöds är kolumnnamn. Namnet ska användas utan citattecken. Före utvärderingen mappar programmet kolumnnamnen i uttrycket till utdatatabellens kolumner och tilldelar hållaren kolumnens datatyp. Standardtypen är ”string”.
.sp
\f(CRparam\fP används för att representera ett värde direkt. De datatyper som för närvarande stöds är integer, float, string och boolean.
.sp
En operator arbetar med en eller två operander och förväntar sig vissa datatyper för dem. En oväntad datatyp orsakar ett syntaxfel. Biblioteket kan konvertera mellan datatyper. Den typ som anges av \f(CRparam\fP föredras alltid. I uttryck med både heltal och flyttal föredras flyttal.
.sp
Operatorer som tar två operander är \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. Alfabetiskt namngivna operatorer har C\-språksanpassade alias: \f(CR&&\fP, \f(CR||\fP, \f(CR==\fP, \f(CR!=\fP, \f(CR<\fP, \f(CR\(lA\fP, \f(CR>=\fP och \f(CR>\fP.
.sp
\f(CR!\fP är den enda operatorn som tar en operand. Om ingen operator anges är uttrycket sant om param eller holder inte är tomma. Till exempel returnerar \fB\-\-filter NAME\fP rader där kolumnen NAME inte är tom.
.sp
\f(CR=~\fP och \f(CR!~\fP används för matchning med reguljära uttryck. Resultatet är sant om en sträng på höger sida matchar (eller inte matchar, för \f(CR!~\fP) ett reguljärt uttryck på vänster sida. Operanden på höger sida måste vara en strängliteral.
.sp
Prioriteterna inom operatorer är \f(CRor\fP, \f(CRand\fP, och \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 "BEGRÄNSNINGAR"
.sp
När det gäller typvärdena \f(CRfloat\fP och \f(CRinteger\fP stöder filtermotorn endast icke\-negativa tal. \f(CRinteger\fP är ett osignerat 64\-bitars tal och \f(CRfloat\fP är en lång dubbel. Heltal kan följas av de multiplikativa suffixen KiB, GiB, TiB, PiB, EiB, ZiB och YiB (iB är valfritt, t.ex. har "K" samma betydelse som "KiB").
.SH "UPPHOVSPERSONER"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.sp
Baserat på originalimplementationen från \c
.MTO "yamato\(atredhat.com" "Masatake YAMATO" "."
.SH "FELRAPPORTERING"
.sp
För felrapporter, använd \c
.URL "https://github.com/util\-linux/util\-linux/issues" "felhanteraren" "."
.SH "TILLGÄNGLIGHET"
.sp
Biblioteket \fBlibsmartcols\fP är en del av paketet util\-linux sedan version 2.25. Det kan laddas ner från \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."