_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

Envoie les données mises en forme vers un flux.Prints formatted data to a stream.

SyntaxeSyntax

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

ParamètresParameters

streamstream
Pointeur désignant la structure FILE.Pointer to the FILE structure.

formatformat
Chaîne de contrôle de format.Format-control string.

argumentargument
Arguments facultatifs.Optional arguments.

localelocale
Paramètres régionaux à utiliser.The locale to use.

Valeur de retourReturn Value

_fprintf_p et _fwprintf_p retournent le nombre de caractères écrits ou retournent une valeur négative lorsqu’une erreur de sortie se produit._fprintf_p and _fwprintf_p return the number of characters written or return a negative value when an output error occurs.

NotesRemarks

_fprintf_p formate et imprime une série de caractères et de valeurs dans le fluxde sortie._fprintf_p formats and prints a series of characters and values to the output stream. Chaque argument de fonction (le cas échéant) est converti et sorti selon la spécification de format correspondante au format.Each function argument (if any) is converted and output according to the corresponding format specification in format. Pour _fprintf_p, l’argument de format a la même syntaxe et son utilisation dans _printf_p.For _fprintf_p, the format argument has the same syntax and use that it has in _printf_p. Ces fonctions prennent en charge les paramètres positionnels, ce qui signifie que l’ordre des paramètres utilisés par la chaîne de format peut être modifié.These functions support positional parameters, meaning that the order of the parameters used by the format string can be changed. Pour plus d’informations sur les paramètres positionnels, consultez Paramètres positionnels printf_p.For more information about positional parameters, see printf_p Positional Parameters.

_fwprintf_p est une version à caractères larges de _fprintf_p; dans _fwprintf_p, format est une chaîne de caractères larges._fwprintf_p is a wide-character version of _fprintf_p; in _fwprintf_p, format is a wide-character string. Ces fonctions se comportent de la même façon si le flux est ouvert en mode ANSI.These functions behave identically if the stream is opened in ANSI mode. _fprintf_p ne prend pas actuellement en charge la sortie dans un flux Unicode._fprintf_p doesn't currently support output into a UNICODE stream.

Les versions de ces fonctions avec le suffixe _L sont identiques, sauf qu’elles utilisent les paramètres régionaux passés au lieu des paramètres régionaux actuels.The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current locale.

Important

Assurez-vous que format n'est pas une chaîne définie par l'utilisateur.Ensure that format is not a user-defined string.

Comme les versions non sécurisées (voir fprintf, _fprintf_l, fwprintf, _fwprintf_l), ces fonctions valident leurs paramètres et appellent le gestionnaire de paramètres non valides, comme décrit dans validation de paramètre, si Stream ou le format est un pointeur null ou s’il existe des spécificateurs de mise en forme inconnus ou incorrects.Like the non-secure versions (see fprintf, _fprintf_l, fwprintf, _fwprintf_l), these functions validate their parameters and invoke the invalid parameter handler, as described in Parameter Validation, if either stream or format is a null pointer or if there are any unknown or badly formed formatting specifiers. Si l’exécution est autorisée à se poursuivre, les fonctions retournent-1 et attribuent à errno la valeur EINVAL.If execution is allowed to continue, the functions return -1 and set errno to EINVAL.

Mappages de routines de texte génériqueGeneric-Text Routine Mappings

Routine Tchar.hTchar.h routine _UNICODE et _MBCS non définis_UNICODE and _MBCS not defined _MBCS défini_MBCS defined _UNICODE défini_UNICODE defined
_ftprintf_p_ftprintf_p _fprintf_p_fprintf_p _fprintf_p_fprintf_p _fwprintf_p_fwprintf_p
_ftprintf_p_l_ftprintf_p_l _fprintf_p_l_fprintf_p_l _fprintf_p_l_fprintf_p_l _fwprintf_p_l_fwprintf_p_l

Pour plus d'informations, consultez Spécifications de format.For more information, see Format Specifications.

Configuration requiseRequirements

FonctionFunction En-tête requisRequired header
_fprintf_p, _fprintf_p_l_fprintf_p, _fprintf_p_l <stdio.h><stdio.h>
_fwprintf_p, _fwprintf_p_l_fwprintf_p, _fwprintf_p_l <stdio.h> ou <wchar.h><stdio.h> or <wchar.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.For more compatibility information, see Compatibility.

ExempleExample

// 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

Voir aussiSee also

E/S de fluxStream I/O
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_lfscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
Paramètres positionnels printf_pprintf_p Positional Parameters
_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
Paramètres positionnels printf_pprintf_p Positional Parameters
fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_lfscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l