CKTIS / C
fopen — funkcja strumieniowa C23
`fopen(filename, mode)` z `<stdio.h>` otwiera plik wskazany przez łańcuch `filename`, wiąże go z nowym strumieniem `FILE` i zwraca wskaźnik albo null przy niepowodzeniu. Tryby `r`, `w`, `a`, opcjonalne `+` i `b` oraz `x` wyłącznie w wyliczonych trybach opartych na `w` określają dostęp, tworzenie, obcięcie, dopisywanie i wyłączność.
Wersja: C23
Składnia
FILE *fopen(const char * restrict filename, const char * restrict mode);fopen(filename, mode) z <stdio.h> otwiera plik wskazany przez łańcuch filename, wiąże go z nowym strumieniem FILE i zwraca wskaźnik albo null przy niepowodzeniu. Tryby r, w, a, opcjonalne + i b oraz x wyłącznie w wyliczonych trybach opartych na w określają dostęp, tworzenie, obcięcie, dopisywanie i wyłączność.
Przykład otwiera własny plik przez fopen(name, "w+"), zapisuje 42, przewija, odczytuje wartość, zamyka i usuwa plik. Wynik 1 42 pokazuje udane otwarcie aktualizujące oraz poprawne przejście od zapisu do odczytu po pozycjonowaniu.
w może obciąć istniejący plik, a kieruje każdy zapis na bieżący koniec, a x w dozwolonym trybie w wymaga utworzenia bez nadpisania; x nie jest flagą dla r ani a. Zawsze sprawdzaj null i wynik fclose. W strumieniu aktualizującym przejście zapis→odczyt wymaga fflush albo funkcji pozycjonującej, natomiast odczyt→zapis wymaga pozycjonowania, chyba że odczyt osiągnął EOF.
Przykłady
#include <stdio.h>
int main(void){const char *name="c_ref_20_demo.tmp";FILE *s=fopen(name,"w+");if(!s)return 1;int opened=1;if(fputs("42",s)==EOF){fclose(s);remove(name);return 1;}rewind(s);int value=0;if(fscanf(s,"%d",&value)!=1){fclose(s);remove(name);return 1;}int closed=fclose(s);int removed=remove(name);printf("%d %d\n",opened,value);return closed==0&&removed==0?0:1;}
Wynik
1 42
Przykład otwiera własny plik przez `fopen(name, "w+")`, zapisuje `42`, przewija, odczytuje wartość, zamyka i usuwa plik. Wynik `1 42` pokazuje udane otwarcie aktualizujące oraz poprawne przejście od zapisu do odczytu po pozycjonowaniu.