添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接

xlsread

(不推荐)读取电子表格文件

全页折叠

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

说明

示例

num = xlsread( filename ) 读取名为 filename Microsoft ® Excel ® 电子表格工作表中的第一个工作表,并在一个矩阵中返回数值数据。

num = xlsread( filename , sheet ) 读取指定的工作表。

示例

num = xlsread( filename , xlRange ) 从工作簿的第一个工作表的指定范围内读取数据。使用 Excel 范围语法,例如 'A1:C3'

示例

num = xlsread( filename , sheet , xlRange ) 读取指定的工作表和范围。

num = xlsread( filename , sheet , xlRange , 'basic' ) basic 导入模式下读取电子表格中的数据。如果您的计算机未安装 Windows ® 版 Excel 或者您正在使用 MATLAB ® Online™ xlsread 会自动在 basic 导入模式下运行,该模式支持 XLS、XLSX、XLSM、XLTX 和 XLTM 文件。

如果不指定所有参量,请使用空字符向量 '' 作为占位符,例如, num = xlsread(filename,'','','basic')

示例

[ num , txt , raw ] = xlsread( ___ ) 支持上述语法中的任何输入参量,且可在元胞数组 txt 中返回文本字段,在元胞数组 raw 中返回数值数据和文本数据。

___ = xlsread( filename ,-1) 打开一个 Excel 窗口以便按交互方式来选择数据。选择工作表,将鼠标拖放到所需范围上,然后点击 确定 。只有安装了 Microsoft Excel 软件的 Windows 计算机才支持此语法。

示例

[ num , txt , raw , custom ] = xlsread( filename , sheet , xlRange ,'', processFcn ) (其中 processFcn 是函数句柄)读取电子表格,对数据调用 processFcn ,并在数组 num 中以数值数据的形式返回最终结果。 xlsread 函数在元胞数组 txt 中返回文本字段、在元胞数组 raw 中返回数值和文本数据,并在数组 custom 中返回 processFcn 的第二个输出。 xlsread 函数不会更改电子表格中存储的数据。只有安装了 Excel 软件的 Windows 计算机才支持此语法。

示例

全部折叠

创建一个名为 myExample.xlsx 的 Excel 文件。

values = {1, 2, 3 ; 4, 5, 'x' ; 7, 8, 9};
headers = {'First','Second','Third'};
xlswrite('myExample.xlsx',[headers; values]);

myExample.xlsx Sheet1 包含:

   First    Second    Third
       1         2        3
       4         5    x    
       7         8        9

读取第一个工作表中的数值数据。

filename = 'myExample.xlsx';
A = xlsread(filename)
A =
     1     2     3
     4     5   NaN
     7     8     9

从上一示例的 Excel 文件中读取特定范围的数据。

filename = 'myExample.xlsx';
sheet = 1;
xlRange = 'B2:C3';
subsetA = xlsread(filename,sheet,xlRange)
subsetA =
     2     3
     5   NaN

从第一个示例的 Excel 文件中读取第二列。

filename = 'myExample.xlsx';
columnB = xlsread(filename,'B:B')
columnB =
     8

要获得更佳的性能,可在范围中包括行号,例如 'B1:B3'

从第一个示例中的 Excel 文件中请求数值数据、文本数据和合并数据。

[num,txt,raw] = xlsread('myExample.xlsx')
num =
     1     2     3
     4     5   NaN
     7     8     9
txt = 
    'First'    'Second'    'Third'
    ''         ''          ''     
    ''         ''          'x'    
raw = 
    'First'    'Second'    'Third'
    [    1]    [     2]    [    3]
    [    4]    [     5]    'x'    
    [    7]    [     8]    [    9]

在编辑器中,创建一个函数以处理工作表中的数据。在这种情况下,将范围 [0.2,0.8] 之外的值设置为 0.2 0.8

