Fluxo de E/S

Artigo
08/25/2010

Essas funções processam dados em diferentes tamanhos e formatos de caracteres únicos estruturas de dados grande.Eles também fornecem armazenamento em buffer, que pode melhorar o desempenho.O dimensionar padrão de um buffer de fluxo é 4 K.Essas rotinas afetam somente os buffers criados pelas rotinas da biblioteca de time de execução e não têm efeito nos buffers criados pelo sistema operacional.

Rotinas de fluxo de E/S

Rotina	Uso	Equivalente .NET estrutura
clearerr, clearerr_s	Indicador de erro claro para fluxo	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
fclose	Fluxo de fechar	sistema::IO::fluxo::fechar, sistema::IO::BinaryReader::fechar, sistema::IO::BinaryWriter::fechar, sistema::IO::TextReader::fechar, sistema::IO::TextWriter::fechar, sistema::IO::StringReader::fechar, sistema::IO::StringWriter::fechar, sistema::IO::StreamReader::fechar, sistema::IO::StreamWriter::fechar
_fcloseall	fechar todas as em aberto fluxos exceto stdin, stdout, e stderr	sistema::IO::fluxo::fechar, sistema::IO::BinaryReader::fechar, sistema::IO::BinaryWriter::fechar, sistema::IO::TextReader::fechar, sistema::IO::TextWriter::fechar, sistema::IO::StringReader::fechar, sistema::IO::StringWriter::fechar, sistema::IO::StreamReader::fechar, sistema::IO::StreamWriter::fechar
_fdopen, wfdopen	Associar fluxo descritor de arquivo do arquivo em aberto	sistema::IO::FileStream::FileStream
feof	Testar a participante de arquivo no fluxo	sistema::IO::FileStream::Read
ferror	Teste de erro no fluxo	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
fflush	Liberar o fluxo para o buffer ou dispositivo de armazenamento	sistema::IO::FileStream::Flush
fgetc, fgetwc	Ler caractere a partir do fluxo (função versões de getc e getwc)	sistema::IO::StreamReader::Read
_fgetchar, _fgetwchar	Ler caractere stdin (função versões do getchar e getwchar)	sistema::Console::Read
fgetpos	Obtenha o indicador de posição do fluxo	sistema::IO::FileStream::Position
fgets, fgetws	Ler a seqüência de caracteres de fluxo	sistema::IO::StreamReader::ReadLine, sistema::IO::TextReader::ReadBlock
_fileno	Obter o descritor de arquivo associado ao fluxo	sistema::IO::FileStream::Handle
_flushall	Liberar todos os fluxos de dados para o buffer ou dispositivo de armazenamento	sistema::IO::FileStream::Flush, sistema::IO::StreamWriter::Flush, sistema::IO::TextWriter::Flush, sistema::IO::BinaryWriter::Flush
fopen, _wfopen, fopen_s, _wfopen_s	Fluxo em aberto	sistema::IO::arquivo::em aberto
fprintf, _fprintf_l, fwprintf, _fwprintf_l, fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l	Gravar dados formatados em fluxo	sistema::IO::StreamWriter::gravar
fputc, fputwc	gravar um caractere para um fluxo de versões (função de putc e putwc)	sistema::IO::StreamWriter::gravar
_fputchar, _fputwchar	Gravar caractere stdout (função versões do putchar e putwchar)	sistema::Console::gravar
fputs, fputws	Gravar cadeia de caracteres de fluxo	sistema::IO::StreamWriter::gravar
fRead	Ler dados não formatados de fluxo	sistema::IO::FileStream::Read
freopen, _wfreopen, freopen_s, _wfreopen_s	Reatribuir FILE ponteiro de fluxo para novo arquivo ou dispositivo	sistema::IO::arquivo::em aberto
fscanf, fwscanf, fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l	Ler dados do fluxo formatados	sistema::IO::StreamReader::ReadLine; see also Parse métodos, sistema autônomo sistema::Double::Parse.
fseek, _fseeki64	Mover arquivo posição ao dado local	sistema::IO::FileStream::Position, sistema::IO::FileStream:: Seek
fsetpos	Indicador de posição do conjunto de fluxo	sistema::IO::FileStream::Position
_fsopen, _wfsopen	Fluxo em aberto com o compartilhamento de arquivos	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
ftell, _ftelli64	Obter posição corrente do arquivo	sistema::IO::FileStream::Position
Fwrite	Gravar itens de dados não formatados para o fluxo	sistema::IO::FileStream::gravar
getc, getwc	Ler caractere a partir do fluxo (versões de macro do fgetc e fgetwc)	sistema::IO::StreamReader::Read
getchar, getwchar	Ler caractere stdin (macro versões do fgetchar e fgetwchar)	sistema::Console::Read
_getmaxstdio	Retorna o número de arquivos abertos simultaneamente permitido no fluxo de nível de E/s.	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
Obtém, getws, gets_s, _getws_s	Ler linha stdin	sistema::Console::Read
_getw	Ler binário int do fluxo	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
printf, _printf_l, wprintf, _wprintf_l,printf_s, _printf_s_l, wprintf_s, _wprintf_s_l	Gravar dados formatados em stdout	sistema::Console::gravar
putc, putwc	Gravar caractere em um fluxo (versões de macro do fputc e fputwc)	sistema::IO::StreamWriter::gravar
putchar, putwchar	Gravar caractere stdout (macro versões do fputchar e fputwchar)	sistema::Console::gravar
coloca _putws	Gravar fluxo linha	sistema::Console::gravar
_putw	Escreva binário int para transmitir	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
retroceder	Mover a posição do arquivo para início do fluxo	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
_rmtmp	Remover arquivos temporários criados por tmpfile	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
scanf, _scanf_l, wscanf, _wscanf_l,scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l	Ler dados de stdin formatados	sistema::Console::ReadLine; see also Parse métodos, sistema autônomo sistema::Double::Parse.
setbuf	Buffer de fluxo de controle	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
_setmaxstdio	Defina um máximo para o número de arquivos abertos simultaneamente nível o fluxo de E/S.	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
setvbuf	Buffer de fluxo de controle e o dimensionar do buffer	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
_snprintf, _snwprintf, _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l	Gravar dados formatados do comprimento especificado seqüência de caracteres	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
_snscanf, _snwscanf, _snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l	Ler dados de um período especificado do fluxo de entrada padrão em formato.	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
sprintf, swprintf, sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l	Gravar dados formatados em seqüência	sistema::String::Format
sscanf, swscanf, sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l	Ler dados da seqüência de caracteres em formato	See Parse métodos, sistema autônomo sistema::Double::Parse
_tempnam, _wtempnam	Gerar nome de arquivo temporário na pasta em questão	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
tmpfile, tmpfile_s	Criar arquivo temporário	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
tmpnam, _wtmpnam, tmpnam_s, _wtmpnam_s	Gerar nome de arquivo temporário	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
ungetc, ungetwc	Empurre caractere de volta no fluxo	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
_vcprintf, _vcwprintf, _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l	Gravar dados formatados do console.	sistema::Console::gravar
vfprintf, vfwprintf, vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l	Gravar dados formatados em fluxo	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
vprintf, vwprintf, vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l	Gravar dados formatados em stdout	sistema::Console::gravar
_vsnprintf, _vsnwprintf, vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l	Gravar dados formatados do comprimento especificado buffer	Não aplicável.Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
vsprintf, vswprintf, vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l	Gravar dados formatados em buffer	sistema::String::Format

