> Linux Reviews > man >

lseek

herplaats lees/schrijf bestand-positie

lseek.2.man

1. lseek.2.man

Manpage of LSEEK

LSEEK

Section: Systeem aanroepen (2)
Updated: Januari 17, 1998
Index Return to Main Contents

NAAM

lseek - herplaats lees/schrijf bestand-positie

OVERZICHT

#include <sys/types.h>
#include <unistd.h>

off_t lseek(int bes_ind, off_t positie, int vanaf);

BESCHRIJVING

De lseek functie herplaatst de positie van de bestandindicator bes_ind naar het argument positie volgens de aanwijzing vanaf als volgt:

SEEK_SET: De positie wordt naar positie bytes gezet.
SEEK_CUR: De positie wordt naar de huidige plaats plus positie bytes gezet.
SEEK_END: De positie wordt naar de lengte van het bestand plus positie bytes gezet.

De lseek functie status toe dat de bestand positie verder dan het einde van het bestaande einde-van-bestand van het bestand wordt gezet. Als gegevens later op deze positie worden geschreven, geven navolgende lees opdrachten in het gat ge-Nulde bytes terug (totdat er daadwerkelijk gegevens in het gat worden geschreven).

TERUGGEEF WAARDE

Bij geslaagde afronding geeft lseek de opgeleverde plaats zoals gemeten in bytes van het begin van het bestand, terug. Anders wordt een waarde van (off_t)-1 teruggegeven, en errno wordt gezet om de fout duidelijk te maken.

FOUTEN

EBADF: {slechte*} bes_ind is geen open bestandindicator.
ESPIPE: bes_ind hoort bij een pijp, een socket, of een FIFO.
EINVAL: {ongeldig} Vanaf is geen juiste waarde.

VOLDOET AAN

SVr4, POSIX, BSD 4.3

BEPERKINGEN

Sommige apparaten zijn niet in status tot zoeken, en POSIX bepaald niet welke apparaten het moeten ondersteunen.

Linux-eigen beperkingen: lseek op een tty apparaat gebruiken geeft ESPIPE terug. Andere systemen geven het aantal geschreven letters, met gebruik van SEEK_SET om de teller te zetten. Sommige apparaten, zoals /dev/null veroorzaken de fout ESPIPE niet, maar geven een pointer terug met onbepaalde waarde.

OPMERKINGEN

Het gebruik van vanaf in dit document is niet goed Engels {zie Engelse manpage}, maar volgehouden voor historische redenen.

Bij het omzetten van oude code, vervang de waarde voor vanaf met de volgende macro's:

oud	nieuw
0	SEEK_SET
1	SEEK_CUR
2	SEEK_END
L_SET	SEEK_SET
L_INCR	SEEK_CUR
L_XTND	SEEK_END

SVR1-3 geeft "long" terug in plaats van "off_t", BSD geeft "int" terug.

ZIE

dup(2) {kopieer}, open(2) {open}, fseek(3) {zoek}

VERTALING

Alles wat tussen `{'..`}' staat is aanvullende vertaling, en hoort niet bij de originele handleiding. Deze handleiding uit manpages-dev 1.29 werd vertaald door JHBoersema. Email naar <manpages-nl@nl.linux.org>.

$Id: lseek.2,v 1.2 2001/12/20 22:38:36 joostvb Exp $

This document was created by man2html using the manual pages.
Time: 17:14:43 GMT, January 19, 2012