writecell

将单元格数组写入文件

折叠所有页面

语法

writecell (C)

writecell (C,文件名)

writecell (＿＿＿、名称、值)

描述

例子

writecell (C）写入单元格数组C到以逗号分隔的文本文件。文件名是单元格数组的工作区名称，并附加扩展名. txt．如果writecell不能从输入单元格数组名构造文件名，则写入文件cell.txt．

每一列中的每一个变量C成为输出文件中的一列。的writecell函数覆盖任何现有文件。

例子

writecell (C,文件名）写入具有指定的名称和扩展名的文件文件名．

writecell根据指定的扩展名确定文件格式。扩展名必须是以下其中之一:

. txt,.dat,或. csv对于带分隔符的文本文件
xls,.xlsm,或.xlsx为Excel^®电子表格文件
.xlsb下载Excel for Windows系统所支持的Exc金宝appel电子表格文件^®

例子

writecell (＿＿＿,名称,值）将单元格数组写入包含一个或多个指定的附加选项的文件名称,值对参数，并且可以包括以前语法中的任何输入参数。

例子

全部折叠

将单元格数组写入文本文件

打开实时脚本

创建单元格数组，将其写入逗号分隔的文本文件，然后将单元格数组写入使用不同分隔符的另一个文本文件。

在工作区中创建一个简单的单元格数组。

C = {1,2,3;“文本”datetime (“今天”(1)}),小时

C =2×3单元格数组{[1]}{[2]}{[3]}{‘文本’}{(09 - 1月- 2019)}{(1小时)}

将单元格数组写入以逗号分隔的文本文件并显示文件内容。的writecell函数输出一个名为C.txt．

writecell (C)类型“C.txt”

1,2,3文本，09- 01 -2019,1小时

要将相同的单元格数组写入具有不同分隔符字符的文本文件，请使用“分隔符”名称-值对。

writecell (C,“C_tab.txt”,“分隔符”,“标签”)类型“C_tab.txt”

2019年1月09日1小时

将单元格数组写入电子表格文件

打开实时脚本

创建单元格数组，将其写入电子表格文件，然后读取并显示文件的内容。

在工作区中创建单元格数组。

C = {1,2,3;“文本”datetime (“今天”(1)}),小时

C =2×3单元格数组{[1]}{[2]}{[3]}{‘文本’}{(09 - 1月- 2019)}{(1小时)}

将单元格数组写入电子表格文件。

writecell (C,“C.xls”）

读取并显示矩阵C.xls．

readcell (“C.xls”）

ans =2×3单元格数组{[1]}{[2]}{[3]}{‘文本’}{(09 - 1月- 2019)}{' 1小时'}

将单元格数组写入指定的工作表和范围

打开实时脚本

创建单元格数组，并将其写入电子表格文件中的指定表和范围。

在工作区中创建单元格数组。

C = {1,2,3;“文本”datetime (“今天”(1)}),小时

C =2×3单元格数组{[1]}{[2]}{[3]}{‘文本’}{(09 - 1月- 2019)}{(1小时)}

将单元格数组写入文件Cxls，在文件的第二个工作表中，从第三行开始。

writecell (C,“C.xls”,“表”2,“范围”,A3: C5的）

读取并显示单元格数组。

readcell (“C.xls”,“表”2,“范围”,A3: C5的）

ans =2×3单元格数组{[1]}{[2]}{[3]}{‘文本’}{(09 - 1月- 2019)}{' 1小时'}

在电子表格中的现有数据下面附加单元格数组

打开实时脚本

将单元格数组附加到包含现有数据的电子表格文件的底部。

在工作区中创建两个单元格数组。

C = {1,2,3;“文本”datetime (“今天”(1)}),小时

C =2×3单元格数组{[1]}{[2]}{[3]}{‘文本’}{[31 - 8月- 2022]}{(1小时)}

RGB = {“红色”,“绿色”,“蓝”｝

rgb =1 x3单元格{'红'}{'绿'}{'蓝'}

写入单元格数组C一个名为C的电子表格文件xls．

writecell (C,“C.xls”）

附加单元格数组rgb下面是电子表格文件中的现有数据。

writecell (rgb,“C.xls”,“写模式”,“添加”）

读取并显示单元格数组。

readcell (“C.xls”）

ans =3×3单元格数组{[1]}{[2]}{[3]}{‘文本’}{[31 - 8月- 2022]}{“1小时”}{‘红色’}{“绿色”}{“蓝”}

附加单元格数组到文本文件的底部

打开实时脚本

将单元格数组附加到包含现有数据的文本文件的底部。

在工作区中创建三个单元格数组。

州= {“麻省”,“纽约”,“马里兰”,“维吉尼亚”｝

州=1×4单元格数组(“麻省”){}{[“纽约”]}{[“马里兰”]}{[“弗吉尼亚”]}

stateBird = {“吃教”山雀,“东蓝知更鸟”,.．.“巴尔的摩金莺”,“红衣主教”｝

stateBird =1×4单元格数组列1到3{["黑顶…"]}{["东部蓝…}{["巴尔的摩或…}第4列{["红衣主教"]}

stateFlower = {“落后于杨梅”,“玫瑰”,.．.“黑眼苏珊。”,“开花山茱萸”｝

stateFlower =1×4单元格数组列1到3{["拖尾arb…"}{["玫瑰"]}{["黑眼睛S…"}第4列{["开花做…"]}

写入单元格数组州到文件states.txt．然后写入数组stateBird而且stateFlower下面的文本文件中的现有条目。

writecell(州,“states.txt”) writecell (stateBird“states.txt”,“写模式”,“添加”) writecell (stateFlower“states.txt”,“写模式”,“添加”）

读取并显示单元格数组。

readcell (“states.txt”）

ans =3 x4细胞第1至3列{'马萨诸塞州'}{'纽约'}{'马里兰州'}{'黑顶c…＇｝{'Eastern bluebird'} {'Baltimore oriole'} {'Trailing arbutus' } {'Rose' } {'Black-eyed Susan'} Column 4 {'Virginia' } {'Cardinal' } {'Flowering dogwood'}

输入参数

全部折叠

`C`- - - - - -输入单元格数组
单元阵列

输入数据，指定为单元格数组。

`文件名`- - - - - -文件名称
特征向量|字符串标量

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

根据你要写信的地点，文件名可以变成这些形式之一。

位置

形式

当前文件夹

要写入当前文件夹，请指定文件的名称文件名．

例子:“myTextFile.csv”

其他文件夹

要写入与当前文件夹不同的文件夹，请在中指定完整或相对路径名文件名．

例子:“C: \ myFolder \ myTextFile.csv”

例子:“myFolder \ myExcelFile.xlsx”

远程位置

要向远程位置写入数据，文件名必须包含指定为统一资源定位器(URL)的文件的完整路径，格式为:

scheme_name: / /path_to_file/my_file.ext

根据位置的远近scheme_name可以是本表中的值之一。

远程位置	`scheme_name`
Amazon S3™	`s3`
Windows Azure^®Blob存储	`wasb`,`wasbs`
HDFS™	`hdfs`

有关更多信息，请参见使用远程数据．

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

如果文件名包括文件扩展名，然后写入功能从扩展名确定文件格式。否则，写入函数创建一个以逗号分隔的文本文件，并追加扩展名. txt．或者，您可以指定文件名没有文件的扩展名，然后包括“文件类型”名称-值对参数来指示文件类型。

如果文件名不存在，则写入函数创建该文件。
如果文件名是现有文本文件的名称，则写入函数将覆盖该文件。
如果文件名是现有电子表格文件的名称，则写入函数将数据写入指定的位置，但不覆盖输入数据范围之外的任何值。

数据类型:字符|字符串

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:“文件类型”,文本指示不应将变量名包括在输出文件的第一行中。

文本和电子表格文件

全部折叠

`文件类型`- - - - - -文件类型
`“文本”`|`“表格”`

文件类型，指定为逗号分隔的对，由“文件类型”和字符向量或字符串，包含“文本”或“表格”．

的“文件类型”名称-值对必须与文件名输入参数。不需要指定“文件类型”名称-值对参数文件名Input参数包含一个标准的文件扩展名。写入功能可以识别以下标准文件扩展名:

. txt,.dat,或. csv对于带分隔符的文本文件
xls,.xlsm,或.xlsx用于Excel电子表格文件
.xlsb下载Excel for Windows系统所支持的Exc金宝appel电子表格文件

例子:“文件类型”、“表格”

数据类型:字符|字符串

`DateLocale`- - - - - -书写日期的地区
特征向量|字符串标量

用于写入日期的区域设置，指定为逗号分隔的对，由“DateLocale”和字符向量或字符串标量。当你写datetime值添加到文件中，使用DateLocale指定的区域设置writecell应写出月份和星期的名称和缩写。字符向量或字符串采用这种形式xx_YY,在那里xx是一个小写的ISO 639-1两个字母的代码，表示一种语言，和YY是大写的ISO 3166-1 alpha-2代码，表示国家。有关区域设置的通用值的列表，请参见语言环境属性的名称-值对参数datetime函数。

写入函数忽略“DateLocale”当日期可以写成excel格式的日期时，参数值。

例子:“DateLocale”、“ja_JP”

数据类型:字符|字符串

`写方式`- - - - - -写作模式
特征向量|字符串标量

写入模式，指定为由逗号分隔的对组成“写模式”和字符向量或字符串标量。根据文件类型选择写方式。

文件类型	写模式
文本文件	`“覆盖”`(默认)-覆盖文件。 `“添加”`—追加文件内容。如果指定的文件不存在，则写入函数将创建数据并将数据写入新文件。
电子表格文件	`“原地”`(默认)-只更新输入数据占用的范围。写入函数不会改变输入数据所占范围之外的任何数据。如果没有指定工作表，则写入函数将写入第一个工作表。 `“overwritesheet”`—清空指定的工作表，并将输入数据写入清空的工作表中。如果没有指定工作表，则写入函数将清除第一个工作表并将输入数据写入其中。 `“添加”`—写入功能将输入的数据追加到指定表格已占用范围的底部。如果没有指定工作表，则写入函数将输入数据追加到第一个工作表的占用范围的底部。 `“replacefile”`-从文件中删除所有其他工作表，然后将输入数据清除并写入指定的工作表。如果没有指定工作表，则写入函数将从文件中删除所有其他工作表，然后清除输入数据并将其写入第一个工作表。如果指定的文件不存在，则写入函数将创建一个新文件并将输入数据写入第一个工作表。

文件类型

写模式

文本文件

“覆盖”(默认)-覆盖文件。
“添加”—追加文件内容。

如果指定的文件不存在，则写入函数将创建数据并将数据写入新文件。

电子表格文件

“原地”(默认)-只更新输入数据占用的范围。写入函数不会改变输入数据所占范围之外的任何数据。
- 如果没有指定工作表，则写入函数将写入第一个工作表。

“overwritesheet”—清空指定的工作表，并将输入数据写入清空的工作表中。
- 如果没有指定工作表，则写入函数将清除第一个工作表并将输入数据写入其中。

“添加”—写入功能将输入的数据追加到指定表格已占用范围的底部。
- 如果没有指定工作表，则写入函数将输入数据追加到第一个工作表的占用范围的底部。

“replacefile”-从文件中删除所有其他工作表，然后将输入数据清除并写入指定的工作表。
- 如果没有指定工作表，则写入函数将从文件中删除所有其他工作表，然后清除输入数据并将其写入第一个工作表。
- 如果指定的文件不存在，则写入函数将创建一个新文件并将输入数据写入第一个工作表。

当WriteVariableNames设置为真正的，写功能不支持写模式金宝app“添加”．
电子表格文件:
- 当写模式为时“添加”，写入功能不支持金宝app范围参数。
- 如果指定的文件不存在，则写入函数执行与“replacefile”．

例子:“写模式”,“添加”

数据类型:字符|字符串

仅限文本文件

全部折叠

`分隔符`- - - - - -字段分隔符字符
特征向量|字符串标量

字段分隔符字符，指定为逗号分隔的对，由“分隔符”和包含以下说明符之一的字符向量或字符串标量:

说明符	字段分隔符
`”、“` `“逗号”`	逗号。这是默认行为。
`' '` `“空间”`	空间
`' \ t '` `“标签”`	选项卡
`“;”` `“半”`	分号
`“\|”` `“酒吧”`	竖线

您可以使用“分隔符”仅用于分隔文本文件的名称-值对。

例子:“分隔符”、“空间”

数据类型:字符|字符串

`QuoteStrings`- - - - - -用于写作引用文本的指示器
`“最低”`(默认)|`“所有”`|`“没有”`

用于写入引用文本的指示器，指定为“最低”,“所有”,或“没有”．

如果QuoteStrings是“最低”，则该函数将包含分隔符、行结束符或双引号字符的任何变量包含在双引号字符中。
如果QuoteStrings是“所有”，则该函数将所有文本、类别、datetime和持续时间变量包含在双引号中。
如果QuoteStrings是“没有”，则函数不会用双引号将变量括起来。

您可以使用QuoteStrings仅对带分隔符的文本文件使用名称-值参数。

`编码`- - - - - -字符编码方案
`“utf - 8”`(默认)|`“iso - 8859 - 1”`|`“windows - 1251”`|`“windows - 1252”`|……

与文件关联的字符编码方案，指定为逗号分隔的对，由“编码”而且“系统”或标准字符编码方案名称。当您不指定任何编码时，写入函数使用UTF-8写入文件。

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

数据类型:字符|字符串

电子表格文件

全部折叠

`表`- - - - - -要写入的工作表
特征向量|字符串标量|正整数

要写入的工作表，指定为逗号分隔的对，由“表”字符向量或包含工作表名称的字符串标量或指示工作表索引的正整数。工作表名称不能包含冒号(：)．若要确定电子表格文件中工作表的名称，请使用Sheets = sheetnames(文件名)．有关更多信息，请参见sheetnames．

按名称或索引指定要写入的工作表:

name -如果指定的表名在文件中不存在，则写入函数将在工作表集合的末尾添加一个新表。
index -如果指定的工作表索引大于工作表的数量，则写入函数将追加空工作表，直到工作簿中的工作表数量等于工作表索引。写入功能还生成一个警告，表明它已添加了一个新的工作表。

您可以使用“表”仅用于电子表格文件的名称-值对。

例子:“表”,2

例子:“表”,“MySheetName”

数据类型:字符|字符串|单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

`范围`- - - - - -要写入的工作表的矩形部分
特征向量|字符串标量

要写入的工作表的矩形部分，指定为由逗号分隔的对组成的“范围”和下列形式之一的字符向量或字符串标量。

价值的形式范围 描述

价值的形式`范围`	描述
`＇Corner1＇`	`Corner1`指定要写入的区域的第一个单元格。写入函数从这个单元格开始写入数据。例子:`“范围”、“D2”`
`＇Corner1: Corner2＇`	`Corner1`而且`Corner2`是两个相对的角，它们定义了要写入的区域。例如,`“D2: H4”`表示两个角之间的3 × 5矩形区域`D2`而且`H4`在工作表上。的`“范围”`名称-值对参数不区分大小写，并使用Excel A1引用样式(请参阅Excel帮助)。例子:`“范围”、“D2: H4` 如果指定的范围小于输入数据的大小，则写入函数只写入符合范围的输入数据的子集。如果指定的范围大于输入数据的大小，则写入函数保持区域的其余部分不变。

＇Corner1＇

Corner1指定要写入的区域的第一个单元格。写入函数从这个单元格开始写入数据。

例子:“范围”、“D2”

＇Corner1: Corner2＇

Corner1而且Corner2是两个相对的角，它们定义了要写入的区域。例如,“D2: H4”表示两个角之间的3 × 5矩形区域D2而且H4在工作表上。的“范围”名称-值对参数不区分大小写，并使用Excel A1引用样式(请参阅Excel帮助)。

例子:“范围”、“D2: H4

如果指定的范围小于输入数据的大小，则写入函数只写入符合范围的输入数据的子集。
如果指定的范围大于输入数据的大小，则写入函数保持区域的其余部分不变。

的“范围”名称-值对只能用于Excel文件。

例子:“范围”,A1: F10的

数据类型:字符|字符串

`UseExcel`- - - - - -标记启动Microsoft Excel for Windows实例
`假`(默认)|`真正的`

的实例开始的标志微软^®Excel写入电子表格数据时，指定为逗号分隔的对，由“UseExcel”,要么真正的,或假．

您可以设置“UseExcel”参数设置为以下值之一:

真正的—写入时启动Excel实例。
假—写入时不启动Excel实例。在此模式下操作时，写入功能在对文件格式和交互特性(如公式和宏)的支持方面有所不同。金宝app

UseExcel	`真正的`	`假`
金宝app支持的文件格式	`.xls， .xlsx， .xlsm， .xltx， .xltm， .xlsb， .ods`	`.xls， .xlsx， .xlsm， .xltx， .xltm`
金宝app支持交互式特性，如公式和宏	是的	没有

在Windows平台上写入电子表格文件时，如果要启动的实例Microsoft Excel，然后设置“UseExcel”参数真正的．

`AutoFitWidth`- - - - - -自动调整列宽
`真正的`(默认)|`假`

自动调整列宽，指定为真正的或假．的值0或假,然后writecell不会自动调整列宽度以适应单元格中的数据。

例子:“AutoFitWidth”,0

`PreserveFormat`- - - - - -保留单元格格式
`真正的`(默认)|`假`

保留现有电子表格的单元格格式，指定为真正的或假．如果你指定假,writecell将不会保留电子表格的单元格格式。格式包括字体、单元格边框和颜色阴影单元格等元素。

当你写datetime数据到电子表格文件，必须同时设置“PreserveFormat”和“UseExcel”名称-值对真正的以保留现有的单元格格式。如果“UseExcel”设置为假而且“PreserveFormat”设置为真正的当你写datetime数据到文件中，writecell不会保留文件的现有单元格格式。

例子:“PreserveFormat”,假

算法

有一些例子writecell函数创建的文件不完全表示输入数据。的时候，您会注意到这一点readcell函数读取该文件。结果数据可能没有与原始数据完全相同的格式或内容。如果您需要保存单元格数组，并在稍后检索它，以完全匹配原始单元格数组，使用相同的数据和组织，然后将其保存为mat文件。writecell在以下实例中写入一个不精确的表:

writecell用写出数值数据长g格式，类别或字符数据为未引用的文本。
writecell将具有两个以上维度的单元格数组写入二维数组，并将后面的维度折叠起来。

版本历史

在R2019a中引入

另请参阅

writetable|writetimetable|readcell|writematrix

writecell

语法

描述

例子

将单元格数组写入文本文件

将单元格数组写入电子表格文件

将单元格数组写入指定的工作表和范围

在电子表格中的现有数据下面附加单元格数组

附加单元格数组到文本文件的底部

输入参数

C- - - - - -输入单元格数组单元阵列

文件名- - - - - -文件名称特征向量|字符串标量

名称-值参数

文件类型- - - - - -文件类型“文本”|“表格”

DateLocale- - - - - -书写日期的地区特征向量|字符串标量

写方式- - - - - -写作模式特征向量|字符串标量

分隔符- - - - - -字段分隔符字符特征向量|字符串标量

QuoteStrings- - - - - -用于写作引用文本的指示器“最低”(默认)|“所有”|“没有”

编码- - - - - -字符编码方案“utf - 8”(默认)|“iso - 8859 - 1”|“windows - 1251”|“windows - 1252”|……

表- - - - - -要写入的工作表特征向量|字符串标量|正整数

范围- - - - - -要写入的工作表的矩形部分特征向量|字符串标量

UseExcel- - - - - -标记启动Microsoft Excel for Windows实例假(默认)|真正的

AutoFitWidth- - - - - -自动调整列宽真正的(默认)|假

PreserveFormat- - - - - -保留单元格格式真正的(默认)|假

算法

版本历史

另请参阅

`C`- - - - - -输入单元格数组
单元阵列

`文件名`- - - - - -文件名称
特征向量|字符串标量

`文件类型`- - - - - -文件类型
`“文本”`|`“表格”`

`DateLocale`- - - - - -书写日期的地区
特征向量|字符串标量

`写方式`- - - - - -写作模式
特征向量|字符串标量

`分隔符`- - - - - -字段分隔符字符
特征向量|字符串标量

`QuoteStrings`- - - - - -用于写作引用文本的指示器
`“最低”`(默认)|`“所有”`|`“没有”`

`编码`- - - - - -字符编码方案
`“utf - 8”`(默认)|`“iso - 8859 - 1”`|`“windows - 1251”`|`“windows - 1252”`|……

`表`- - - - - -要写入的工作表
特征向量|字符串标量|正整数

`范围`- - - - - -要写入的工作表的矩形部分
特征向量|字符串标量

`UseExcel`- - - - - -标记启动Microsoft Excel for Windows实例
`假`(默认)|`真正的`

`AutoFitWidth`- - - - - -自动调整列宽
`真正的`(默认)|`假`

`PreserveFormat`- - - - - -保留单元格格式
`真正的`(默认)|`假`