E/S de flux

Ces fonctions traitent des données de tailles et des formats différents, des caractères uniques à de larges structures de données. Elles fournissent également la mise en mémoire tampon, ce qui peut améliorer les performances. La taille par défaut d'une mémoire tampon de flux est 4K. Ces routines affectent uniqueùent les mémoires tampons crées par les routines de la librairie runtime, et n'ont aucun effet sur les mémoires tampons créées par le système d'exploitation.

routines I/O de flux

Routine	Utilisez	Équivalent de .NET Framework
clearerr, clearerr_s	Indicateur d'erreur clair du flux de données	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
fclose.	Fermez le flux de données	System::IO::Stream::Close, System::IO::BinaryReader::Close, System::IO::BinaryWriter::Close, System::IO::TextReader::Close, System::IO::TextWriter::Close, System::IO::StringReader::Close, System::IO::StringWriter::Close, System::IO::StreamReader::Close, System::IO::StreamWriter::Close
_fcloseall	Fermez tous les flux de données ouverts excepté stdin, stdout, et stderr	System::IO::Stream::Close, System::IO::BinaryReader::Close, System::IO::BinaryWriter::Close, System::IO::TextReader::Close, System::IO::TextWriter::Close, System::IO::StringReader::Close, System::IO::StringWriter::Close, System::IO::StreamReader::Close, System::IO::StreamWriter::Close
_fdopen, _wfdopen	Associe le flux de données avec le descripteur de fichier du fichier ouvert	System::IO::FileStream::FileStream
feof	Test de fin de fichier sur le flux de données	System::IO::FileStream::Read
ferror	Test d'erreur dans le flux de données	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
fflush	Vide le flux de données dans la mémoire tampon ou dans une unité de stockage	System::IO::FileStream::Flush
fgetc, fgetwc	Lis les caractères à partir du flux de données (versions de fonction de getc et degetwc)	System::IO::StreamReader::Read.
_fgetchar, _fgetwchar	Lis les caractères à partir de stdin (versions de fonction degetchar et degetwchar)	System::Console::Read
fgetpos	Obtient l'Indicateur de position du flux de données	System::IO::FileStream::Position
fgets, fgetws	Lis les chaines à partir du flux de données	System::IO::StreamReader::ReadLine, System::IO::TextReader::ReadBlock
_fileno	Obtient le Descripteur de fichier associé au flux de données	System::IO::FileStream::Handle
_flushall	Vide tous les flux de données dans la mémoire tampon ou dans une unité de stockage	System::IO::FileStream::Flush, System::IO::StreamWriter::Flush, System::IO::TextWriter::Flush, System::IO::BinaryWriter::Flush
fopen, _wfopen, fopen_s, _wfopen_s	Ouvre le flux de données	System::IO::File::Open
fprintf, _fprintf_l, fwprintf, _fwprintf_l, fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l	Écris des données formatées dans le flux de données	System::IO::StreamWriter::Write
fputc, fputwc	Entre un caractère dans un flux (les versions de fonction deputc et deputwc)	System::IO::StreamWriter::Write
_fputchar, _fputwchar	Ecris un caractère dans stdout (versions de la fonction deputchar et deputwchar)	System::Console::Write
fputs, fputws	Ecris une chaine dans le flux	System::IO::StreamWriter::Write
fread	Lit les données non mises en forme à partir d'un flux.	System::IO::FileStream::Read
freopen, _wfreopen, freopen_s, _wfreopen_s	Réattribue le pointeur de fluxFILE au nouveau fichier ou au périphérique	System::IO::File::Open
fscanf, fwscanf, fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l	Lit les données mises en forme à partir d'un flux.	System::IO::StreamReader::ReadLine; consultez également les méthodes, commeParse, telles que System::Double::Parse.
fseek, _fseeki64	Déplacez la position de fichier à l'emplacement spécifié	System::IO::FileStream::Position, System::IO::FileStream::Seek
fsetpos	Définit l'indicateur de position du flux	System::IO::FileStream::Position
_fsopen, _wfsopen	Ouvre le flux de données avec partage de fichiers	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
ftell, _ftelli64	Obtient la position actuelle du fichier	System::IO::FileStream::Position
fwrite	Entre les éléments de données non mis en forme dans le flux de données	System::IO::FileStream::Write
getc, getwc	Lis les caractères à partir du flux de données (versions macro de fonction de fgetc et defgetwc)	System::IO::StreamReader::Read.
getchar, getwchar	Lis les caractères à partir de stdin (versions macro de fonction defgetchar et defgetwchar)	System::Console::Read
_getmaxstdio	Retourne le nombre de fichiers ouverts simultanément permis au niveau du flux I/O.	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
gets, getws, gets_s, _getws_s	Lis des lignes depuis stdin	System::Console::Read
_getw	Lis le binaire int depuis le flux	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
printf, _printf_l, wprintf, _wprintf_l,printf_s, _printf_s_l, wprintf_s, _wprintf_s_l	Écris des données mises en forme dans stdout	System::Console::Write
putc, putwc	Ecris des caractères dans un flux de données (versions macro defputc et defputwc)	System::IO::StreamWriter::Write
putchar, putwchar	Ecris un caractère dans stdout (versions macro defputchar et defputwchar)	System::Console::Write
puts, _putws	Ecris une ligne à transmettre en continu	System::Console::Write
_putw	Ecris un int binaire à transmettre en continu	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
rewind	Déplace la position du fichier au début du flux	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
_rmtmp	Supprimedes fichiers temporaires créés par tmpfile	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
scanf, _scanf_l, wscanf, _wscanf_l,scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l	lis des données mises en forme à partir destdin	System::Console::ReadLine; consultez également les méthodes d'Parse, telles que System::Double::Parse.
setbuf	Controle du chargement du flux	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
_setmaxstdio	Définis une valeur maximale pour nombre de fichiers ouverts simultanément au niveau du flux I/O	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
setvbuf	Controle du chargement du flux et de la taille du tampon	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
_snprintf, _snwprintf, _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l	Ecris les données mises en forme de la longueur spécifiée sous forme de chaîne	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
_snscanf, _snwscanf, _snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l	Lit les données mises en forme d'une longueur spécifiée du flux d'entrée standard.	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
sprintf, swprintf, sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l	Écris des données formattées dans une chaîne.	System::String::Format
sscanf, swscanf, sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l	Lit les données mises en forme à partir d'une chaîne.	Voir également les méthodes Parse, telles que System::Double::Parse.
_tempnam, _wtempnam	Génére le nom de fichier temporaire dans le répertoire spécifique	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
tmpfile, tmpfile_s	Créez le fichier temporaire	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
tmpnam, _wtmpnam, tmpnam_s, _wtmpnam_s	Génére le nom de fichier temporaire	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
ungetc, ungetwc	Renvoie des caractères dans le flux de données	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
_vcprintf, _vcwprintf, _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l	Ecris des données formatées dans la console	System::Console::Write
vfprintf, vfwprintf, vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l	Écris des données formatées dans le flux de données	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
vprintf, vwprintf, vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l	Écris des données mises en forme dans stdout	System::Console::Write
_vsnprintf, _vsnwprintf, vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l	Ecris les données formattées de la longueur spécifiée sous forme de chaîne	Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
vsprintf, vswprintf, vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l	Ecris des données formatées dans la mémoire tampon	System::String::Format

