readcell

从文件读取单元阵列

描述

例子

C=读取单元(文件名)通过从文件中读取面向列的数据创建单元格数组。

readcell根据文件扩展名确定文件格式:

  • 。文本文件,.dat,或的.csv对于分隔文本文件

  • .xls文件,.xlsb,.XLSM,.XLSX,.xltm,.xltx,或.ods文件电子表格文件

例子

C=读取单元(文件名,选择)另外使用导入选项选择

例子

C=读取单元(___,名称、值)使用一个或多个名称-值对参数指定的附加选项从文件创建单元格数组。在指定名称-值对之前,请使用前面语法中的任何输入参数。

设置特定导入选项为你的数据,你可以使用选择对象,或者您可以指定名称 - 值对。当您在除指定名称 - 值对选择,然后readcell万博1manbetx只支持这些名称-值对:

  • 文本文件-日期区域设置,编码

  • 电子表格文件-工作表,UseExcel

例子

全部折叠

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

类型basic_cell.txt
1,2,3你好,世界不同,NaN年10月10 2018 10:27:56.1,
C=读取单元('基本单元格.txt')
C =3×3电池{[1]} {[2]} {[3]} { '你好'} { '世界'} {[NaN的]}  -  {[10-OCT-2018 10点27分56秒]} {[1]} {1x1的缺失}

导入混合表格数据基本单元.xls变成一个细胞阵列。

