Qbs

Blog Documentation Get Qbs Community
  • Qbs Manual
  • List of Built-in Services
  • TextFile Service
  • Qbs 2.4.0
  • TextFile Service

    The TextFile service allows you to read from and write into text files.

    TextFile.OpenMode

    enum TextFile.OpenMode { ReadOnly, WriteOnly, ReadWrite, Append }

    List of modes that a file may be opened in.

    The OpenMode values can be combined with the bitwise or operator.

    Available operations

    Constructor

    TextFile(filePath: string, openMode: OpenMode = TextFile.ReadOnly)

    Opens the file at filePath in the given mode and returns the object representing the file.

    Note: The mode influences which of the operations listed below can actually be used on the file.

    atEof

    atEof(): boolean

    Returns true if no more data can be read from the file, false otherwise.

    close

    close(): void

    Closes the file. It is recommended to always call this function as soon as you are finished with the file, in order to keep the number of in-flight file descriptors as low as possible.

    filePath

    filePath(): string

    The absolute path of the file represented by this object.

    readAll

    readAll(): string

    Reads all data from the file and returns it.

    readLine

    readLine(): string

    Reads one line of text from the file and returns it. The returned string does not contain the newline characters.

    setCodec

    setCodec(codec: string): void

    Sets the text codec to codec. The supported codecs are the same as for QTextCodec, for example: "UTF-8", "UTF-16", and "ISO 8859-1".

    truncate

    truncate(): void

    Truncates the file, that is, gives it the size of zero, removing all content.

    write

    write(data: string): void

    Writes data into the file at the current position.

    writeLine

    writeLine(data: string): void

    Writes data into the file at the current position and appends the newline character(s).