Main Content

csvread

(不推荐)读取逗号分隔值 (CSV) 文件

不推荐使用 csvread。请改用 readmatrix。有关详细信息,请参阅兼容性注意事项

说明

示例

M = csvread(filename) 将逗号分隔值 (CSV) 格式化文件读入数组 M 中。该文件只能包含数值。

示例

M = csvread(filename,R1,C1) 从行偏移量 R1 和列偏移量 C1 开始读取文件中的数据。例如,偏移量 R1=0C1=0 指定文件中的第一个值。

示例

M = csvread(filename,R1,C1,[R1 C1 R2 C2]) 仅读取行偏移量 R1R2 及列偏移量 C1C2 界定的范围。另一种定义范围的方法是使用电子表格表示法(例如 'A1..B7')而非 [0 0 6 1]

示例

全部折叠

创建一个名为 csvlist.dat 的包含逗号分隔值的文件。

   02, 04, 06, 08
   03, 06, 09, 12
   05, 10, 15, 20
   07, 14, 21, 28
  

读取文件中的数值。

filename = 'csvlist.dat';
M = csvread(filename)
M =

     2     4     6     8
     3     6     9    12
     5    10    15    20
     7    14    21    28

从上一个示例中描述的文件读取从第一行下方两行开始的矩阵。

M = csvread('csvlist.dat',2,0)
M =

     5    10    15    20
     7    14    21    28

从第一个示例中描述的文件读取行偏移量 1 和 2 及列偏移量 0 和 2 界定的矩阵。

M = csvread('csvlist.dat',1,0,[1,0,2,2])
M =

     3     6     9
     5    10    15

输入参数

全部折叠

文件名,指定为字符向量或字符串。

示例: 'myFile.dat'"myFile.dat"

数据类型: char | string

起始行偏移量,指定为非负整数。第一行的偏移量为 0。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

起始列偏移量,指定为非负整数。第一列的偏移量为 0。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

结束行偏移量,指定为非负整数。第一行的偏移量为 0。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

结束列偏移量,指定为非负整数。第一列的偏移量为 0。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

提示

  • 通过指定行和列偏移量跳过标题行或列。文件而非标题中的所有值必须是数值。

算法

csvread 用零填充空的分隔字段。当 csvread 函数读取其行以非空格分隔符(例如分号)结尾的数据文件时,它返回矩阵 M,该矩阵包含由零组成的额外最后一列。

csvread 将任何复数作为一个整体导入到复数字段中,将实部和虚部转换为指定的数字类型。表中显示了复数的有效形式。

形式

示例

±<real>±<imag>i|j

5.7-3.1i

±<imag>i|j

-7j

复数中的嵌入空白无效,将视为字段分隔符。

版本历史记录

在 R2006a 之前推出

全部折叠

R2019a: 不推荐使用 csvread

不推荐使用 csvread。请改用 readmatrix。目前没有删除 csvread 的计划。

从 R2019a 开始,请使用 readmatrix 函数从 csv 文件中读取矩阵。与 csvread 函数相比,readmatrix 函数具有以下优势:

  • 更好的跨平台支持和性能

  • 自动检测数据格式和类型

  • 能够使用导入选项来控制数据导入过程,包括错误和缺失数据的处理

下表显示了 csvread 的典型用法,以及如何更新您的代码以改用 readmatrix

不推荐

推荐

M = csvread(filename)
M = readmatrix(filename)