简单文件I/O(GNU Octave(版本9.3.0))

: val = save_default_options () ¶

: old_val = save_default_options (new_val) ¶

: old_val = save_default_options (new_val, "local") ¶

查询或设置内部变量,该变量指定的默认参数save命令,并定义默认格式。

默认值为"-text"(Octave自己的基于文本的文件格式)。详见的文档save命令进行其他选择。

当从具有的函数内部调用时"local"参数,则该变量会为函数及其调用的任何子程序在本地进行更改。退出函数时将恢复原始变量值。

详见: save, save_header_format_string, save_precision.

: val = save_precision () ¶

: old_val = save_precision (new_val) ¶

: old_val = save_precision (new_val, "local") ¶

查询或设置内部变量,该变量指定以文本格式保存数据时要保留的位数。

默认值为17,这是无损保存和恢复IEEE-754双值所需的最小值;对于IEEE-754单个值,最小值为9。如果文件大小是一个问题,那么最好选择二进制格式来保存数据,而不是降低保存值的精度。

当从具有的函数内部调用时"local"参数,则该变量会为函数及其调用的任何子程序在本地进行更改。退出函数时将恢复原始变量值。

详见: save_default_options.

: val = save_header_format_string () ¶

: old_val = save_header_format_string (new_val) ¶

: old_val = save_header_format_string (new_val, "local") ¶

查询或设置内部变量,该变量指定用于在Octave保存的文本格式数据文件开头写入的注释行的格式字符串。

格式字符串被传递到strftime并且必须以字符“”开头#,并且不包含换行符。如果的值save_header_format_string是空字符串,头注释是从文本格式的数据文件中发出的。默认值为

"# Created by Octave VERSION, %a %b %d %H:%M:%S %Y %Z <USER@HOST>"

当从具有的函数内部调用时"local"参数,则该变量会为函数及其调用的任何子程序在本地进行更改。退出函数时将恢复原始变量值。

详见: strftime, save_default_options.

: load file ¶

: load options file ¶

: load options file v1 v2 … ¶

: S = load ("options", "file", "v1", "v2", …) ¶

: load file options ¶

: load file options v1 v2 … ¶

: S = load ("file", "options", "v1", "v2", …) ¶

加载命名变量v1, v2,…,来自文件file.

如果未指定任何变量,则将加载文件中找到的所有变量。与一样save,要提取的变量列表可以是全名,也可以使用模式语法。文件的格式是自动检测到的,但可以通过提供适当的参数来覆盖。

如果使用函数形式调用load

load ("-option1", ..., "file", "v1", ...)

然后options, file,和变量名参数(v1,…)必须指定为字符串。

如果一个未符号为全局的变量是在具有相同名称的全局符号已经存在的情况下从文件中加载的,则会将其加载到全局符号表中。此外,如果一个变量在文件中符号为全局,并且存在局部符号,则局部符号会移动到全局符号表中,并从文件中给定值。

如果使用单个输出参数调用,Octave将返回数据,而不是在符号表中插入变量。如果数据文件只包含数字(制表符或空格分隔的列),则会返回一个值矩阵。否则load返回一个结构体,其成员与文件中变量的名称相对应。

这个load命令可以读取以Octave的文本和二进制格式存储的数据,以及MATLAB的二进制格式。如果使用zlibsupport编译,它还可以加载gzip压缩文件。它将自动检测文件类型,并从不同的浮点格式进行转换(目前只有IEEE big和little endian,但未来可能会添加其他格式)。

的有效参数load下表中列出了。

