_fprintf_p
, , _fprintf_p_l
_ftprintf_p_l
_ftprintf_p
_fwprintf_p
,_fwprintf_p_l
Выводит форматированные данные в поток.
Дополнительные сведения _ftprintf_p
см_ftprintf_p_l
. в сопоставлениях функций универсального текста.
Синтаксис
int _fprintf_p(
FILE *stream,
const char *format [,
argument ]...
);
int _fprintf_p_l(
FILE *stream,
const char *format,
_locale_t locale [,
argument ]...
);
int _fwprintf_p(
FILE *stream,
const wchar_t *format [,
argument ]...
);
int _fwprintf_p_l(
FILE *stream,
const wchar_t *format,
_locale_t locale [,
argument ]...
);
Параметры
stream
Указатель на структуру FILE
.
format
Строка управления форматом.
argument
Необязательные аргументы.
locale
Используемый языковой стандарт.
Возвращаемое значение
Функции _fprintf_p
и _fwprintf_p
возвращают число выведенных символов или отрицательное значение в случае ошибки.
Замечания
Функция _fprintf_p
форматирует и выводит набор символов и значений в выходной поток stream
. Каждый argument
функции (при наличии) преобразуется и выводится согласно соответствующей спецификации формата в format
. Для _fprintf_p
аргумента format
имеется тот же синтаксис, что и в _printf_p
нем. Эти функции поддерживают позиционные параметры, это означает, что можно изменить порядок параметров, используемых в строке формата. Дополнительные сведения см. в разделе Позиционные параметры printf_p.
_fwprintf_p
— версия функции _fprintf_p
для расширенных символов; в функции _fwprintf_p
параметр format
— это строка расширенных символов. Эти функции ведут себя одинаково, если поток открыт в режиме ANSI. Функция _fprintf_p
на данный момент не поддерживает вывод данных в поток в кодировке Юникод.
Версии этих функций с суффиксом _l
идентичны, за исключением того, что они используют переданный параметр языкового стандарта вместо текущего языкового стандарта.
Внимание
Убедитесь, что format
не является строкой, определяемой пользователем.
Начиная с Windows 10 версии 2004 (сборка 19041), printf
семейство функций выводит точно представленные числа с плавающей запятой в соответствии с правилами IEEE 754 для округления. В предыдущих версиях Windows точно представленные числа с плавающей запятой, заканчивающиеся на "5", всегда округлялись. IEEE 754 утверждает, что они должны округлиться до ближайшей даже цифры (также известной как "Округление банкира"). Например, оба printf("%1.0f", 1.5)
и printf("%1.0f", 2.5)
должны округлиться до 2. Ранее 1,5 округляет до 2 и 2,5 округления до 3. Это изменение влияет только на точно представленные числа. Например, 2.35 (который при представлении в памяти приближается к 2,3500000000000000008) продолжает округляется до 2,4. Округление, выполняемое этими функциями, теперь также учитывает режим округления с плавающей запятой, заданный fesetround
. Ранее округление всегда выбрало FE_TONEAREST
поведение. Это изменение влияет только на программы, созданные с помощью Visual Studio 2019 версии 16.2 и более поздних версий. Чтобы использовать устаревшее поведение округления с плавающей запятой, свяжите ссылку с "legacy_stdio_float_rounding.obj".
Как и небезопасные версии (смfprintf
_fprintf_l
. , fwprintf
), _fwprintf_l
эти функции проверяют свои параметры и вызывают обработчик недопустимых параметров, как описано в разделе "Проверка параметров", если или является пустым указателем, или если есть какие-либо stream
format
неизвестные или плохо сформированные описатели форматирования. Если продолжение выполнения разрешено, функции возвращают значение -1 и задают для errno
значение EINVAL
.
Сопоставления функций универсального текста
Функция в столбце сопоставляется с функцией в tchar.h
других столбцах в зависимости от набора символов, определенного во время компиляции.
Функция tchar.h |
_UNICODE и _MBCS не определен |
_MBCS Определенные |
_UNICODE Определенные |
---|---|---|---|
_ftprintf_p |
_fprintf_p |
_fprintf_p |
_fwprintf_p |
_ftprintf_p_l |
_fprintf_p_l |
_fprintf_p_l |
_fwprintf_p_l |
Дополнительные сведения см. в разделе "Синтаксис спецификации формата".
Требования
Function | Обязательный заголовок |
---|---|
_fprintf_p , _fprintf_p_l |
<stdio.h> |
_fwprintf_p , _fwprintf_p_l |
<stdio.h> или <wchar.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость.
Пример
// crt_fprintf_p.c
// This program uses _fprintf_p to format various
// data and print it to the file named FPRINTF_P.OUT. It
// then displays FPRINTF_P.OUT on the screen using the system
// function to invoke the operating-system TYPE command.
//
#include <stdio.h>
#include <process.h>
int main( void )
{
FILE *stream = NULL;
int i = 10;
double fp = 1.5;
char s[] = "this is a string";
char c = '\n';
// Open the file
if ( fopen_s( &stream, "fprintf_p.out", "w" ) == 0)
{
// Format and print data
_fprintf_p( stream, "%2$s%1$c", c, s );
_fprintf_p( stream, "%d\n", i );
_fprintf_p( stream, "%f\n", fp );
// Close the file
fclose( stream );
}
// Verify our data
system( "type fprintf_p.out" );
}
this is a string
10
1.500000
См. также
Потоковый ввод-вывод
_cprintf
, , _cprintf_l
_cwprintf
_cwprintf_l
fscanf
, , _fscanf_l
fwscanf
_fwscanf_l
sprintf
, , _sprintf_l
swprintf
, _swprintf_l
__swprintf_l
Позиционные параметры printf_p
_cprintf_p
, , _cprintf_p_l
_cwprintf_p
_cwprintf_p_l
_cprintf_s
, , _cprintf_s_l
_cwprintf_s
_cwprintf_s_l
Позиционные параметры printf_p
fscanf_s
, , _fscanf_s_l
fwscanf_s
_fwscanf_s_l