function [Data] = setMinMax(Data)
minval = 0.2; 
maxval = 0.8;
for k = 1:Data.Count
  v = Data.Value{k};
  if v > maxval
    Data.Value{k} = maxval;
  elseif v < minval
    Data.Value{k} = minval;

在命令行窗口中,将随机数据添加到 myExample.xlsx

A = rand(5);
xlswrite('myExample.xlsx',A,'MyData')

名为 MyData 的工作表包含范围在 0 至 1 之间的值。

读取工作表中的数据,并重置范围 [0.2,0.8] 之外的任何值。指定工作表名称,但使用 '' 作为 xlRange 'basic' 输入的占位符。

trim = xlsread('myExample.xlsx','MyData','','',@setMinMax);

对工作表执行函数并显示自定义索引输出。

在编辑器中,修改上一示例中的函数 setMinMax 以返回更改后的元素(自定义输出)的索引。

function [Data,indices] = setMinMax(Data)
minval = 0.2; 
maxval = 0.8;
indices = [];
for k = 1:Data.Count
  v = Data.Value{k};
  if v > maxval
    Data.Value{k} = maxval;
    indices = [indices k];
  elseif v < minval
    Data.Value{k} = minval;
    indices = [indices k];
end

读取工作表 MyData 中的数据,并请求自定义索引输出 idx

[trim,txt,raw,idx] = xlsread('myExample.xlsx',...
    'MyData','','',@setMinMax);

输入参数

全部折叠

文件名,指定为字符向量或字符串。如果未包括扩展名, xlsread 将搜索具有指定的名称和支持的 Excel 扩展名的文件。 xlsread 可以读取当前在 Windows 版 Excel 中打开的文件中保存的数据。

示例: 'myFile.xlsx' "myFile.xlsx"

数据类型: char | string

工作表,指定为下列值之一:

  • 包含工作表名称的字符向量或字符串。名称不能包含冒号 ( : )。要确定电子表格文件中工作表的名称,请使用 xlsfinfo 。对于 basic 模式的 XLS 文件, sheet 区分大小写。

  • 指示工作表索引的正整数。对于 basic 模式下的 XLS 文件,不支持此选项。

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

矩形范围,指定为字符向量或字符串。

使用两个对角指定 xlRange ,这两个对角用来定义要读取的区域。例如, 'D2:H4' 表示工作表上两个角落 D2 H4 之间的 3×5 矩形区域。 xlRange 输入不区分大小写,并使用 Excel A1 引用样式(请参阅 Excel 帮助)。

读取 basic 模式下的 XLS 文件时不支持范围选择。在这种情况下,请使用 '' 代替 xlRange

如果未指定 sheet ,则 xlRange 必须包括两个角落和一个冒号字符,甚至对于单个单元格(例如 'D2:D2' )也是如此。否则, xlsread 会将输入解释为工作表名称(例如 'sales' 'D2' )。

如果指定了 sheet ,则 xlRange

  • 无需包括冒号和对角即可描述单个单元格。

  • 可以引用在 Excel 文件中定义的命名范围(请参阅 Excel 帮助)。

当指定的 xlRange 与合并的单元格重叠时:

  • 在安装了 Excel 的 Windows 计算机上, xlsread 将展开该范围以包括所有合并的单元格。

  • 在未安装 Windows 版 Excel 的计算机上, xlsread 仅返回指定范围中的数据,且合并单元格的值为空或 NaN

数据类型: char | string

请求在 basic 模式下进行读取的标志,指定为字符向量或字符串 'basic'

basic 模式是不带 Excel(适用于 Windows)的计算机的默认设置。在 basic 模式下, xlsread

  • 仅读取 XLS、XLSX、XLSM、XLTX 和 XLTM 文件。

  • 读取 XLS 文件时不支持 xlRange 输入。在这种情况下,请使用 '' 代替 xlRange

  • 不支持函数句柄输入。

  • 将所有日期导入为 Excel 日期序列值。Excel 日期序列值使用不同于 MATLAB 日期数字的参考日期。

