BaseTextDocument Class | Extending Qt Creator Manual

Extending Qt Creator Manual | BaseTextDocument

Extending Qt Creator Manual 4.12.0

# BaseTextDocument Class

(Core::BaseTextDocument)

The BaseTextDocument class is a very general base class for documents that work with text. More...

Header: | #include <BaseTextDocument>
Inherits: | Core::IDocument

- List of all members, including inherited members

## Public Functions

Utils::TextFileFormat | format() const
Core::BaseTextDocument::ReadResult | read(const QString &fileName, QStringList *plainTextList, QString *errorString)
Core::BaseTextDocument::ReadResult | read(const QString &fileName, QString *plainText, QString *errorString)
bool | write(const QString &fileName, const QString &data, QString *errorMessage) const
bool | write(const QString &fileName, const Utils::TextFileFormat &format, const QString &data, QString *errorMessage) const

## Detailed Description

This class contains helper methods for saving and reading text files with encoding and line ending settings.

See also Utils::TextFileFormat.

## Member Function Documentation

### Utils::TextFileFormat BaseTextDocument::format() const

Returns the format obtained from the last call to read().

### Core::BaseTextDocument::ReadResult BaseTextDocument::read(const QString &fileName, QStringList *plainTextList, QString *errorString)

Autodetects file format and reads the text file specified by fileName into a list of strings specified by plainTextList.

If an error occurs while writing the file, errorString is set to the error details.

Returns whether the operation was successful.

### Core::BaseTextDocument::ReadResult BaseTextDocument::read(const QString &fileName, QString *plainText, QString *errorString)

Autodetects file format and reads the text file specified by fileName into plainText.

If an error occurs while writing the file, errorString is set to the error details.

Returns whether the operation was successful.

### bool BaseTextDocument::write(const QString &fileName, const QString &data, QString *errorMessage) const

Writes out the contents (data) of the text file fileName. Uses the format obtained from the last read() of the file.

If an error occurs while writing the file, errorMessage is set to the error details.

Returns whether the operation was successful.

### bool BaseTextDocument::write(const QString &fileName, const Utils::TextFileFormat &format, const QString &data, QString *errorMessage) const

Writes out the contents (data) of the text file fileName. Uses the custom format format.

If an error occurs while writing the file, errorMessage is set to the error details.

Returns whether the operation was successful.