writelines

Write text to file

Since R2022a

Syntax

writelines(lines,filename)

writelines(lines,filename,Name=Value)

Description

writelines(lines,filename) writes the text specified by lines to a plain text file named filename. If the file specified by filename does not exist, writelines creates a new file. Otherwise, writelines overwrites the existing file.

writelines(lines,filename,Name=Value) specifies options using one or more name-value arguments. For example, you can append the text to an existing file, specify end-of-line characters, or specify the character encoding scheme.

Examples

Write Text to Local File

Write the text "Example String" to a new file within the current directory.

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

Display the contents of the new file.

type temp.txt

Example String

Append Text to Existing File

Append a string to an existing file.

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

Display the contents of the appended file.

type C:\Users\asato3\Desktop\original_file.txt

Original Content 123
New Content 456

Input Arguments

lines — Text to write

string array | character vector | cell array of character vectors

Text to write, specified as a string array, character vector, or cell array of character vectors. Each element of the array is written as a separate line in the file.

Example: "Sample text"

Example: ["String1","String2","String3"]

filename — File name

string scalar | character vector

File name, specified as a string scalar or character vector, used to designate where to write the lines of data. Depending on the location of the file, filename can take on one of these forms.

Location	Form
Current folder or folder on the MATLAB® path	Specify the name of the file in filename. Example: "myFile.txt"
File in a folder	If the file is not in the current folder or in a folder on the MATLAB path, then specify the full or relative path name in filename. Example: "C:\myFolder\myFile.xlsx" Example: "dataDir\myFile.txt"
Internet URL	If the file is specified as an internet uniform resource locator (URL), then filename must contain the protocol type "http://" or "https://". Example: "http://hostname/path_to_file/my_data.csv"
Remote Location	If the file is stored at a remote location, then filename must contain the full path of the file specified with the form: scheme_name://path_to_file/my_file.ext Based on the remote location, scheme_name can be one of the values in this table. Remote Location scheme_name Amazon S3™ s3 Azure® Blob Storage wasb, wasbs HDFS™ hdfs For more information, see Work with Remote Data. Example: "s3://bucketname/path_to_file/my_file.csv"

Example: writelines("Sample string","temp.txt") writes to a file in the current folder.

Example: writelines("Sample string","s3://bucketname/path_to_file/temp.txt") writes to a file at the Amazon S3 URL.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: writelines(lines,filename,WriteMode="append") appends data to an existing file.

LineEnding — End-of-line characters

string scalar | character vector

End-of-line characters, specified as either a string scalar or character vector. The default value is dependent on system, the default value is "\r\n" on Windows^® and "\n" on UNIX^® and macOS.

Example: LineEnding="\n"

Example: LineEnding="\r\n"

Encoding — Character encoding scheme

"system" (default) | "UTF-8" | "ISO-8859-1" | "windows-1251" | "windows-1252" | ...

Character encoding scheme associated with the file, specified as "system" or one of the values in the table. The default value is "system", which uses your system default encoding to write the file.

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

Example: Encoding="system" uses the system default encoding.

WriteMode — Writing mode

"overwrite" (default) | "append"

Writing mode, specified as "overwrite" or "append". For an existing file, "overwrite" will overwrite the file and "append" will append data to the file.

Example: WriteMode="append"

TrailingLineEndingRule — How to handle trailing line endings

"auto" (default) | "always" | "never"

How to handle trailing line endings in a file, specified as "auto", "always", or "never".

• "auto" – End the file with a trailing line ending. If the text does not have one, an extra line is appended.

• "always" – Always append a line ending to the file.

• "never" – Never append a line ending to the file.

Example: TrailingLineEndingRule="always"

Version History

Introduced in R2022a