-force: 此参数可用于向后兼容性,但会被忽略。Octave现在用文件中相同名称的变量覆盖当前内存中的变量。
-ascii: 强制Octave假定文件包含文本格式的数字列,没有任何标头或其他信息。文件中的数据将加载为单个数字矩阵,该矩阵具有从文件名称派生的变量名称。
-binary: 强制Octave假定文件为Octave的二进制格式。
-hdf5: 强制Octave假定文件为HDF5格式(HDF5是一种免费的、可移植的二进制格式,从伊利诺伊大学国家超级计算应用中心开发。) 注意：load只被设计用于读取用save保存的HDF5文件, 而且尝试读取其他的 HDF5 文件可能失败或者生成不可预测的结果。-hdf5 选项还提供一个有限的能力去读取使用MATLAB的-v7.3 选项生成的文件 (保存为HDF5 格式) ，尽管很多数据类型仍然不支持。这个格式只在 Octave 在编译时链接 HDF5 依赖库时才可用.
-import: 此参数可用于向后兼容性,但会被忽略。Octave现在可以支持多维HDF数据,如果变量名是无效的Octave标识符,则可以自动修改变量名。
-text: 强制Octave假定文件为Octave的文本格式。
-v7.3
-V7.3
-7.3: Octave 没有支持 MATLAB’的 v7.3 二进制数据格式。因为 v7.3 格式是一个 HDF5 为基础的格式, "-hdf5" 参数可能被用于打开 v7.3 格式的文件. 注意：Octave现在不能用这种格式保存。
-v7
-V7
-7
-mat7-binary: 强制Octave假定文件在MATLAB的版本7二进制格式。
-v6
-V6
-6
-mat
-mat-binary: 强制Octave假定文件在MATLAB的版本6二进制格式。
-v4
-V4
-4
-mat4-binary: 强制Octave假定文件在MATLAB的版本4二进制格式。

详见: save, dlmwrite, csvwrite, fwrite.

: str = fileread (filename) ¶

: str = fileread (filename, param, value, …) ¶

阅读的内容filename并将其作为字符串返回。

param, value是可选的参数和值对。有效参数包括:

"Encoding": 指定从文件中读取时使用的编码。这是一个有效编码标识符的字符串。默认为"utf-8".

详见: fopen, fread, fscanf, importdata, textscan, type.

: fmtstr = native_float_format () ¶

以字符串形式返回本机浮点格式。

: fdisp (fid, x) ¶

显示的值x在溪流上fid.

例如

fdisp (stdout, "The value of pi is:"), fdisp (stdout, pi)

     -| the value of pi is:
     -| 3.1416

请注意,的输出fdisp总是以换行符结尾。

详见: disp.

: dlmwrite (file, M) ¶

: dlmwrite (file, M, delim, r, c) ¶

: dlmwrite (file, M, key, val …) ¶

: dlmwrite (file, M, "-append", …) ¶

: dlmwrite (fid, …) ¶

编写数字矩阵M到文本文件file使用限幅器。

file应该是从给定的文件名或可写文件IDfopen.

参数delim指定用于分隔行中值的分隔符。如果未指定分隔符,则使用逗号字符,isused。

的值r指定要添加到文件开头的仅限分隔符的行数。

的值c指定每行数据前要加的分隔符数。

如果参数"-append"的末尾file.

此外,以下关键字-值对可能会出现在参数列表的末尾:

"append": 任何一个"on"或"off"详见"-append"在上面
"delimiter": 详见delim在上面
"newline": 用于分隔每一行的字符。此参数有三种特殊情况。"unix"被更改为"\n","pc"被更改为"\r\n"和"mac"被更改为"\r"。任何其他值都直接用作换行符。
"roffset": 详见r在上面
"coffset": 详见c在上面
"precision": 写入文件时要使用的精度。它可以是一个格式字符串(如fprintf所用),也可以是多个有效数字。

dlmwrite ("file.csv", reshape (1:16, 4, 4));

dlmwrite ("file.tex", a, "delimiter", "&", "newline", "\n")

详见: dlmread, csvread, csvwrite.

: data = dlmread (file) ¶

: data = dlmread (file, sep) ¶

: data = dlmread (file, sep, r0, c0) ¶

: data = dlmread (file, sep, range) ¶

: data = dlmread (…, "emptyvalue", EMPTYVAL) ¶

从文本文件中读取数字数据file它使用分隔符sep数据值之间。

如果sep未定义,字段之间的分隔符从文件本身确定。

可选标量参数r0和c0定义要读取的数据的起始行和列。这些值从零开始索引,即,第一数据行对应于零的索引。

这个range参数指定读取哪些数据元素。参数的第一种形式是包含左上角和右下角的4元素向量[R0,C0,R1,C1]其中索引是基于零的。指定最后一列——相当于end索引时--使用值Inf。或者,aspreadsheet样式的表单,例如"A2..Q15"或"T1:AA5"可以使用。最低字母索引'A'指第一列。最低的行索引为1。

file应该是从给定的文件名或文件idfopen。在较低的情况下,读取文件直到到达文件末尾。

这个"emptyvalue"参数可用于指定用于填充空字段的值。默认值为零。请注意,任何非数字值(如文本)也会被替换为"emptyvalue".

详见: csvread, textscan, dlmwrite.

: csvwrite (filename, x) ¶

: csvwrite (filename, x, dlm_opt1, …) ¶

编写数字矩阵x到文件filename不可分数值 (CSV)格式。

此函数等效于

dlmwrite (filename, x, ",", dlm_opt1, ...)

任何可选参数都直接传递给dlmwrite详见dlmwrite).

详见: csvread, dlmwrite, dlmread.

: x = csvread (filename) ¶

: x = csvread (filename, dlm_opt1, …) ¶

读取逗号分隔值(CSV)文件filename进入矩阵x.

注意:只能读取包含数字数据的CSV文件。

此函数等效于

x = dlmread (filename, "," , dlm_opt1, ...)

任何可选参数都直接传递给dlmread详见dlmread).

详见: dlmread, textscan, csvwrite, dlmwrite.

: [a, …] = textread (filename) ¶

: [a, …] = textread (filename, format) ¶

: [a, …] = textread (filename, format, n) ¶

: [a, …] = textread (filename, format, prop1, value1, …) ¶

: [a, …] = textread (filename, format, n, prop1, value1, …) ¶

此函数已过时。使用textscan相反

从文本文件中读取数据。

文件filename根据读取和解析format。该函数的行为类似strread除了它通过解析文件而不是字符串来工作。详见的文档strread详细信息。

除了支持的参数之外strread,此函数还支持两个:

"headerlines":第一个value的行数filename被跳过。
"endofline":指定单个字符或"\r\n"。如果没有给定值,则将从文件中推断出该值。如果设置为(空字符串)EOL作为分隔符被忽略。

可选输入n(格式重复计数)指定要使用格式字符串的次数或要读取的行数,以读取时先发生的为准。前者相当于要求数据输出向量的长度N注意,当读取具有引用多行的格式字符串的文件时,n应该是要读取的行数,而不是字符串使用的格式数。

如果格式字符串为空(不仅仅是被省略),并且文件只包含数字数据(不包括头行),textread将返回一个矩形矩阵,其列数与文件第一行数据上的数字字段数相匹配。空字段将作为零值返回。

示例:

  Assume a data file like:
  1 a 2 b
  3 c 4 d
  5 e

  [a, b] = textread (f, "%f %s")
  returns two columns of data, one with doubles, the other a
  cellstr array:
  a = [1; 2; 3; 4; 5]
  b = {"a"; "b"; "c"; "d"; "e"}

  [a, b] = textread (f, "%f %s", 3)
  (read data into two culumns, try to use the format string
  three times)
  returns
  a = [1; 2; 3]
  b = {"a"; "b"; "c"}

  With a data file like:
  1
  a
  2
  b

  [a, b] = textread (f, "%f %s", 2)
  returns a = 1 and b = {"a"}; i.e., the format string is used
  only once because the format string refers to 2 lines of the
  data file.  To obtain 2x1 data output columns, specify N = 4
  (number of data lines containing all requested data) rather
  than 2.

详见: textscan, load, dlmread, fscanf, strread.

: C = textscan (fid, format) ¶

: C = textscan (fid, format, repeat) ¶

: C = textscan (fid, format, param, value, …) ¶

: C = textscan (fid, format, repeat, param, value, …) ¶

: C = textscan (str, …) ¶

: [C, position, errmsg] = textscan (…) ¶

从文本文件或字符串中读取数据。

字符串str或与关联的文件fid读取并根据format。该函数是的扩展strread和textread。差异包括:从文件或字符串中读取的能力、附加参数和附加格式值。

输入被解释为单词、分隔符(如空白)和文字的序列。构成分隔符和空白的字符从参数决定。格式从散布在文字之间的格式值组成。在该格式中,空白是连续文字之间的分隔符,但在其他情况下会被忽略。

输出C是一个元胞数组,其中列的数量从格式值的数量决定。

输入的第一个字与格式的第一个值匹配,并放置在输出的第一列中;第二个与第二个值匹配并放在第二列中,依此类推。如果单词多于值,则重复该过程,直到所有单词都已处理完毕或达到repeat已满足(见下文)。

字符串format描述中的单词str应该进行解析。如中所示fscanf,任何非这些值格式的(非空白)文本都被视为文本。如果两个格式值之间有一个文字,那么相同的文字必须出现在匹配单词之间的输入流中。

以下值有效:

