KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

ftell — C23-streamfunctie

`ftell(stream)` uit `<stdio.h>` verkrijgt de huidige bestandspositie. Voor een binaire stream telt het resultaat tekens vanaf het begin; voor een tekststream is het ondoorzichtige informatie die met `SEEK_SET` aan `fseek` kan worden gegeven om dezelfde positie te herstellen.

Versie: C23

Syntax

long int ftell(FILE *stream);

ftell(stream) uit <stdio.h> verkrijgt de huidige bestandspositie. Voor een binaire stream telt het resultaat tekens vanaf het begin; voor een tekststream is het ondoorzichtige informatie die met SEEK_SET aan fseek kan worden gegeven om dezelfde positie te herstellen.

Het voorbeeld schrijft vijf bytes ABCDE naar een binair tijdelijk bestand, zodat de eerste ftell 5 geeft. Na fseek(..., 2L, SEEK_SET) geeft de tweede 2 en leest de volgende bewerking C; het programma print 5 2 C.

Het verschil tussen twee waarden voor een tekststream hoeft niet het aantal gelezen of geschreven tekens te meten. Bij een fout retourneert de functie -1L en bewaart een positieve implementatieafhankelijke waarde in errno; test die sentinel altijd. Een grote positie past mogelijk niet in long; gebruik fgetpos en fsetpos als ook multibytetoestand behouden moet blijven.

Voorbeelden

#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fwrite("ABCDE",1,5,stream)!=5){fclose(stream);return 1;}long end=ftell(stream);if(end<0||fseek(stream,2L,SEEK_SET)!=0){fclose(stream);return 1;}long middle=ftell(stream);int character=fgetc(stream);printf("%ld %ld %c\n",end,middle,character);return fclose(stream)==0?0:1;}

Resultaat

5 2 C

Het voorbeeld schrijft vijf bytes `ABCDE` naar een binair tijdelijk bestand, zodat de eerste `ftell` `5` geeft. Na `fseek(..., 2L, SEEK_SET)` geeft de tweede `2` en leest de volgende bewerking `C`; het programma print `5 2 C`.

Bronnen