.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 1990, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\" @(#)stdio.3 6.5 (Berkeley) 5/6/91 .\" .\" Converted for Linux, Mon Nov 29 16:07:22 1993, faith@cs.unc.edu .\" Modified, 2001-12-26, aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH stdio 3 "2 maja 2024 r." "Linux man\-pages 6.9.1" .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 \fP .P \fBFILE *\fP\fIstdin\fP\fB;\fP \fBFILE *\fP\fIstdout\fP\fB;\fP \fBFILE *\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 _ \fBclearerr\fP(3) T{ sprawdza i zmienia stan strumienia T} \fBfclose\fP(3) T{ zamyka strumień T} \fBfdopen\fP(3) T{ funkcje otwarcia strumienia T} \fBfeof\fP(3) T{ sprawdza i zmienia stan strumienia T} \fBferror\fP(3) T{ sprawdza i zmienia stan strumienia T} \fBfflush\fP(3) T{ wypróżnia bufory strumienia T} \fBfgetc\fP(3) T{ odczytuje następny znak lub słowo ze strumienia wejściowego T} \fBfgetpos\fP(3) T{ zmienia pozycję w strumieniu T} \fBfgets\fP(3) T{ odczytuje wiersz ze strumienia T} \fBfileno\fP(3) T{ zwraca liczbowy deskryptor strumienia z argumentu T} \fBfmemopen\fP(3) T{ otwiera pamięć jako strumień T} \fBfopen\fP(3) T{ funkcje otwarcia strumienia T} \fBfopencookie\fP(3) T{ otwiera własny strumień T} \fBfprintf\fP(3) T{ konwertuje formatowanie wyjściowe T} \fBfpurge\fP(3) T{ wypróżnia bufory strumienia T} \fBfputc\fP(3) T{ wypisuje znak lub słowo do strumienia T} \fBfputs\fP(3) T{ wypisuje wiersz do strumienia T} \fBfread\fP(3) T{ odczytuje/zapisuje strumień binarny T} \fBfreopen\fP(3) T{ funkcje otwarcia strumienia T} \fBfscanf\fP(3) T{ konwertuje format wejściowy T} \fBfseek\fP(3) T{ zmienia pozycję w strumieniu T} \fBfsetpos\fP(3) T{ zmienia pozycję w strumieniu T} \fBftell\fP(3) T{ zmienia pozycję w strumieniu T} \fBfwrite\fP(3) T{ odczytuje/zapisuje strumień binarny T} \fBgetc\fP(3) T{ odczytuje następny znak lub słowo ze strumienia wejściowego T} \fBgetchar\fP(3) T{ odczytuje następny znak lub słowo ze strumienia wejściowego T} \fBgets\fP(3) T{ odczytuje wiersz ze strumienia T} \fBgetw\fP(3) T{ odczytuje następny znak lub słowo ze strumienia wejściowego T} \fBmktemp\fP(3) T{ tworzy (unikatową) nazwę pliku tymczasowego T} \fBopen_memstream\fP(3) T{ otwiera strumień bufora pamięci dynamicznej T} \fBopen_wmemstream\fP(3) T{ otwiera strumień bufora pamięci dynamicznej T} \fBperror\fP(3) T{ systemowe komunikaty o błędach T} \fBprintf\fP(3) T{ konwertuje formatowanie wyjściowe T} \fBputc\fP(3) T{ wypisuje znak lub słowo do strumienia T} \fBputchar\fP(3) T{ wypisuje znak lub słowo do strumienia T} \fBputs\fP(3) T{ wypisuje wiersz do strumienia T} \fBputw\fP(3) T{ wypisuje znak lub słowo do strumienia T} \fBremove\fP(3) T{ usuwa wpis katalogu T} \fBrewind\fP(3) T{ zmienia pozycję w strumieniu T} \fBscanf\fP(3) T{ konwertuje format wejściowy T} \fBsetbuf\fP(3) T{ działania buforowania strumienia T} \fBsetbuffer\fP(3) T{ działania buforowania strumienia T} \fBsetlinebuf\fP(3) T{ działania buforowania strumienia T} \fBsetvbuf\fP(3) T{ działania buforowania strumienia T} \fBsprintf\fP(3) T{ konwertuje formatowanie wyjściowe T} \fBsscanf\fP(3) T{ konwertuje format wejściowy T} \fBstrerror\fP(3) T{ systemowe komunikaty o błędach T} \fBsys_errlist\fP(3) T{ systemowe komunikaty o błędach T} \fBsys_nerr\fP(3) T{ systemowe komunikaty o błędach T} \fBtempnam\fP(3) T{ funkcje pliku tymczasowego T} \fBtmpfile\fP(3) T{ funkcje pliku tymczasowego T} \fBtmpnam\fP(3) T{ funkcje pliku tymczasowego T} \fBungetc\fP(3) T{ zwraca znak ze strumienia wejściowego T} \fBvfprintf\fP(3) T{ konwertuje formatowanie wyjściowe T} \fBvfscanf\fP(3) T{ konwertuje format wejściowy T} \fBvprintf\fP(3) T{ konwertuje formatowanie wyjściowe T} \fBvscanf\fP(3) T{ konwertuje format wejściowy T} \fBvsprintf\fP(3) T{ konwertuje formatowanie wyjściowe T} \fBvsscanf\fP(3) 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 . .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 .