_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

Artykuł
02/27/2013

Drukuje sformatowane dane do strumienia.

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 ]...
);

Parametry

stream
Wskaźnik, aby FILE struktury.
format
Ciąg formatu formantu.
argument
Opcjonalne argumenty.
locale
Ustawienia regionalne, aby użyć.

Wartość zwracana

_fprintf_pi _fwprintf_p zwraca liczbę znaków, napisane lub zwraca wartość ujemną po wystąpieniu błędu danych wyjściowych.

Uwagi

_fprintf_pformaty i drukuje serii wartości w danych wyjściowych i znaki stream.Każda funkcja argument (jeśli ma zastosowanie) jest konwertowane i wyjściowe zgodnie ze specyfikacją odpowiedni format w format.Dla _fprintf_p, format argumentu po tej samej składni i użycia, które ma w _printf_p.Te funkcje obsługi parametrów pozycyjne, co oznacza, że można zmieniać kolejność parametry używane przez ciąg formatu.Aby uzyskać więcej informacji dotyczących parametrów pozycyjne, zobacz printf_p parametry pozycyjne.

_fwprintf_pjest to wersja szerokich znaków _fprintf_p; w _fwprintf_p, format jest łańcuch szerokich znaków.Funkcje te zachowują się identycznie, gdy strumień jest otwierany w trybie ANSI._fprintf_paktualnie nie obsługuje dane wyjściowe do strumienia UNICODE.

Wersje te funkcje, z _l sufiks są identyczne, z wyjątkiem, że używają oni przekazany zamiast bieżące ustawienia regionalne parametr ustawień regionalnych.

Uwaga dotycząca zabezpieczeń
Zapewnić, że format nie jest ciągiem zdefiniowane przez użytkownika.

Jak wersje-secure (zobacz fprintf, _fprintf_l, fwprintf, _fwprintf_l), funkcje te sprawdza poprawność ich parametrów i wywołać obsługi nieprawidłowy parametr, jak opisano w Sprawdzanie poprawności parametru, jeśli albo stream lub format jest wskaźnik zerowy lub jeśli żadnych specyfikatorów formatowania nieznany lub źle sformułowane.Jeśli wykonanie może kontynuować, funkcje zwracają wartość -1 i errno do EINVAL.

Tekst rodzajowy rutynowych mapowania

Procedura TCHAR.h	_UNICODE i _MBCS nie zdefiniowane	_MBCS, definicja	_UNICODE, definicja
_ftprintf_p	_fprintf_p	_fprintf_p	_fwprintf_p
_ftprintf_p_l	_fprintf_p_l	_fprintf_p_l	_fwprintf_p_l

Aby uzyskać więcej informacji, zobacz Specyfikacji formatu.

Wymagania

Funkcja	Wymaganego nagłówka
_fprintf_p, _fprintf_p_l	<stdio.h>
_fwprintf_p, _fwprintf_p_l	<stdio.h> lub <wchar.h>

Informacji dotyczących zgodności, zobacz zgodności we wprowadzeniu.

Przykład

// 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" );
}