Main Content

matlab.codetools.requiredFilesAndProducts

MATLAB 프로그램 파일의 종속성(Dependency) 나열

설명

예제

fList = matlab.codetools.requiredFilesAndProducts(files)files로 지정된 프로그램 파일을 실행하는 데 필요한 MATLAB® 프로그램 파일의 목록을 반환합니다.

matlab.codetools.requiredFilesAndProducts 함수는 MATLAB 프로그램 파일의 소비자에게 전달할 정보를 제공할 목적으로 작성되었습니다.

예제

[fList, pList] = matlab.codetools.requiredFilesAndProducts(files)files로 지정된 프로그램 파일을 실행하는 데 필요할 수 있는 MathWorks® 제품의 목록을 반환합니다.

제공된 MATLAB 코드에 matlab.codetools.requiredFilesAndProducts 함수를 사용할 경우 plist는 시스템에 설치된 필수 툴박스만 포함합니다. 이 경우, plist가 완전하지 않을 수 있습니다.

예제

[fList, pList] = matlab.codetools.requiredFilesAndProducts(___,'toponly')는 출력값에 포함할 파일이나 제품에 대해 files에 지정된 하나 이상의 파일에서 직접 사용해야 함을 나타냅니다. 'toponly' 입력 옵션은 대/소문자를 구분하지 않습니다.

예제

모두 축소

Image Processing Toolbox™에서 edge 함수에 필요한 파일과 제품을 확인합니다.

[fList,pList] = matlab.codetools.requiredFilesAndProducts('edge.m')
fList = 

     {}


pList = 

1x2 struct array with fields:

    Name
    Version
    ProductNumber
    Certain

필요한 MATLAB 파일은 없지만 두 개의 제품이 필요합니다.

필요한 제품을 나열합니다.

{pList.Name}'
ans = 

    'MATLAB'
    'Image Processing Toolbox'

현재 작업 폴더의 getRandomNumber.m 파일에 함수를 만듭니다.

function a = getRandomNumber
    rng shuffle
    a = rand;
end

이제 명령줄에서 getRandomNumber.m에 필요한 파일과 제품을 확인합니다.

[fList,pList] = matlab.codetools.requiredFilesAndProducts('getRandomNumber.m')
fList = 

    'C:\work\getRandomNumber.m'


pList = 

             Name: 'MATLAB'
          Version: '8.5'
    ProductNumber: 1
          Certain: 1

getRandomNumber 함수를 실행하는 데는 함수 파일만 필요합니다. 필요한 MathWorks 제품은 MATLAB뿐입니다.

현재 작업 폴더의 displayNumber.m 파일에 함수를 만듭니다.

function displayNumber
    a = getRandomNumber;
    disp(['Your number is ' num2str(a)])
end

이제 명령줄에서 displayNumber.m에 필요한 파일과 제품을 확인합니다.

[fList,pList] = matlab.codetools.requiredFilesAndProducts('displayNumber.m')
fList = 

    'C:\work\displayNumber.m'    'C:\work\getRandomNumber.m'


pList = 

             Name: 'MATLAB'
          Version: '8.5'
    ProductNumber: 1
          Certain: 1

displayNumber 함수에는 함수 파일 외에도 getRandomNumber.m 파일이 필요합니다. 필요한 MathWorks 제품은 MATLAB뿐입니다.

현재 작업 폴더의 ExampleHandle.m 파일에 핸들 클래스를 만듭니다.

classdef ExampleHandle < handle
    % class content
end

현재 작업 폴더의 AnotherExampleHandle.m 파일에 ExampleHandle에서 상속되는 클래스를 만듭니다.

classdef AnotherExampleHandle < ExampleHandle
    % class content
end

현재 작업 폴더의 getHandles.m 파일에 AnotherExampleHandle 객체를 인스턴스화하는 함수를 만듭니다.

function [h1,h2] = getHandles()
    h1 = AnotherExampleHandle;
    h2 = AnotherExampleHandle;
