fopen

Open a file in Nelson.

Syntax

• fid = fopen(filename)

• fid = fopen(filename, permission)

• [fid, msg] = fopen(filename)

• [fid, msg] = fopen(filename, permission)

• [fid, msg] = fopen(filename, permission, machinefmt, encoding)

• [filename, permission, machinefmt, encoding] = fopen(fid)

• fids = fopen('all')

Input argument

• filename - a string: filename to open

• permission - a string: permission applied on file: 'r', 'w', 'a', 'r+', 'a+'

• machinefmt - a string: machine format applied on file: 'n' or 'native', 'b' or 'ieee-be', 'l' or 'ieee-le', 's' or 'ieee-be.l64', 'a' or 'ieee-le.l64'

• encoding - a string: ccharacter encoding applied on file: 'UTF-8', 'ISO-8859-1', 'windows-1251', 'windows-1252', ...

Output argument

• fid - an integer value: a file descriptor or -1 if there is an error.

• msg - a string: error message returned by fopen or ''.

• fids - a vector of integer values: list of files descriptor opened in Nelson.

Description

fopen opens a file in Nelson.

functions fprintf, fgetl, fgets, fread, and fwrite use character encoding for subsequent read and write operations.

Examples

fid = fopen([tempdir(), filesep(), 'fopen_tst'], 'wt');
[filename, permission] = fopen(fid)
fids = fopen('all')
status = fclose(fd)
[filename, permission] = fopen(stdin)
[filename, permission] = fopen(stdout)
[filename, permission] = fopen(stderr)

characters encoding

TEXT_REF = 'Виртуальная';
filename = [tempdir(), 'fwrite_example_Windows-1251.txt'];
F = fopen(filename, 'wt', 'n', 'windows-1251');
W = fwrite(F, TEXT_REF, 'char')
fclose(F);
F = fopen(filename, 'rt', 'n', 'windows-1251');
TXT_READ = fread(F, '*char')
fclose(F);

See also

fclose, feof.

History

Version	Description
1.0.0	initial version

Author

Allan CORNET