C++ 컴파일 라이브러리에서 함수 호출하기

C++ 라이브러리에 대한 MATLAB^® 인터페이스의 퍼블리셔는 필요하다면 인터페이스 파일과 종속 라이브러리 파일의 설치 지침을 제공합니다. 퍼블리셔는 종속 라이브러리 파일을 제공하거나 외부 소스로부터 라이브러리를 설치하도록 요청하거나 모든 관련 파일에 대한 링크를 제공할 수 있습니다. 퍼블리셔가 MATLAB 애드온을 사용하여 툴박스를 만든 경우, 이 정보는 애드온 매니저에서 툴박스에 대한 옵션 메뉴를 통해 제공되는 시작하기 안내서에서 볼 수 있습니다. 추가 정보가 필요하거나 시작하기 안내서를 찾을 수 없는 경우 퍼블리셔에 문의하십시오. 애드온에 대한 자세한 내용은 애드온 관리하기 항목을 참조하십시오.

라이브러리 libname의 인터페이스 파일 이름은 libnameInterface.ext입니다. 여기서 ext는 플랫폼마다 다릅니다. Windows^®에서는 .dll, Linux^®에서는 .so 또는 macOS에서는 .dylib입니다.

런타임 경로 설정하기

MATLAB은 MATLAB 경로에서 인터페이스 파일을 찾고 시스템 경로 또는 런타임 검색 경로(rpath)에서 종속 라이브러리 파일을 찾습니다. 퍼블리셔가 종속 라이브러리 파일을 제공한다면 이러한 파일을 인터페이스 파일과 같은 폴더에 넣으면 됩니다. 또는, 이러한 파일을 시스템 경로에 추가하려면 Set Run-Time Library Path for C++ Interface 항목을 참조하십시오. 종속 라이브러리 찾기에 대한 자세한 내용은 Missing or Incorrectly Installed Run-Time Libraries 항목을 참조하십시오.

MATLAB 경로 설정하기

인터페이스 파일이 포함된 폴더에 대해 addpath를 호출합니다.

도움말 표시하기

MATLAB help 및 doc 함수는 라이브러리의 구성원에 대한 도움말을 제공합니다. 예를 들어, 라이브러리 libname에서 함수 funcname에 대한 도움말을 표시하려면 다음을 입력하십시오.

help clib.libname.funcname

함수 호출하기

C++ 라이브러리 libname의 함수 funcname을 입력 인수 arg1,arg2,...와 출력 인수 retVal을 사용하여 호출하려면, MATLAB clib 패키지를 사용하십시오. 다음을 입력하면 MATLAB이 라이브러리를 자동으로 불러옵니다.

retVal = clib.libname.funcname(arg1,arg2,...)

MATLAB이 라이브러리를 불러온 후에는 탭 완성을 사용하여 clib 패키지의 구성원을 볼 수 있습니다.

디폴트 인수를 사용하여 함수 호출하기

C++ 함수가 디폴트 인수로 정의된 경우 하나 이상의 후행 인수를 제공하지 않고 이 함수를 호출할 수 있습니다. 함수 도움말은 디폴트 값을 보여줍니다. 예를 들어, arg의 유형이 double형이고 디폴트 값이 100이면 도움말에 다음이 표시됩니다.

clib.libname.funcname(arg)
    Input Arguments
      arg             double = 100

다음 명령문은 동일한 결과를 생성합니다.

clib.libname.funcname
clib.libname.funcname(100)

결과는 다를 수 있지만 다음 명령문도 올바릅니다.

clib.libname.funcname(99)

MATLAB은 정수 스칼라 및 부동소수점 유형에 대한 디폴트 인수를 지원합니다.