Core
Classes
Section titled “Classes”| Name | Description |
|---|---|
BuildInfo | Exposes build-time SDK and target metadata compiled into the core module. |
Config | Stores the normalized values returned after successful schema validation. |
ConfigError | Describes one parser or validation failure produced by ConfigSchema. |
ConfigMigrationRunner | Orchestrates an ordered sequence of ConfigMigrationStep instances. |
ConfigMigrationStep | Base class representing a single migration operation in a configuration pipeline. |
ConfigResult | Represents either a validated Config or the complete list of validation errors. |
ConfigSchema | Declares and validates a typed application configuration schema. |
ConfigStore | Provides thread-safe read/write access to a single INI-format QSettings file. |
DeviceInfo | Provides static information about the device the application runs on. |
SingletonInterface | Provides lazy singleton construction for service-style classes. |
Functions
Section titled “Functions”| Return | Name | Description |
|---|---|---|
bool | enumToStr static | Convert an enum value into its case-sensitive Qt meta-object key. |
bool | strToEnum static | Convert a case-sensitive Qt meta-object key into an enum value. |
bool | toObjList static | Cast a list of QObject-derived pointers into a QList<QObject*>. |
static
enumToStr
Section titled “enumToStr”Convert an enum value into its case-sensitive Qt meta-object key.
This helper uses QMetaEnum::fromType<T>() to resolve the registered key name for enumeration. If the enum type is not registered with Qt’s meta-object system, or if the provided value does not map to a known key, the output string is cleared and the function returns false.
Returns
Section titled “Returns”true when the enum value was resolved to a key name; otherwise false.
Parameters
Section titled “Parameters”| Name | Type | Description |
|---|---|---|
enumeration | T | Enum value to convert into its string key. |
str | QString* | Output parameter that receives the enum key when conversion succeeds, or an empty string when conversion fails. |
static
strToEnum
Section titled “strToEnum”Convert a case-sensitive Qt meta-object key into an enum value.
This helper uses QMetaEnum::fromType<T>() to look up an enum value by its registered key name. The conversion is case-sensitive and only succeeds when str exactly matches a known key for the enum type.
Returns
Section titled “Returns”true when str maps to a valid enum key; otherwise false.
Parameters
Section titled “Parameters”| Name | Type | Description |
|---|---|---|
str | const QString& | Case-sensitive enum key to parse. |
enumeration | T* | Output parameter that receives the parsed enum value when conversion succeeds. |
static
toObjList
Section titled “toObjList”Cast a list of QObject-derived pointers into a QList<QObject*>.
This helper is primarily intended for APIs such as Q_PROPERTY declarations that expose heterogeneous QObject collections through a common base type. The conversion fails if any item cannot be cast to QObject.
Returns
Section titled “Returns”true when every item was cast successfully; otherwise false.
Parameters
Section titled “Parameters”| Name | Type | Description |
|---|---|---|
in | const QList<T*>& | Input list containing pointers to cast. |
out | QList<QObject*>* | Output parameter intended to receive the casted QObject list when every item converts successfully. |