Main Content

xlswrite

(권장되지 않음) 스프레드시트 파일 쓰기

xlswrite는 권장되지 않습니다. 대신 writetable, writematrix 또는 writecell을 사용하십시오. 자세한 내용은 호환성 관련 고려 사항을 참조하십시오.

설명

예제

xlswrite(filename,A)는 행렬 AMicrosoft® Excel® 스프레드시트 통합 문서 filename에 있는 첫 번째 워크시트에 셀 A1부터 씁니다.

xlswrite(filename,A,sheet)는 지정된 워크시트에 씁니다.

xlswrite(filename,A,xlRange)는 통합 문서의 첫 번째 워크시트에 xlRange로 지정된 사각 범위에 씁니다. Excel 범위 구문을 사용합니다(예: 'A1:C3').

예제

xlswrite(filename,A,sheet,xlRange)는 지정된 워크시트의 지정된 범위에 씁니다.

status = xlswrite(___)는 위에 열거된 구문의 입력 인수 중 하나를 사용하여 쓰기 작업의 상태를 반환합니다. 작업이 성공한 경우 상태 1이 반환됩니다. 그렇지 않은 경우에는 상태 0이 반환됩니다.

[status,message] = xlswrite(___)는 쓰기 작업으로 생성된 경고나 오류 메시지를 추가적으로 구조체 message에 반환합니다.

예제

모두 축소

요소를 7개 가진 벡터를 Excel® 파일에 씁니다.

filename = 'testdata.xlsx';
A = [12.7 5.02 -98 63.9 0 -.2 56];
xlswrite(filename,A)

혼합된 텍스트 데이터와 숫자형 데이터를 Sheet2의 셀 E1에서부터 Excel® 파일에 씁니다.

filename = 'testdata.xlsx';
A = {'Time','Temperature'; 12,98; 13,99; 14,97};
sheet = 2;
xlRange = 'E1';
xlswrite(filename,A,sheet,xlRange)

입력 인수

모두 축소

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

filename이 존재하지 않을 경우 xlswrite는 지정된 확장자를 기준으로 형식을 결정하여 파일을 만듭니다. Excel 97-2003 소프트웨어와 호환되는 파일을 만들려면, .xls 확장자를 지정하십시오. Excel 2007 형식으로 파일을 만들려면 확장자를 .xlsx, .xlsb, .xlsm 중 하나로 지정하십시오. 확장자를 지정하지 않으면 xlswrite가 디폴트 값인 .xls를 사용합니다.

예: 'myFile.xlsx' 또는 "myFile.xlsx"

예: 'C:\myFolder\myFile.xlsx'

예: 'myFile.csv'

데이터형: char | string

입력 행렬로, 2차원 숫자형 배열, 문자형 배열 또는 string형 배열로 지정되거나, 각 셀에 단일 요소가 포함된 경우 셀형 배열로 지정됩니다.

A가 스칼라 숫자나 텍스트가 아닌 다른 것이 포함된 셀형 배열인 경우 xlswrite는 스프레드시트의 해당 셀을 빈 상태로 그대로 둡니다.

배열 A의 최대 크기는 연관된 Excel 버전에 따라 달라집니다. Excel 사양 및 제한에 대한 자세한 내용은 Excel 도움말을 참조하십시오.

예: [10,2,45;-32,478,50]

예: {92.0,'Yes',45.9,'No'}

예: "ABCDEF"

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | cell

워크시트 이름으로, 다음 중 하나로 지정됩니다.

  • 워크시트 이름을 포함하는 문자형 벡터 또는 string형. 이름에는 콜론(:)을 사용할 수 없습니다. 스프레트시트 파일에서 시트의 이름을 확인하려면 xlsfinfo를 사용하십시오.

  • 워크시트 인덱스를 나타내는 양의 정수.

sheet가 존재하지 않으면 xlswrite가 워크시트 모음 끝에 새 시트를 추가합니다. sheet가 워크시트의 개수보다 큰 인덱스인 경우, 통합 문서에 있는 워크시트의 개수가 sheet와 같아질 때까지 xlswrite가 빈 시트를 추가합니다. 두 경우 모두, xlswrite는 새 워크시트가 추가되었음을 나타내는 경고를 생성합니다.

데이터형: char | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

사각 범위로, 문자형 벡터나 string형으로 지정됩니다.