Lorsqu'un programme lance l'exécution, le code de démarrage ouvre automatiquement plusieurs flux de données : entrée standard (désignée par stdin), sortie standard (désignée par stdout), puis erreur standard (désignée par stderr). Ces flux de données sont dirigés vers la console (clavier et écran) par défaut. Utilisez freopen pour rediriger stdin, stdout, ou stderr dans un fichier disque ou un lecteur.

Les fichiers ouverts à l'aide des routines de flux de données sont mises en mémoire tampon par défaut. Les fonctions stdout et stderr sont vidées chaque fois qu'elles sont saturées ou, si vous ecrivez sur une unité de caractères, après chaque appel de bibliothèque. Si un programme se termine anormalement, les tampons de sortie ne sont peut etre pas vidés, ce qui peut résulter en perte de données. Utilisez fflush ou _flushall pour s'assurer que la mémoire tampon associée à un fichier spécifié ou que toutes les mémoires tampons ouvertes sont vidées sur le système d'exploitation, qui peut mettre en cache les données avant de les écrire sur disque. La fonctionnalité validée sur disque garantit que le contenu vidé de mémoire tampon n'est pas perdu en cas de défaillance du système.

Il existe deux méthodes pour valider le contenu du tampon sur le disque :

• Connectez vous au fichier COMMODE.OBJ pour définir un indicateur global de validation. Le paramètre par défaut de l'indicateur global est n, pour « étiquette sans validation. »

• Définissez l'indicateur d'affichage à c avec fopen ou _fdopen.

Tout fichier ouvert spécifiquement avec soit c soit l'indicateur n se comporte selon l'indicateur, quelque soit l'état de l'indicateur global de validation/non validation.

Si votre programme omet de fermer explicitement un flux de données, le flux de données est fermée automatiquement lorsque le programme prend fin. Toutefois, vous devez fermer le flux de données lorsque le programme se termine avec lui, comme le nombre de flux de données qui peuvent être ouverts simultanément est limité. Voir _setmaxstdio pour plus d'informations sur cette limite.

L'entrée peut suivre la sortie directement uniquement avec un appel àfflush ou à une fonction de placement de fichier (fseek, fsetpos, ou rewind). La sortie peut suivre l'entrée sans appeler une fonction de placement de fichier si l'opération d'entrée rencontre la fin du fichier.

Voir aussi

Référence

Entrées et sorties

Routines runtime par catégorie