Main Content

xlsfinfo

(권장되지 않음) 파일이 Microsoft Excel 스프레드시트를 포함하는지 확인

xlsfinfo는 권장되지 않습니다. sheetnames를 대신 사용하십시오. 자세한 내용은 호환성 관련 고려 사항을 참조하십시오.

설명

status = xlsfinfo(filename)filenamexlsread 함수가 읽을 수 있는 파일인지 여부를 나타냅니다.

[status,sheets] = xlsfinfo(filename) 은 파일에 있는 각 스프레드시트의 이름을 추가로 반환합니다.

예제

[status,sheets,xlFormat] = xlsfinfo(filename)은 Excel®이 해당 파일에 대해 반환하는 형식 설명도 반환합니다. Windows®용 Excel이 설치되지 않은 시스템에서 xlFormat은 빈 문자형 벡터('')입니다.

예제

모두 축소

myExample.xlsx라는 이름의 Excel® 파일을 만듭니다.

values = {1, 2, 3 ; 4, 5, 'x' ; 7, 8, 9};
headers = {'First', 'Second', 'Third'};
xlswrite('myExample.xlsx', [headers; values]);

xlsfinfo를 호출하여 파일에 대한 정보를 가져옵니다.

[status,sheets,xlFormat] = xlsfinfo('myExample.xlsx')
status =

Microsoft Excel Spreadsheet


sheets = 

    'Sheet1'    'Sheet2'    'Sheet3'


xlFormat =

xlOpenXMLWorkbook

status에 포함된 설명 텍스트를 통해 xlsread 함수가 샘플 파일을 읽을 수 있음을 알 수 있습니다.

입력 인수

모두 축소

파일의 이름으로, 문자형 벡터 또는 string형으로 지정됩니다.

예: 'myFile.xlsx'

데이터형: char | string

출력 인수

모두 축소

파일 형식으로, 문자형 벡터로 반환됩니다.

  • filenamexlsread가 읽을 수 있는 파일이면 status는 설명 텍스트(예: 'Microsoft Excel Spreadsheet')입니다.

  • filenamexlsread가 읽을 수 있는 파일이 아니면 status는 비어 있습니다('').

  • MATLAB®이 파일을 찾을 수 없으면 xlsfinfo는 오류를 반환합니다.

워크시트 이름으로, 문자형 벡터로 구성된 1×n 셀형 배열로 반환됩니다. 여기서 n은 파일에 있는 워크시트의 개수입니다. 각 셀에는 워크시트의 이름이 들어 있습니다. xlsread가 특정 워크시트를 읽을 수 없는 경우, 대응하는 셀은 오류 메시지를 포함합니다.

xlsfinfo가 파일을 읽을 수 없는 경우 sheets는 오류 메시지를 포함합니다.

Excel이 반환하는 파일 형식 설명으로, 문자형 벡터로 반환됩니다.

Excel 소프트웨어가 설치된 Windows 시스템에서 xlFormat은 다음 중 하나입니다.

'xlOpenXMLWorkbook'XLSX 형식의 스프레드시트(Excel 2007 이후)
'xlWorkbookNormal' 또는 'xlExcel8'XLS 형식의 스프레드시트(Excel 97-2003과 호환)
'xlCSV'쉼표로 구분된 값(CSV) 형식의 파일
'xlHtml' 또는 'xlWebArchive'HTML 포맷으로 내보낸 스프레드시트

다른 모든 시스템에서 xlFormat은 빈 문자형 벡터('')입니다.

제한 사항

  • xlsfinfo는 7비트 ASCII 문자만 지원합니다.

  • xlsfinfo가 ActiveX® 서버를 시작할 수 없다고 경고하는 경우, 일반적인 Excel 설치의 일부인 COM 서버를 사용할 수 없습니다. 이 경우 Excel 소프트웨어를 다시 설치하는 것이 좋습니다. Windows용 Excel이 설치된 시스템에서는 xlsfinfo가 COM 서버를 사용하여 정보를 얻습니다.

버전 내역

R2006a 이전에 개발됨

모두 축소

R2019b: xlsfinfo는 권장되지 않음

xlsfinfo는 권장되지 않습니다. sheetnames를 대신 사용하십시오. xlsfinfo를 제거할 계획은 없습니다.

R2019b부터는 스프레드시트 파일에서 워크시트의 이름을 가져오려면 sheetnames 함수를 사용하십시오. sheetnames 함수는 xlsfinfo 함수에 비해 다음과 같은 이점이 있습니다.

  • 비ASCII 문자를 포함하는 시트 이름 지원

  • 성능 및 크로스 플랫폼 지원 기능이 더 우수함

  • 원격으로 저장된 데이터로 작업 가능

다음 표에서는 xlsfinfo의 일반적인 사용법과 코드에서 sheetnames를 사용하도록 업데이트하는 방법을 보여줍니다.

권장되지 않음

권장됨

[~,sheets] = xlsfinfo('myData.xls')
sheets = sheetnames('myData.xls')