.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1990-1991, Regents of the University of California.
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: BSD-4-Clause-UC
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH stdio 3 "17 maja 2025 r." "Linux man\-pages 6.15" 
.SH NAZWA
stdio \- funkcje biblioteczne standardowego wejścia/wyjścia
.SH BIBLIOTEKA
Standardowa biblioteka C (\fIlibc\fP,\ \fI\-lc\fP)
.SH SKŁADNIA
.nf
\fB#include <stdio.h>\fP
.P
\fBextern\ FILE\ \ *\fP\fIstdin\fP\fB;\fP
\fBextern\ FILE\ \ *\fP\fIstdout\fP\fB;\fP
\fBextern\ FILE\ \ *\fP\fIstderr\fP\fB;\fP
.fi
.SH OPIS
Biblioteka standardowego wejścia/wyjścia zapewnia prosty i wydajny interfejs
buforowanych strumieni wejścia/wyjścia. Wejście i wyjście jest przypisywane
do logicznych strumieni danych, a fizyczna charakterystyka wejścia/wyjścia
jest ukrywana. Funkcje i makra wypisano poniżej; więcej informacji jest
dostępnych w poszczególnych stronach podręcznika systemowego.
.P
Strumień jest wiązany z zewnętrznym plikiem (który może być fizycznym
urządzeniem) przez \fIotwarcie\fP pliku, co może wymagać utworzenia nowego
pliku. Utworzenie istniejącego pliku spowoduje odrzucenie jego wcześniejszej
zawartości. Jeśli plik może obsłużyć żądania pozycjonowania (np. jest to
plik na dysku, a nie terminal), to \fIwskaźnik pozycji pliku\fP związany ze
strumieniem jest umieszczany na początku pliku (bajt zero), chyba że plik
otwarto w trybie dopisywania. W trybie dopisywania nie jest określone, czy
wskaźnik pozycji zostanie umieszczony na początku, czy na końcu
pliku. Wskaźnik pozycji jest utrzymywany przez kolejne odczyty, zapisy i
żądania pozycjonowania. Wszelkie wejście zachowuje się, jakby znaki były
odczytywane przez kolejne wywołania do funkcji \fBfgetc\fP(3); wszelkie wyjście
zachowuje się, jakby wszystkie znaki były zapisywane przez kolejne wywołania
do funkcji \fBfputc\fP(3).
.P
Plik jest oddzielany od strumienia przez \fIzamknięcie\fP pliku. Strumienie
wyjściowe są opróżniane (wszelka niezapisana zawartość bufora jest
transferowana do środowiska gospodarza) przed oddzieleniem strumienia z
pliku. Wartość wskaźnika do obiektu \fIFILE\fP jest nieokreślona po zamknięciu
pliku (śmieci).
.P
Plik może być później otwarty ponownie, przez wykonanie tego samego lub
innego programu, a jego zawartość odzyskana lub zmodyfikowana (jeśli może
być spozycjonowany od początku). Jeśli główna funkcja powróci do swego
pierwotnego wywołującego lub jeśli wywołano funkcję \fBexit\fP(3), wszystkie
otwarte pliki są zamykane (stąd wszystkie strumienie wyjściowe są
opróżniane) przed zakończeniem programu. Inne sposoby na zakończenie
programu, takie jak \fBabort\fP(3), nie troszczą się o poprawne zamknięcie
plików.
.P
Przy uruchomieniu programu, trzy strumienie tekstowe są predefiniowane i nie
trzeba ich jawnie otwierać: \fIstandardowe wejście\fP (ang. standard input
\[en] do odczytu zwykłego wejścia), \fIstandardowe wyjście\fP (ang. standard
output \[en] do wypisywania zwykłego wyjścia) oraz \fIstandardowe wyjście błędów\fP (ang. standard error \[en] do wypisywania wyjścia
diagnostycznego). Strumienie tę są nazywane skrótowo \fIstdin\fP, \fIstdout\fP i
\fIstderr\fP. Przy otwarciu, strumień standardowego wyjścia błędów nie jest w
pełni buforowany; strumienie standardowego wejścia i wyjścia są w pełni
buforowane wtedy i tylko wtedy, gdy strumienie te nie odnoszą się do
urządzenia interaktywnego.
.P
Strumienie wyjściowe odnoszące się do urządzeń terminali są domyślnie zawsze
buforowane do wiersza; oczekujące wyjście do tych strumieni jest zapisywane
automatycznie, gdy tylko odczytywany jest strumień wejściowy odnoszący się
do urządzenia terminala. W przypadkach, gdy po wypisaniu części wiersza na
terminal wyjściowy dokonywana jest znaczna ilość obliczeń, konieczne jest
dokonanie \fBfflush\fP(3) na standardowym wyjściu przed zajęciem się
obliczeniami, dzięki czemu pojawi się wyjście.
.P
Biblioteka \fIstdio\fP jest częścią biblioteki \fBlibc\fP i funkcje są ładowane
automatycznie w miarę potrzeb przez \fBcc\fP(1). Rozdziały SKŁADNIA poniższych
stron podręcznika systemowego wskazują, których plików include należy użyć,
jak wygląda deklaracja kompilatora dla funkcji oraz które zmienne zewnętrzne
przyjmują.
.P
.\" Not on Linux: .BR fropen ,
.\" Not on Linux: .BR fwopen ,
Nazwy, które zdefiniowano jako makra, nie mogą być użyte ponownie, przed
usunięciem ich aktualnych definicji za pomocą \fB#undef\fP; dotyczy to:
\fBBUFSIZ\fP, \fBEOF\fP, \fBFILENAME_MAX\fP, \fBFOPEN_MAX\fP, \fBL_cuserid\fP,
\fBL_ctermid\fP, \fBL_tmpnam\fP, \fBNULL\fP, \fBSEEK_END\fP, \fBSEEK_SET\fP, \fBSEEK_CUR\fP,
\fBTMP_MAX\fP, \fBclearerr\fP, \fBfeof\fP, \fBferror\fP, \fBfileno\fP, \fBgetc\fP, \fBgetchar\fP,
\fBputc\fP, \fBputchar\fP, \fBstderr\fP, \fBstdin\fP, \fBstdout\fP. Istnieją wersje
zaimplementowane jako funkcje następujących makr: \fBfeof\fP, \fBferror\fP,
\fBclearerr\fP, \fBfileno\fP, \fBgetc\fP, \fBgetchar\fP, \fBputc\fP i \fBputchar\fP; zostaną
one użyte, jeśli usunie się definicje makr.
.SS "Lista funkcji"
.TS
;
lb lbx
l l.
Funkcja	Opis
_
T{
\fBclearerr\fP(3)
T}	T{
sprawdza i zmienia stan strumienia
T}
T{
\fBfclose\fP(3)
T}	T{
zamyka strumień
T}
T{
\fBfdopen\fP(3)
T}	T{
funkcje otwarcia strumienia
T}
T{
\fBfeof\fP(3)
T}	T{
sprawdza i zmienia stan strumienia
T}
T{
\fBferror\fP(3)
T}	T{
sprawdza i zmienia stan strumienia
T}
T{
\fBfflush\fP(3)
T}	T{
wypróżnia bufory strumienia
T}
T{
\fBfgetc\fP(3)
T}	T{
odczytuje następny znak lub słowo ze strumienia wejściowego
T}
T{
\fBfgetpos\fP(3)
T}	T{
zmienia pozycję w strumieniu
T}
T{
\fBfgets\fP(3)
T}	T{
odczytuje wiersz ze strumienia
T}
T{
\fBfileno\fP(3)
T}	T{
zwraca liczbowy deskryptor strumienia z argumentu
T}
T{
\fBfmemopen\fP(3)
T}	T{
otwiera pamięć jako strumień
T}
T{
\fBfopen\fP(3)
T}	T{
funkcje otwarcia strumienia
T}
T{
\fBfopencookie\fP(3)
T}	T{
otwiera własny strumień
T}
T{
\fBfprintf\fP(3)
T}	T{
konwertuje formatowanie wyjściowe
T}
T{
\fBfpurge\fP(3)
T}	T{
wypróżnia bufory strumienia
T}
T{
\fBfputc\fP(3)
T}	T{
wypisuje znak lub słowo do strumienia
T}
T{
\fBfputs\fP(3)
T}	T{
wypisuje wiersz do strumienia
T}
T{
\fBfread\fP(3)
T}	T{
odczytuje/zapisuje strumień binarny
T}
T{
\fBfreopen\fP(3)
T}	T{
funkcje otwarcia strumienia
T}
T{
\fBfscanf\fP(3)
T}	T{
konwertuje format wejściowy
T}
T{
\fBfseek\fP(3)
T}	T{
zmienia pozycję w strumieniu
T}
T{
\fBfsetpos\fP(3)
T}	T{
zmienia pozycję w strumieniu
T}
T{
\fBftell\fP(3)
T}	T{
zmienia pozycję w strumieniu
T}
T{
\fBfwrite\fP(3)
T}	T{
odczytuje/zapisuje strumień binarny
T}
T{
\fBgetc\fP(3)
T}	T{
odczytuje następny znak lub słowo ze strumienia wejściowego
T}
T{
\fBgetchar\fP(3)
T}	T{
odczytuje następny znak lub słowo ze strumienia wejściowego
T}
T{
\fBgets\fP(3)
T}	T{
odczytuje wiersz ze strumienia
T}
T{
\fBgetw\fP(3)
T}	T{
odczytuje następny znak lub słowo ze strumienia wejściowego
T}
T{
\fBmktemp\fP(3)
T}	T{
tworzy (unikatową) nazwę pliku tymczasowego
T}
T{
\fBopen_memstream\fP(3)
T}	T{
otwiera strumień bufora pamięci dynamicznej
T}
T{
\fBopen_wmemstream\fP(3)
T}	T{
otwiera strumień bufora pamięci dynamicznej
T}
T{
\fBperror\fP(3)
T}	T{
systemowe komunikaty o błędach
T}
T{
\fBprintf\fP(3)
T}	T{
konwertuje formatowanie wyjściowe
T}
T{
\fBputc\fP(3)
T}	T{
wypisuje znak lub słowo do strumienia
T}
T{
\fBputchar\fP(3)
T}	T{
wypisuje znak lub słowo do strumienia
T}
T{
\fBputs\fP(3)
T}	T{
wypisuje wiersz do strumienia
T}
T{
\fBputw\fP(3)
T}	T{
wypisuje znak lub słowo do strumienia
T}
T{
\fBremove\fP(3)
T}	T{
usuwa wpis katalogu
T}
T{
\fBrewind\fP(3)
T}	T{
zmienia pozycję w strumieniu
T}
T{
\fBscanf\fP(3)
T}	T{
konwertuje format wejściowy
T}
T{
\fBsetbuf\fP(3)
T}	T{
działania buforowania strumienia
T}
T{
\fBsetbuffer\fP(3)
T}	T{
działania buforowania strumienia
T}
T{
\fBsetlinebuf\fP(3)
T}	T{
działania buforowania strumienia
T}
T{
\fBsetvbuf\fP(3)
T}	T{
działania buforowania strumienia
T}
T{
\fBsprintf\fP(3)
T}	T{
konwertuje formatowanie wyjściowe
T}
T{
\fBsscanf\fP(3)
T}	T{
konwertuje format wejściowy
T}
T{
\fBstrerror\fP(3)
T}	T{
systemowe komunikaty o błędach
T}
T{
\fBsys_errlist\fP(3)
T}	T{
systemowe komunikaty o błędach
T}
T{
\fBsys_nerr\fP(3)
T}	T{
systemowe komunikaty o błędach
T}
T{
\fBtempnam\fP(3)
T}	T{
funkcje pliku tymczasowego
T}
T{
\fBtmpfile\fP(3)
T}	T{
funkcje pliku tymczasowego
T}
T{
\fBtmpnam\fP(3)
T}	T{
funkcje pliku tymczasowego
T}
T{
\fBungetc\fP(3)
T}	T{
zwraca znak ze strumienia wejściowego
T}
T{
\fBvfprintf\fP(3)
T}	T{
konwertuje formatowanie wyjściowe
T}
T{
\fBvfscanf\fP(3)
T}	T{
konwertuje format wejściowy
T}
T{
\fBvprintf\fP(3)
T}	T{
konwertuje formatowanie wyjściowe
T}
T{
\fBvscanf\fP(3)
T}	T{
konwertuje format wejściowy
T}
T{
\fBvsprintf\fP(3)
T}	T{
konwertuje formatowanie wyjściowe
T}
T{
\fBvsscanf\fP(3)
T}	T{
konwertuje format wejściowy
T}
.TE
.SH STANDARDY
C11, POSIX.1\-2008.
.SH HISTORIA
C89, POSIX.1\-2001.
.SH "ZOBACZ TAKŻE"
\fBclose\fP(2), \fBopen\fP(2), \fBread\fP(2), \fBwrite\fP(2), \fBstdout\fP(3),
\fBunlocked_stdio\fP(3)
.PP
.SH TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika:
Michał Kułach <michal.kulach@gmail.com>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .