_fputchar
, _fputwchar
Записывает символ в поток stdout
.
Синтаксис
int _fputchar(
int c
);
wint_t _fputwchar(
wchar_t c
);
Параметры
c
Символ, который требуется записать.
Возвращаемое значение
Каждая из этих функций возвращает записанный символ. Для _fputchar
возвращаемое значение EOF
указывает на ошибку. Для _fputwchar
возвращаемое значение WEOF
указывает на ошибку. В случае c NULL
эти функции создают недопустимое исключение параметров, как описано в разделе "Проверка параметров". Если выполнение разрешено продолжать, возвращается EOF
(_fputwchar
возвращаетсяWEOF
), и они задают значение errno
EINVAL
. _fputchar
Дополнительные сведения об этих и других кодах ошибок см. в разделе errno
, _doserrno
и _sys_errlist
_sys_nerr
.
Замечания
Обе эти функции записывают один символьный аргумент c
stdout
и перемещают индикатор соответствующим образом. _fputchar
эквивалентна fputc( stdout )
. Он также эквивалентен putchar
, но реализуется только как функция, а не как функция и макрос. В отличие от fputc
этих putchar
функций, эти функции несовместимы со стандартом ANSI.
По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.
Сопоставления подпрограмм универсального текста
Подпрограмма Tchar.h | _UNICODE и _MBCS не определен |
_MBCS Определенные |
_UNICODE Определенные |
---|---|---|---|
_fputtchar |
_fputchar |
_fputchar |
_fputwchar |
Требования
Function | Обязательный заголовок |
---|---|
_fputchar |
<stdio.h> |
_fputwchar |
<stdio.h> или <wchar.h> |
Консоль не поддерживается в приложениях универсальная платформа Windows (UWP). Стандартные дескрипторы потока, связанные с консолью,stdin
stdout
и stderr
должны быть перенаправлены, прежде чем функции времени выполнения C могут использовать их в приложениях UWP. Дополнительные сведения о совместимости см. в разделе Совместимость.
Пример
// crt_fputchar.c
// This program uses _fputchar
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr[] = "This is a test of _fputchar!!\n";
char *p = NULL;
// Print line to stream using _fputchar.
p = strptr;
while( (*p != '\0') && _fputchar( *(p++) ) != EOF )
;
}
This is a test of _fputchar!!