QLibrary Class

Documentación de funciones miembro

[explicit] QLibrary::QLibrary(QObject *parent = nullptr)

Construye una biblioteca con la dirección parent.

[explicit] QLibrary::QLibrary(const QString &fileName, QObject *parent = nullptr)

Construye un objeto biblioteca con el parent dado que cargará la biblioteca especificada por fileName.

Recomendamos omitir el sufijo del archivo en fileName, ya que QLibrary buscará automáticamente el archivo con el sufijo apropiado según la plataforma, por ejemplo ".so" en Unix, ".dylib" en macOS e iOS, y ".dll" en Windows. (Véase fileName.)

[explicit] QLibrary::QLibrary(const QString &fileName, const QString &version, QObject *parent = nullptr)

Construye un objeto biblioteca con el valor dado parent que cargará la biblioteca especificada por fileName y el número de versión completo version. Actualmente, el número de versión se ignora en Windows.

Recomendamos omitir el sufijo del archivo en fileName, ya que QLibrary buscará automáticamente el archivo con el sufijo apropiado de acuerdo con la plataforma, por ejemplo ".so" en Unix, ".dylib" en macOS e iOS, y ".dll" en Windows. (Véase fileName.)

[explicit] QLibrary::QLibrary(const QString &fileName, int verNum, QObject *parent = nullptr)

Construye un objeto biblioteca con el valor parent que cargará la biblioteca especificada por fileName y el número de versión principal verNum. Actualmente, el número de versión se ignora en Windows.

Recomendamos omitir el sufijo del archivo en fileName, ya que QLibrary buscará automáticamente el archivo con el sufijo apropiado de acuerdo con la plataforma, por ejemplo ".so" en Unix, ".dylib" en macOS e iOS, y ".dll" en Windows. (Véase fileName.)

[virtual noexcept] QLibrary::~QLibrary()

Destruye el objeto QLibrary.

A menos que se haya llamado explícitamente a unload(), la biblioteca permanecerá en memoria hasta que finalice la aplicación.

Véase también isLoaded() y unload().

QString QLibrary::errorString() const

Devuelve una cadena de texto con la descripción del último error que se ha producido. Actualmente, errorString sólo se establecerá si load(), unload() o resolve() por alguna razón fallan.

[static] bool QLibrary::isLibrary(const QString &fileName)

Devuelve true si fileName tiene un sufijo válido para una biblioteca cargable; en caso contrario devuelve false.

Los números de versión finales en Unix se ignoran.

bool QLibrary::isLoaded() const

Devuelve true si load() tuvo éxito; en caso contrario devuelve false.

Véase también load().

bool QLibrary::load()

Carga la biblioteca y devuelve true si la biblioteca se ha cargado correctamente; en caso contrario devuelve false. Dado que resolve() siempre llama a esta función antes de resolver cualquier símbolo, no es necesario llamarla explícitamente. En algunas situaciones es posible que desee cargar la biblioteca con antelación, en cuyo caso utilizaría esta función.

Véase también unload().

QFunctionPointer QLibrary::resolve(const char *symbol)

Devuelve la dirección del símbolo exportado symbol. Si es necesario, se carga la biblioteca. La función devuelve nullptr si no se ha podido resolver el símbolo o si no se ha podido cargar la biblioteca.

Ejemplo:

typedef int (*AvgFunction)(int, int);

AvgFunction avg = (AvgFunction) library->resolve("avg");
if (avg)
    return avg(5, 8);
else
    return -1;

El símbolo debe exportarse como una función C de la biblioteca. Esto significa que la función debe estar envuelta en un extern "C" si la biblioteca se compila con un compilador C++. En Windows también debe exportar explícitamente la función desde la DLL utilizando la directiva del compilador __declspec(dllexport), por ejemplo:

extern "C" MY_EXPORT int avg(int a, int b)
{
    return (a + b) / 2;
}

con MY_EXPORT definido como

#ifdef Q_OS_WIN
#define MY_EXPORT __declspec(dllexport)
#else
#define MY_EXPORT
#endif

[static] QFunctionPointer QLibrary::resolve(const QString &fileName, const char *symbol)

Carga la biblioteca fileName y devuelve la dirección del símbolo exportado symbol. Tenga en cuenta que fileName no debe incluir el sufijo de archivo específico de la plataforma; (véase fileName). La biblioteca permanece cargada hasta que se cierra la aplicación.

La función devuelve nullptr si no se ha podido resolver el símbolo o si no se ha podido cargar la biblioteca.

Véase también resolve().

[static] QFunctionPointer QLibrary::resolve(const QString &fileName, const QString &version, const char *symbol)

Carga la biblioteca fileName con el número de versión completo version y devuelve la dirección del símbolo exportado symbol. Tenga en cuenta que fileName no debe incluir el sufijo de archivo específico de la plataforma; (véase fileName). La biblioteca permanece cargada hasta que la aplicación sale. version se ignora en Windows.

La función devuelve nullptr si no se ha podido resolver el símbolo o si no se ha podido cargar la biblioteca.

Véase también resolve().

[static] QFunctionPointer QLibrary::resolve(const QString &fileName, int verNum, const char *symbol)

Carga la biblioteca fileName con el número de versión principal verNum y devuelve la dirección del símbolo exportado symbol. Tenga en cuenta que fileName no debe incluir el sufijo de archivo específico de la plataforma; (véase fileName). La biblioteca permanece cargada hasta que se cierra la aplicación. verNum se ignora en Windows.

La función devuelve nullptr si no se ha podido resolver el símbolo o si no se ha podido cargar la biblioteca.

Véase también resolve().

void QLibrary::setFileNameAndVersion(const QString &fileName, const QString &version)

Establece la propiedad fileName y el número de versión completa en fileName y version respectivamente. El parámetro version se ignora en Windows.

Véase también setFileName().

void QLibrary::setFileNameAndVersion(const QString &fileName, int versionNumber)

Establece la propiedad fileName y el número de versión principal en fileName y versionNumber respectivamente. versionNumber se ignora en Windows.

Véase también setFileName().

bool QLibrary::unload()

Descarga la biblioteca y devuelve true si la biblioteca pudo ser descargada; en caso contrario devuelve false.

Esto ocurre automáticamente al finalizar la aplicación, por lo que normalmente no debería ser necesario llamar a esta función.

Si otras instancias de QLibrary están utilizando la misma biblioteca, la llamada fallará, y la descarga sólo se producirá cuando todas las instancias hayan llamado a unload().

Ten en cuenta que en macOS, las bibliotecas dinámicas no pueden ser descargadas. QLibrary::unload() devolverá true, pero la biblioteca permanecerá cargada en el proceso.

Ver también resolve() y load().