C=读取单元(“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=检测端口选项('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 ____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ ______ ________________ ________________ ________ ____________ ____________ __________ _____________ _________________ 1996 1 18 4 2117 2120 2305 2259 { 'HP'} 415 { 'N637AW'} 108 99 85 6 -3 { 'COS'} { 'PHX'} 551 5 18 0 {为0x0炭{0为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} 1996年1 12 5 1252 1245 1511 1500 { 'HP'} 610 { 'N905AW'} 79 75 58 11 7 { 'LAX'} { 'PHX'} 370 3 18 0 {为0x0炭{0为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} 1996年1 16 2 1441 1445 1708 1721 { 'HP'} 211 {'N165AW'} 87 96 74 -13-4 { 'RNO'} { 'PHX'} 601 4 9 0 {为0x0炭{0为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} 1996 1 1 1 2258 2300 2336 2335 {'HP'} 1245 { 'N183AW'} 38 35 20 1 -2 { 'TUS'} { 'PHX'} 110 6 12 0 {为0x0炭{0为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} 1996 1 4 4 1814 1814 1901 1910 { 'US'} 683 { 'N963VJ'} 47 56 34 -9 0 { 'DTW'} { 'PIT'} 201 6 7 0 {为0x0炭} 0 {为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} 1996年1 31 3 1822 1820 1934 1925 { 'US'} 757 { 'N912VJ'} 72 65 52 9 2 { 'PHL'} {”PIT '} 267 6 14 0 {为0x0炭{0为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} 1996年1 18 4 729 730 841 843 {' US '} 1564 {' N941VJ”} 72 73 58 -2 -1 { 'DCA'} { 'PVD'} 357 3 11 0 {为0x0炭{0为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} {为0x0炭} 1996年1月26日5 1704 1705 1829 1839 { 'NW'} 1538 { 'N960N'} 85 94 69 -10 -1 { 'DTW'} { 'RIC'} 456 3 13 0 {为0x0炭{0为0x0炭} {为0x0炭}{为0x0炭} {为0x0炭} {为0x0炭}

为变量导入10行数据7,8,和9从名为2007年. Excel范围'G2:I11'代表列7通过9,从第一行开始有十行2在变量名之后。

M=读取单元('airlinesmall_subset.xlsx','片',2007年,'范围','G2:I11')
米=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)的文件的完整路径:

方案名称://文件路径/我的文件扩展名

根据你的远程位置,方案名称可以是此表中的值之一。

远程位置 方案名称
亚马逊S3™ s3号
微软Azure®Blob存储 黄蜂,黄蜂
HDFS™ HDFS

欲了解更多信息,请参阅使用远程数据

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

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

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

  • 如果您的系统没有Excel for Windows,或者您正在使用MATLAB在线™,进口功能与操作UseExcel属性设置为,只有读.xls、.xlsx、.xlsm、.xltx和.xltm文件。

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

数据类型:烧焦|一串

文件导入选项,指定为SpreadsheetImportOptions,DelimitedTextImportOptions,或固定宽度导入对象创建者检测端口选项函数。该选择对象包含控制数据导入过程的属性。有关每个对象的属性的详细信息,请参阅相应的对象页。

类型的文件 输出
电子表格文件 SpreadsheetImportOptions对象
文本文件 DelimitedTextImportOptions对象
宽度固定的文本文件 固定宽度导入对象

名称-值对参数

指定可选的逗号分隔的对名称、值参数。姓名参数名和价值是相应的值。姓名必须出现在引号内。可以按任意顺序指定多个名称和值对参数,如下所示名1,值1,...,NameN,值N

例:“NumHeaderLines”, 5指示表格数据前面的前五行是标题行。

文本和电子表格文件

全部折叠

文件类型,由逗号分隔的对组成“文件类型”'文本''电子表格'

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

  • 。文本文件,.dat,或的.csv对于分隔文本文件

  • .xls文件,.xlsb,.XLSM,.XLSX,.xltm,.xltx,或.ods文件电子表格文件

例:'文件类型','文本'

数据类型:烧焦|一串

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

例:“NumHeaderLines”7

数据类型:单一的|

预期的变量数,指定为逗号分隔对,由'预期的numvariables'和一个正整数。如果没有指定,导入功能自动检测变量的数目。

数据类型:单一的|

从文本或电子表格文件中读取的数据的一部分,指定为逗号分隔对,由'范围'以及其中一种形式的字符向量、字符串标量或数值向量。

指定方式范围 描述

起始单元格

'单元格'[行列]

将数据的起始单元格指定为字符向量或字符串标量或双元素数字向量。

  • 使用Excel包含列字母和行号的字符向量或字符串标量A1符号。例如,A5是在列的交叉点的标识符的单元一个和行5

  • 形式的二元数值向量[行列]指示起始行和列。

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

例:'A5'[51]

矩形范围

'Corner1:Corner2'[r1 c1 r2 c2]

指定确切的范围使用矩形范围在这些形式之一来读取。

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

  • [r1 c1 r2 c2]-使用包含开始行、开始列、结束行和结束列的四元素数字向量指定范围。例如,[2 3 15 13]

进口功能只读取包含在指定的范围内的数据。指定的范围内的任何空字段被导入为缺失的细胞。

行范围或列范围

“第一行:Row2”'第1列:第2列'

通过识别起始和终止使用Excel行号行指定的范围内。

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

例:“5:500”

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

使用指定列范围,导入功能自动通过从第一非空行读取到数据或页脚范围的结束检测行的程度。

指定范围内的列数必须与预期变量财产。

例:'A:K'

起始行号

n

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

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

例:5

Excel的命名范围

'NamedRange'

在Excel中,可以创建名称来标识电子表格中的范围。例如,您可以选择电子表格的一个矩形部分并调用它'myTable的'. 如果电子表格中存在这样的命名范围,则导入函数可以使用其名称读取该范围。

例:'范围', 'myTable的'

未指定或空

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

例:'范围',''

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

数据类型:烧焦|一串|

键入导入的文本数据,指定为逗号分隔的一对组成的'文本类型',要么“字符”'串'

  • “字符”-将文本数据作为字符向量导入到MATLAB中。

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

例:'TextType', '炭'

输入日期和时间数据的类型,指定为逗号分隔的对“DatetimeType”其中一个值是:'日期时间','文本',或'exceldatenum'。价值'exceldatenum'仅适用于电子表格文件,对文本文件无效。

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

MATLAB日期时间数据类型

欲了解更多信息,请参阅日期时间

'文本'

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

  • 如果'文本类型'设定为“字符”,然后进口函数返回日期作为字符向量的单元阵列。

  • 如果'文本类型'设定为'串',然后导入函数将日期作为字符串数组返回。

'exceldatenum'

Excel序列号

序列号是一个数字,等于给定参考日期后的天数。Excel序列号使用的参考日期与MATLAB序列号不同。有关Excel日期的详细信息,请参见https://万博1manbetxsupport.microsoft.com/en-us/kb/214330

数据类型:烧焦|一串

只有文本文件

全部折叠

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

例:'分隔符','|'

例:'分隔符',{';','*'}

数据类型:烧焦|一串|细胞

将字符视为空白,指定为包含一个或多个字符的字符向量或字符串标量。

例:'空白', '_'

例:'空白', '?!'

行尾字符,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。

例:'行尾','\n'

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

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

数据类型:烧焦|一串|细胞

注释的样式,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。

例如,要忽略后面的在同一行百分号文字,指定评论风格作为'%'

例:'注释样式',{'/*'}

数据类型:烧焦|一串|细胞

与文件相关的字符编码方案,指定为逗号分隔的对组成“编码”'系统'或标准字符编码方案名称,如此表中的值之一。

'大5'

'ISO-8859-1'

'窗口-847'

'中文-HKSCS'

'ISO-8859-2'

“windows - 949”

'CP949'

'ISO-8859-3'

'windows-1250'

“EUC-KR”

'ISO-8859-4'

'windows-1251'

“EUC-JP”

'ISO-8859-5'

'windows-1252'

'EUC-TW'

'ISO-8859-6'

'windows-1253'

'GB18030'

'ISO-8859-7'

'窗口-1254'

“GB2312”

'ISO-8859-8'

'窗口-1255'

'GBK'

'ISO-8859-9'

'窗口-1256'

'IBM866'

'ISO-8859-11'

'窗口-1257'

'KOI8-R'

'ISO-8859-13'

'窗口-1258'

'KOI8-U'

'ISO-8859-15'

'US-ASCII'

“麦金塔”

'UTF-8'

“Shift_JIS”

例:“编码”,“系统”使用系统默认编码。

数据类型:烧焦|一串

从文本文件输出持续时间数据的数据类型,指定为逗号分隔对,由'工期类型',要么'持续时间''文本'

价值 导入的持续时间数据的类型
'持续时间'

MATLAB持续时间数据类型

欲了解更多信息,请参阅持续时间

'文本'

如果'工期类型'指定为'文本',则导入的持续时间数据的类型取决于'文本类型'参数:

  • 如果'文本类型'设定为“字符”,然后导入函数将持续时间数据作为字符向量的单元格数组返回。

  • 如果'文本类型'设定为'串',则导入函数将持续时间数据作为字符串数组返回。

数据类型:烧焦|一串

读取日期的区域设置,指定为逗号分隔对,由“DateLocale”和字符向量或形式的字符串标量XX_YY,其中:

  • YY是表示一个国家的大写ISO 3166-1 alpha-2代码。

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

有关区域设置的公用值列表,请参见地区的名称-值对参数日期时间函数。

当使用% D格式说明读取文本日期时间值,使用日期区域设置指定导入函数应在其中解释周名称和缩写的月份和日期的区域设置。

如果指定日期区域设置除了选择导入选项,然后导入函数使用日期区域设置参数,它将覆盖导入选项定义的语言环境。

例:'DateLocale','ja_JP'

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

连续的分隔符规则 行为
'拆分' 拆分连续分隔成多个领域。
“加入” 将分隔符合并为一个分隔符。
'错误' 返回一个错误并中止导入操作。

数据类型:烧焦|一串

过程,用于管理带分隔符的文本文件中的前导分隔符,该文本文件指定为此表中的值之一。

前导分隔符规则 行为
'保持' 保留分隔符。
'忽略' 忽略了分隔符。
'错误' 返回一个错误并中止导入操作。

仅电子表格文件

全部折叠

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

规范 行为
(默认) 从第一个工作表导入数据。
姓名 从匹配表名称输入数据,而不管在电子表格文件片材的顺序。
整数 从工作表中以整数表示的位置导入数据,与电子表格文件中的工作表名称无关。

数据类型:烧焦|一串|单一的|

标记来启动的实例Microsoft Excel对于Windows,当读取电子表格数据时,指定为逗号分隔对,由'UseExcel',要么真的,或

你可以设置'UseExcel'这些值之一的参数:

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

  • -导入函数在读取文件时不启动Microsoft Excel实例。在此模式下操作时,导入函数功能在支持文件格式和交互功能(如公式和宏)方面有所不同。万博1manbetx

UseExcel

真的

万博1manbetx支持的文件格式

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

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

万博1manbetx支持交互式特性,如公式和宏

是的

从电子表格文件中读取Windows平台上的时候,如果要启动的实例Microsoft Excel,然后设置'UseExcel'参数到真的

介绍了R2019a