QLibraryInfo Class

The QLibraryInfo class provides information about the Qt library. More...

Header: #include <QLibraryInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Public Types

enum LibraryPath { PrefixPath, DocumentationPath, HeadersPath, LibrariesPath, LibraryExecutablesPath, …, SettingsPath }

Static Public Members

bool isDebugBuild()
(since 6.5) bool isSharedBuild()
(since 6.0) QString path(QLibraryInfo::LibraryPath p)
(since 6.8) QStringList paths(QLibraryInfo::LibraryPath p)
QVersionNumber version()

Detailed Description

Many pieces of information are established when Qt is configured and built. This class provides an abstraction for accessing that information. By using the static functions of this class, an application can obtain information about the instance of the Qt library which the application is using at run-time.

You can also use a qt.conf file to override the hard-coded paths that are compiled into the Qt library. For more information, see the Using qt.conf documentation.

See also QSysInfo and Using qt.conf.

Member Type Documentation

enum QLibraryInfo::LibraryPath

This enum type is used to query for a specific path:

ConstantValueDescription
QLibraryInfo::PrefixPath0The default prefix for all paths.
QLibraryInfo::DocumentationPath1The path to documentation upon install.
QLibraryInfo::HeadersPath2The path to all headers.
QLibraryInfo::LibrariesPath3The path to installed libraries.
QLibraryInfo::LibraryExecutablesPath4The path to installed executables required by libraries at runtime.
QLibraryInfo::BinariesPath5The path to installed Qt binaries (tools and applications).
QLibraryInfo::PluginsPath6The path to installed Qt plugins.
QLibraryInfo::QmlImportsPath7The path to installed QML extensions to import.
QLibraryInfo::Qml2ImportsPathQmlImportsPathThis value is deprecated. Use QmlImportsPath instead.
QLibraryInfo::ArchDataPath8The path to general architecture-dependent Qt data.
QLibraryInfo::DataPath9The path to general architecture-independent Qt data.
QLibraryInfo::TranslationsPath10The path to translation information for Qt strings.
QLibraryInfo::ExamplesPath11The path to examples upon install.
QLibraryInfo::TestsPath12The path to installed Qt testcases.
QLibraryInfo::SettingsPath100The path to Qt settings. Not applicable on Windows.

See also path().

Member Function Documentation

[static noexcept] bool QLibraryInfo::isDebugBuild()

Returns true if this build of Qt was built with debugging enabled, or false if it was built in release mode.

[static noexcept, since 6.5] bool QLibraryInfo::isSharedBuild()

Returns true if this is a shared (dynamic) build of Qt.

This function was introduced in Qt 6.5.

[static, since 6.0] QString QLibraryInfo::path(QLibraryInfo::LibraryPath p)

Returns the path specified by p.

If there is more than one path listed in qt.conf, it will only return the first one.

This function was introduced in Qt 6.0.

See also paths.

[static, since 6.8] QStringList QLibraryInfo::paths(QLibraryInfo::LibraryPath p)

Returns all paths specificied by p.

This function was introduced in Qt 6.8.

See also path.

[static noexcept] QVersionNumber QLibraryInfo::version()

Returns the version of the Qt library.

See also qVersion().