Fluxo de i/O

  • Artigo

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

Rotinas de fluxo de i/O

Rotina

Uso

.Equivalente do NET Framework

clearerr,clearerr_s

Indicador de erro clara para fluxo

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

fclose

Fluxo de fechamento

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

Feche todos os fluxos, exceto stdin, stdout, estderr

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

Associar o fluxo com o descritor de arquivo do arquivo aberto

System::IO::FileStream::FileStream

feof

Teste para o fim do arquivo no fluxo

System::IO::FileStream::Read

ferror

Teste de erro no fluxo

Não aplicável.Para chamar 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

System::IO::FileStream::flush

fgetc, fgetwc

Ler caracteres de fluxo (funcionarem versões do getc e getwc)

System::IO::StreamReader::Read

_fgetchar, _fgetwchar

Ler caractere da stdin (funcionarem versões do getchar e getwchar)

System::console::Read

fgetpos

Obtenha o indicador de posição do fluxo

System::IO::FileStream::position

fgets, fgetws

Ler a seqüência de caracteres do fluxo

System::IO::StreamReader::ReadLine, System::IO::TextReader::ReadBlock

_fileno

Obter o descritor de arquivo associado ao fluxo

System::IO::FileStream::Handle

_flushall

Liberar todos os fluxos para buffer ou dispositivo de armazenamento

System::IO::FileStream::flush, System::IO::StreamWriter::Flush, System::IO::TextWriter::Flush, System::IO::BinaryWriter::Flush

fopen, _wfopen,fopen_s, _wfopen_s

Abrir fluxo

System::IO::File::Open

fprintf, _fprintf_l, fwprintf, _fwprintf_l, fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

Gravar os dados formatados em fluxo

System::IO::StreamWriter::Write

fputc, fputwc

Escreva um caractere em um fluxo (funcionarem versões do putc e putwc)

System::IO::StreamWriter::Write

_fputchar, _fputwchar

Escreva o caractere para stdout (funcionarem versões do putchar e putwchar)

System::console::Write

fputs, fputws

Gravar a seqüência de caracteres em fluxo

System::IO::StreamWriter::Write

fRead

Ler dados não formatados de fluxo

System::IO::FileStream::Read

freopen, _wfreopen,freopen_s, _wfreopen_s

Reatribuir FILE ponteiro de fluxo para o novo arquivo ou dispositivo

System::IO::File::Open

fscanf, fwscanf,fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l

Dados do fluxo de formatados de leitura

System::IO::StreamReader::ReadLine; Consulte também Parse métodos, como System::Double::Parse.

fseek, _fseeki64

Mover a posição do arquivo para dada local

System::IO::FileStream::position, System::IO::FileStream:: Seek

fsetpos

Indicador de posição do conjunto de fluxo

System::IO::FileStream::position

_fsopen, _wfsopen

Com o compartilhamento de arquivo ao abrir fluxo

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

ftell, _ftelli64

Obter a posição atual do arquivo

System::IO::FileStream::position

Fwrite

Os itens de dados não formatados para o fluxo de gravação.

System::IO::FileStream::Write

getc, getwc

Ler caracteres de fluxo (versões de macro do fgetc e fgetwc)

System::IO::StreamReader::Read

getchar, getwchar

Ler caractere da stdin (versões de macro do fgetchar e fgetwchar)

System::console::Read

_getmaxstdio

Retorna o número de arquivos abertos simultaneamente permitido no fluxo de nível de i/O.

Não aplicável.Para chamar 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

Linha de leitura dostdin

System::console::Read

_getw

Leitura binário int do fluxo

Não aplicável.Para chamar 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 os dados formatados parastdout

System::console::Write

putc, putwc

Gravar caractere em um fluxo (versões de macro do fputc e fputwc)

System::IO::StreamWriter::Write

putchar, putwchar

Escreva o caractere para stdout (versões de macro do fputchar e fputwchar)

System::console::Write

Coloca, _putws

Gravar fluxo linha

System::console::Write

_putw

Escrever binário int a fluxo

Não aplicável.Para chamar 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 o início do fluxo de

Não aplicável.Para chamar 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 portmpfile

Não aplicável.Para chamar 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

Leitura formatado dados a partir destdin

System::console::ReadLine; Consulte também Parse métodos, como System::Double::Parse.

setbuf

O buffer de fluxo de controle

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

_setmaxstdio

Defina nível máximo para o número de arquivos abertos simultaneamente o fluxo de i/O.

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

setvbuf

O buffer de fluxo de controle e o tamanho do buffer

Não aplicável.Para chamar 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 de comprimento especificado em seqüência

Não aplicável.Para chamar 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

Leitura formatado dados de um comprimento especificado do fluxo de entrada padrão.

Não aplicável.Para chamar 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

System::String::Format

sscanf, swscanf,sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l

Ler dados de seqüência de caracteres em formato

Consulte Parse métodos, como System::Double::Parse

_tempnam, _wtempnam

Gerar um nome de arquivo temporário no diretório de dado

Não aplicável.Para chamar 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 chamar 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 um nome de arquivo temporário

Não aplicável.Para chamar a função c padrão, use PInvoke.Para obter mais informações, consulte Exemplos de invocação de plataforma.

ungetc, ungetwc

Empurre o caractere no fluxo

Não aplicável.Para chamar 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

Escreva dados formatados para o console.

System::console::Write

vfprintf, vfwprintf,vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Gravar os dados formatados em fluxo

Não aplicável.Para chamar 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 os dados formatados parastdout

System::console::Write

_vsnprintf, _vsnwprintf,vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l

Gravar os dados formatados de comprimento especificado buffer

Não aplicável.Para chamar 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

System::String::Format

Quando um programa começa a execução, o código de inicialização abre automaticamente vários fluxos: entrada padrão (apontada por stdin), saída padrão (apontada por stdout) e erro padrão (apontada por stderr).Esses fluxos são direcionados para o console (teclado e tela) 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.O stdout e stderr funções são liberadas sempre que eles estão cheios ou, se você estiver escrevendo para um dispositivo de caractere, após cada chamada de biblioteca.Se um programa é fechado abruptamente, 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 os buffers são liberadas para o sistema operacional, que pode armazenar em cache dados antes de gravá-la em disco.O recurso de confirmação em disco garante que o conteúdo do buffer liberados não é perdido em caso de uma falha do sistema.

Há duas maneiras para confirmar o conteúdo do buffer em disco:

  • A ligação com o arquivo COMMODE.OBJ para definir um sinalizador de confirmação global.A configuração padrão do sinalizador global é n, para "não-confirmação".

  • Set the mode flag to c with fopen or _fdopen.

Especificamente, qualquer arquivo aberto com um a c ou o n sinalizador se comporta de acordo com ao sinalizador, independentemente do estado do sinalizador global não/confirmação-confirmação.

Se seu programa não fechar explicitamente um fluxo, o fluxo está fechado automaticamente, quando o programa é encerrado.No entanto, você deve fechar um fluxo quando o programa termina com ele, como o número de fluxos que podem ser abertos ao mesmo tempo é limitado.Consulte _setmaxstdio para obter informações sobre esse limite.

Entrada pode seguir a saída diretamente apenas com uma chamada de interveniente fflush ou a uma função de posicionamento de arquivo (fseek, fsetpos, ou rewind).Saída pode seguir a entrada sem uma chamada intermediárias para uma função de posicionamento de arquivo se a operação de entrada encontrar o final do arquivo.

Consulte também

Referência

Entrada e Saída

Rotinas de tempo de execução por categoria