이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

uiputfile

파일을 저장하기 위한 대화 상자 열기

설명

file = uiputfile은 파일을 선택하거나 지정할 수 있는 모달 대화 상자를 엽니다. 대화 상자는 현재 폴더에 있는 파일과 폴더를 나열합니다.

  • 사용자가 유효한 파일 이름을 지정하고 저장(Save)을 클릭한 경우, MATLAB®file에 파일 이름을 반환합니다.

  • 사용자가 대화 상자를 취소하면 MATLAB은 file0을 반환합니다.

참고

  • uiputfile의 실행에 성공하면 사용자가 지정하는 새로운 파일 또는 기존 파일의 이름을 반환합니다. 이 함수가 파일을 만들지는 않습니다.

  • 대화 상자의 시각적인 특성은 코드를 실행하는 운영 체제에 따라 달라집니다. 예를 들어, 일부 운영 체제는 대화 상자에 제목 표시줄을 표시하지 않습니다. 대화 상자 제목을 uiputfile 함수로 전달하면 운영 체제는 제목을 표시하지 않습니다.

[file,path] = uiputfile은 선택되거나 지정된 파일 경로를 path에 반환합니다. 사용자가 대화 상자를 취소하면 MATLAB은 두 출력 인수 모두에 0을 반환합니다.

[file,path,indx] = uiputfile은 대화 상자에서 선택된 파일 형식(Save as type) 값의 인덱스를 반환합니다. 인덱스는 1에서 시작됩니다. 사용자가 취소(Cancel) 버튼 또는 창 닫기 버튼(X)을 클릭하거나, 파일이 존재하지 않는 경우 MATLAB은 indx0을 반환합니다. 사용자가 대화 상자를 취소하면 MATLAB은 모든 출력 인수에 0을 반환합니다.

예제

___ = uiputfile(filter)filter와 일치하는 확장자를 가진 파일만 표시합니다. 일부 플랫폼에서 uiputfilefilter와 일치하지 않는 파일을 표시하기도 하지만, 이러한 파일은 흐리게 표시됩니다. uiputfile 함수는 파일 형식 목록에 모든 파일(All Files)을 추가합니다.

filter가 파일 이름인 경우, uiputfile파일 이름(File name) 필드에서 파일 이름을 표시하고 그 파일 확장자를 디폴트 필터로 사용합니다.

이 구문을 위에 열거된 구문의 모든 출력 인수 조합과 함께 사용하십시오.

예제

___ = uiputfile(filter,title)은 지정된 제목을 갖는 대화 상자를 엽니다. 디폴트 파일 필터를 사용하여 필터링하되 사용자 지정 제목을 지정하려면 필터 값에 빈 따옴표를 사용하십시오.

file = uiputfile('','Select a File')

예제

___ = uiputfile(filter,title,defname)defname으로 지정된 파일 이름이 파일 이름(File name) 필드에 표시되는 대화 상자를 엽니다.

예제

모두 축소

대화 상자를 만들고 filteraniminit.m으로 지정합니다. 코드를 실행하면 파일 이름 필드에 지정된 파일 이름이 포함되고 파일 형식 필드가 *.m으로 설정됩니다.

[file,path,indx] = uiputfile('animinit.m');

filter 입력 인수에서 각 파일 확장자를 세미콜론으로 구분하여 파일 형식(Save as type) 목록 상자에 여러 파일 형식을 표시합니다.

filter = {'*.m';'*.slx';'*.mat';'*.*'};
[file, path] = uiputfile(filter);

filter 입력값에 대한 셀형 배열을 사용하여 파일 형식 목록을 만들고 디폴트 설명과는 다른 설명을 지정합니다. 'MATLAB Files''Models' 설명이 여러 파일 형식에 연결됩니다.

입력 인수 filter 셀형 배열의 첫 번째 열에는 파일 확장자가 포함되고 두 번째 열에는 파일 형식의 설명이 포함됩니다. 예를 들어, 1열의 첫 번째 항목에는 여러 확장자가 세미콜론으로 구분되어 있습니다. 이러한 파일 형식은 모두 설명 'MATLAB Files (*.m,*.mlx,*.fig,*.mat,*.slx,*.mdl)'과 연결됩니다.

[filename, pathname, filterindex] = uiputfile( ...
{'*.m;*.fig;*.mat;*.slx;*.mdl',...
 'MATLAB Files (*.m,*.mlx,*.fig,*.mat,*.slx,*.mdl)';
 '*.m;*.mlx', 'program files (*.m,*.mlx)';...
 '*.fig','Figures (*.fig)';...
 '*.mat','MAT-files (*.mat)';...
 '*.slx;*.mdl','Models (*.slx,*.mdl)';...
 '*.*',  'All Files (*.*)'});

파일 형식(Save as type) 필드가 MAT 파일로 설정되고 제목이 'Workspace File'인 대화 상자를 만듭니다.

[file,path] = uiputfile('*.mat','Workspace File');

파일 이름(File name) 필드에서 디폴트 파일을 표시하지만 사용자가 대화 상자에서 모든 파일 형식을 볼 수 있도록 하려면, 필터에 와일드카드를 지정하고 디폴트 파일 이름을 지정하십시오.

[file,name,path] = uiputfile('*.*','File Selection','test.m');

쓰려는 파일 선택 대화 상자를 열고 파일을 선택합니다. MATLAB이 다른 이름으로 저장 확인 대화 상자를 자동으로 엽니다.

  • 확인 대화 상자에서 확인(OK)을 클릭하면 MATLAB이 두 대화 상자를 모두 닫고 선택 항목을 명령 창에 표시합니다.

  • 확인 대화 상자에서 아니요(No)를 클릭하고, 쓰려는 파일 선택 대화 상자에서 취소(Cancel)를 클릭하면 명령 창에 User clicked Cancel.이 표시됩니다.

[file,path] = uiputfile('*.m');
if isequal(file,0) || isequal(path,0)
   disp('User clicked Cancel.')
else
   disp(['User selected ',fullfile(path,file),...
         ' and then clicked Save.'])
end

입력 인수

모두 축소

대화 상자가 열릴 때 파일 이름(File name) 필드에 표시할 디폴트 파일 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

defname의 값은 경로를 포함하거나 경로로만 구성될 수 있습니다. defname 인수에는 다음 문자를 사용할 수 있습니다.

.
..
\
/
~

defname을 폴더로만 지정하려면 defname의 마지막 문자를 백슬래시 \ 또는 슬래시 /로 지정하십시오. 이렇게 하면 MATLAB은 경로로 지정된 폴더의 대화 상자를 엽니다. 존재하지 않는 경로를 지정하면 MATLAB은 현재 폴더의 대화 상자를 엽니다.

예: 'myfile.m'

예: '../myfile.m'

파일 형식 필터 명세로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다. MATLAB은 대화 상자에 표시되는 파일 형식 목록에 모든 파일을 추가합니다. filter 값은 와일드카드 문자(*)를 포함할 수 있습니다.

예: *.m

예: 'MATLAB Files (*.m,*.mlx,*.fig,*.mat,*.slx,*.mdl)'

대화 상자 제목으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 디폴트 파일 필터를 사용하여 필터링하되 사용자 지정 제목을 지정하려면 필터 값에 빈 따옴표를 사용하십시오. 예를 들면 다음과 같습니다.

uiputfile(' ','Select File')

예: 'File Selector'

출력 인수

모두 축소

사용자가 지정한 파일 이름으로, 문자형 벡터 또는 string형 스칼라로 반환됩니다. 사용자는 대화 상자에서 파일 이름을 선택하거나, 파일 이름(File name) 필드에 파일 이름을 입력하거나, 디폴트 파일 이름(사용자가 제공할 경우)을 수락하여 파일 이름을 지정할 수 있습니다. 사용자가 대화 상자를 취소하면 MATLAB은 file0으로 반환합니다.

  • 사용자가 유효한 파일 이름을 지정하고 저장(Save)을 클릭한 경우, MATLAB은 file에 파일 이름을 반환합니다.

  • 사용자가 대화 상자의 파일 이름 필드에 별표 문자(*) 또는 물음표 문자(?)가 포함된 파일 이름을 입력하면, 저장 버튼을 클릭할 경우 MATLAB이 응답하지 않습니다. 사용자가 이를 취소하거나 와일드카드 문자 또는 물음표 문자를 제거할 때까지 대화 상자가 그대로 열려 있습니다. 이 제한 사항은 파일 이름에 이러한 문자를 허용하는 플랫폼까지 포함하여 모든 플랫폼에 적용됩니다.

  • 사용자가 기존 파일 이름을 지정하면, 파일이 이미 있음을 알리는 경고 대화 상자가 열리고 파일을 바꿀 수 있는 옵션이 제공됩니다.

    • 사용자가 경고 대화 상자에서 예(Yes)를 클릭하면 MATLAB은 기존 파일을 바꾸고 파일 이름을 반환합니다.

    • 사용자가 경고 대화 상자에서 아니요(No)를 클릭하면 컨트롤이 uiputfile 대화 상자에 반환되어, 사용자가 다른 파일 이름을 지정할 수 있습니다.

  • 사용자가 대화 상자를 취소하면 MATLAB은 file0을 반환합니다.

사용자가 지정한 파일 이름에 대한 경로로, 문자형 벡터 또는 0으로 반환됩니다. 사용자가 대화 상자를 취소하면 MATLAB은 path0으로 반환합니다.

파일 형식(Save as type) 인덱스로, 정수로 반환됩니다. 아래 그림에 표시된 것처럼, 인덱스는 파일 형식(Save as type) 행의 선택 항목에 대응합니다. 인덱스는 1에서 시작됩니다.

사용자가 취소(Cancel) 버튼 또는 대화 상자의 닫기 버튼(X)을 클릭하거나, 파일이 존재하지 않는 경우 MATLAB은 indx0으로 반환합니다.

세부 정보

모두 축소

모달 대화 상자

모달 대화 상자에서는 모달 대화 상자 조작이 끝나기 전에 다른 MATLAB 창과 상호 작용을 할 수 없습니다.

  • MATLAB 함수와 MATLAB 툴박스 함수를 사용하여 사용자가 지정한 파일과 위치에 데이터를 쓰려면 uiputfile이 반환하는 경로와 파일 이름을 사용하십시오. 예를 들면 다음과 같습니다.

    • fprintf - 데이터를 텍스트 파일에 씁니다.

    • imwrite - 이미지를 그래픽스 파일에 씁니다.

    • xlswrite - 행렬을 Microsoft® Excel® 스프레드시트에 씁니다. 예를 들어, 아래 코드는 행렬 A를 만들고, 사용자로부터 파일 이름을 얻는 대화 상자를 만들고, 반환된 값에서 전체 파일 이름을 작성한 다음, 사용자가 지정한 Excel 파일에 행렬을 씁니다.

      A = [12.7 5.02 -98 63.9 0 -.2 56];
      [file,path] = uiputfile('*.xlsx');
      filename = fullfile(path,file);
      xlswrite(filename,A);
      

참고 항목

| | |

R2006a 이전에 개발됨