File.readText Action

Format

s = CS.File.readText(path := ...ʃ, encoding := ...ʅ)

Argument	Description	Types / Required
path	The path of the file to read.	string required
encoding	The encoding to use to decode the file's text. The default value is "UTF-8".	string not required

Description

The File.readText action reads a file, specified as path, as text, returning the entire file's content as a single string.

The encoding argument allows you specify how the contents of the file are decoded to text. There are few cases where this may be necessary, as the default of reading UTF-8 text will generally meet the needs of most users. Options include:

"ANSI": The contents are decoded as part of the Windows code page.
"UTF-8": The contents are decoded as UTF-8, regardless of whether there is a byte order mark (BOM).
"UTF-8-BOM": The contents are decoded as UTF-8, regardless of whether there is a BOM.

Return Value

The action returns a string containing the file's content.

Exceptions

The action throws an exception if any of its arguments are not specified in a valid form or if the file does not exist or cannot be read.

Example (CSPro)

// read the text stored in readme.txt
string fileText = CS.File.readText(path := "readme.txt");

// write the text in uppercase form
CS.File.writeText(path := "readme (uppercase).txt", text := toupper(fileText));