Main Content

writelines

将文本写入文件

自 R2022a 起

全页折叠

语法

writelines(lines,filename)
writelines(lines,filename,Name=Value)

说明

示例

writelines(lines,filename) 将 lines 指定的文本写入名为 filename 的纯文本文件。如果 filename 指定的文件不存在，writelines 会创建一个新文件。否则，writelines 会覆盖现有文件。

示例

writelines(lines,filename,Name=Value) 使用一个或多个名称-值参量指定选项。例如，您可以将文本追加到现有文件中，指定行尾字符，或指定字符编码方案。

示例

全部折叠

将文本“Example String”写入当前目录下的一个新文件中。

writelines("Example String","temp.txt")

显示新文件的内容。

type temp.txt
Example String

将一个字符串追加到现有文件中。

lines = "New Content 456";
filename = "C:\Users\asato3\Desktop\original_file.txt";
writelines(lines,filename,WriteMode="append")

显示追加后的文件的内容。

type C:\Users\asato3\Desktop\original_file.txt
Original Content 123
New Content 456

输入参数

全部折叠

要写入的文本，指定为字符串数组、字符向量或字符向量元胞数组。数组的每个元素在文件中作为单独的一行写入。

示例: "Sample text"

示例: ["String1","String2","String3"]

文件名，指定为字符串标量或字符向量，用于指定写入数据行的位置。根据文件的位置，filename 可以采用下列形式之一。

位置

形式

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

指定 filename 中文件的名称。

例如："myFile.txt"

文件夹中的文件

如果该文件不在当前文件夹或 MATLAB 路径下的文件夹中，则在 filename 中指定完整或相对路径名。

示例："C:\myFolder\myFile.xlsx"

例如："dataDir\myFile.txt"

Internet URL

如果文件指定为 Internet 统一资源定位器 (URL)，则 filename 必须包含协议类型 "http://" 或 "https://"。

例如："http://hostname/path_to_file/my_data.csv"

远程位置

如果文件存储在远程位置，则 filename 必须包含用以下格式指定的文件的完整路径：

scheme_name://path_to_file/my_file.ext

根据远程位置，scheme_name 可以是下表中的值之一。

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

有关详细信息，请参阅处理远程数据。

示例： "s3://bucketname/path_to_file/my_file.csv"

示例: writelines("Sample string","temp.txt") 写入当前文件夹下的一个文件。

示例: writelines("Sample string","s3://bucketname/path_to_file/temp.txt") 写入位于 Amazon S3 URL 上的一个文件。

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: writelines(lines,filename,WriteMode="append") 将数据追加到一个现有文件中。

行尾字符，指定为字符串标量或字符向量。默认值取决于系统，在 Windows® 上的默认值为 "\r\n"，在 UNIX® 和 macOS 上的默认值为 "\n"。

示例: LineEnding="\n"

示例: LineEnding="\r\n"

与文件关联的字符编码方案，指定为 "system" 或下表中的值之一。默认值为 "system"，它使用您的系统默认编码来写入文件。

"Big5"

"ISO-8859-1"

"windows-874"

"Big5-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"

"windows-1254"

"GB2312"

"ISO-8859-8"

"windows-1255"

"GBK"

"ISO-8859-9"

"windows-1256"

"IBM866"

"ISO-8859-11"

"windows-1257"

"KOI8-R"

"ISO-8859-13"

"windows-1258"

"KOI8-U"

"ISO-8859-15"

"US-ASCII"

 

"Macintosh"

"UTF-8"

 

"Shift_JIS"

 

示例: Encoding="system" 使用系统默认编码。

写入模式，指定为 "overwrite" 或 "append"。对于现有文件，"overwrite" 将覆盖该文件，而 "append" 将向该文件追加数据。

示例: WriteMode="append"

如何处理文件中的末尾换行符，指定为 "auto"、"always" 或 "never"。

  • "auto" - 以一个末尾换行符结束文件。如果文本没有换行符，则追加一个额外的行。

  • "always" - 始终在文件末尾追加一个换行符。

  • "never" - 从不在文件末尾追加换行符。

示例: TrailingLineEndingRule="always"

版本历史记录

在 R2022a 中推出

另请参阅

|