_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_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эти функции проверяют свои параметры и вызывают обработчик недопустимых параметров, как описано в разделе "Проверка параметров", если или является пустым указателем, или если есть какие-либо streamformat неизвестные или плохо сформированные описатели форматирования. Если продолжение выполнения разрешено, функции возвращают значение -1 и задают для errno значение EINVAL.

Сопоставления подпрограмм универсального текста

Подпрограмма 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

Дополнительные сведения см. в разделе "Синтаксис спецификации формата".

Требования

Функция	Обязательный заголовок
_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