<< fgets stream manager filewrite >>

fileread


Read contents of file as text.


Syntax


str = fileread(filename)
str = fileread(filename, type)
str = fileread(filename, 'char', eol)
str = fileread(filename, 'char', eol, encoding)

Input argument


filename

a string: a file name

type

a string: 'char', 'cell' or 'string'. 'cell' will converts text file to a cell of string. 'string' will converts text file to a string array. 'char' by default.

eol

a string: 'native', 'pc' or 'unix'. Set end of line. 'unix' by default.

encoding

a string: 'UTF-8' (default), 'auto', 'ISO-8859-1', 'windows-1251', 'windows-1252', ...

Output argument


str

a string, cell of strings or string array.

Description


fileread read contents of file as text.

if encoding is 'auto', nelson will try to detect best encoding to read contents of file as text.

Examples


str = fileread([nelsonroot(),'/CHANGELOG.md'])
str = fileread([nelsonroot(),'/CHANGELOG.md'], 'char')
str = fileread([nelsonroot(),'/CHANGELOG.md'], 'cell')
str = fileread([nelsonroot(),'/CHANGELOG.md'], 'string')

str = 'живете зело, земля, и иже и како люди';
filewrite([tempdir(), 'example_fileread.txt'], str, 'native', 'windows-1251')
T1 = fileread([tempdir(), 'example_fileread.txt'], 'char', 'native', 'windows-1251')
T2 = fileread([tempdir(), 'example_fileread.txt'], 'string', 'native', 'auto')

See also


fgetl, filewrite.

History


Version Description
1.0.0 initial version

Author


Allan CORNET

<< fgets stream manager filewrite >>