<< filewrite

Stream manager

fprintf >>

---

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