KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

fsetpos — C23-streamfunctie

`fsetpos(stream, pos)` uit `<stdio.h>` herstelt de bestandspositie en, indien aanwezig, het `mbstate_t`-object uit een waarde die door een geslaagde `fgetpos` op een stream voor hetzelfde bestand is opgeslagen. Het retourneert `0` bij succes en niet-nul bij een fout.

Versie: C23

Syntax

int fsetpos(FILE *stream, const fpos_t *pos);

fsetpos(stream, pos) uit <stdio.h> herstelt de bestandspositie en, indien aanwezig, het mbstate_t-object uit een waarde die door een geslaagde fgetpos op een stream voor hetzelfde bestand is opgeslagen. Het retourneert 0 bij succes en niet-nul bij een fout.

Het voorbeeld schrijft ABCDE, bewaart de positie na AB, leest tot het einde en ziet feof == 1. Daarna herstelt fsetpos de toestand; 1 0 C toont dat EOF is gewist en C opnieuw vanaf de bedoelde positie wordt gelezen.

Succes maakt effecten van ungetc ongedaan, wist de bestandseinde-indicator en staat daarna invoer of uitvoer op een updatestream toe. fpos_t is ondoorzichtig: reken er niet mee en draag waarden niet tussen bestanden over. Bij een lees- of schrijffout wordt de foutindicator gezet; de retour is niet-nul en errno krijgt een positieve implementatieafhankelijke waarde.

Voorbeelden

#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF){fclose(stream);return 1;}rewind(stream);if(fgetc(stream)!='A'||fgetc(stream)!='B'){fclose(stream);return 1;}fpos_t pos;if(fgetpos(stream,&pos)!=0){fclose(stream);return 1;}while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fsetpos(stream,&pos)!=0){fclose(stream);return 1;}int after=feof(stream)!=0,character=fgetc(stream);printf("%d %d %c\n",before,after,character);return fclose(stream)==0?0:1;}

Resultaat

1 0 C

Het voorbeeld schrijft `ABCDE`, bewaart de positie na `AB`, leest tot het einde en ziet `feof == 1`. Daarna herstelt `fsetpos` de toestand; `1 0 C` toont dat EOF is gewist en `C` opnieuw vanaf de bedoelde positie wordt gelezen.

Bronnen