readcell.

从文件中读取单元格数组

描述

例子

c = readcell(文件名通过从文件读取面向列的数据来创建单元数组。

readcell.从文件扩展名确定文件格式:

  • 。文本.dat, 要么.csv.用于分隔的文本文件

  • .xls..xLSB..xlsm..xlsx..xltm..xltx., 要么.ods.电子表格文件

例子

c = readcell(文件名选择此外使用导入选项选择

例子

c = readcell(___名称,价值从一个文件创建单元数组,其中包含一个或多个名称值对参数指定的附加选项。在指定名称值对之前,使用先前语法中的任何输入参数。

要为数据设置特定的导入选项,您可以使用选择对象或您可以指定名称值对。除了添加名称 - 值对时选择,然后readcell.金宝app仅支持以下名称-值对:

  • 文本文件 -datelocale.编码

  • 电子表格文件 -床单UseExcel

例子

全部收缩

显示内容basic_cell.txt,然后将混合数据导入单元格数组。

类型basic_cell.txt
1,2,3你好,世界,南10月10日 -  2018年10:27:56,11,
c = readcell('basic_cell.txt'
C =3×3个单元阵列{[1]} {[2]} {[3]} {'hello'} {'world'} {[10-oct-2018 10:27:56]} {[1]} {1x1缺少}

从中导入混合表格数据basic_cell.xls.进入小区阵列。

c = readcell(“basic_cell.xls”
C =3×3个单元阵列{[1]}{[2]}{[3]}{'你好'}{‘世界’}{1 x1失踪}{[10 - 10月- 2018 10:27:56]}{[1]}{1 x1失踪}

预览电子表格文件中的数据,并从指定的工作表和范围中将混合数据导入单元格数组。

电子表格文件airlinesmall_subset.xlsx包含1996年至2008年之间多年的多个工作表中的数据。每个工作表都有一年的数据。预览文件中的数据airlinesmall_subset.xlsx.这预习函数默认显示来自第一个工作表的数据。

opts = detectimportoptions('airlinesmall_subset.xlsx');预习('airlinesmall_subset.xlsx',选择)
ans =.8×29表年月DAYOFMONTH DAYOFWEEK DepTime CRSDepTime ArrTime CRSArrTime UniqueCarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime开播ArrDelay DepDelay产地目标距离TaxiIn TaxiOut取消CancellationCode改行CarrierDelay WeatherDelay SDELAY SecurityDelay LateAircraftDelay ____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ ______ ________________ ________________________________________________________________________________________________________0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 12 5 1252 1245 1511 1500 {'n905aw'} 79 75 58 11 7 {'lax'{'phx'} 370 3 18 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 16 2 1441 1445 1708 1721 {'HP'} 211 {'n165aw'} 87 96 74 -13-4 {'phx'} {'phx'} 601 4 9 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 1 11 2 2258 2300 2336 2335 {'hp'} 1245 {'n183aw'} 38 35 20 1 -2 {'tus'} {'phx'} {'phx'} 110 6 12 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}} {0x0 char} 1996 1 4 4 1814 1814 1901 1910 {'美国'} 683 {'n963vj'} 47 56 34 -9 0 {'dtw'} {'pit'} 201 6 7 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 31 3 1822 1820 1934 1925 {'nu912vj'} 72 65 52 9 2 {'phl'} {''pit'} 267 6 14 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 18 4 729 730 841 843 {'n941vj'{72 73 58 -2 -1 {'dca'} {'pvd'} 357 3 11 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} 1996 1 265 1704 1705 1829 1839 {'nw'} 1538 {'n960n'} 85 94 69 -10 -1 {'dtw'} {'ric'} 456 3 13 0 {0x0 char} 0 {0x0 char} {0x0 char}{0x0 char} {0x0 char} {0x0 char}

为变量导入10行数据78, 和9从名为的工作表'2007'.Excel系列'G2:I11'代表列7通过9,从一行开始一共十行2在变量名后面。

m = readcell('airlinesmall_subset.xlsx''床单''2007''范围''G2:I11'
m =10×3个单元阵列{[935]}{[935]}{的WN}{[1041]}{[1040]}{的WN}{[1430]}{[1500]}{的WN}{[940]}{[950]}{的WN}{[1515]}{[1515]}{的WN}{[2042]}{[2035]}{的WN}{[2116]}{[2130]}{的WN}{[1604]}{[1605]}{的WN}{[1258]}{[1230]}{的WN} {[1134]} {[1145]} {' WN '}

输入参数

全部收缩

要读取的文件的名称,指定为字符向量或字符串标量。

根据您的文件的位置,文件名可以采取其中一种形式。

地点

形式

Matlab上的当前文件夹或文件夹®路径

指定文件的名称文件名

例子:“myFile.txt”

文件夹中的文件

如果文件不在当前文件夹或MATLAB路径上的文件夹中,则指定完整或相对路径名文件名

例子:'c:\ myfolder \ myfile.xlsx'

例子:“dataDir \ myFile.txt”

远程位置

如果文件存储在远程位置,那么文件名必须包含指定为表单的统一资源定位器(URL)的文件的完整路径:

scheme_name.://path_to_file./my_file.ext.

基于您的远程位置,scheme_name.可以是此表中的值之一。

远程位置 scheme_name.
亚马逊S3™ S3.
Windows Azure®Blob Storage. 黄金草原
HDFS™ HDFS.

有关更多信息,请参阅使用远程数据

例子:s3: / / bucketname / path_to_file / my_file.csv '

  • 如果文件名包含文件扩展名,然后导入函数根据扩展名确定文件格式。否则,必须指定“文件类型”名称 - 值对参数指示文件类型。

  • 在Windows上®与微软系统®excel.®软件,导入功能读取任何Excel电子表格文件格式识别您的Excel版本。

  • 如果您的系统没有Windows的Excel,或者您正在使用Matlab Online™,导入功能与该功能一起运行UseExcel属性设置为,只读.xls,.xlsx,.xlsm,.xltx和.xltm文件。

  • 对于分隔文本文件,导入函数将文件中的空字段转换为(对于数字变量)或空字符向量(用于文本变量)。文本文件中的所有行必须具有相同数量的分隔符。导入函数忽略文件中无关紧要的空白空间。

数据类型:char|细绳

文件导入选项,指定为SpreadSheetimportOptions.delimitedtextimportoptions., 要么多个沃特莫特选项由此创建的对象侦探函数。这选择对象包含控制数据导入过程的属性。有关每个对象属性的更多信息,请参阅相应的对象页面。

类型的文件 输出
电子表格文件 SpreadSheetimportOptions.对象
文本文件 delimitedtextimportoptions.对象
宽度固定的文本文件 多个沃特莫特选项对象

名称值对参数

指定可选的逗号分隔的对名称,价值论点。名称参数名和价值是相应的价值。名称必须出现在引号内。您可以以任何顺序指定多个名称和值对参数name1,value1,...,namen,valuen

例子:“NumHeaderLines”,5表示在表格数据之前的前五条线是标题线。

文本和电子表格文件

全部收缩

文件类型,指定为逗号分隔对,由“文件类型”'文本'要么'电子表格'

指定“文件类型”名称 - 值对参数何时文件名不包括文件扩展名或扩展名是以下之一:

  • 。文本.dat, 要么.csv.用于分隔的文本文件

  • .xls..xLSB..xlsm..xlsx..xltm..xltx., 要么.ods.电子表格文件

例子:'filetype','text'

数据类型:char|细绳

文件中的标题线数,指定为逗号分隔对组成'numheaderlines'和一个正整数。如果未指定,导入函数会自动检测文件中的标题行数。

例子:“NumHeaderLines”7

数据类型:单身的|双倍的

预期的变量数,指定为逗号分隔对组成'预期的内瓦里亚布尔'和一个正整数。如果未指定,导入函数会自动检测变量的数量。

数据类型:单身的|双倍的

从文本或电子表格文件中读取的部分数据,指定为逗号分隔对'范围'和其中一个表单中的字符向量,字符串标量或数字矢量。

指定的方法范围 描述

起始牢房

'细胞'要么[行col]

将数据的起始小区指定为字符向量或字符串标量或两个元素数字向量。

  • 字符向量或字符串标量,包含excel的列字母和行号A1符号。例如,A5是列中的单元格的标识符一个和行5

  • 表格的两个元素数字矢量[行col]表示起始行和列。

使用启动单元格,导入函数通过在起始单元格上开始导入并在最后一个空行或页脚范围内来自动检测数据的范围。

例子:'A5'要么[5 1]

矩形范围

'Corner1:Corner2'要么[R1 C1 R2 C2]

指定在其中一种形式中使用矩形范围读取的精确范围。

  • 'Corner1:Corner2'—指定使用范围Corner1Corner2定义要在Excel中读取的区域的两个相对的角是哪两个A1符号。例如,'C2:N15'

  • [R1 C1 R2 C2]—使用包含start-row、start-column、end-row和end-column的四个元素的数字向量指定范围。例如,[2 3 15 13]

导入功能仅读取指定范围内包含的数据。指定范围内的任何空字段都将导入丢失的单元格。

行范围或列范围

“第一行:Row2”要么'第1列:column2'

通过识别使用Excel行号的开始和结束行来指定范围。

通过使用指定的行范围,导入函数自动检测列扩展,从第一个非空列读取到数据的末尾,并为每列创建一个变量。

例子:“5:500”

或者,通过使用Excel列字母或数字标识开始和结束列来指定范围。

使用指定的列范围,导入函数通过从第一个NONEMPTY行读取到数据的末尾或页脚范围来自动检测行范围。

指定范围中的列数必须与指定的数字匹配预示.财产。

例子:'A:K'

起始行号

n

使用正标量行索引指定包含数据的第一行。

使用指定的行索引,导入函数通过从指定的第一行读取数据末尾或页脚范围自动检测数据的范围。

例子:5

Excel的命名范围

'namedrange'

在Excel中,您可以创建名称以识别电子表格中的范围。例如,您可以选择电子表格的矩形部分并调用它'MyTable'.如果在电子表格中存在此类命名范围,则导入功能可以使用其名称读取该范围。

例子:'范围','mytable'

未指定或空的

''

如果未指定,导入功能会自动检测使用的范围。

例子:'范围',''

笔记:使用范围指实际包含数据的电子表格的矩形部分。导入功能通过修剪不包含数据的任何前导和尾随行和列自动检测使用的范围。只有空白空间的文本被视为数据,并在使用的范围内捕获。

数据类型:char|细绳|双倍的

输入导入的文本数据,指定为逗号分隔的配对组成'texttype'和任何一种'char'要么'细绳'

  • 'char'- 将文本数据导入MATLAB作为字符向量。

  • '细绳'- 将文本数据导入MATLAB作为字符串数组。

例子:'texttype','char'

类型用于导入的日期和时间数据,指定为由“DatetimeType”其中一个价值观是:'约会时间''文本', 要么'ExceldateNum'.价值'ExceldateNum'仅适用于电子表格文件,对文本文件无效。

价值 输入导入日期和时间数据
'约会时间'

马铃薯约会时间数据类型

有关更多信息,请参阅约会时间

'文本'

如果“DatetimeType”被指定为'文本',则导入的日期和时间数据的类型取决于'texttype'范围:

  • 如果'texttype'被设置为'char',然后导入函数将日期返回为字符向量的单元格数组。

  • 如果'texttype'被设置为'细绳',然后导入函数将日期返回为字符串数组。

'ExceldateNum'

Excel连续日期编号

序列日序是单个数字等于给定参考日期的天数。Excel序列日序号使用与Matlab序列日期号不同的其他参考日期。有关Excel日期的更多信息,请参阅https://金宝appsupport.microsoft.com/en-us/kb/214330

数据类型:char|细绳

仅文本文件

全部收缩

分隔文本文件中的字段分隔符字符,指定为字符向量、字符串标量、字符向量单元格数组或字符串数组。

例子:'delimiter','|'

例子:'delimiter',{';','*'}

数据类型:char|细绳|细胞

要作为空白处理的字符,指定为包含一个或多个字符的字符向量或字符串标量。

例子:'空白','_'

例子:'空白','!!。,'

线端字符,指定为字符向量,字符串标量,字符向量的单元格数组或字符串数​​组。

例子:'排队','\ n'

例子:“LineEnding”、“\ r \ n”

例子:LineEnding,{‘\ b’,‘:’}

数据类型:char|细绳|细胞

评论的风格,指定为字符向量,字符串标量,字符向量或字符串数​​组。

例如,要在同一行上挂牌略有百分之符号,请指定CommentStyle.作为'%'

例子:'CommentStyle',{'/ *'}

数据类型:char|细绳|细胞

与文件关联的字符编码方案,指定为逗号分隔对,由“编码”'系统'或编码方案名称的标准字符。当您没有指定任何编码时,readcell.函数使用自动字符集检测来确定读取文件时的编码。

如果您指定了“编码”参数除了导入选项,那么readcell.函数使用指定的值“编码”,覆盖导入选项中定义的编码。

例子:'编码','utf-8'使用UTF-8作为编码。

例子:'编码','system'使用系统默认编码。

数据类型:char|细绳

从文本文件输出数据类型的持续时间数据,指定为逗号分隔对'durationtype'和任何一种'期间'要么'文本'

价值 输入导入持续时间数据
'期间'

马铃薯持续时间数据类型

有关更多信息,请参阅持续时间

'文本'

如果'durationtype'被指定为'文本',然后导入持续时间数据的类型取决于指定的值'texttype'范围:

  • 如果'texttype'被设置为'char'然后,导入函数将持续时间数据返回为字符向量的小区数组。

  • 如果'texttype'被设置为'细绳',则导入函数将持续时间数据作为字符串数组返回。

数据类型:char|细绳

用于阅读日期的区域设置,指定为逗号分隔的配对“DateLocale”以及表单的字符矢量或字符串标量XX._yy., 在哪里:

  • yy.是一个大写ISO 3166-1 Alpha-2代码,指示一个国家。

  • XX.是指示语言的小写ISO 639-1双字母代码。

有关区域设置的常见值列表,请参阅地区名称值对参数约会时间函数。

使用时% D格式化说明符以读取文本约会时间值,使用datelocale.指定导入函数应该解释月份和日常名称和缩写的语言环境。

如果您指定了datelocale.论点选择导入选项,然后导入函数使用指定的值datelocale.参数,覆盖导入选项中定义的语言环境。

例子:'datelocale','ja_jp'

过程在分隔的文本文件中处理连续分隔符,指定为此表中的值之一。

连续分隔符规则 行为
'分裂' 将连续分隔符分成多个字段。
“加入” 将分隔符加入一个分隔符。
'错误' 返回错误并中止导入操作。

数据类型:char|细绳

管理定界文本文件中的前导定界符(指定为本表中的值之一)的过程。

领先的分隔符规则 行为
'保持' 保持分隔符。
'忽略' 忽略了分隔符。
'错误' 返回错误并中止导入操作。

仅限电子表格文件

全部收缩

要读取的工作表,指定为空字符数组、包含工作表名称的字符向量或字符串标量,或表示工作表索引的正标量整数。的值床单属性,导入函数的行为如表中所述。

规格 行为
''(默认) 从第一张作为导入数据。
名称 无论电子表格文件中的纸张订单如何导入匹配的工作表名称。
整数 无论电子表格文件中的工作表名称如何导入由整数的位置的页面导入数据。

数据类型:char|细绳|单身的|双倍的

的实例微软Excel.读取电子表格数据时的Windows,指定为包括的逗号分隔对'使用'和任何一种真的, 要么

您可以设置'使用'参数到其中一个值:

  • 真的- 读取文件时,导入函数启动Microsoft Excel的实例。

  • - 读取文件时,导入功能不会启动Microsoft Excel的实例。在此模式下运行时,导入功能功能在文件格式和交互功能的支持下不同,例如公式和宏。金宝app

UseExcel

真的

金宝app支持的文件格式

.xls,.xlsx,.xlsm,.xltx,.xltm,.xlsb,.ods

.xls, .xlsx, .xlsm, .xltx, .xltm

金宝app支持交互特性,如公式和宏

是的

从Windows平台上的电子表格文件读取时,如果要启动一个实例微软Excel.,然后设置'使用'参数到真的

介绍了R2019a