.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Modified Wed Jul 28 11:12:07 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Fri Sep  8 15:48:13 1995 by Andries Brouwer (aeb@cwi.nl)
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetc 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
fgetc, fgets, getc, getchar, ungetc \- функции для ввода символов и строк
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <stdio.h>\fP
.PP
\fBint fgetc(FILE *\fP\fIstream\fP\fB);\fP
\fBint getc(FILE *\fP\fIstream\fP\fB);\fP
\fBint getchar(void);\fP
.PP
\fBchar *fgets(char \fP\fIs\fP\fB[restrict .\fP\fIsize\fP\fB], int \fP\fIsize\fP\fB, FILE *restrict \fP\fIstream\fP\fB);\fP
.PP
\fBint ungetc(int \fP\fIc\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Функция \fBfgetc\fP() считывает очередной символ из потока \fIstream\fP и
возвращает \fIunsigned char\fP преобразованный в \fIint\fP, или \fBEOF\fP при
достижении конца файла или при возникновении ошибки.
.PP
Функция \fBgetc\fP() похожа на \fBfgetc\fP(), но она может быть реализована как
макрос, который определяет состояние \fIstream\fP более одного раза.
.PP
Функция \fBgetchar\fP() эквивалентна \fBgetc(\fP\fIstdin\fP\fB)\fP.
.PP
\fBfgets\fP()  reads in at most one less than \fIsize\fP characters from \fIstream\fP
and stores them into the buffer pointed to by \fIs\fP.  Reading stops after an
\fBEOF\fP or a newline.  If a newline is read, it is stored into the buffer.  A
terminating null byte (\[aq]\e0\[aq])  is stored after the last character in
the buffer.
.PP
Функция \fBungetc\fP() заносит \fIc\fP обратно в \fIstream\fP, преобразует в
\fIunsigned char\fP, если это возможно для дальнейших операций
чтения. Занесённые обратно символы будут возвращаться в обратном порядке;
гарантируется только одно занесение символов.
.PP
Вызовы функций, описанные здесь, могут смешиваться друг с другом и с другими
функциями ввода из библиотеки \fIstdio\fP для того же потока ввода.
.PP
Для неблокирующих аналогов, см. \fBunlocked_stdio\fP(3).
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
\fBfgetc\fP(), \fBgetc\fP(), and \fBgetchar\fP()  return the character read as an
\fIunsigned char\fP cast to an \fIint\fP or \fBEOF\fP on end of file or error.
.PP
Функция \fBfgets\fP() возвращает \fIs\fP при удачном выполнении и NULL при ошибке
или если достигнут конец файла, а символы остались несчитанными.
.PP
При успешном выполнении функция \fBungetc\fP() возвращает \fIc\fP или \fBEOF\fP при
ошибке.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBfgetc\fP(),
\fBfgets\fP(),
\fBgetc\fP(),
\fBgetchar\fP(),
\fBungetc\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.sp 1
.SH СТАНДАРТЫ
C11, POSIX.1\-2008.
.SH ИСТОРИЯ
POSIX.1\-2001, C89.
.SH ЗАМЕЧАНИЯ
Не рекомендуется чередовать вызовы функций ввода библиотеки \fIstdio\fP с
низкоуровневыми вызовами \fBread\fP(2) для дескриптора файла, связанного с
потоком ввода; результат этого будет неопределённым и, скорее всего, не тем,
который ожидается.
.SH "СМ. ТАКЖЕ"
\fBread\fP(2), \fBwrite\fP(2), \fBferror\fP(3), \fBfgetwc\fP(3), \fBfgetws\fP(3),
\fBfopen\fP(3), \fBfread\fP(3), \fBfseek\fP(3), \fBgetline\fP(3), \fBgets\fP(3),
\fBgetwchar\fP(3), \fBputs\fP(3), \fBscanf\fP(3), \fBungetwc\fP(3),
\fBunlocked_stdio\fP(3), \fBfeature_test_macros\fP(7)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Azamat Hackimov <azamat.hackimov@gmail.com>,
Dmitry Bolkhovskikh <d20052005@yandex.ru>,
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .