_fsopen, _wfsopen

Abre um fluxo com compartilhamento de arquivos.

Sintaxe

FILE *_fsopen(
   const char *filename,
   const char *mode,
   int shflag
);
FILE *_wfsopen(
   const wchar_t *filename,
   const wchar_t *mode,
   int shflag
);

Parâmetros

filename
Nome do arquivo a ser aberto.

mode
Tipo de acesso permitido.

shflag
Tipo de compartilhamento permitido.

Valor retornado

Cada uma dessas funções retorna um ponteiro para o fluxo. Um valor de ponteiro nulo indica um erro. Se filename for ou NULL mode for ou uma cadeia de caracteres vazia, essas funções invocarão o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução puder continuar, essas funções retornarão NULL e definirão errno para EINVAL.

Para obter mais informações sobre esses e outros códigos de erro, consulte errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

A função _fsopen abre o arquivo especificado por filename como um fluxo e prepara o arquivo para leitura ou gravação compartilhada posterior, conforme definido pelo modo e pelos argumentos de shflag. _wfsopen é uma versão de caractere largo de _fsopen; os argumentos filename e mode para _wfsopen são cadeias de caracteres largos. Caso contrário, _wfsopen e _fsopen se comportam de forma idêntica.

A cadeia de caracteres mode especifica o tipo de acesso solicitado para o arquivo, conforme mostrado na tabela a seguir.

Use os tipos "w" e "w+" com cuidado porque eles podem destruir os arquivos existentes.

Quando um arquivo for aberto com o tipo de acesso "a" ou "a+", todas as operações de gravação ocorrerão no final do arquivo. O ponteiro do arquivo pode ser reposicionado usando fseek ou rewind, mas sempre é movido de volta para o final do arquivo antes que qualquer operação de gravação seja executada. Portanto, os dados existentes não podem ser substituídos. Quando o tipo de acesso "r+", "w+" ou "a+" for especificado, tanto a leitura quanto a gravação serão permitidas (nesse caso, diz-se que o arquivo está aberto para atualização). No entanto, ao alternar entre leitura e gravação, deverá haver uma operação fsetpos, fseek ou rewind. A posição atual pode ser especificada para a operação fsetpos ou fseek, se desejado. Além dos valores acima, um dos caracteres seguintes pode ser incluído em mode para especificar o modo de conversão para novas linhas e para o gerenciamento de arquivo.

Se t for ou b não fornecido em mode, o modo de tradução é definido pela variável _fmodedefault-mode . Se t ou b for prefixado para o argumento, a função falha e retorna NULL. Para saber mais sobre os modos de texto e binário, consulte E/S de texto e arquivo de modo binário.

DEm relação e T :

• T evita gravar o arquivo no disco, desde que a pressão da memória não exija isso. Para obter mais informações, consulte FILE_ATTRIBUTE_TEMPORARY em Constantes de atributo de arquivo e também esta postagem no blog É apenas temporário.
• D Especifica um arquivo regular que é gravado no disco. A diferença é que ele é excluído automaticamente quando é fechado. Você pode combinar TD para obter ambas as semânticas.

_fsopen e _wfsopen são variantes específicas da Microsoft do fopen. Eles não fazem parte do padrão ANSI. Para uma função mais portátil e segura, se você não precisar de compartilhamento de arquivos, considere _wfopen_s ou fopen_s.

O argumento shflag é uma expressão constante que consiste em uma das seguintes constantes de manifesto, definidas em Share.h.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Requisitos

Exemplo

// crt_fsopen.c

#include <stdio.h>
#include <stdlib.h>
#include <share.h>

int main( void )
{
   FILE *stream;

   // Open output file for writing. Using _fsopen allows us to
   // ensure that no one else writes to the file while we are
   // writing to it.
    //
   if( (stream = _fsopen( "outfile", "wt", _SH_DENYWR )) != NULL )
   {
      fprintf( stream, "No one else in the network can write "
                       "to this file until we are done.\n" );
      fclose( stream );
   }
   // Now others can write to the file while we read it.
   system( "type outfile" );
}

No one else in the network can write to this file until we are done.

Confira também

E/S de fluxo
fclose, _fcloseall
_fdopen, _wfdopen
ferror
_fileno
fopen, _wfopen
freopen, _wfreopen
_open, _wopen
_setmode
_sopen, _wsopen