end

이제 명령줄에서 getHandles.m에 필요한 파일을 확인합니다.

[fList,~] = matlab.codetools.requiredFilesAndProducts('getHandles.m');
fList'
ans = 

    'C:\work\AnotherExampleHandle.m'
    'C:\work\ExampleHandle.m'
    'C:\work\getHandles.m'

getHandles.m에 직접 필요한 필수 파일을 확인합니다.

[fList,~] = matlab.codetools.requiredFilesAndProducts('getHandles.m','toponly')
fList = 

    'C:\work\AnotherExampleHandle.m'    'C:\work\getHandles.m'

AnotherExampleHandle.mExampleHandle.m이 필요하더라도 이 파일은 getHandles.m에 대한 직접 요구 사항은 아닙니다.

입력 인수

모두 축소

분석할 파일의 목록으로, 문자형 벡터로 구성된 셀형 배열, 문자형 벡터 또는 string형 배열로 지정됩니다. 각 요소는 단일 MATLAB 프로그램 파일의 이름입니다. 예를 들어, files는 다른 사용자에게 제공하려는 MATLAB 프로그램 파일의 목록입니다. matlab.codetools.requiredFilesAndProducts 함수는 파일과 함께 전달할 요구 사항 정보를 제공합니다.

정확한 종속성 분석을 보장하려면 files와 종속성이 MATLAB 경로에 있어야 합니다. matlab.codetools.requiredFilesAndProducts는 경로에 없는 종속 파일에 대한 정보는 반환하지 않습니다.

예: 'myFile.m' 또는 "C:\Program Files\MATLAB\R2014a\my_work\myFile.m"

예: {'myFile.m','myOtherFile.m'}

예: cellstr(ls('*.m'))

출력 인수

모두 축소

files에 필요한 사용자가 작성한 MATLAB 프로그램 파일의 목록으로, 문자형 벡터로 구성된 셀형 배열로 반환됩니다. 각 문자형 벡터는 필요한 파일의 전체 경로를 나타냅니다. 내장 MATLAB 파일은 pList에 나열된 제품과 함께 설치되므로 fList에 포함되지 않습니다.

fList는 표준 파일 형식과 로우 레벨 I/O 함수를 사용하여 액세스하는 종속 파일을 포함합니다. 이 종속 파일에는 텍스트 파일, 스프레드시트, 이미지, 오디오, 비디오, XML 파일이 포함됩니다. 예를 들어, 코드 load('mydata.mat')를 포함한 파일을 분석 중인 경우, matlab.codetools.requiredFilesAndProducts 함수는 fListmydata.mat를 포함시킵니다.

종속 파일의 자동 감지를 지원하는 함수로는 audioinfo, audioread, csvread, daqread, dlmread, fileread, fopen, imfinfo, importdata, imread, load, matfile, mmfileinfo, open, readtable, type, VideoReader, xlsfinfo, xlsread, xmlread, xslt가 포함됩니다.

files에 필요할 수 있는 MathWorks 제품의 목록으로, 구조체 또는 구조체로 구성된 배열로 반환됩니다. 각 제품은 이름(Name 필드), 버전(Version 필드), 제품 번호(ProductNumber 필드), 확실성 표시(Certain 필드)로 설명됩니다. Certain 필드는 matlab.codetools.requiredFilesAndProducts가 지정된 프로그램 파일 files에 해당 제품이 확실히 필요하다고 판단하는 경우 값 1을 가지며, 제품이 필요할 수도 있는 경우에는 값 0을 가집니다.

matlab.codetools.requiredFilesAndProducts 함수는 MATLAB 프로그램 파일의 소비자에게 전달할 정보를 제공할 목적으로 작성되었습니다. 버전 번호는 함수를 실행할 때 설치한 제품의 버전을 나타냅니다. Version은 이전 버전과의 호환성을 나타내는 표시가 아닙니다.

버전 내역

R2014a에 개발됨