head(1p)

PROLOG

Denna manualsida är en del av POSIX Programmer's Manual. Linux-implementationen av detta gränssnitt kan skilja sig åt; se motsvarande Linux-manualsida för detaljer om Linux-beteende. Gränssnittet kanske inte heller är implementerat på Linux.

NAMN

head — kopiera den första delen av filer

SYNOPSIS

head [-n antal] [fil...]

BESKRIVNING

Verktyget head ska kopiera sina indatafiler till standardutmatningen och avsluta utmatningen för varje fil vid en angiven punkt.

Kopieringen ska avslutas vid den punkt i varje indatafil som anges av flaggan -n antal. Flagargumentet antal ska räknas i enheter av rader.

FLAGGOR

Verktyget head ska följa Base Definitions-volymen av POSIX.1-2017, avsnitt 12.2, Utility Syntax Guidelines.

Följande flagga ska stödjas:

-n antal

De första antal raderna i varje indatafil ska kopieras till standardutmatningen. Programmet ska säkerställa att flagargumentet antal är ett positivt decimalt heltal.

När en fil innehåller färre än antal rader ska hela filen kopieras till standardutmatningen. Detta ska inte vara ett fel.

Om inga flaggor anges ska head bete sig som om -n 10 hade angetts.

OPERANDER

Följande operand ska stödjas:

fil

En sökväg till en indatafil. Om inga fil-operander anges ska standardindata användas.

STDIN

Standardindata ska användas om inga fil-operander anges, och ska användas om en fil-operand är - och implementationen behandlar - som standardindata. I annat fall ska standardindata inte användas. Se avsnittet INDATAFILER.

INDATAFILER

Indatafiler ska vara textfiler, men radlängden är inte begränsad till {LINE_MAX} byte.

MILJÖVARIABLER

Följande miljövariabler ska påverka körningen av head:

LANG

Ger ett standardvärde för internationaliseringsvariabler som är osatta eller tomma. Se Base Definitions-volymen av POSIX.1-2017, avsnitt 8.2, Internationalization Variables, för prioritetsordningen mellan internationaliseringsvariabler som används för att bestämma värdena för lokalkategorier.

LC_ALL

Om den är satt till ett icke-tomt strängvärde, åsidosätter den värdena för alla andra internationaliseringsvariabler.

LC_CTYPE

Bestämmer lokalen för tolkning av sekvenser av byte med textdata som tecken, till exempel enkelbyte- i motsats till flerbytetecken i argument och indatafiler.

LC_MESSAGES

Bestämmer den lokal som ska användas för att påverka format och innehåll i diagnostiska meddelanden som skrivs till standardfel.

NLSPATH

Bestämmer platsen för meddelandekataloger för behandling av LC_MESSAGES.

ASYNKRONA HÄNDELSER

Standard.

STDOUT

Standardutmatningen ska innehålla angivna delar av indatafilerna.

Om flera fil-operander anges ska head föregå utmatningen för varje fil med rubriken:

"\n==> %s <==\n", <sökväg>

förutom att den första rubriken som skrivs inte ska innehålla den inledande radbrytningen.

STDERR

Standardfel ska endast användas för diagnostiska meddelanden.

UTDATAFILER

Inga.

UTÖKAD BESKRIVNING

Ingen.

SLUTSTATUS

Följande slutvärden ska returneras:

0

Slutförd utan fel.

> 0

Ett fel inträffade.

FÖLJDER AV FEL

Standard.

Följande avsnitt är informativa.

PROGRAMANVÄNDNING

När head används för att behandla sökvägar rekommenderas att LC_ALL, eller åtminstone LC_CTYPE och LC_COLLATE, sätts till POSIX eller C i miljön. Detta eftersom sökvägar kan innehålla bytesekvenser som inte bildar giltiga tecken i vissa lokaler. I sådana fall vore verktygets beteende odefinierat. I POSIX-lokalen är varje byte ett giltigt enkelbytetecken, och därför undviks detta problem.

EXEMPEL

För att skriva de första tio raderna av alla filer, utom de som börjar med punkt, i katalogen:

head -- *

BAKGRUND

Även om det är möjligt att simulera head med sed 10q för en enda fil, beslutade standardutvecklarna att populariteten hos head på historiska BSD-system motiverade att det inkluderades tillsammans med tail.

POSIX.1-2008-versionen av head följer Utility Syntax Guidelines. Flaggan -n lades till i detta nya gränssnitt så att head och tail skulle vara mer logiskt relaterade. Tidigare versioner av denna standard tillät en flagga av formen -antal. Denna form specificeras inte längre av POSIX.1-2008 men kan finnas i vissa implementationer.

Det finns ingen -c-flagga, som det gör i tail, eftersom detta inte är historisk praxis och eftersom andra verktyg i denna volym av POSIX.1-2017 tillhandahåller liknande funktionalitet.

FRAMTIDA RIKTNINGAR

Inga.

SE ÄVEN

sed(1p), tail(1p)

Base Definitions-volymen av POSIX.1-2017, kapitel 8, Environment Variables, avsnitt 12.2, Utility Syntax Guidelines

COPYRIGHT

Delar av denna text är återgivna och reproducerade i elektronisk form från IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. Vid eventuell avvikelse mellan denna version och den ursprungliga IEEE- och The Open Group-standarden är den ursprungliga standarden det avgörande dokumentet. Den ursprungliga standarden kan hämtas online på:

http://www.opengroup.org/unix/online.html

Eventuella typografiska fel eller formateringsfel som förekommer på denna sida har troligen införts vid konverteringen av källfilerna till manualsidesformat. För att rapportera sådana fel, se:

https://www.kernel.org/doc/man-pages/reporting_bugs.html

IEEE/The Open Group 2017 HEAD(1P)

Sidor som hänvisar till denna sida

• tail(1p)

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/head.1p.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorservice som har sponsrat Linux.se med webbhotell.