Main Content

xlswrite

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

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 이전에 개발됨

모두 확장