QPluginLoader Class

멤버 함수 문서

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

주어진 parent 으로 플러그인 로더를 생성합니다.

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

fileName 에 지정된 플러그인을 로드하는 parent 로 플러그인 로더를 생성합니다.

로드 가능하려면 파일의 접미사가 플랫폼에 따라 로드 가능한 라이브러리에 유효한 접미사여야 합니다(예: Unix의 경우 .so, - macOS 및 iOS의 경우 .dylib, Windows의 경우 .dll ). 접미사는 QLibrary::isLibrary()로 확인할 수 있습니다.

setFileName()도 참조하세요 .

[virtual noexcept] QPluginLoader::~QPluginLoader()

QPluginLoader 객체를 삭제합니다.

unload()가 명시적으로 호출되지 않는 한 플러그인은 애플리케이션이 종료될 때까지 메모리에 남아 있습니다.

isLoaded() 및 unload()도 참조하세요 .

QString QPluginLoader::errorString() const

마지막으로 발생한 오류에 대한 설명이 포함된 텍스트 문자열을 반환합니다.

QObject *QPluginLoader::instance()

플러그인의 루트 컴포넌트 객체를 반환합니다. 필요한 경우 플러그인이 로드됩니다. 플러그인을 로드할 수 없거나 루트 컴포넌트 객체를 인스턴스화할 수 없는 경우 nullptr 함수를 반환합니다.

루트 컴포넌트 객체가 소멸된 경우 이 함수를 호출하면 새 인스턴스가 생성됩니다.

이 함수가 반환하는 루트 컴포넌트는 QPluginLoader 사이트가 삭제되어도 삭제되지 않습니다. 루트 컴포넌트가 삭제되었는지 확인하려면 더 이상 핵심 컴포넌트에 액세스할 필요가 없는 즉시 unload()를 호출해야 합니다. 라이브러리가 최종적으로 언로드되면 루트 컴포넌트는 자동으로 삭제됩니다.

컴포넌트 객체는 QObject. 관심 있는 인터페이스에 액세스하려면 qobject_cast()를 사용합니다.

load()도 참조하세요 .

bool QPluginLoader::isLoaded() const

플러그인이 로드되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

load()도 참조하세요 .

bool QPluginLoader::load()

플러그인을 로드하고 플러그인이 성공적으로 로드된 경우 true 을 반환하고 그렇지 않으면 false 을 반환합니다. instance ()는 항상 기호를 확인하기 전에 이 함수를 호출하므로 명시적으로 호출할 필요는 없습니다. 어떤 상황에서는 플러그인을 미리 로드하고 싶을 수 있으며, 이 경우 이 함수를 사용할 수 있습니다.

unload()도 참조하세요 .

QJsonObject QPluginLoader::metaData() const

이 플러그인의 메타 데이터를 반환합니다. 메타 데이터는 플러그인을 컴파일할 때 Q_PLUGIN_METADATA() 매크로를 사용하여 json 형식으로 지정한 데이터입니다.

메타 데이터는 플러그인을 실제로 로드하지 않고도 빠르고 저렴한 방법으로 쿼리할 수 있습니다. 이를 통해 예를 들어 플러그인의 기능을 저장하고 이 메타 데이터에 따라 플러그인을 로드할지 여부를 결정할 수 있습니다.

[static] QObjectList QPluginLoader::staticInstances()

플러그인 로더가 보유한 정적 플러그인 인스턴스(루트 컴포넌트)의 목록을 반환합니다.

staticPlugins()도 참조하세요 .

[static] QList<QStaticPlugin> QPluginLoader::staticPlugins()

플러그인 로더가 보유한 QStaticPlugins 목록을 반환합니다. 이 함수는 staticInstances()와 유사하지만 QStaticPlugin 에 메타 데이터 정보도 포함된다는 점이 다릅니다.

staticInstances()도 참조하세요 .

bool QPluginLoader::unload()

플러그인을 언로드할 수 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수는 애플리케이션 종료 시 자동으로 수행되므로 일반적으로 이 함수를 호출할 필요가 없습니다.

QPluginLoader 의 다른 인스턴스가 동일한 플러그인을 사용하는 경우 호출이 실패하고 모든 인스턴스가 unload()를 호출한 경우에만 언로드가 수행됩니다.

루트 컴포넌트를 삭제하려고 하지 마세요. 대신 필요할 때 unload()가 자동으로 삭제할 것이라는 점을 믿으세요.

instance() 및 load()도 참조하세요 .