QLibrary Class

멤버 함수 문서

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

주어진 parent 로 라이브러리를 구축합니다.

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

fileName 에 지정된 라이브러리를 로드하는 지정된 parent 으로 라이브러리 객체를 생성합니다.

fileName 에서 파일 접미사는 생략하는 것이 좋습니다. QLibrary는 플랫폼에 따라 적절한 접미사를 가진 파일을 자동으로 찾기 때문입니다(예: Unix에서는 ".so", macOS 및 iOS에서는 ".dylib", Windows에서는 ".dll"). ( fileName 참조)

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

fileName 으로 지정된 라이브러리와 전체 버전 번호 version 를 로드하는 라이브러리 객체를 지정된 parent 로 구성합니다. 현재 Windows에서는 버전 번호가 무시됩니다.

fileName 에서 파일 접미사를 생략하는 것이 좋습니다. QLibrary는 플랫폼에 따라 적절한 접미사를 가진 파일을 자동으로 찾습니다(예: Unix에서는 ".so", macOS 및 iOS에서는 ".dylib", Windows에서는 ".dll"). ( fileName 참조)

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

fileName 으로 지정된 라이브러리와 주 버전 번호 verNum 로 지정된 라이브러리를 로드하는 라이브러리 객체를 parent 로 생성합니다. 현재 Windows에서는 버전 번호가 무시됩니다.

fileName 에서 파일 접미사를 생략하는 것이 좋습니다. QLibrary는 플랫폼에 따라 적절한 접미사를 가진 파일(예: Unix에서는 ".so", macOS 및 iOS에서는 ".dylib", Windows에서는 ".dll"을 자동으로 찾습니다. ( fileName 참조)

[virtual noexcept] QLibrary::~QLibrary()

QLibrary 객체를 삭제합니다.

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

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

QString QLibrary::errorString() const

마지막으로 발생한 오류에 대한 설명이 포함된 텍스트 문자열을 반환합니다. 현재는 load(), unload() 또는 resolve()가 어떤 이유로 실패한 경우에만 errorString이 설정됩니다.

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

fileName 에 로드 가능한 라이브러리에 유효한 접미사가 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

Unix의 후행 버전 번호는 무시됩니다.

bool QLibrary::isLoaded() const

load()이 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

load()도 참조하십시오 .

bool QLibrary::load()

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

unload()도 참조하세요 .

QFunctionPointer QLibrary::resolve(const char *symbol)

내보낸 심볼의 주소를 반환합니다 symbol. 필요한 경우 라이브러리가 로드됩니다. 심볼을 확인할 수 없거나 라이브러리를 로드할 수 없는 경우 nullptr 을 반환합니다.

예:

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

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

심볼은 라이브러리에서 C 함수로 내보내야 합니다. 즉, 라이브러리가 C++ 컴파일러로 컴파일되는 경우 함수를 extern "C" 로 래핑해야 합니다. 또한 Windows에서는 __declspec(dllexport) 컴파일러 지시문을 사용하여 DLL에서 함수를 명시적으로 내보내야 합니다(예: 컴파일러 지시문):

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

MY_EXPORT 으로 정의된 경우

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

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

이 함수는 오버로드된 함수입니다.

라이브러리 fileName 를 로드하고 내보낸 심볼의 주소 symbol 를 반환합니다. fileName 에는 플랫폼별 파일 접미사가 포함되어서는 안 됩니다( fileName 참조). 라이브러리는 애플리케이션이 종료될 때까지 로드된 상태로 유지됩니다.

심볼을 확인할 수 없거나 라이브러리를 로드할 수 없는 경우 nullptr 을 반환합니다.

resolve()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

전체 버전 번호 version 로 라이브러리 fileName 를 로드하고 내보낸 심볼의 주소 symbol 를 반환합니다. fileName 에는 플랫폼별 파일 접미사가 포함되어서는 안 됩니다( fileName 참조). 라이브러리는 애플리케이션이 종료될 때까지 로드된 상태로 유지됩니다. version 은 Windows에서 무시됩니다.

심볼을 확인할 수 없거나 라이브러리를 로드할 수 없는 경우 이 함수는 nullptr 을 반환합니다.

resolve()도 참조하십시오 .

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

이 함수는 오버로드된 함수입니다.

주요 버전 번호가 verNum 인 라이브러리 fileName 를 로드하고 내보낸 심볼의 주소 symbol 를 반환합니다. fileName 에는 플랫폼별 파일 접미사가 포함되어서는 안 됩니다( fileName 참조). 라이브러리는 애플리케이션이 종료될 때까지 로드된 상태로 유지됩니다. verNum 은 Windows에서 무시됩니다.

심볼을 확인할 수 없거나 라이브러리를 로드할 수 없는 경우 이 함수는 nullptr 을 반환합니다.

resolve()도 참조하십시오 .

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

fileName 속성 및 정식 버전 번호를 각각 fileName 및 version 로 설정합니다. version 매개 변수는 Windows에서 무시됩니다.

setFileName()도 참조하세요 .

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

fileName 속성 및 주 버전 번호를 각각 fileName 및 versionNumber 로 설정합니다. versionNumber 은 Windows에서 무시됩니다.

setFileName()도 참조하세요 .

bool QLibrary::unload()

라이브러리를 언로드할 수 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

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

macOS에서는 동적 라이브러리를 언로드할 수 없습니다. QLibrary::unload()는 true 를 반환하지만 라이브러리는 프로세스에 로드된 상태로 유지됩니다.

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