이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.
writetable
파일에 테이블 쓰기
설명
writetable(
는 쉼표로 구분된 텍스트 파일에 테이블 T
)T
를 씁니다. 파일 이름은 테이블의 작업 공간 변수 이름으로, 확장자 .txt
가 추가됩니다. writetable
은 입력 테이블 이름에서 파일 이름을 생성할 수 없는 경우에 파일 table.txt
에 씁니다.
텍스트 및 스프레드시트 파일의 경우 T의 각 변수 열은 출력 파일에서 열이 됩니다. T
의 변수 이름은 파일 첫 번째 행의 열 제목이 됩니다.
XML 파일의 경우 T
의 각 열은 출력 파일에서 XML 노드가 됩니다. T
의 변수 이름은 출력 XML 파일에서 요소 노드의 이름이 됩니다.
writetable(___,
는 하나 이상의 Name,Value
)Name,Value
쌍 인수로 추가 옵션을 지정하여 파일에 테이블을 씁니다. 이 구문은 위에 열거한 구문에 있는 어떤 입력 인수도 포함할 수 있습니다.
예를 들어, 변수 이름을 출력 파일의 열 제목으로 쓸 것인지 여부를 지정할 수 있습니다.
예제
텍스트 파일에 테이블 쓰기
테이블을 만듭니다.
T = table(['M';'F';'M'],[45 45;41 32;40 34],... {'NY';'CA';'MA'},[true;false;false])
T=3×4 table
Var1 Var2 Var3 Var4
____ ________ ______ _____
M 45 45 {'NY'} true
F 41 32 {'CA'} false
M 40 34 {'MA'} false
테이블을 쉼표로 구분된 텍스트 파일에 쓰고 파일 내용을 표시합니다.
writetable(T)
writetable
이 텍스트 파일 T.txt
를 출력합니다.
type 'T.txt'
Var1,Var2_1,Var2_2,Var3,Var4 M,45,45,NY,1 F,41,32,CA,0 M,40,34,MA,0
두 열 위에 놓인 변수 이름 Var2
에는 writetable
이 고유한 접미사를 추가합니다.
공백으로 구분된 텍스트 파일에 테이블 쓰기
테이블을 만듭니다.
T = table(['M';'F';'M'],[45 45;41 32;40 34],... {'NY';'CA';'MA'},[true;false;false])
T=3×4 table
Var1 Var2 Var3 Var4
____ ________ ______ _____
M 45 45 {'NY'} true
F 41 32 {'CA'} false
M 40 34 {'MA'} false
테이블을 공백으로 구분된 텍스트 파일 myData.txt
에 쓰고 파일 내용을 표시합니다.
writetable(T,'myData.txt','Delimiter',' ') type 'myData.txt'
Var1 Var2_1 Var2_2 Var3 Var4 M 45 45 NY 1 F 41 32 CA 0 M 40 34 MA 0
두 열 위에 놓인 변수 이름 Var2
에는 writetable
이 고유한 접미사를 추가합니다.
행 이름이 포함된 텍스트 파일에 테이블 쓰기
테이블을 만듭니다.
LastName = {'Smith';'Johnson';'Williams';'Jones';'Brown'}; Age = [38;43;38;40;49]; Height = [71;69;64;67;64]; Weight = [176;163;131;133;119]; BloodPressure = [124 93; 109 77; 125 83; 117 75; 122 80]; T = table(Age,Height,Weight,BloodPressure,... 'RowNames',LastName)
T=5×4 table
Age Height Weight BloodPressure
___ ______ ______ _____________
Smith 38 71 176 124 93
Johnson 43 69 163 109 77
Williams 38 64 131 125 83
Jones 40 67 133 117 75
Brown 49 64 119 122 80
테이블 T
를 쉼표로 구분된 텍스트 파일 myPatientData.dat
에 쓰고 파일 내용을 표시합니다.
writetable(T,'myPatientData.dat','WriteRowNames',true) type 'myPatientData.dat'
Row,Age,Height,Weight,BloodPressure_1,BloodPressure_2 Smith,38,71,176,124,93 Johnson,43,69,163,109,77 Williams,38,64,131,125,83 Jones,40,67,133,117,75 Brown,49,64,119,122,80
행 이름이 포함된 첫 번째 열에는 열 제목 Row
가 위치합니다. 속성 T.Properties.DimensionNames
의 첫 번째 차원 이름이 테이블에 사용된 것입니다.
텍스트 파일에 다른 언어의 날짜 쓰기
테이블의 영어 날짜를 독일어로 변환한 후 해당 테이블을 파일에 써 보겠습니다.
날짜가 영어로 표시되어 있는 datetime
형 배열이 포함된 테이블을 만듭니다. 날짜값과 함께 사용될 숫자형 데이터로 구성된 열 벡터를 만듭니다.
D = datetime({'01-Jan-2014';'01-Feb-2014';'01-Mar-2014'}); D.Format = 'dd MMMM yyyy'; X1 = [20.2;21.6;20.7]; X2 = [100.5;102.7;99.8]; T = table(D,X1,X2)
T = D X1 X2 ________________ ____ _____ 01 January 2014 20.2 100.5 01 February 2014 21.6 102.7 01 March 2014 20.7 99.8
테이블을 텍스트 파일에 씁니다. DateLocale
이름-값 쌍의 인수를 사용하여 날짜 로캘을 독일어로 지정한 후 텍스트 파일의 날짜를 표시합니다.
writetable(T,'myfile.txt','DateLocale','de_DE'); type myfile.txt
D,X1,X2 01 Januar 2014,20.2,100.5 01 Februar 2014,21.6,102.7 01 März 2014,20.7,99.8
텍스트 파일에 다른 언어 문자 쓰기
데이터에 다른 언어 문자 또는 비ASCII 문자가 들어 있는 경우 인코딩 파라미터를 사용하여 파일을 올바르게 썼는지 확인합니다. 먼저, 제공된 테이블을 작업 공간에 불러옵니다. 그런 다음, 디폴트 인코딩을 사용하여 테이블을 파일에 씁니다. 마지막으로, 'UTF-8'
인코딩을 사용하여 테이블을 쓰고 그 결과를 검토합니다.
테이블 T가 들어 있는 Table_Japanese_Characters.mat
를 불러옵니다. 아래에 테이블의 미리보기가 나와 있습니다. 이 테이블에는 일본어 문자로 구성된 열이 두 개 들어 있습니다.
load('Table_Japanese_Characters.mat')
테이블을 파일에 씁니다. writetable
함수는 파일을 쓸 때 시스템 디폴트 인코딩을 사용합니다. 결과는 시스템 설정에 따라 달라질 수 있습니다. 결과 파일을 검토하려면 readtable
함수를 사용하여 테이블을 다시 작업 공간으로 읽어 들이십시오. writetable
이 다른 언어 문자가 들어 있는 열(1과 3)을 쓰는 데 성공하지 못했습니다.
writetable(T,'myTable.txt') myTable = readtable('myTable.txt')
myTable=9×3 table
A B C
_____ ______ _______
'' 458.98 ''
'' 530.14 ''
'' 289.4 ''
'' 434.81 ''
'' 186.44 ''
'' 0 ''
'' 231.29 ''
'' 311.86 ''
'' 239.93 ''
테이블에 다른 언어 문자 또는 비ASCII 문자가 들어 있는 경우 'Encoding'
파라미터를 사용하여 데이터를 올바르게 쓰도록 합니다. 'Encoding'
을 광범위한 다른 언어 문자와 비ASCII 문자를 지원하는 'UTF-8'
로 설정합니다. 결과 파일을 검토하려면 readtable
함수를 사용하여 테이블을 다시 작업 공간으로 읽어 들이십시오. 인코딩 파라미터가 올바르면 writetable
함수가 데이터를 성공적으로 씁니다.
writetable(T,'myTable_UTF8.txt','Encoding','UTF-8') myTable_UTF8 = readtable('myTable_UTF8.txt','Encoding','UTF-8')
myTable_UTF8=9×3 table
A B C
_______ ______ ___________
'南西' 458.98 '冬の嵐'
'南東' 530.14 '冬の嵐'
'南東' 289.4 '冬の嵐'
'西' 434.81 '機器の故障'
'中西部' 186.44 '深刻な嵐'
'西' 0 '攻撃'
'西' 231.29 '機器の故障'
'西' 311.86 '機器の故障'
'北東' 239.93 '火災'
CSV 파일에 따옴표로 묶인 텍스트 쓰기
테이블을 만듭니다.
T = table(['M';'F';'M'],[45;41;36],... {'New York, NY';'San Diego, CA';'Boston, MA'},[true;false;false])
T=3×4 table
Var1 Var2 Var3 Var4
____ ____ _________________ _____
M 45 {'New York, NY' } true
F 41 {'San Diego, CA'} false
M 36 {'Boston, MA' } false
테이블을 쉼표로 구분된 텍스트 파일 myData.csv
에 쓴 후 파일 내용을 봅니다. 'QuoteStrings'
이름-값 쌍의 인수를 사용하여 세 번째 열의 쉼표가 구분 기호로 처리되지 않도록 합니다.
writetable(T,'myData.csv','Delimiter',',','QuoteStrings','all') type 'myData.csv'
Var1,Var2,Var3,Var4 "M",45,"New York, NY",1 "F",41,"San Diego, CA",0 "M",36,"Boston, MA",0
스프레드시트의 특정 시트 및 범위에 테이블 쓰기
테이블을 만듭니다.
T = table(['M';'F';'M'],[45 45;41 32;40 34],... {'NY';'CA';'MA'},[true;false;false])
T=3×4 table
Var1 Var2 Var3 Var4
____ ________ ______ _____
M 45 45 {'NY'} true
F 41 32 {'CA'} false
M 40 34 {'MA'} false
테이블을 스프레드시트 myData.xls
에 씁니다. 데이터를 첫 번째 시트의 끝 지점이 B2
와 F6
인 5×5 범위에 포함시킵니다. 워크시트에 대응되는 인덱스를 지정하여 데이터를 쓰려는 워크시트를 변경할 수 있습니다.
writetable(T,'myData.xls','Sheet',1,'Range','B2:F6')
지정된 범위가 입력 테이블 T
의 크기보다 크기 때문에 Excel®은 B6
부터 F6
까지의 스프레드시트 행에 #N/A
를 입력합니다.
임의의 변수 이름을 포함하는 테이블 형식 데이터 쓰기
공백 및 비ASCII 문자를 비롯한 임의의 문자를 갖는 변수 이름을 포함하는 테이블 형식 데이터를 쓸 수 있습니다. 임의의 변수 이름을 갖는 테이블을 만들고 테이블을 텍스트 파일에 씁니다. 그런 다음 원래 변수 이름을 그대로 유지한 채 테이블 형식 데이터를 다시 읽어 들입니다.
임의의 변수 이름을 갖는 3개의 변수를 포함하는 테이블을 만듭니다. 첫 번째 변수와 세 번째 변수는 공백과 비ASCII 문자를 포함합니다.
LastName = {'Sanchez';'Johnson';'Li';'Diaz';'Brown'}; Age = [38;43;38;40;49]; Smoker = logical([1;0;1;0;1]); varNames = {'Last Name','Age','Smoker (1 or 0)'}; T = table(LastName,Age,Smoker,'VariableNames',varNames)
T=5×3 table
Last Name Age Smoker (1 or 0)
___________ ___ _______________
{'Sanchez'} 38 true
{'Johnson'} 43 false
{'Li' } 38 true
{'Diaz' } 40 false
{'Brown' } 49 true
데이터를 파일 'sampletable.txt'
에 씁니다.
writetable(T,'sampletable.txt')
readtable
을 사용하여 테이블 형식 데이터를 다시 읽어 들입니다. 기본적으로 MATLAB®은 공백이나 비ASCII 문자가 들어 있는 변수 이름을 유효한 MATLAB® 식별자로 변환합니다. 예를 들어, MATLAB®은 변수 이름 'Last Name'
을 'LastName'
으로 변환하고 'Smoker (1 or 0)'
을 'Smoker_1or0_'
으로 변환합니다. 변수 이름을 그대로 유지하면서 테이블 형식 데이터를 읽어 들이려면 'VariableNamingRule'
파라미터를 preserve
로 설정하십시오.
T_preserve = readtable('sampletable.txt',"VariableNamingRule","preserve")
T_preserve=5×3 table
Last Name Age Smoker (1 or 0)
___________ ___ _______________
{'Sanchez'} 38 1
{'Johnson'} 43 0
{'Li' } 38 1
{'Diaz' } 40 0
{'Brown' } 49 1
테이블 맨 아래에 데이터 추가하기
기존 데이터가 있는 테이블의 맨 아래에 새 행으로 데이터를 추가합니다.
테이블을 만듭니다.
InsectSpecies = {'Monarch Butterfly';'Seven-spot Ladybird';'Orchid Mantis';... 'American Bumblebee';'Blue Dasher Dragonfly'}; InsectOrder = {'Lepidoptera';'Coleoptera';'Mantodea';'Hymenoptera';'Odonata'}; InsectFamily = {'Nymphalidae';'Coccinellidae';'Hymenopodidae';... 'Apidae';'Libellulidae'}; PredatoryInsect = logical([0;1;1;0;1]); T = table(InsectSpecies,InsectOrder,InsectFamily,PredatoryInsect)
T=5×4 table
InsectSpecies InsectOrder InsectFamily PredatoryInsect
_________________________ _______________ _________________ _______________
{'Monarch Butterfly' } {'Lepidoptera'} {'Nymphalidae' } false
{'Seven-spot Ladybird' } {'Coleoptera' } {'Coccinellidae'} true
{'Orchid Mantis' } {'Mantodea' } {'Hymenopodidae'} true
{'American Bumblebee' } {'Hymenoptera'} {'Apidae' } false
{'Blue Dasher Dragonfly'} {'Odonata' } {'Libellulidae' } true
테이블 T를 InsectCollection.txt
라는 텍스트 파일에 씁니다.
writetable(T,'InsectCollection.txt','WriteRowNames',true)
기존 테이블에 추가할 테이블 형식의 새 데이터를 만듭니다.
newInsect = table({'Red-banded leafhopper'},{'Hemiptera'},{'Cicadellidae'},logical([0]))
newInsect=1×4 table
Var1 Var2 Var3 Var4
_________________________ _____________ ________________ _____
{'Red-banded leafhopper'} {'Hemiptera'} {'Cicadellidae'} false
'WriteMode','Append'
이름-값 쌍의 인수를 사용하여 newInsect
를 InsectCollection.txt
에 추가합니다.
writetable(newInsect,'InsectCollection.txt','WriteMode','Append',... 'WriteVariableNames',false,'WriteRowNames',true)
작업 공간으로 테이블을 다시 읽어 들입니다.
readtable('InsectCollection.txt')
ans=6×4 table
InsectSpecies InsectOrder InsectFamily PredatoryInsect
_________________________ _______________ _________________ _______________
{'Monarch Butterfly' } {'Lepidoptera'} {'Nymphalidae' } 0
{'Seven-spot Ladybird' } {'Coleoptera' } {'Coccinellidae'} 1
{'Orchid Mantis' } {'Mantodea' } {'Hymenopodidae'} 1
{'American Bumblebee' } {'Hymenoptera'} {'Apidae' } 0
{'Blue Dasher Dragonfly'} {'Odonata' } {'Libellulidae' } 1
{'Red-banded leafhopper'} {'Hemiptera' } {'Cicadellidae' } 0
기존 열 너비 보존하기
스프레드시트 파일 아래에 데이터를 추가할 때 파일의 기존 열 너비를 보존합니다.
텍스트 데이터를 사용하여 작업 공간 변수를 만든 다음 테이블을 변수에 대한 컨테이너로 만듭니다.
state = {'Massachussetts';'California';'Minnesota';'Virginia'}; stateFlower = {'Trailing arbutus';'Golden Poppy';'Pink and White Lady''s Slipper';'Flowering dogwood'}; stateBird = {'Black-capped chickadee';'California Valley Quail';'Common Loon';'Cardinal'}; data = table(state,stateFlower,stateBird);
테이블을 스프레드시트 파일 states_funfacts.xlsx
에 씁니다.
writetable(data,'state_funfacts.xlsx')
텍스트 데이터로 구성된 테이블을 하나 더 만듭니다.
t = table({'Maryland';'New York'},{'Black-eyed Susan';'Rose'},{'Baltimore oriole';'Eastern bluebird'});
테이블을 기존 스프레드시트 파일에 추가합니다. 'AutoFitWidth'
를 false
로 지정하여 스프레드시트의 기존 열 너비를 보존합니다.
writetable(t,'state_funfacts.xlsx',"WriteMode","append","AutoFitWidth",false);
'AutoFitWidth'
를 false
가 아닌 true
로 지정하면 writetable
은 원래 열 너비를 보존하는 대신 쓰려는 데이터에 맞게 스프레드시트의 열 너비를 조정합니다.
기존 셀 서식 수정하기
스프레드시트의 셀 서식을 보존하지 않고 기존 스프레드시트 파일 내의 행을 편집합니다.
스프레드시트 파일 student_grades.xlsx
는 서식이 지정된 셀을 포함합니다. 모든 셀에는 색이 채워져 있고 테두리가 있으며 머리글 셀에는 굵은 글꼴을 사용합니다.
텍스트와 숫자형 데이터로 구성된 테이블을 만듭니다.
Student = {'Mary';'John'}; Grade = [95;87]; t = table(Student,Grade)
t=2×2 table
Student Grade
________ _____
{'Mary'} 95
{'John'} 87
입력 데이터 테이블로 기존 스프레드시트 파일을 업데이트합니다. 'PreserveFormat'
을 false
로 지정하여 스프레드시트 파일의 기존 셀 서식을 무시합니다. 이렇게 하면 student_grades.xlsx
가 다음과 같이 수정됩니다.
writetable(t,'student_grades.xlsx','PreserveFormat',false);
기존 스프레드시트 파일에 데이터를 쓸 때 'PreserveFormat'
을 false
가 아닌 true
로 지정하면 writetable
은 스프레드시트의 기존 셀 서식을 보존합니다.
writetable(t,'student_grades.xlsx','PreserveFormat',true);
XML 파일에 테이블 쓰기
데이터 테이블을 만든 다음 XML 파일에 씁니다. 추가 이름-값 인수를 지정하여 writetable
이 XML 파일에 테이블 데이터를 쓰는 방법을 사용자 지정합니다.
데이터 테이블을 만듭니다.
InsectSpecies = {'Monarch Butterfly';'Seven-spot Ladybird';'Orchid Mantis'; ... 'American Bumblebee';'Blue Dasher Dragonfly'}; InsectOrder = {'Lepidoptera';'Coleoptera';'Mantodea';'Hymenoptera';'Odonata'}; InsectFamily = {'Nymphalidae';'Coccinellidae';'Hymenopodidae'; ... 'Apidae';'Libellulidae'}; PredatoryInsect = logical([0;1;1;0;1]); T = table(InsectOrder,InsectFamily,PredatoryInsect); T.Properties.RowNames = InsectSpecies; head(T,5)
InsectOrder InsectFamily PredatoryInsect _______________ _________________ _______________ Monarch Butterfly {'Lepidoptera'} {'Nymphalidae' } false Seven-spot Ladybird {'Coleoptera' } {'Coccinellidae'} true Orchid Mantis {'Mantodea' } {'Hymenopodidae'} true American Bumblebee {'Hymenoptera'} {'Apidae' } false Blue Dasher Dragonfly {'Odonata' } {'Libellulidae' } true
테이블 T
를 InsectCollection.xml
이라는 XML 파일에 씁니다. 테이블 행의 이름을 쓰려면 'WriteRowNames'
를 true
로 지정합니다. 행 이름은 출력 XML 파일에서 Row
요소 노드에 속하는 필드로 나타납니다.
'RowNodeName'
의 값으로 'Insect'
를 지정하여 XML 파일에서 노드 이름을 사용자 정의합니다.
writetable(T,'InsectCollection.xml',"WriteRowNames",false,"RowNodeName","Insect")
InsectCollection.xml
파일의 내용을 표시합니다.
type InsectCollection.xml
<?xml version="1.0" encoding="UTF-8"?> <table> <Insect> <InsectOrder>Lepidoptera</InsectOrder> <InsectFamily>Nymphalidae</InsectFamily> <PredatoryInsect>false</PredatoryInsect> </Insect> <Insect> <InsectOrder>Coleoptera</InsectOrder> <InsectFamily>Coccinellidae</InsectFamily> <PredatoryInsect>true</PredatoryInsect> </Insect> <Insect> <InsectOrder>Mantodea</InsectOrder> <InsectFamily>Hymenopodidae</InsectFamily> <PredatoryInsect>true</PredatoryInsect> </Insect> <Insect> <InsectOrder>Hymenoptera</InsectOrder> <InsectFamily>Apidae</InsectFamily> <PredatoryInsect>false</PredatoryInsect> </Insect> <Insect> <InsectOrder>Odonata</InsectOrder> <InsectFamily>Libellulidae</InsectFamily> <PredatoryInsect>true</PredatoryInsect> </Insect> </table>
WriteRowNames
를 true
로 지정하지 않으면 writetable
은 파일에 테이블 행 이름 쓰기를 건너뜁니다.
입력 인수
T
— 입력 데이터
테이블
입력 데이터로, 테이블로 지정됩니다.
filename
— 파일 이름
문자형 벡터 | string형 스칼라
파일 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.
쓰려는 위치에 따라 filename
은 다음 형식 중 하나가 될 수 있습니다.
위치 | 형식 | ||||||||
---|---|---|---|---|---|---|---|---|---|
현재 폴더 | 현재 폴더에 쓰려면 예: | ||||||||
다른 폴더 | 현재 폴더가 아닌 다른 폴더에 쓰려면 예: 예: | ||||||||
원격 위치 | 원격 위치에 쓰려면
원격 위치에 따라
자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오. 예: |
filename
에 파일 확장자가 포함되는 경우 쓰기 함수는 확장자를 통해 파일 형식을 결정하게 됩니다. 포함되어 있지 않으면 쓰기 함수는 쉼표로 구분된 텍스트 파일을 생성하고 확장자.txt
를 추가합니다. 또는 파일 확장자 없이filename
을 지정한 다음, 파일 유형을 나타내는'FileType'
이름-값 쌍의 인수를 포함시킬 수도 있습니다.
filename
이 없으면 쓰기 함수는 파일을 생성합니다.filename
이 기존 텍스트 파일의 이름이면 쓰기 함수는 해당 파일을 덮어씁니다.filename
이 기존 스프레드시트 파일의 이름이면 쓰기 함수는 지정한 위치에 데이터를 쓰지만 입력 데이터의 범위 외의 값은 덮어쓰지 않습니다.
데이터형: char
| string
이름-값 인수
선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN
으로 지정합니다. 여기서 Name
은 인수 이름이고 Value
는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.
R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name
을 따옴표로 묶으십시오.
예: 'WriteVariableNames',false
는 변수 이름이 출력 파일의 첫 번째 행으로 포함되어서는 안 된다는 것을 나타냅니다.
WriteRowNames
— 행 이름 쓰기용 표시자
false
(디폴트 값) | true
행 이름을 쓰기 위한 표시자로, 'WriteRowNames'
와 함께 false
또는 true
가 쉼표로 구분되어 지정됩니다.
표시자 | 동작 |
---|---|
|
|
| 텍스트 및 스프레드시트 파일의 경우,
XML 파일의 경우, |
DateLocale
— 날짜 쓰기에 적용할 로캘
문자형 벡터 | string형 스칼라
날짜 쓰기에 적용할 로캘로, 'DateLocale'
과 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. datetime
값을 파일에 쓸 때 writetable
함수가 어떤 로캘을 사용해 월 이름, 요일 이름, 약어를 쓸지 지정하려면 DateLocale
을 사용하십시오. 문자형 벡터 또는 string형은
형식을 사용합니다. 여기서 xx
_YY
xx
는 언어를 지정하는 ISO 639-1 두 자리 코드(소문자)이고, YY
는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다. 로캘에 일반적으로 사용되는 값 목록은 datetime
함수에 대한 Locale
이름-값 쌍의 인수를 참조하십시오.
쓰기 함수는 날짜를 Excel 형식이 지정된 날짜로 쓸 수 있는 경우에는 항상 'DateLocale'
파라미터 값을 무시합니다.
예: 'DateLocale','ja_JP'
데이터형: char
| string
FileType
— 파일 형식
'text'
| 'spreadsheet'
| 'xml'
파일 형식으로, 'FileType'
과 'text'
, 'spreadsheet'
또는 'xml'
을 포함하는 문자형 벡터 또는 string형이 쉼표로 구분되어 지정됩니다.
'FileType'
이름-값 쌍은 filename
입력 인수와 함께 사용되어야 합니다. filename
입력 인수에 표준 파일 확장자가 포함된 경우에는 'FileType'
이름-값 쌍의 인수를 지정할 필요가 없습니다. 쓰기 함수는 다음과 같은 표준 파일 확장자를 인식합니다.
.txt
,.dat
,.csv
- 기호로 구분된 텍스트 파일.xls
,.xlsm
,.xlsx
- Excel 스프레드시트 파일.xlsb
- Windows용 Excel이 설치된 시스템에서 지원되는 Excel 스프레드시트 파일.xml
- XML 파일
예: 'FileType','spreadsheet'
데이터형: char
| string
WriteVariableNames
— 변수 이름을 열 제목으로 쓸 것인지 여부를 나타내는 표시자
true
(디폴트 값) | false
변수 이름을 열 제목으로 쓸 것인지 여부를 나타내는 표시자로, 'WriteVariableNames'
와 함께 true
또는 false
가 쉼표로 구분되어 지정됩니다.
표시자 | 동작 |
---|---|
| 쓰기 함수는 변수 이름을 출력값의 열 제목으로 포함시킵니다. 이는 디폴트 동작입니다. |
| 쓰기 함수는 출력값에 변수 이름을 포함시키지 않습니다. |
WriteMode
— 쓰기 모드
문자형 벡터 | string형 스칼라
쓰기 모드로, 'WriteMode'
와 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 파일 형식에 따라 쓰기 모드를 선택합니다.
파일 형식 | 쓰기 모드 |
---|---|
텍스트 파일 |
지정한 파일이 존재하지 않으면 쓰기 함수가 새 파일을 만들고 데이터를 새 파일에 씁니다. |
스프레드시트 파일 |
|
WriteVariableNames
가true
로 설정된 경우, 쓰기 함수에서 쓰기 모드'append'
를 사용할 수 없습니다.스프레드시트 파일의 경우:
쓰기 모드가
'append'
인 경우, 쓰기 함수에서Range
파라미터를 사용할 수 없습니다.지정한 파일이 존재하지 않으면 쓰기 함수가
'replacefile'
과 동일한 동작을 수행합니다.
예: 'WriteMode','append'
데이터형: char
| string
Encoding
— 문자 인코딩 체계
'UTF-8'
(디폴트 값) | 'ISO-8859-1'
| 'windows-1251'
| 'windows-1252'
| ...
파일과 연결된 문자 인코딩 체계로, 'Encoding'
과 함께 'system'
또는 표준 문자 인코딩 체계 이름이 쉼표로 구분되어 지정됩니다. 인코딩을 지정하지 않은 경우, 쓰기 함수는 UTF-8을 사용하여 파일을 씁니다.
예: 'Encoding','UTF-8'
은 UTF-8을 인코딩으로 사용합니다.
데이터형: char
| string
Delimiter
— 필드 구분 기호 문자
문자형 벡터 | string형 스칼라
필드 구분 기호 문자로, 'Delimiter'
와 함께 다음 지정자 중 하나를 포함하는 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다.
지정자 | 필드 구분 기호 |
---|---|
| 쉼표. 이는 디폴트 동작입니다. |
| 공백 |
| 탭 |
| 세미콜론 |
| 세로 막대 |
'Delimiter'
이름-값 쌍은 구분된 텍스트 파일에만 사용할 수 있습니다.
예: 'Delimiter','space'
데이터형: char
| string
QuoteStrings
— 따옴표로 묶인 텍스트를 쓸 것인지 여부를 나타내는 표시자
"minimal"
(디폴트 값) | "all"
| "none"
따옴표로 묶인 텍스트를 쓸 것인지 여부를 나타내는 표시자로, "minimal"
, "all"
또는 "none"
으로 지정됩니다.
QuoteStrings
가"minimal"
이면 쓰기 함수는 구분 기호, 라인 끝 또는 큰따옴표 문자가 포함된 모든 변수를 큰따옴표로 묶습니다.QuoteStrings
가"all"
이면 쓰기 함수는 모든 텍스트, categorical형 변수, datetime형 변수, duration형 변수를 큰따옴표로 묶습니다.QuoteStrings
가"none"
이면 쓰기 함수는 변수를 큰따옴표로 묶지 않습니다.
QuoteStrings
이름-값 인수는 구분된 텍스트 파일에만 사용할 수 있습니다.
Sheet
— 테이블을 쓰려는 워크시트
문자형 벡터 | string형 스칼라 | 양의 정수
테이블을 쓰려는 워크시트로, 'Sheet'
와 함께 워크시트 이름을 포함한 문자형 벡터나 string형 스칼라 또는 워크시트 인덱스를 나타내는 양의 정수가 쉼표로 구분되어 지정됩니다. 워크시트 이름에는 콜론(:
)을 사용할 수 없습니다. 스프레드시트 파일에서 시트의 이름을 확인하려면 sheets = sheetnames(filename)
을 사용하십시오. 자세한 내용은 sheetnames
를 참조하십시오.
데이터를 쓰려는 워크시트를 다음과 같이 이름 또는 인덱스로 지정합니다.
이름 — 파일에 지정된 시트 이름이 존재하지 않으면 쓰기 함수는 이 워크시트 모음 끝에 새 시트를 추가합니다.
인덱스 — 지정된 시트가 워크시트의 개수보다 큰 인덱스인 경우, 쓰기 함수는 통합 문서에 있는 워크시트의 개수가 시트 인덱스와 같아질 때까지 빈 시트를 추가합니다. 쓰기 함수는 새 워크시트가 추가되었음을 나타내는 경고도 생성합니다.
'Sheet'
이름-값 쌍은 스프레드시트 파일에만 사용할 수 있습니다.
예: 'Sheet'
,2
예: 'Sheet'
, 'MySheetName'
데이터형: char
| string
| single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Range
— 테이블을 쓰려는 워크시트의 사각형 부분
문자형 벡터 | string형 스칼라
테이블을 쓰려는 워크시트의 사각형 부분으로, 'Range'
와 함께 다음 형식 중 하나의 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다.
Range 값 형식 | 설명 |
---|---|
' |
예: |
' |
예:
|
'Range'
이름-값 쌍은 Excel 파일에만 사용할 수 있습니다.
예: 'Range'
, 'A1:F10'
데이터형: char
| string
UseExcel
— Windows용 Microsoft® Excel 인스턴스를 시작할지 지정하는 플래그
false
(디폴트 값) | true
스프레드시트 데이터를 쓸 때 Windows용 Microsoft Excel 인스턴스를 시작할지 지정하는 플래그로, 'UseExcel'
과 함께 true
또는 false
가 쉼표로 구분되어 지정됩니다.
'UseExcel'
파라미터는 다음 값 중 하나로 설정할 수 있습니다.
true
— 쓰기 함수가 파일을 쓸 때 Microsoft Excel 인스턴스를 시작합니다.false
— 쓰기 함수가 파일을 쓸 때 Microsoft Excel 인스턴스를 시작하지 않습니다. 이 모드에서 작업할 때 쓰기 기능은 파일 형식 지원과 수식이나 매크로 같은 대화형 기능 지원 면에서 다르게 동작합니다.
UseExcel |
|
|
---|---|---|
지원되는 파일 형식 |
|
|
수식이나 매크로 같은 대화형 기능 지원 | 예 | 아니요 |
Windows 플랫폼에 스프레드시트 파일을 쓸 때 Microsoft Excel 인스턴스를 시작하려면 'UseExcel'
파라미터를 true
로 설정하십시오.
비대화형 방식의 자동화 환경에서는 UseExcel
이 지원되지 않습니다.
AutoFitWidth
— 열 너비를 자동으로 조정할지 여부
true
(디폴트 값) | false
열 너비를 자동으로 조정할지 여부로, true
또는 false
로 지정됩니다. 값을 0
또는 false
로 지정할 경우 writetable
함수는 셀의 데이터에 맞게 자동으로 열 너비를 조정하지 않습니다.
예: 'AutoFitWidth'
,0
PreserveFormat
— 셀 서식을 보존할지 여부
true
(디폴트 값) | false
스프레드시트의 셀 서식을 보존할지 여부로, true
또는 false
로 지정됩니다. false
를 지정할 경우 writetable
함수는 스프레드시트의 셀 서식을 보존하지 않습니다. 서식에는 글꼴, 셀 테두리, 색이 적용된 셀 등이 포함됩니다.
datetime
데이터를 스프레드시트 파일에 쓰는 경우, 기존 셀 서식을 보존하려면 'PreserveFormat'
이름-값 쌍과 'UseExcel'
이름-값 쌍을 모두 true
로 설정해야 합니다. datetime
데이터를 파일에 쓸 때 'UseExcel'
을 false
로 설정하고 'PreserveFormat'
을 true
로 설정할 경우, writetable
함수는 파일의 기존 셀 서식을 보존하지 않습니다.
예: 'PreserveFormat'
,false
AttributeSuffix
— 특성 접미사
'Attribute'
(디폴트 값) | 문자형 벡터 | string형 스칼라
특성 접미사로, 'AttributeSuffix'
와 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정되며, 입력 테이블의 어떤 변수 이름을 출력 XML 파일의 특성으로 쓸지 나타냅니다.
예를 들어, 입력 테이블에 변수 이름 AttName_att
가 있을 경우 'AttributeSuffix','_att'
를 지정하면 'AttName'
을 출력 XML 파일의 특성으로 쓰도록 지정했음을 나타냅니다.
'AttributeSuffix'
를 지정하지 않으면writetable
은 기본적으로 출력 XML 파일의 특성으로 접미사'Attribute'
를 사용하여 변수를 씁니다.'AttributeSuffix'
값으로 지정된 특성이 입력 테이블의 변수 이름에 붙은 접미사와 일치하면 해당 접미사는 출력 XML 파일의 변수 이름에서 생략됩니다. 예를 들어,'AttributeSuffix','_att'
를 지정하면MyField_att
라는 입력 테이블의 변수는 XML 파일의MyField
라는 특성으로 대응됩니다.
예: 'AttributeSuffix','_att'
RowNodeName
— XML 행 노드 이름
'row'
| string형 배열
XML 행 노드 이름으로, 'RowNodeName'
과 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정되며, 쓰기 함수가 입력 테이블의 행에 대응되는 노드 이름을 출력 XML 파일에 씁니다. RowNodeName
을 지정하지 않으면 쓰기 함수는 출력 테이블의 행 노드 이름으로 'row'
를 씁니다.
예: 'TableNodeName','RootName'
TableNodeName
— XML 루트 노드 이름
'table'
(디폴트 값) | 문자형 벡터 | string형 배열
XML 루트 노드 이름으로, 'TableNodeName'
과 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정되며, 쓰기 함수가 출력 XML 파일에 루트 노드 이름으로 씁니다. TableNodeName
을 지정하지 않으면 쓰기 함수는 출력 테이블의 루트 노드 이름으로 'table'
을 씁니다.
예: 'TableNodeName','RootName'
제한 사항
writetable
은 중첩 테이블 쓰기를 지원하지 않습니다. 쓰기 전에, 중첩 테이블에서splitvars
를 사용하여 다중 열 변수를 단일 열 변수로 분할하십시오.
팁
스프레드시트 파일에서 빈 시트 만들기:
writetable
을 사용하여 빈 테이블을 써서 스프레드시트 파일에서 빈 시트를 만들 수 있습니다. 예를 들어 이름이'MySheetName'
인 빈 시트를 만들어 보겠습니다.또는 이름이writetable(table(),'empty.xls','Sheet','MySheetName')
'Sheet1'
,'Sheet2'
,'Sheet3'
인 3개의 빈 시트를 만들어 보십시오.writetable(table(),'empty.xls','Sheet',3)
알고리즘
'WriteVariableNames'
논리값 표시자와'WriteRowNames'
논리값 표시자가 모두true
이면writetable
함수는 속성T.Properties.DimensionNames
의 첫 번째 차원 이름을 출력값 내 첫 번째 열의 열 제목으로 사용합니다.Excel은
Inf
값을65535
로 변환합니다. MATLAB®은NaN
,NaT
,<undefined>
categorical형 값,<missing>
문자열 값을 빈 셀로 변환합니다.Excel 파일의 경우,
writetable
은datetime
형 배열이 포함된table
변수를 Excel 날짜로 씁니다.table
에 연도가 1900년 또는 1904년 이전인datetime
형 배열이 포함되어 있으면writetable
은 변수를 텍스트로 씁니다. Excel 날짜에 대한 자세한 내용은 Differences between the 1900 and the 1904 date system in Excel을 참조하십시오.일부의 경우
writetable
함수가 만든 파일이T
를 정확하게 나타내지 못할 수 있습니다.readtable
을 사용하여 이 파일을 읽을 때 이것을 확인할 수 있습니다. 결과 테이블의 형식이나 내용이 원래 테이블과 다를 수 있습니다. 테이블을 저장한 뒤 추후에 원래 테이블과 정확하게 일치하는 동일한 데이터와 구성으로 다시 가져오고자 하는 경우에는 테이블을 MAT 파일로 저장하십시오. 다음의 경우writetable
은 부정확한 테이블을 씁니다.텍스트 파일에 쓸 때
writetable
은 숫자형 변수는long g
형식으로, categorical형 변수 또는 문자형 변수는 따옴표가 없는 문자로 출력합니다.둘 이상의 열이 있는 변수의 경우,
writetable
은 열 제목으로 사용할 변수 이름에 고유한 식별자를 추가합니다.세 개 이상의 차원이 있는 출력 변수의 경우,
writetable
은 해당 변수를 후행 차원이 축소된 2차원으로 출력합니다. 예를 들면,writetable
은 4×3×2 변수를 마치 크기가 4×6인 것처럼 출력합니다.cell
데이터형이 포함된 변수의 경우,writetable
은 여러 필드에 각 셀의 내용을 단일 행으로 출력합니다. 내용이 숫자형, 논리형, 문자형, categorical형이 아니면writetable
은 비어 있는 하나의 필드를 출력합니다.
버전 내역
R2013b에 개발됨
참고 항목
table
| readtable
| writecell
| writetimetable
| writematrix
MATLAB 명령
다음 MATLAB 명령에 해당하는 링크를 클릭했습니다.
명령을 실행하려면 MATLAB 명령 창에 입력하십시오. 웹 브라우저는 MATLAB 명령을 지원하지 않습니다.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)