diff options
author | Kai Köhne <kai.koehne@qt.io> | 2022-12-21 15:39:15 +0100 |
---|---|---|
committer | Kai Köhne <kai.koehne@qt.io> | 2022-12-22 19:23:53 +0100 |
commit | 8b0818235d512c9085ce0fd0ea2490f1653a6c36 (patch) | |
tree | b1b3913f365ba8e071ca4b220f274449aef34ee2 /src/corelib/io | |
parent | ac6e61d867d76d0a24449f82c0f484a513fec184 (diff) |
Doc: Reorder QFile overview
Move the paragraphs dealing with encodeName()/decodeName() and Unix
special files to 'Platform Specific Issues'.
Pick-to: 6.5
Change-Id: I076191e041ef238556aab28b5ad5d51974f8f7ff
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
Diffstat (limited to 'src/corelib/io')
-rw-r--r-- | src/corelib/io/qfile.cpp | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/src/corelib/io/qfile.cpp b/src/corelib/io/qfile.cpp index 585b5c8a1b..c260e98202 100644 --- a/src/corelib/io/qfile.cpp +++ b/src/corelib/io/qfile.cpp @@ -150,6 +150,15 @@ QAbstractFileEngine *QFilePrivate::engine() const data and operator>>() to read it back. See the class documentation for details. + \section1 Signals + + Unlike other QIODevice implementations, such as QTcpSocket, QFile does not + emit the aboutToClose(), bytesWritten(), or readyRead() signals. This + implementation detail means that QFile is not suitable for reading and + writing certain types of files, such as device files on Unix platforms. + + \section1 Platform Specific Issues + \l{Input/Output and Networking}{Qt APIs related to I/O} use UTF-16 based QStrings to represent file paths. Standard C++ APIs (\c <cstdio> or \c <iostream>) or platform-specific APIs however often need a 8-bit encoded @@ -167,15 +176,6 @@ QAbstractFileEngine *QFilePrivate::engine() const \snippet file/file.cpp 3 - \section1 Signals - - Unlike other QIODevice implementations, such as QTcpSocket, QFile does not - emit the aboutToClose(), bytesWritten(), or readyRead() signals. This - implementation detail means that QFile is not suitable for reading and - writing certain types of files, such as device files on Unix platforms. - - \section1 Platform Specific Issues - File permissions are handled differently on Unix-like systems and Windows. In a non \l{QIODevice::isWritable()}{writable} directory on Unix-like systems, files cannot be created. This is not always |