%f
%f64
%n: 该单词被解析为数字并转换为双精度。
%f32: 单词被解析为数字并转换为single(float)。
%d
%d8
%d16
%d32
%d64: 该单词被解析为数字,并转换为int8、int16、int32或int64。如果未指定大小,则使用int32。
%u
%u8
%u16
%u32
%u64: 单词被解析为数字,并转换为uint8、uint16、uint32或uint64。如果没有指定大小,则使用uint32。
%s: 该单词被解析为以空格前最后一个字符、行尾或参数中指定的分隔符结尾的字符串。
%q: 该单词被解析为“带引号的字符串”。如果字符串的第一个字符是双引号(“),则该字符串包括所有内容,直到匹配的双引号为止,包括空格、分隔符和行尾字符。如果输入中出现一对连续的双引号,则输出中会用一个双引号替换。例如,输入“He said”“Hello”“将返回值”He said'Hello“。
%c: 读取输入的下一个字符。这包括分隔符、空白和行尾字符。
%[…]
%[^…]: 在第一种形式中,单词从最长的一行组成,该行仅从括号之间的字符组成。字符范围可以通过连字符指定;例如,%[0-9a-zA-Z]匹配所有字母数字字符(如果基础字符集是ASCII)。自从MATLAB从整体上处理连字符,此扩展仅适用于字母数字字符。要在集合中包含“-”,它应该出现在括号中的第一个或最后一个;要包含“]”,它应该是第一个字符。如果第一个字符是“^”,则单词从个字符组成不上市的
%N…: 对于%s、%c%d、%f、%n、%u,可选宽度可以指定为%Ns等。其中n是大于1的整数。对于%c,这将导致丢失N个字符,而不是单个字符。对于其他值,它是基于读取的字符数的上限;正常的分隔符可能会导致读取更少的字符。对于复数,这一限制分别适用于实数和虚数分量。对于%f和%n,允许使用像%n.Mf这样的格式值,其中M是要考虑的小数点后字符数的上限;跳过后面的数字。例如,值%8.2f将12.345e6读取为1.234e7。
%*…: 将跳过从转换值的剩余部分指定的单词。
literals: 此外,该格式可能包含文字字符串;这些将在阅读过程中跳过。如果输入字符串与此文字不匹配,则处理终止。

对应于第一个值的解析词在第一个输出参数中返回,对于其余的值也是如此。

默认情况下,如果只有一个输入参数,format是f这意味着数字从输入读取到单列向量中。如果format显式为空()则textscan将返回与输入的第一个数据行上的字段数相匹配的多个列中的数据。只有当输入仅为数字时,这两种方法中的任何一种都适用。

例如,字符串

str = "\
Bunny Bugs   5.5\n\
Duck Daffy  -7.5e-5\n\
Penguin Tux   6"

: A = importdata (fname) ¶

: A = importdata (fname, delimiter) ¶

: A = importdata (fname, delimiter, header_rows) ¶

: [A, delimiter] = importdata (…) ¶

: [A, delimiter, header_rows] = importdata (…) ¶

从文件导入数据fname.

输入参数:

fname包含数据的文件的名称。
delimiter分隔数据列的字符。使用\t用于参数卡。(仅适用于ASCII文件)
header_rows数据开始之前的标题行数。(仅对ASCII文件有效)

支持不同的文件类型:

ASCII表
使用指定的标题行数和指定的分隔符导入ASCII表。
图像文件
MATLAB文件
电子表格文件(取决于外部软件)
WAV文件

详见: textscan, dlmread, csvread, load.

: B = rescale (A) ¶

: B = rescale (A, l, u) ¶

: B = rescale (…, "inputmin", inmin) ¶

: B = rescale (…, "inputmax", inmax) ¶

将矩阵元素缩放到指定的值范围。

使用单个矩阵参数调用时A,重新缩放元素以占用间隔[0,1]。

可选输入[l, u]将缩放A到具有下界的区间l和上限u.

可选输入"inputmin"替换所有小于指定值的元素inmin具有inmin。同样,optionalinput"inputmax"替换所有大于指定值的元素inmax具有inmax.如果未指定,则从数据本身获取的最小值和最大值(inmin=最小值(A(:)) 和inmax=最大值(A(:)) ).

编程说明:应用的公式为

B= l+ ((A- inmin) ./ (inmax- inmin)).* (u- l)

输出矩阵的类B如果输入为单一Aissingle,但对于双精度、整数或逻辑类型的输入,它属于双精度类。

详见: bounds, min, max.

14.1.3简单文件I/O¶