diff --git a/src/corelib/io/qfile.cpp b/src/corelib/io/qfile.cpp index 585b5c8a1b9..c260e98202d 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 or \c ) 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