Main Content

mwArray API(C++03)를 사용하여 C++ 애플리케이션에 배포하기

데이터 교환용 mwArray API를 사용하여 패키징된 MATLAB® 함수를 C ++애플리케이션에 통합

이 접근법에서는 배포하려는 MATLAB 함수로부터 C++ 공유 라이브러리와 헤더 파일을 만듭니다. C++용 레거시 MATLABCompiler SDK™ API를 C++ 애플리케이션과 배포된 MATLAB 함수 간의 인터페이스로 사용합니다. mwArray API를 사용하여 C++ 애플리케이션과 배포된 MATLAB 함수 간의 데이터 교환을 처리합니다. 배포된 MATLAB 함수를 C++ 코드 내에서 멤버 함수로 사용할 수 있도록, 생성된 헤더 파일을 전처리기 지시문을 사용하여 C++ 애플리케이션에 포함해야 합니다. 배포된 MATLAB 함수가 사용하는 MATLAB Runtime 인스턴스의 수명 주기를 명시적으로 관리해야 합니다. Runtime 인스턴스는 C++ 애플리케이션의 현재 프로세스 내(in-process)에서만 실행할 수 있고, 배포된 MATLAB 함수는 동기식으로만 실행할 수 있습니다.

C++ mwArray API는 C++03 기능만 지원합니다. mwArray API를 사용하는 C++ 공유 라이브러리에는 C 스타일 함수를 사용하여 MATLAB Runtime을 초기화하고, 패키징된 MATLAB 함수를 MATLAB Runtime으로 불러오고, C ++ 드라이버 코드와 MATLAB Runtime 간에 전달되는 데이터를 관리하는 인터페이스가 있습니다. 이 함수들에 대한 설명은 C/C++ API 아래에 나와 있습니다. C++ mwArray API 아래에 나와 있는 함수들은 mwArray API에 고유하며, 다른 API용으로 만든 공유 라이브러리에는 사용할 수 없습니다.

함수

compiler.build.cppSharedLibraryCreate C++ shared library (R2021a 이후)
compiler.build.CppSharedLibraryOptionsOptions for building C++ shared libraries (R2021a 이후)
compiler.build.ResultsCompiler build results object (R2020b 이후)
mbuildCompile and link source files against MATLAB generated shared libraries

C/C++ API

mclmcrInitializeInitialize the MATLAB Runtime proxy library
mclInitializeApplicationSet up application state shared by all MATLAB Runtime instances created in current process
mclTerminateApplicationClose MATLAB Runtime-internal application state
<library>Initialize[WithHandlers]Initialize MATLAB Runtime instance associated with library
<library>TerminateFree all resources allocated by MATLAB Runtime instance associated with library
mclRunMainMechanism for creating identical wrapper code across all platforms
mclIsMCRInitializedDetermine if MATLAB Runtime has been properly initialized
mclWaitForFiguresToDieEnable deployed applications to process graphics events so that figure windows remain displayed
mclGetLastErrorMessageLast error message from unsuccessful library initialization or MATLAB function call
mclGetLogFileNameRetrieve name of log file used by MATLAB Runtime
mclIsJVMEnabledDetermine if MATLAB Runtime was started with instance of Java Virtual Machine (JVM)
mclIsNoDisplaySetDetermine if -nodisplay mode is enabled

C++ mwArray API

mwArrayClass used to pass input/output arguments to C++ functions generated by MATLAB Compiler SDK
mwExceptionException type used by the mwArray API and the C++ interface functions
mwStringString class used by the mwArray API to pass string data as output from certain methods

도움말 항목

요구 사항

C++ mwArray API 공유 라이브러리 생성하기

C++ 공유 라이브러리를 C++ 애플리케이션에 통합하기

유지관리