1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clarify limitations of QCoreApplication::libraryPaths()

Browse Source 
If you call libraryPaths() before constructing a QCoreApplication,
intersting things may happen.

Task-number: QTBUG-38598
Change-Id: I2861746277e391ede9e921e4a8ad825007e25fa0
Reviewed-by: Topi Reiniö <topi.reinio@digia.com>
This commit is contained in:
Ulf Hermann 2015-03-09 17:25:28 +01:00
parent 42a8613ffa
commit a3aaabc646
1 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
src/corelib/kernel/qcoreapplication.cpp
View File

@ -2420,16 +2420,27 @@ Q_GLOBAL_STATIC_WITH_ARGS(QMutex, libraryPathMutex, (QMutex::Recursive))
Returns a list of paths that the application will search when Returns a list of paths that the application will search when
dynamically loading libraries. dynamically loading libraries.
The return value of this function may change when a QCoreApplication
is created. It is not recommended to call it before creating a
QCoreApplication. The directory of the application executable (\b not
the working directory) is part of the list if it is known. In order
to make it known a QCoreApplication has to be constructed as it will
use \c {argv[0]} to find it.
Qt provides default library paths, but they can also be set using Qt provides default library paths, but they can also be set using
a \l{Using qt.conf}{qt.conf} file. Paths specified in this file a \l{Using qt.conf}{qt.conf} file. Paths specified in this file
will override default values. will override default values. Note that if the qt.conf file is in
the directory of the application executable, it may not be found
until a QCoreApplication is created. If it is not found when calling
this function, the default library paths will be used.
This list will include the installation directory for plugins if The list will include the installation directory for plugins if
it exists (the default installation directory for plugins is \c it exists (the default installation directory for plugins is \c
INSTALL/plugins, where \c INSTALL is the directory where Qt was INSTALL/plugins, where \c INSTALL is the directory where Qt was
installed). The directory of the application executable (NOT the installed). The colon separated entries of the \c QT_PLUGIN_PATH
working directory) is always added, as well as the colon separated environment variable are always added. The plugin installation
entries of the \c QT_PLUGIN_PATH environment variable. directory (and its existence) may change when the directory of
the application executable becomes known.
If you want to iterate over the list, you can use the \l foreach If you want to iterate over the list, you can use the \l foreach
pseudo-keyword: pseudo-keyword: