QLibrary Class

멤버 함수 문서

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

지정된 ` parent`를 사용하여 라이브러리를 생성합니다.

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

지정된 ` parent `을 사용하여 ` fileName`로 지정된 라이브러리를 불러오는 라이브러리 객체를 생성합니다.

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

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

주어진 ` parent `을 사용하여 라이브러리 객체를 생성하며, 이 객체는 ` fileName `으로 지정된 라이브러리와 전체 버전 번호 ` version`을 불러옵니다. 현재 Windows에서는 버전 번호가 무시됩니다.

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

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

지정된 ` parent `을 사용하여 라이브러리 객체를 생성하며, 이 객체는 ` fileName `에 명시된 라이브러리와 ` verNum`의 메이저 버전 번호를 불러옵니다. 현재 Windows에서는 버전 번호가 무시됩니다.

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

[virtual noexcept] QLibrary::~QLibrary()

QLibrary 객체를 파괴합니다.

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

isLoaded() 및 unload()도 참조하십시오 .

QString QLibrary::errorString() const

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

[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 참조). 이 라이브러리는 애플리케이션이 종료될 때까지 로드된 상태로 유지됩니다. Windows에서는 version 가 무시됩니다.

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

resolve()도 참조하십시오 .

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

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

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

resolve()도 참조하십시오 .

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

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

setFileName()도 참조하십시오 .

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

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

setFileName()도 참조하십시오 .

bool QLibrary::unload()

라이브러리를 언로드하고, 라이브러리를 언로드할 수 있는 경우 ` true `를 반환하며, 그렇지 않은 경우 ` false`를 반환합니다.

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

QLibrary 의 다른 인스턴스가 동일한 라이브러리를 사용하고 있는 경우, 호출은 실패하며 모든 인스턴스가 unload()를 호출한 후에야 언로드가 이루어집니다.

macOS에서는 동적 라이브러리를 언로드할 수 없다는 점에 유의하십시오. QLibrary::unload()는 true 를 반환하지만, 라이브러리는 프로세스에 계속 로드된 상태로 남아 있습니다.

resolve() 및 load()도 참조하십시오 .