기록할 범위를 정의하는 2개의 끝 지점을 사용하여 xlRange를 지정합니다. 예를 들어, 'D2:H4'는 워크시트에서 2개의 끝 지점 D2H4 사이에 있는 3×5 사각 범위를 나타냅니다. xlRange 입력값은 대/소문자를 구분하지 않으며 Excel A1 참조 스타일을 사용합니다(Excel 도움말 참조). xlswrite는 명명된 범위를 인식하지 않습니다.

  • sheet를 지정하지 않으면 xlRange는 단일 셀의 경우에도 양쪽 끝 지점과 콜론 문자를 포함해야 합니다(예: 'D2:D2'). 그렇지 않으면, xlswrite는 입력값을 워크시트 이름(예: 'D2')으로 해석합니다.

  • sheet를 지정할 경우 xlRange는 첫 번째 셀만 지정할 수 있습니다(예: 'D2'). xlswrite는 이 셀부터 입력 배열 A를 씁니다.

  • xlRange가 입력 배열 A의 크기보다 큰 경우, Excel 소프트웨어는 범위의 나머지 부분을 #N/A로 채웁니다. xlRangeA의 크기보다 작은 경우 xlswritexlRange에 맞는 부분만 파일에 씁니다.

데이터형: char | string

출력 인수

모두 축소

쓰기 작업의 상태로, 1(true)이나 0(false)으로 반환됩니다. 쓰기 작업이 성공한 경우 status1이 됩니다. 그렇지 않으면 status0이 됩니다.

쓰기 작업 동안 생성되는 오류 또는 경고로, 다음 두 개 필드가 포함된 구조체형 배열로 반환됩니다.

message경고 또는 오류 메시지의 텍스트.
identifier메시지 ID.

제한 사항

  • xlswrite 함수는 CSV 파일에 쓰려고 시도할 때 서로 다른 데이터형을 포함하는 셀형 배열을 쓰는 것을 지원하지 않습니다.

  • 컴퓨터에 Windows®용 Excel이 설치되어 있지 않거나 MATLAB® Online™을 사용하고 있는 경우, xlswrite 함수는 다음과 같이 동작합니다.

    • 배열 A를 쉼표로 구분된 값(CSV) 형식으로 텍스트 파일에 씁니다. A는 숫자형 행렬이어야 합니다.

    • sheet 인수와 xlRange 인수를 무시합니다.

    이 제한 사항은 일반적인 Excel 설치에 포함되는 COM 서버를 사용할 수 없는 경우에도 적용됩니다.

  • 컴퓨터에 Microsoft Office 2003 소프트웨어가 설치되어 있으나 Excel 2007 형식으로 파일을 만들려면 Office 2007 호환 기능 팩을 설치하십시오.

  • Excel과 MATLAB은 날짜를 해당 날짜('10/31/96')나 날짜 일련 번호 값(예: 729329)을 나타내는 텍스트로 저장할 수 있습니다. 배열에 날짜 일련 번호 값이 포함되어 있으면 xlswrite를 호출하기 전에 datestr을 사용하여 해당 날짜를 텍스트 표현으로 변환하십시오.

  • 사용자 지정 형식을 사용하여(예: 글꼴 또는 색) Excel 파일에 데이터를 쓰려면 xlswrite가 아니라 actxserver를 사용하여 Windows COM 서버에 직접 액세스하십시오. 예를 들어, 이 MathWorks Support Answeractxserver를 사용하여 MATLAB과 Excel 간 연결을 설정하고, 워크시트에 데이터를 쓰고, 셀의 색을 지정합니다.

알고리즘

Excel은 Inf 값을 65535로 변환합니다. MATLAB은 NaN 값을 빈 셀로 변환합니다.

버전 내역

R2006a 이전에 개발됨

모두 축소

R2019a: xlswrite는 권장되지 않음

xlswrite는 권장되지 않습니다. 대신 writetable, writematrix 또는 writecell을 사용하십시오. xlswrite를 제거할 계획은 없습니다.

R2019a부터는 writetable, writematrix 또는 writecell을 대신 사용하십시오. writetable, writematrixwritecell 함수는 xlswrite 함수보다 성능 및 크로스 플랫폼 지원 기능이 더 우수합니다.

다음 표에서는 xlswrite의 일반적인 사용법과 코드에서 대신 writetable, writematrix 또는 writecell을 사용하도록 업데이트하는 방법을 보여줍니다.

권장되지 않음

권장됨

xlswrite(filename,M)

스프레드시트에 테이블 형식 데이터를 쓰려면 대신 다음 옵션 중 하나를 사용하십시오.

테이블 쓰기:

writetable(T,filename)

행렬 쓰기:

writematrix(M,filename)

셀형 배열 쓰기:

writecell(C,filename)