数据类型: char | string

自定义函数的句柄。仅安装了 Excel 软件的 Windows 计算机上才支持此参量。 xlsread 读取电子表格,对数据副本执行您的函数,并返回最终结果。 xlsread 不会更改电子表格中存储的数据。

xlsread 调用自定义函数时,它将传递 Excel 应用程序的一个范围接口以提供对数据的访问权限。自定义函数必须包括此接口作为输入和输出参量。(请参阅 对工作表执行函数

示例: @myFunction

输出参量

全部折叠

数值数据,返回为 double 值的矩阵。该数组不包含标题行中的任何信息,也不包含外部行或列(包含非数值数据)中的任何信息。内部电子表格行和列中的文本数据在 num 输出中显示为 NaN

文本数据,返回为元胞数组。内部电子表格行和列中的数值在 txt 中显示为空字符向量 ''

对于 basic 导入模式下的 XLS 文件, txt 输出包含空字符向量 '' ,代替位于电子表格中文本数据前面的数值数据的前导列。在所有其他情况下, txt 不包含这些额外的列。

未定义的值(例如 '#N/A' )在 txt 输出中显示为 '#N/A' basic 模式下的 XLS 文件除外。

工作表中的数值数据和文本数据,以元胞数组的形式返回。

在安装了 Windows 版 Excel 的计算机上,未定义的值(例如 '#N/A' )在 raw 输出中显示为 'ActiveX VT_ERROR:' 。对于其他计算机上或 MATLAB Online 中的 XLSX、XLSM、XLTX 和 XLTM 文件,未定义的值显示为 '#N/A'

对应于 processFcn 的函数的第二个输出。 custom 的值和数据类型由该函数确定。

局限性

  • xlsread 仅读取 7 位 ASCII 字符。

  • xlsread 不支持非相邻范围。

  • 如果您的计算机未安装 Windows 版 Excel 或者您正在使用 MATLAB Online xlsread 会自动在 basic 导入模式下运行。

  • 在 Linux ® Mac 平台上, xlsread 不能打开使用 writetable 函数编写的电子表格文件。

算法

  • xlsread 导入表示日期的格式化文本(例如 '10/31/96' ),但在 basic 模式下导入时除外。

版本历史记录

在 R2006a 之前推出

全部折叠

R2019a: 不推荐使用 xlsread

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

从 R2019a 开始,请分别使用 readtable readmatrix readcell 将电子表格数据作为表、矩阵或元胞数组导入。与 xlsread 函数相比, readtable readmatrix readcell 函数具有以下优势:

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

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

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

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

不推荐

推荐

使用 xlsread 将电子表格数据作为矩阵读取:

M = xlsread(filename)

将电子表格数据作为表读取:

T = readtable(filename)
但是,要继续将数据作为矩阵读取,请使用:
M = readmatrix(filename)

使用 xlsread 将电子表格数据作为元胞数组读取:

[~,~,C] = xlsread(filename)

将电子表格数据作为表导入:

T = readtable(filename)
但是,要继续将数据作为元胞数组导入,请使用:
C = readcell(filename)

使用 xlsread 将特定工作表和范围作为矩阵读取:

M = xlsread(filename,sheet,range)

将特定工作表和范围作为表读取:

T = readtable(filename,'Sheet',sheet,'Range',range)
但是,要继续将数据作为矩阵读取,请使用:
M = readmatrix(filename,'Sheet',sheet,'Range',range)

使用 xlsread 将特定工作表和范围作为元胞数组读取:

[~,~,C] = xlsread(filename,sheet,range)

将特定工作表和范围作为表读取:

T = readtable(filename,'Sheet',sheet,'Range',range)
但是,要继续将数据作为元胞数组读取:
C = readcell(filename,'Sheet',sheet,'Range',range)