fopen

Abre um arquivo e retorna um identificador de arquivo.

Categoria: Data Import and Analysis > Data Import and Export

Sintaxe

fid = fopen(filename)

Abre o arquivo para leitura.

fid = fopen(filename, permission)

Abre com um modo como 'w', 'a', 'r+'; acrescente t para modo texto.

[fid, msg] = fopen(...)

Retorna também uma mensagem de erro quando a abertura falha.

[name, perm, machinefmt, enc] = fopen(fid)

Consulta as propriedades de um arquivo aberto.

Descrição

fopen não gera erro quando o arquivo não existe. Ela retorna -1, então verifique o resultado antes de ler. Os identificadores 0, 1 e 2 são reservados à entrada padrão, à saída padrão e ao erro padrão.

Todo arquivo aberto deve ser fechado com fclose.

Argumentos de entrada

filename
Nome do arquivo.
permission
'r' leitura (padrão), 'w' escrita com truncamento, 'a' acréscimo, 'r+' leitura e escrita, 'w+' e 'a+' para variantes de atualização.

Argumentos de saída

fid
Identificador inteiro, 3 ou maior, para passar às demais funções de arquivo; -1 se o arquivo não pôde ser aberto.
msg
Texto que descreve por que a abertura falhou.

Exemplo

Abrir para leitura, com um caso que falha

[fid, msg] = fopen('missing.txt')
fid = fopen('ok.txt', 'w');
fprintf(fid, 'hi');
fclose(fid);
fid = fopen('ok.txt');
[name, perm] = fopen(fid)
fclose(fid);
Saída
fid = -1
msg = 'No such file or directory'
name = 'ok.txt'
perm = 'r'

Veja também

fclose fprintf fread fgetl fileread