Quando um programa iniciará a execução, o código de inicialização abre automaticamente vários fluxos: entrada padrão (indicada por stdin), saída padrão (indicada por stdout) e erro padrão (indicada por stderr). Esses fluxos são direcionados para o console (tela e teclado) por padrão.Use freopen Para redirecionar stdin, stdout, ou stderr para um arquivo de disco ou um dispositivo.

Arquivos abertos com as rotinas de fluxo são armazenados em buffer por padrão.The stdout e stderr funções são liberadas sempre que eles estão cheios ou, se estiver escrevendo para um dispositivo de caractere após cada telefonar de biblioteca. Se um programa termina de forma anormal, buffers de saída não podem ser liberados, resultando em perda de dados.Use fflush ou _flushall para garantir que o buffer associado a um arquivo especificado ou todos em aberto buffers são transferidas para o sistema operacional, que pode armazenar em cache dados antes de gravá-la em disco. O recurso de confirmar em disco garante que o Sumário do buffer liberados não é perdido no caso de falha do sistema.

Há duas maneiras para confirmar o Sumário do buffer em disco:

A ligação com o arquivo COMMODE.OBJ para conjunto um sinalizar de confirmar global.A configuração padrão do sinalizar global é n, para "não-confirmar".
Defina o sinalizar de modo para c com fopen ou _fdopen.

Qualquer arquivo aberto especificamente com um a c ou o n sinalizar se comporta de acordo com o sinalizar, independentemente do estado do sinalizar global confirmar/não-confirmar.

Se seu programa não fecha explicitamente um fluxo, o fluxo está fechado automaticamente quando o programa é encerrado.No entanto, você deve fechar um fluxo quando seu programa for concluído com ela, sistema autônomo o número de fluxos que podem ser abertos simultaneamente é limitado.See _setmaxstdio para obter informações sobre esse limite.

Entrada pode seguir saída diretamente apenas com uma telefonar de intermediáriasfflush ou para um posicionamento de arquivos funcionam)fseek, fsetpos, ou rewind). Saída pode seguir a entrada sem uma telefonar intermediárias para uma função de posicionamento de arquivo se a operação de entrada encontrar o participante do arquivo.

Consulte também

Referência

Entrada e Saída

em time de execução Rotinas por categoria

Fluxo de E/S

Consulte também

Referência

Recursos adicionais