이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.
readtable
파일에서 테이블 만들기
구문
설명
는 하나 이상의 이름-값 인수를 사용하여 옵션을 지정합니다. 예를 들어, T
= readtable(filename
,Name=Value
)ReadVariableNames
이름-값 인수를 사용하여 파일의 첫 번째 행을 변수 이름 또는 데이터로 읽어 올 수 있습니다.
는 import options 객체와 이름-값 인수를 모두 사용하여 테이블을 만듭니다. import options 객체 외에 이름-값 인수까지 지정하면, T
= readtable(filename
,opts
,Name=Value
)readtable
은 텍스트 파일에는 ReadVariableNames
, ReadRowNames
, DateLocale
, Encoding
이름-값 인수만 지원하고 스프레드시트 파일에는 ReadVariableNames
, ReadRowNames
, Sheet
, UseExcel
이름-값 인수만 지원합니다.
예제
텍스트 파일의 내용을 테이블로 가져옵니다. 생성되는 테이블은 파일의 각 열별로 변수를 하나씩 포함하고 파일의 첫 번째 라인에 있는 항목을 변수 이름으로 사용합니다.
T = readtable("myCsvTable.dat")
T=5×6 table
LastName Gender Age Height Weight Smoker
____________ ______ ___ ______ ______ ______
{'Smith' } {'M'} 38 71 176 1
{'Johnson' } {'M'} 43 69 163 0
{'Williams'} {'F'} 38 64 131 0
{'Jones' } {'F'} 40 67 133 0
{'Brown' } {'F'} 49 64 119 0
데이터 누락이 있는 텍스트 파일에서 테이블을 만듭니다. 기본적으로 readtable
은 누락된 부분을 적절한 누락값으로 채웁니다.
T = readtable("headersAndMissing.txt")
T=5×6 table
LastName Gender Age Height Weight Smoker
___________ __________ ___ ______ ______ ______
{'Wu' } {'M' } 38 71 176 1
{'Johnson'} {'M' } 43 69 163 0
{'Sanchez'} {'F' } 38 64 131 0
{'Brown' } {'F' } NaN 67 133 0
{'Picard' } {0×0 char} NaN 64 119 0
데이터 누락이 있는 행을 생략하려면 MissingRule
이름-값 인수를 지정하십시오.
T = readtable("headersAndMissing.txt",MissingRule="omitrow")
T=3×6 table
LastName Gender Age Height Weight Smoker
___________ ______ ___ ______ ______ ______
{'Wu' } {'M'} 38 71 176 1
{'Johnson'} {'M'} 43 69 163 0
{'Sanchez'} {'F'} 38 64 131 0
import options 객체를 사용하여 readtable
이 파일을 해석하는 방법을 구성합니다. 예를 들어 import options 객체를 사용하여 텍스트 파일의 일부만 읽어옵니다.
먼저, 변수 이름 및 유형, 구분자, 공백 문자를 포함한 텍스트 파일의 특징을 검출하기 위해 detectImportOptions
를 사용해서 import options 객체를 만듭니다. 이 경우 detectImportOptions
는 DelimitedTextImportOptions
객체를 만듭니다.
opts = detectImportOptions("airlinesmall.csv")
opts = DelimitedTextImportOptions with properties: Format Properties: Delimiter: {','} Whitespace: '\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'ISO-8859-1' Replacement Properties: MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars' Variable Import Properties: Set types by name using setvartype VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more} VariableTypes: {'double', 'double', 'double' ... and 26 more} SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more} VariableOptions: Show all 29 VariableOptions Access VariableOptions sub-properties using setvaropts/getvaropts VariableNamingRule: 'modify' Location Properties: DataLines: [2 Inf] VariableNamesLine: 1 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0 To display a preview of the table, use preview
import options 객체를 수정하여 가져올 변수의 서브셋을 지정합니다. 그런 다음 import options 객체와 함께 readtable
을 사용하여 데이터 서브셋을 가져옵니다.
opts.SelectedVariableNames = ["TaxiIn","TaxiOut"]; T = readtable("airlinesmall.csv",opts);
첫 번째 행에 변수 이름을 포함하고 첫 번째 열에 행 이름을 포함한 스프레드시트에서 테이블을 만듭니다. 테이블에서 처음 5개 행과 처음 4개 변수를 표시합니다.
T = readtable("patients.xls",ReadRowNames=true);
T(1:5,1:4)
ans=5×4 table
Gender Age Location Height
__________ ___ _____________________________ ______
Smith {'Male' } 38 {'County General Hospital' } 71
Johnson {'Male' } 43 {'VA Hospital' } 69
Williams {'Female'} 38 {'St. Mary's Medical Center'} 64
Jones {'Female'} 40 {'VA Hospital' } 67
Brown {'Female'} 49 {'County General Hospital' } 64
스프레드시트의 지정된 영역에 있는 데이터를 사용하여 테이블을 만듭니다. 끝 지점 C2
와 E6
사이에 있는 5×3의 사각형 영역의 데이터를 사용합니다. 이 영역의 첫 번째 행을 변수 이름으로 사용하지 않습니다. 결과로 생성되는 테이블은 대신 디폴트 변수 이름을 사용합니다.
T = readtable("patients.xls",Range="C2:E6",ReadVariableNames=false)
T=5×3 table
Var1 Var2 Var3
____ _____________________________ ____
38 {'County General Hospital' } 71
43 {'VA Hospital' } 69
38 {'St. Mary's Medical Center'} 64
40 {'VA Hospital' } 67
49 {'County General Hospital' } 64
import options 객체를 사용하여 readtable이 파일을 해석하는 방법을 구성합니다. 예를 들어, import options 객체를 사용하여 스프레드시트 파일에서 지정된 변수만 읽어옵니다.
먼저, 변수 이름 및 유형을 포함한 스프레드시트 파일의 특징을 검출하기 위해 detectImportOptions
를 사용해서 파일에서 import options 객체를 만듭니다. 이 경우 detectImportOptions
는 SpreadsheetImportOptions
객체를 만듭니다.
opts = detectImportOptions("patients.xls")
opts = SpreadsheetImportOptions with properties: Sheet Properties: Sheet: '' Replacement Properties: MissingRule: 'fill' ImportErrorRule: 'fill' MergedCellColumnRule: 'placeleft' MergedCellRowRule: 'placetop' Variable Import Properties: Set types by name using setvartype VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more} VariableTypes: {'char', 'char', 'double' ... and 7 more} SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more} VariableOptions: Show all 10 VariableOptions Access VariableOptions sub-properties using setvaropts/getvaropts VariableNamingRule: 'modify' Range Properties: DataRange: 'A2' (Start Cell) VariableNamesRange: 'A1' RowNamesRange: '' VariableUnitsRange: '' VariableDescriptionsRange: '' To display a preview of the table, use preview
import options 객체를 수정하여 가져올 변수를 지정합니다. 그런 다음 import options 객체와 함께 readtable
을 사용하여 지정된 변수를 가져옵니다. 테이블의 처음 5개 행을 표시합니다.
opts.SelectedVariableNames = ["Systolic","Diastolic"]; T = readtable("patients.xls",opts); T(1:5,:)
ans=5×2 table
Systolic Diastolic
________ _________
124 93
109 77
125 83
117 75
122 80
XML 파일의 내용을 테이블로 가져옵니다.
students.xml
파일에는 Student
라는 이름의 형제 노드 7개가 있으며 각 노드에는 동일한 자식 노드와 특성이 포함되어 있습니다.
type students.xml
<?xml version="1.0" encoding="utf-8"?> <Students> <Student ID="S11305"> <Name FirstName="Priya" LastName="Thompson" /> <Age>18</Age> <Year>Freshman</Year> <Address> <Street xmlns="https://www.mathworks.com">591 Spring Lane</Street> <City>Natick</City> <State>MA</State> </Address> <Major>Computer Science</Major> <Minor>English Literature</Minor> </Student> <Student ID="S23451"> <Name FirstName="Conor" LastName="Cole" /> <Age>18</Age> <Year>Freshman</Year> <Address> <Street xmlns="https://www.mathworks.com">4641 Pearl Street</Street> <City>San Francisco</City> <State>CA</State> </Address> <Major>Microbiology</Major> <Minor>Public Health</Minor> </Student> <Student ID="S119323"> <Name FirstName="Morgan" LastName="Yang" /> <Age>21</Age> <Year>Senior</Year> <Address> <Street xmlns="https://www.mathworks.com">30 Highland Road</Street> <City>Detriot</City> <State>MI</State> </Address> <Major>Political Science</Major> </Student> <Student ID="S201351"> <Name FirstName="Salim" LastName="Copeland" /> <Age>19</Age> <Year>Sophomore</Year> <Address> <Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street> <City>Fort Worth</City> <State>TX</State> </Address> <Major>Business</Major> <Minor>Japanese Language</Minor> </Student> <Student ID="S201351"> <Name FirstName="Salim" LastName="Copeland" /> <Age>20</Age> <Year>Sophomore</Year> <Address> <Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street> <City>Fort Worth</City> <State>TX</State> </Address> <Major>Business</Major> <Minor>Japanese Language</Minor> </Student> <Student ID="54600"> <Name FirstName="Dania" LastName="Burt" /> <Age>22</Age> <Year>Senior</Year> <Address> <Street xmlns="https://www.mathworks.com">22 Angie Drive</Street> <City>Los Angeles</City> <State>CA</State> </Address> <Major>Mechanical Engineering</Major> <Minor>Architecture</Minor> </Student> <Student ID="453197"> <Name FirstName="Rikki" LastName="Gunn" /> <Age>21</Age> <Year>Junior</Year> <Address> <Street xmlns="https://www.mathworks.com">65 Decatur Lane</Street> <City>Trenton</City> <State>ME</State> </Address> <Major>Economics</Major> <Minor>Art History</Minor> </Student> </Students>
먼저, XML 파일의 특징을 검출하기 위해 detectImportOptions
를 사용해서 XMLImportOptions
객체를 만듭니다. VariableSelectors
이름-값 인수를 Street
요소 노드의 XPath 표현식으로 지정하여 도로 이름만 테이블로 읽어옵니다. RegisteredNamespaces
이름-값 인수를 설정하여 사용자 지정 네임스페이스 접두사를 기존 네임스페이스 URL에 등록합니다.
opts = detectImportOptions("students.xml",RegisteredNamespaces=["myPrefix","https://www.mathworks.com"], ... VariableSelectors="//myPrefix:Street");
그런 다음 import options 객체와 함께 readtable
을 사용하여 지정된 변수를 가져옵니다.
T = readtable("students.xml",opts)
T=7×1 table
Street
___________________
"591 Spring Lane"
"4641 Pearl Street"
"30 Highland Road"
"3388 Moore Avenue"
"3388 Moore Avenue"
"22 Angie Drive"
"65 Decatur Lane"
Microsoft Word 문서의 테이블을 MATLAB의 테이블로 가져옵니다. 이 사례에서는 문서에 두 개의 테이블이 있고, 두 번째 테이블은 병합된 셀을 포함합니다. TableIndex
이름-값 인수를 설정하여 두 번째 테이블을 읽어 들입니다. MergedCellColumnRule
이름-값 인수를 설정하여, 병합된 열이 있는 셀을 갖는 행을 건너뜁니다.
filename = "MaintenanceReport.docx"; T = readtable(filename,TableIndex=2,MergedCellColumnRule="omitrow")
T=3×5 table
Description Category Urgency Resolution Cost
_____________________________________________________________________ ____________________ ________ __________________ ________
"Items are occasionally getting stuck in the scanner spools." "Mechanical Failure" "Medium" "Readjust Machine" "$45"
"Loud rattling and banging sounds are coming from assembler pistons." "Mechanical Failure" "Medium" "Readjust Machine" "$35"
"There are cuts to the power when starting the plant." "Electronic Failure" "High" "Full Replacement" "$16200"
또는 TableSelector
이름-값 인수를 사용하여, XPath 선택자를 사용하여 테이블을 선택할 수도 있습니다. "Description" 텍스트를 포함하는 Microsoft Word 문서 테이블을 선택하려면 XPath 선택자 "//w:tbl[contains(.,'Description')]"
을 사용하십시오.
T = readtable(filename, ... TableSelector="//w:tbl[contains(.,'Description')]", ... MergedCellColumnRule="omitrow")
T=3×5 table
Description Category Urgency Resolution Cost
_____________________________________________________________________ ____________________ ________ __________________ ________
"Items are occasionally getting stuck in the scanner spools." "Mechanical Failure" "Medium" "Readjust Machine" "$45"
"Loud rattling and banging sounds are coming from assembler pistons." "Mechanical Failure" "Medium" "Readjust Machine" "$35"
"There are cuts to the power when starting the plant." "Electronic Failure" "High" "Full Replacement" "$16200"
XPath 선택자 "//TABLE[contains(.,'readtable')]"
을 사용하여 URL https://www.mathworks.com/help/matlab/text-files.html
에서 텍스트 "readtable"
을 포함하는 첫 번째 테이블을 가져옵니다. 테이블에 제목 행이 없으므로 ReadVariableNames
이름-값 인수를 false
로 설정하십시오.
url = "https://www.mathworks.com/help/matlab/text-files.html"; T = readtable(url,TableSelector="//TABLE[contains(.,'readtable')]", ... ReadVariableNames=false)
T=4×2 table
Var1 Var2
________________ ____________________________
"readtable" "Create table from file"
"writetable" "Write table to file"
"readtimetable" "Create timetable from file"
"writetimetable" "Write timetable to file"
입력 인수
읽을 파일의 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. readtable
은 텍스트, 스프레드시트, XML, Microsoft Word 및 HTML 파일의 데이터 읽기를 지원합니다.
filename
에 확장자가 포함되어 있지 않은 경우 FileType
이름-값 인수를 사용하여 파일 형식을 나타냅니다. 기본적으로 readtable
은 입력 파일의 각 열에서 감지된 데이터 값에 적합한 데이터형의 변수를 만듭니다.
파일의 위치에 따라 filename
은 다음 형식 중 하나가 될 수 있습니다.
위치 | 형식 | ||||||||
---|---|---|---|---|---|---|---|---|---|
현재 폴더 또는 MATLAB® 경로의 폴더 |
예: | ||||||||
폴더 안의 파일 | 파일이 현재 폴더나 MATLAB 경로의 폴더에 없는 경우, 예: 예: | ||||||||
인터넷 URL | 파일이 인터넷 URL(Uniform Resource Locator)로 지정된 경우, 예: | ||||||||
원격 위치 | 파일이 원격 위치에 저장된 경우,
원격 위치에 따라
자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오. 예: 예: 예: |
텍스트 파일
확장자가
.txt
,.dat
또는.csv
인 파일은 구분된 텍스트 파일로 읽힙니다.기본적으로
readtable
은 파일의 각 열마다 하나의 테이블 변수를 만들고 파일의 첫 번째 행에서 변수 이름을 읽어 들입니다. 빈 필드는NaN
(숫자형 변수의 경우)이나 빈 문자형 벡터(텍스트 변수의 경우)로 변환됩니다. 파일에 있는 공백은 무시됩니다.텍스트 파일의 모든 줄에는 동일한 개수의 구분 기호가 있어야 합니다.
자주 사용되는 텍스트 파일 워크플로를 보려면 텍스트 파일에서 테이블로 데이터 가져오기를 참조하십시오.
스프레드시트 파일
확장자가
.xls
,.xlsb
,.xlsm
,.xlsx
,.xltm
,.xltx
또는.ods
인 파일은 스프레드시트 파일로 읽힙니다.기본적으로
readtable
은 파일의 각 열마다 하나의 테이블 변수를 만들고 파일의 첫 번째 행에서 변수 이름을 읽어 들입니다.Microsoft Excel 소프트웨어를 실행하는 Windows® 시스템에서
readtable
은 사용자의 Excel 버전으로 인식되는 모든 Excel 스프레드시트 파일 형식을 읽습니다. 시스템에 Windows용 Microsoft Excel이 없거나 MATLAB Online™을 사용 중인 경우,readtable
은UseExcel
속성이false
로 설정된 상태로 작동하고 확장자가.xls
,.xlsm
,.xlsx
,.xltm
및.xltx
인 파일만 읽습니다.XLSX 형식의 대용량 파일은 불러오는 속도가 느린 경우가 있습니다. 더 나은 가져오기 및 내보내기 성능을 위해 Microsoft는 XLSB 형식을 사용할 것을 권장합니다.
자주 사용되는 스프레드시트 파일 워크플로를 보려면 스프레드시트 데이터를 테이블로 읽어오기 항목을 참조하십시오.
XML 파일
(R2021a 이후)
확장자가
.xml
인 파일은 XML(Extensible Markup Language) 파일로 읽힙니다.기본적으로
readtable
은 테이블 변수로 감지된 각 요소 또는 특성 노드마다 하나의 테이블 변수를 만듭니다. 변수 이름은 요소 및 특성 이름에 해당합니다.
Microsoft Word 문서
(R2021b 이후)
확장자가
.docx
인 파일은 Microsoft Word 파일로 읽힙니다.기본적으로
readtable
은 문서의 첫 번째 테이블에서 데이터를 가져오고 파일의 각 열마다 하나의 테이블 변수를 만든 다음 테이블의 첫 번째 행에서 변수 이름을 읽어 들입니다.
HTML 파일
(R2021b 이후)
확장자가
.html
,.xhtml
또는.htm
인 파일은 HTML(Hypertext Markup Language) 파일로 읽힙니다.기본적으로
readtable
은 첫 번째<table>
요소에서 데이터를 가져오고 테이블의 각 열마다 하나의 테이블 변수를 만든 다음 테이블의 첫 번째 행에서 변수 이름을 읽어 들입니다.
압축되어 아카이브된 파일
(R2025a 이후)
압축된 파일 형식은 파일로 읽힙니다.
아카이브된 파일 형식은 폴더로 처리됩니다. 예를 들어, 함수는
mydatafiles.zip
을 폴더로 해석하므로, 이 파일 내에 있는 파일을 지정해야 합니다(예:mydatafiles.zip/file1.xlsx
)..gz
확장자로 끝나는 파일의 경우, 함수는.gz
앞에 있는 확장자를 사용하여 파일 형식을 확인합니다. 예를 들어,mydata.csv.gz
는 CSV 파일로 읽힙니다.
파일 가져오기 옵션으로, 다음 표에 있는 import options 객체 중 하나로 지정되며 detectImportOptions
함수나 연관된 가져오기 옵션 함수에 의해 생성됩니다. import options 객체에는 데이터 가져오기 과정을 구성하는 속성이 포함되어 있습니다. readtable
은 각 import options 객체의 관련 속성만 사용합니다.
파일 형식 | Import Options 객체 |
---|---|
텍스트 파일 | DelimitedTextImportOptions 객체 |
고정 너비 텍스트 파일 | FixedWidthImportOptions 객체 |
스프레드시트 파일 | SpreadsheetImportOptions 객체 |
XML 파일 | XMLImportOptions 객체 |
Microsoft Word 문서 | WordDocumentImportOptions 객체 |
HTML 파일 | HTMLImportOptions 객체 |
가져오기를 제어하는 방법에 대한 자세한 내용은 Control How MATLAB Imports Your Data 항목을 참조하십시오.
이름-값 인수
선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN
으로 지정합니다. 여기서 Name
은 인수 이름이고 Value
는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.
예: readtable(filename,ReadVariableNames=false)
는 파일의 첫 번째 행을 변수 이름 대신 데이터로 읽어 오도록 지정합니다.
데이터 및 제목 위치
파일의 시작 부분에서 건너뛸 제목 라인 수로, 음이 아닌 정수로 지정됩니다. 이 이름-값 인수를 지정하지 않으면 readtable
은 건너뛸 라인 수를 자동으로 감지합니다.
변수 이름과 데이터는 제목이 아닌 첫 번째 라인부터 읽힙니다.
데이터형: single
| double
파일에서 읽을 범위로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 숫자형 벡터로 지정됩니다.
Range 를 지정하는 방법 | 설명 |
---|---|
시작 요소 | 데이터의 시작 요소를 다음 값 중 하나로 지정합니다.
예: 예: |
사각 범위 | 데이터의 사각 범위를 다음 값 중 하나로 지정합니다.
열의 개수는 예: 예: |
행 범위 |
예: |
열 범위 |
열의 개수는 예: |
명명된 범위(스프레드시트만 해당) | 스프레드시트에서 범위를 식별하는 이름을 만들 수 있습니다. 예를 들어, 스프레드시트의 사각형 부분을 선택하고 |
지정되지 않거나 비어 있음 | 이 이름-값 인수를 지정하지 않으면 참고: 사용된 범위는 실제로 데이터가 들어 있는 파일의 사각형 부분을 말합니다. |
데이터의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터, 양의 정수 또는 양의 정수로 구성된 N
×2
배열로 지정됩니다.
DataRange 를 지정하는 방법 | 설명 |
---|---|
시작 셀 | A1 표기법을 사용하여, 데이터의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다. 예를 들어,
예: |
시작 행 | 양의 행 인덱스를 사용하여 데이터를 포함하는 시작 행을 지정합니다.
예: |
사각 범위 |
예: |
행 범위 |
예: |
열 범위 |
예: |
여러 개의 행 범위 |
여러 개의 행 범위로 구성된 유효한 배열은 다음을 충족해야 합니다.
예: |
비어 있음 | 데이터를 읽지 않습니다. 예: |
읽을 워크시트로, 워크시트 인덱스를 나타내는 양의 정수나 워크시트 이름을 포함하는 string형 스칼라 또는 문자형 벡터로 지정됩니다. 기본적으로 readtable
은 첫 번째 시트를 읽습니다.
string형 스칼라 또는 문자형 벡터를 지정하는 경우 워크시트 이름에는 콜론(:
)을 사용할 수 없습니다. 스프레드시트 파일에서 시트의 이름을 확인하려면 sheets = sheetnames(filename)
을 사용하십시오. 자세한 내용은 sheetnames
를 참조하십시오.
opts
와 함께 Sheet
인수를 지정하면 readtable
함수는 Sheet
에 지정된 값을 사용하고 가져오기 옵션에 정의된 시트 이름을 무시합니다.
예: 2
예: "MySheetName"
여러 테이블을 포함하는 파일에서 읽어 들일 테이블의 인덱스로, 양의 정수로 지정됩니다. 기본적으로 readtable
은 첫 번째 테이블을 읽습니다.
TableIndex
를 지정하면 readtable
함수가 TableSelector
를 동일한 XPath 표현식으로 자동으로 설정합니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
읽어 들일 테이블에 대한 XPath 표현식으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 TableSelector
를 지정해야 합니다.
선택 작업 | 구문 |
---|---|
문서에서의 위치에 관계없이 선택하려는 노드와 이름이 일치하는 모든 노드를 선택합니다. | 이름 앞에 두 개의 슬래시(// )를 붙입니다. |
요소 노드에 속한 특성 값을 선택합니다. | 특성 앞에 골뱅이 기호(@ )를 붙입니다. |
노드 세트에서 특정 노드를 선택합니다. | 대괄호([] ) 안에 선택하고자 하는 노드 인덱스를 제공합니다. |
연산 우선 순위를 지정합니다. | 먼저 평가할 표현식을 괄호로 묶습니다. |
이 이름-값 인수를 지정하지 않으면 readtable은 테이블 위치를 감지합니다.
예: "//table[1]"
읽어올 테이블 데이터의 XML 노드 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다.
열을 가로질러 병합된 셀에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
가져오기 규칙 | 동작 |
---|---|
"placeleft" | 가장 왼쪽 셀에 데이터를 배치하고 나머지 셀을 가져올 변수의 |
"placeright" | 가장 오른쪽 셀에 데이터를 배치하고 나머지 셀을 가져올 변수의 |
"duplicate" | 모든 셀의 데이터를 복제합니다. |
"omitrow" | 병합된 셀이 있는 행을 생략합니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
행을 가로질러 병합된 셀에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
가져오기 규칙 | 동작 |
---|---|
"placetop" | 맨 위쪽 셀에 데이터를 배치하고 나머지 셀을 가져올 변수의 |
"placebottom" | 맨 아래쪽 셀에 데이터를 배치하고 나머지 셀을 가져올 변수의 |
"duplicate" | 모든 셀의 데이터를 복제합니다. |
"omitvar" | 병합된 셀이 있는 변수를 생략합니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
변수
변수 이름을 읽을지 여부로, 숫자형 값 또는 논리값 1
(true
) 또는 0
(false
)으로 지정됩니다. 이 이름-값 인수를 지정하지 않으면 readtable
은 제목 행 뒤에 변수 이름이 있는지 자동으로 감지합니다.
표시자 | 설명 |
---|---|
| 변수 이름을 읽습니다. import options 객체 |
| 변수 이름을 읽지 않습니다. import options 객체 |
지정되지 않음 | 범위에 변수 이름이 포함되어 있는지 자동으로 감지합니다. |
ReadVariableNames
와 ReadRowNames
가 모두 true
인 경우, readtable
은 읽을 영역의 첫 번째 행의 첫 번째 열에 있는 이름을 속성 T.Properties.DimensionNames
의 첫 번째 차원 이름으로 저장합니다.
변수 이름에 대한 규칙으로, 다음 값 중 하나로 지정됩니다.
"modify"
— 유효하지 않은 변수 이름(유효 여부는isvarname
함수의 판정에 따름)을 유효한 MATLAB 식별자로 변환합니다. 이 값은 텍스트 파일과 스프레드시트 파일에 대한 디폴트 값입니다."preserve"
— 공백과 비ASCII 문자가 포함된 변수 이름과 같이 MATLAB 식별자로 유효하지 않은 변수 이름을 그대로 유지합니다. 이 값은 XML, Microsoft Word 및 HTML 파일에 대한 디폴트 값입니다.
변수 이름과 행 이름은 유효한 MATLAB 식별자가 아니어도 됩니다. 이러한 이름에는 공백과 비ASCII 문자까지 포함하여 모든 문자를 사용할 수 있습니다. 또한 영문자뿐만 아니라 어떤 문자로도 시작할 수 있습니다.
예상 변수 개수로, 음이 아닌 정수로 지정됩니다. 이 이름-값 인수를 지정하지 않으면 readtable
은 변수 개수를 자동으로 감지합니다.
변수 이름의 위치로, 음이 아닌 정수로 지정됩니다.
VariableNamesLine
이 0
이면 readtable
은 변수 이름을 가져오지 않습니다. 그렇지 않은 경우, readtable
은 지정된 라인에서 변수 이름을 가져옵니다.
변수 이름이 존재하고 VariableNamesLine
과 ReadVariableNames
가 모두 지정되지 않은 경우, readtable
은 변수 이름이 포함된 라인을 감지하여 변수 이름를 가져옵니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
변수 이름의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 양의 정수로 지정됩니다.
VariableNamesRange 를 지정하는 방법 | 설명 |
---|---|
시작 셀 | A1 표기법을 사용하여, 변수 이름의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다. 예: |
사각 범위 |
범위는 한 행으로만 이루어져야 합니다. 예: |
숫자 인덱스 | 양의 행 인덱스를 사용하여 변수 이름을 포함하는 행을 지정합니다. 예: |
행 범위 |
변수 이름은 하나의 행에 있어야 합니다. 예: |
지정되지 않거나 비어 있음 | 변수 이름이 없음을 나타냅니다. 예: |
데이터형: string
| char
| single
| double
변수 이름의 위치로, 음이 아닌 정수로 지정됩니다.
VariableNamesRow
가 0
이면 readtable
은 변수 이름을 가져오지 않습니다. 그렇지 않은 경우, readtable
은 지정된 행에서 변수 이름을 가져옵니다.
VariableNamesRow
를 지정하지 않은 경우 ReadVariableNames
가 true
(디폴트 값)이면 readtable
은 변수 이름을 가져옵니다. 둘 다 지정되지 않은 경우 readtable은 행에 가져올 변수 이름이 포함되어 있는지 감지합니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
테이블 변수로 읽을 XML 노드의 이름으로, string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 중첩 노드가 동일한 이름을 가지면 VariableNodeNames
는 최상위 수준의 노드를 선택합니다.
예: ["XMLNodeName1","XMLNodeName2"]
읽을 변수에 대한 XPath 표현식으로, string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 VariableSelectors
를 지정해야 합니다.
XPath 표현식을 사용하여 XML 입력 파일의 어느 요소를 가져올지 지정합니다. 예를 들어, 다음 구조를 갖는 XML 파일 myFile.xml
을 가져오고자 한다고 가정하겠습니다.
<data> <table category="ones"> <var>1</var> <var>2</var> </table> <table category="tens"> <var>10</var> <var>20</var> </table> </data>
선택 작업 | 구문 | 예 |
---|---|---|
문서에서의 위치에 관계없이 선택하려는 노드와 이름이 일치하는 모든 노드를 선택합니다. | 이름 앞에 두 개의 슬래시(// )를 붙입니다. | 이름이 T = readtable("myFile.xml",VariableSelectors="//var") |
요소 노드에 속한 특성 값을 선택합니다. | 특성 앞에 골뱅이 기호(@ )를 붙입니다. |
T = readtable("myFile.xml",VariableSelectors="//table/@category") |
노드 세트에서 특정 노드를 선택합니다. | 대괄호([] ) 안에 선택하고자 하는 노드 인덱스를 제공합니다. | 각 T = readtable("myFile.xml",VariableSelectors="//table/var[1]") |
연산 우선 순위를 지정합니다. | 먼저 평가할 표현식을 괄호로 묶습니다. | 각 T = readtable("myFile.xml",VariableSelectors="//table/var[1]") |
첫 번째 T = readtable("myFile.xml",VariableSelectors="(//table/var)[1]") |
이 이름-값 인수를 지정하지 않으면 readtable은 변수의 위치를 감지합니다.
데이터를 결합할지 여부로, 숫자형 값 또는 논리값 1
(true
) 또는 0
(false
)으로 지정됩니다. CollectOutput
이 true
인 경우 readtable
은 동일한 MATLAB 기본 클래스의 연속된 출력 셀들을 하나의 배열로 결합합니다.
행
첫 번째 열을 행 이름으로 읽을지 여부로, 숫자형 값 또는 논리값 1
(true
) 또는 0
(false
)으로 지정됩니다.
값 | 설명 |
---|---|
| 읽을 영역의 첫 번째 열에서 행 이름을 읽어 들입니다. import options 객체 |
| 영역의 첫 번째 열에서 데이터를 읽어 들이지만 행 이름을 만들지는 않습니다. |
ReadVariableNames
와 ReadRowNames
가 모두 true
인 경우, readtable
은 읽을 영역의 첫 번째 행의 첫 번째 열에 있는 이름을 속성 T.Properties.DimensionNames
의 첫 번째 차원 이름으로 저장합니다.
행 이름의 위치로, 음이 아닌 정수로 지정됩니다.
RowNamesColumn
이 0
이면 readtable
은 행 이름을 가져오지 않습니다. 그렇지 않은 경우, readtable
은 지정된 열에서 행 이름을 가져옵니다.
RowNamesColumn
을 지정하지 않은 경우 ReadRowNames
가 true
이면 readtable
은 첫 번째 열을 행 이름으로 가져옵니다.
행 이름의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 양의 정수로 지정됩니다.
RowNamesRange 를 지정하는 방법 | 설명 |
---|---|
시작 셀 | A1 표기법을 사용하여, 행 이름의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다.
예: |
사각 범위 |
행 개수는 데이터의 행 개수와 일치해야 하고, 범위는 한 열로만 이루어져야 합니다. 예: |
열 범위 |
행 이름은 하나의 열에 있어야 합니다. 예: |
숫자 인덱스 | 양의 열 인덱스를 사용하여 행 이름을 포함하는 열을 지정합니다. 예: |
지정되지 않거나 비어 있음 | 행 이름이 없음을 나타냅니다. 예: |
데이터형: string
| char
| single
| double
행 이름에 대한 XPath 표현식으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 RowNamesSelector
를 지정해야 합니다.
이 이름-값 인수를 지정하지 않으면 readtable은 행 이름을 가져오지 않습니다.
예: "/RootNode/ChildNode"
테이블에서 개별 행을 선택하기 위한 XPath 표현식으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 RowSelector
를 지정해야 합니다.
이 이름-값 인수를 지정하지 않으면 readtable은 행의 위치를 감지합니다.
예: "/RootNode/ChildNode"
행을 지정하는 XML 노드로, string형 스칼라 또는 문자형 벡터로 지정됩니다.
데이터형
가져오는 텍스트 데이터의 유형으로, 다음 값 중 하나로 지정됩니다.
"char"
— 텍스트 데이터를 문자형 벡터로 가져옵니다. 이 값은 텍스트 파일과 스프레드시트 파일에 대한 디폴트 값입니다."string"
— 텍스트 데이터를 string형 배열로 가져옵니다. 이 값은 XML, Microsoft Word 및 HTML 파일에 대한 디폴트 값입니다.
가져오는 날짜/시간 데이터의 유형으로, 다음 표에 있는 값 중 하나로 지정됩니다.
값 | 결과 데이터형 |
---|---|
"datetime" | MATLAB |
"text" | 데이터형은
|
"exceldatenum" | Excel 날짜 일련 번호 값 이 값은 스프레드시트 파일에만 유효합니다. 날짜 일련 번호 값은 주어진 기준 날짜로부터의 일수로, 단일 숫자입니다. Excel 날짜 일련 번호 값은 MATLAB 날짜 일련 번호 값과는 다른 기준 날짜를 사용합니다. Excel 날짜에 대한 자세한 내용은 Differences between the 1900 and the 1904 date system in Excel을 참조하십시오. |
가져오는 지속 시간 데이터의 유형으로, 다음 표에 있는 값 중 하나로 지정됩니다.
값 | 결과 데이터형 |
---|---|
"duration" | MATLAB |
"text" | 데이터형은
|
가져오는 16진수 데이터의 유형으로, 다음 표에 있는 값 중 하나로 지정됩니다.
값 | 결과 데이터형 |
---|---|
| 감지된 데이터형으로, |
| 변경되지 않은 입력 텍스트 |
| 8비트 정수, 부호 있음 |
| 16비트 정수, 부호 있음 |
| 32비트 정수, 부호 있음 |
| 64비트 정수, 부호 있음 |
| 8비트 정수, 부호 없음 |
| 16비트 정수, 부호 없음 |
| 32비트 정수, 부호 없음 |
| 64비트 정수, 부호 없음 |
입력 파일은 0x
또는 0X
를 접두사로 사용하고 문자 0
-9
, a
-f
, A
-F
를 숫자로 사용하여 16진수 값을 텍스트로 나타낼 수 있습니다. 대문자와 소문자는 동일한 숫자를 나타냅니다. 예를 들어 "0xf"
와 "0xF"
는 모두 15를 나타냅니다.
가져오는 이진 데이터의 유형으로, 다음 표에 있는 값 중 하나로 지정됩니다.
값 | 결과 데이터형 |
---|---|
| 감지된 데이터형으로, |
| 변경되지 않은 입력 텍스트 |
| 8비트 정수, 부호 있음 |
| 16비트 정수, 부호 있음 |
| 32비트 정수, 부호 있음 |
| 64비트 정수, 부호 있음 |
| 8비트 정수, 부호 없음 |
| 16비트 정수, 부호 없음 |
| 32비트 정수, 부호 없음 |
| 64비트 정수, 부호 없음 |
입력 파일은 0b
또는 0B
를 접두사로 사용하고 문자 0
및 1
을 숫자로 사용하여 이진 값을 텍스트로 나타낼 수 있습니다. 예를 들어, 0b11111111
은 255를 나타냅니다.
날짜 읽기에 적용할 로캘로,
형식의 string형 스칼라 또는 문자형 벡터로 지정됩니다. 여기서,xx
_YY
xx
는 언어를 지정하는 ISO 639-1 두 자리 코드(소문자)입니다.YY
는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다.
readtable
이 어떤 로캘을 사용해 월 이름, 요일 이름, 약어를 해석할지 지정하려면 DateLocale
을 사용하십시오.
다음 표에는 로캘에 일반적으로 사용되는 일부 값이 나와 있습니다.
로캘 | 언어 | 국가 |
---|---|---|
"de_DE" | 독일어 | 독일 |
"en_GB" | 영어 | 영국 |
"en_US" | 영어 | 미국 |
"es_ES" | 스페인어 | 스페인 |
"fr_FR" | 프랑스어 | 프랑스 |
"it_IT" | 이탈리아어 | 이탈리아 |
"ja_JP" | 일본어 | 일본 |
"ko_KR" | 한국어 | 한국 |
"nl_NL" | 네덜란드어 | 네덜란드 |
"zh_CN" | 중국어(간체) | 중국 |
import options 객체 opts
와 함께 DateLocale
인수를 지정하면 인수 값은 가져오기 옵션에 정의된 로캘을 무시합니다.
숫자형 변수에서 숫자형이 아닌 문자를 제거할지 여부로, 숫자형 값 또는 논리값 1
(true
) 또는 0
(false
)으로 지정됩니다. 예를 들어, TrimNonNumeric
이 true
인 경우 readtable
은 "$500/-"
을 500
으로 읽습니다.
숫자형 변수의 소수점 구분 기호 문자로, string형 스칼라 또는 단일 문자로 구성된 문자형 벡터로 지정됩니다. 구분 기호 문자는 숫자의 정수부와 소수부를 구별합니다. 예를 들어, 구분 기호가 ","
이면 readtable
은 텍스트 "3,14159"
를 숫자 3.14159
로 가져옵니다.
정수 데이터형으로 변환할 때 readtable
은 소수부 숫자를 가장 가까운 정수로 반올림합니다. DecimalSeparator
는 숫자를 값으로 허용하지 않습니다.
숫자형 변수의 천 단위 구분 문자로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 이 구분 문자는 매 세 자리값에서 숫자를 분류하는 시각적 구분 기호로 동작합니다. 예를 들어, 구분 문자가 ","
이면 readtable
은 텍스트 "1,234,000"
을 1234000
으로 가져옵니다.
지수 문자로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 디폴트 지수 문자는 e
, E
, d
, D
입니다.
예: "eE"
데이터 정리
누락값으로 처리할 자리 표시자 텍스트로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. readtable
은 이 자리 표시자 텍스트에 해당하는 테이블 요소를 해당 요소의 데이터형에 따른 누락값으로 가져옵니다.
예: "N/A"
예: [".","NA","N/A"]
가져오기 오류에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다. readtable
이 텍스트 요소를 예상했던 데이터형으로 변환할 수 없는 경우 가져오기 오류가 발생합니다.
가져오기 오류 규칙 | 동작 |
---|---|
"fill" | 오류가 발생한 데이터를 가져올 변수의 |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
"omitrow" | 오류가 발생한 행을 생략합니다. |
"omitvar" | 오류가 발생한 변수를 생략합니다. |
누락된 데이터에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
누락 규칙 | 동작 |
---|---|
"fill" | 누락된 데이터를 가져올 변수의 |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
"omitrow" | 누락된 데이터가 포함된 행을 생략합니다. |
"omitvar" | 누락된 데이터가 포함된 변수를 생략합니다. |
텍스트 파일의 경우, 예상한 필드가 행에 없으면 데이터가 누락된 것입니다. 필드가 누락되면 행의 후속 요소에 의해 필드가 앞으로 밀리게 되며, 누락된 필드는 행의 끝부분에서 해석됩니다.
스프레드시트 파일의 경우, 행의 예상되는 필드에 데이터가 없고 필드 유형이 공백이거나 비어 있으면 데이터가 누락된 것입니다.
XML 파일의 경우, 예상했던 노드가 없으면 데이터가 누락된 것입니다.
Microsoft Word 파일의 경우, 예상한 필드가 행에 없으면 데이터가 누락된 것입니다.
HTML 파일의 경우, 예상한 필드가 행에 없으면 데이터가 누락된 것입니다.
데이터의 추가 열에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다. 하나의 행에 예상 개수보다 많은 열이 있는 경우 readtable
은 해당 열을 추가 열로 간주합니다.
추가 열 규칙 | 동작 |
---|---|
"addvars" | 추가 열을 가져오기 위해 새 변수를 생성합니다.
|
"ignore" | 데이터의 추가 열을 무시합니다. |
"wrap" | 새 레코드로 데이터의 추가 열을 줄 바꿈합니다. 이 동작을 수행해도 변수의 개수는 변경되지 않습니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
구분된 텍스트 파일의 빈 숫자형 필드에 대해 반환된 값으로, NaN
또는 숫자형 스칼라로 지정됩니다.
예: 0
데이터의 빈 라인에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다. 라인에 공백 문자만 포함된 경우 readtable
은 해당 라인이 비어 있는 것으로 간주합니다.
빈 라인 규칙 | 동작 |
---|---|
"skip" | 빈 라인을 건너뜁니다. |
"read" | 빈 라인을 가져옵니다. readtable 은 VariableWidths , VariableOptions , MissingRule 과 기타 관련 인수(예: Whitespace )에 지정된 값을 사용하여 빈 라인을 구문 분석합니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
데이터의 빈 행에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
빈 라인 규칙 | 동작 |
---|---|
"skip" | 빈 행을 건너뜁니다. |
"read" | 빈 행을 가져옵니다. readtable 은 VariableWidths , VariableOptions , MissingRule 과 기타 관련 인수(예: Whitespace )에 지정된 값을 사용하여 빈 행을 구문 분석합니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
데이터의 빈 열에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
빈 열 규칙 | 동작 |
---|---|
"skip" | 빈 열을 건너뜁니다. |
"read" | 빈 열을 가져옵니다. readtable 은 VariableWidths , VariableOptions , MissingRule 과 기타 관련 인수(예: Whitespace )에 지정된 값을 사용하여 빈 열을 구문 분석합니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
데이터의 부분 필드에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다. 라인의 끝에 도달했을 때 필드가 예상된 너비보다 문자가 적은 경우 readtable
은 해당 필드가 부분적으로 채워진 것으로 간주합니다. 이 이름-값 인수는 고정 너비를 갖는 필드에만 적용됩니다.
부분 필드 규칙 | 동작 |
---|---|
"keep" | 부분 필드 데이터를 유지하고 텍스트를 적절한 데이터형으로 변환합니다.
|
"fill" | 누락된 데이터를 가져올 변수의 |
"omitrow" | 부분 데이터가 들어 있는 행을 생략합니다. |
"omitvar" | 부분 데이터가 들어 있는 변수를 생략합니다. |
"wrap" | 다음 문자 라인을 읽습니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
파일 정보
파일 형식으로, 다음 표에 있는 값 중 하나로 지정됩니다.
값 | 파일 형식 |
---|---|
"spreadsheet" | 스프레드시트 파일 |
"text" | 텍스트 파일 |
"delimitedtext" | 구분된 텍스트 파일 |
"fixedwidth" | 고정 너비 텍스트 파일 |
"xml" | XML 파일 |
"worddocument" | Microsoft Word 문서 |
"html" | HTML 파일 |
filename
에 파일 확장자가 포함되어 있지 않거나 확장자가 다음 목록에 없는 경우 다음 이름-값 인수를 지정하십시오.
.txt
,.dat
,.csv
- 텍스트 파일.xls
,.xlsb
,.xlsm
,.xlsx
,.xltm
,.xltx
,.ods
- 스프레드시트 파일.xml
- XML 파일.docx
- Microsoft Word 문서.html
,.xhtml
또는.htm
- HTML 파일
파일과 연결된 문자 인코딩 체계로, "system"
또는 표준 문자 인코딩 체계 이름으로 지정됩니다. 인코딩을 지정하지 않은 경우 readtable
함수는 자동 문자 집합 감지를 사용하여 파일을 읽을 때 사용할 인코딩을 결정합니다.
import options 객체 opts
와 함께 Encoding
인수를 지정하면 인수 값은 가져오기 옵션에 정의된 인코딩을 무시합니다.
스프레드시트 데이터를 읽을 때 Windows용 Microsoft Excel을 시작할지 여부로, 숫자형 값 또는 논리값 1
(true
) 또는 0
(false
)으로 지정됩니다.
이 인수에 따라 readtable
은 다양한 파일 형식과 대화형 기능(예: 수식 및 매크로)을 지원합니다.
지원 |
|
|
---|---|---|
지원되는 파일 형식 |
|
|
수식이나 매크로 같은 대화형 기능 지원 | 예 | 아니요 |
비대화형 방식의 자동화 환경에서는 UseExcel
이 지원되지 않습니다.
R2022a 이후
HTTP
또는 HTTPS
요청 옵션으로, weboptions
객체로 지정됩니다. weboptions
객체는 지정된 filename
이 프로토콜 유형 "http://"
또는 "https://"
를 포함하는 인터넷 URL일 때 데이터를 어떻게 가져올지를 결정합니다.
텍스트 구문 분석
필드 구분 기호 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 쉼표 ","
또는 마침표 "."
같은 유효한 문자로 Delimiter
를 지정합니다.
아래 표에는 일반적으로 사용되는 필드 구분 기호 문자가 일부 나열되어 있습니다.
지정자 | 필드 구분 기호 |
---|---|
| 쉼표 |
| 공백 |
| 탭 |
| 세미콜론 |
| 세로 막대 |
지정되지 않음 | 이 이름-값 인수를 지정하지 않으면 |
여러 문자를 단일 구분 기호로 처리하려면 Delimiter
를 string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정하십시오. 알 수 없는 개수의 연속된 구분 기호를 하나로 처리하려면 ConsecutiveDelimitersRule="join"
을 지정하십시오.
Delimiter
는 구분된 텍스트 파일에만 유효하며 고정 너비 텍스트 파일에는 유효하지 않습니다.
라인 끝(EOL) 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 일반적인 라인 끝(EOL) 문자로는 새 줄(Newline) 문자("\n"
)와 캐리지 리턴("\r"
)이 있습니다. "\r\n"
을 지정할 경우 readtable
은 이 둘의 조합(\r\n
)을 라인 끝(EOL) 문자로 취급합니다. {"\r\n", "\r", "\n"}
을 지정할 경우 \r
, \n
, \r\n
은 모두 라인 끝(EOL) 문자로 취급됩니다.
디폴트 라인 끝(EOL) 시퀀스는 파일의 내용에 따라 \n
, \r
, \r\n
중 하나입니다.
공백으로 처리할 문자로, 하나 이상의 문자를 포함하는 string형 스칼라 또는 문자형 벡터로 지정됩니다.
다음 표에는 일반 텍스트를 사용하여 입력할 수 없는 특수 문자를 표현하는 방법이 나와 있습니다.
특수 문자 | 표현 |
---|---|
백분율 |
|
백슬래시 |
|
경보 |
|
백스페이스 |
|
폼 피드(FF) |
|
새 줄(Newline) |
|
캐리지 리턴 |
|
가로 탭 |
|
세로 탭 |
|
그 Unicode® 숫자형 값을 16진수 |
|
그 Unicode 숫자형 값을 8진수 |
|
예: " _"
예: "?!.,"
무시할 텍스트에 대한 주석 표시자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.
예를 들어, "%"
와 같은 문자를 지정하여 동일한 라인에서 그 문자 다음의 텍스트를 무시할 수 있습니다. ["/*","*/"]
와 같은 string형 배열을 지정하여 시퀀스 사이의 모든 텍스트를 무시할 수 있습니다.
readtable
은 라인 내부가 아니라 각 라인의 시작 부분에서만 주석을 확인합니다.
예: ["/*","*/"]
구분된 텍스트 파일의 선행 구분 기호에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
규칙 | 동작 |
---|---|
"keep" | 구분 기호를 유지합니다. |
"ignore" | 구분 기호를 무시합니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
구분된 텍스트 파일의 후행 구분 기호에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
규칙 | 동작 |
---|---|
"keep" | 구분 기호를 유지합니다. |
"ignore" | 구분 기호를 무시합니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
구분된 텍스트 파일의 연속된 구분 기호에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
규칙 | 동작 |
---|---|
"split" | 연속된 구분 기호를 여러 개의 필드로 분할합니다. |
"join" | 여러 구분 기호를 하나의 구분 기호로 결합합니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
여러 구분 기호를 하나로 처리할지 여부로, 숫자형 값 또는 논리값 1
(true
) 또는 0
(false
)으로 지정됩니다.
고정 너비 텍스트 파일의 변수 필드 너비로, 양의 정수로 구성된 벡터로 지정됩니다. 각각의 정수는 변수를 만드는 필드의 문자 수에 해당합니다.
예: [10,7,4,26,7]
파일의 열 형식으로, 하나 이상의 변환 지정자를 포함하는 string형 스칼라나 문자형 벡터 또는 "auto"
로 지정됩니다. 변환 지정자는 textscan
함수가 허용하는 지정자와 동일합니다.
일부 대용량 파일의 경우 형식을 지정하면 가져오는 속도를 확실하게 개선할 수 있습니다.
Format
을 지정하지 않으면 detectImportOptions
함수의 결과를 사용하여 데이터를 가져온 것처럼 readtable
이 동작합니다. 이 동작의 결과에 대한 자세한 내용은 R2020a 버전 내역 정보를 참조하십시오.
Format
을 "auto"
로 지정한 경우 생성되는 변수는 데이터에 따라 double
형 배열, 문자형 벡터로 구성된 셀형 배열 또는 datetime
형 배열입니다. 전체 열이 숫자형인 경우 결과 변수는 double
형입니다. 열에 숫자형이 아닌 요소가 있는 경우 결과 변수는 문자형 벡터로 구성된 셀형 배열이거나 값이 날짜/시간을 나타내는 경우 datetime
형 배열입니다.
XML 구문 분석
XML 특성을 출력 테이블의 변수로 가져올지 여부로, 숫자형 값 또는 논리값 1
(true
) 또는 0
(false
)으로 지정됩니다. 기본적으로 readtable
은 XML 특성을 출력 테이블의 변수로 가져옵니다.
특성과 출력 테이블의 요소를 구분하는 데 사용되는 접미사로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 이 인수는 readtable
이 입력 XML 파일의 특성에 대응하는 모든 테이블 변수에 추가하는 접미사를 지정합니다. AttributeSuffix
를 지정하지 않으면 readtable
은 입력 XML 파일의 특성에 대응하는 모든 변수 이름에 접미사 "Attribute"
를 추가합니다.
예: "_att"
테이블의 주어진 행에서 반복되는 XML 노드에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.
규칙 | 동작 |
---|---|
"addcol" | 변수에서 반복되는 각 노드에 대해 열을 추가하여 연관된 변수에 행렬을 만듭니다. 예를 들면 다음과 같습니다. 입력 데이터 <table> <row> <Var1>1</Var1> <Var2>2</Var2> <Var3>3</Var3> <Var1>11</Var1> <Var1>111</Var1> </row> <row> <Var1>4</Var1> <Var2>5</Var2> <Var3>6</Var3> </row> <row> <Var1>7</Var1> <Var2>8</Var2> <Var3>9</Var3> </row> </table> 출력 테이블 Var1 Var2 Var3 _______________ ____ ____ 1 11 111 2 3 4 NaN NaN 5 6 7 NaN NaN 8 9 |
"ignore" | 반복되는 노드를 건너뜁니다. |
"error" | 오류 메시지를 표시하고 가져오기 작업을 취소합니다. |
등록된 XML 네임스페이스 접두사 집합으로, 접두사 및 관련 URL로 구성된 N
×2 string형 배열로 지정됩니다. readtable
은 XML 파일에서 XPath 표현식을 실행할 때 이러한 접두사를 사용합니다.
VariableSelectors
와 같이 선택자 이름-값 인수로 지정된 XPath 표현식을 실행할 때 RegisteredNamespaces
를 사용할 수 있습니다.
기본적으로 readtable
은 XPath 실행에 사용할 네임스페이스 접두사를 자동으로 감지합니다. 선언되지 않은 네임스페이스 접두사를 갖는 XML 노드를 선택하려면 RegisteredNamespaces
이름-값 인수를 사용하여 네임스페이스 접두사에 대한 사용자 지정 네임스페이스 URL을 등록하십시오. 예를 들어, 네임스페이스 접두사가 포함되지 않은 XML 파일에서 URL https://www.mathworks.com
에 접두사 myprefix
를 할당해 보겠습니다.
T = readtable(filename,VariableSelectors="/myprefix:Data", ... RegisteredNamespaces=["myprefix","https://www.mathworks.com"])
변수 메타데이터
변수 단위의 위치로, 음이 아닌 정수로 지정됩니다.
VariableUnitsLine
이 0
이면 readtable
은 변수 단위를 가져오지 않습니다. 그렇지 않은 경우, readtable
은 지정된 라인에서 변수 단위를 가져옵니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
변수 단위의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 양의 정수로 지정됩니다.
VariableUnitsRange 를 지정하는 방법 | 설명 |
---|---|
시작 셀 | A1 표기법을 사용하여, 변수 단의의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다.
예: |
사각 범위 |
범위는 한 행으로만 이루어져야 합니다. 예: |
숫자 인덱스 | 양의 행 인덱스를 사용하여 변수 단위를 포함하는 행을 지정합니다. 예: |
행 범위 |
변수 단위는 하나의 행에 있어야 합니다. 예: |
지정되지 않거나 비어 있음 | 변수 단위가 없음을 나타냅니다. 예: |
데이터형: string
| char
| single
| double
변수 단위의 위치로, 음이 아닌 정수로 지정됩니다.
VariableUnitsRow
가 0
이면 readtable
은 변수 단위를 가져오지 않습니다. 그렇지 않은 경우, readtable
은 지정된 행에서 변수 단위를 가져옵니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
변수 단위에 대한 XPath 표현식으로, readtable
이 테이블 변수 단위를 선택하는 데 사용하는 string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 VariableUnitsSelector
를 지정해야 합니다.
이 이름-값 인수를 지정하지 않으면 readtable은 변수 단위를 가져오지 않습니다.
예: "/RootNode/ChildNode"
예: "//table[1]/units/"
변수 설명의 위치로, 음이 아닌 정수로 지정됩니다.
VariableDescriptionsLine
이 0
이면 readtable
은 변수 설명을 가져오지 않습니다. 그렇지 않은 경우, readtable
은 지정된 라인에서 변수 설명을 가져옵니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
변수 설명의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 양의 정수로 지정됩니다.
VariableDescriptionsRange 를 지정하는 방법 | 설명 |
---|---|
시작 셀 | A1 표기법을 사용하여, 변수 설명의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다.
예: |
사각 범위 |
범위는 한 행으로만 이루어져야 합니다. 예: |
행 범위 |
변수 설명은 하나의 행에 있어야 합니다. 예: |
숫자 인덱스 | 양의 행 인덱스를 사용하여 설명을 포함하는 행을 지정합니다. 예: |
지정되지 않거나 비어 있음 | 변수 설명이 없음을 나타냅니다. 예: |
데이터형: string
| char
| single
| double
변수 설명의 위치로, 음이 아닌 정수로 지정됩니다.
VariableDescriptionsRow
가 0
이면 readtable
은 변수 설명을 가져오지 않습니다. 그렇지 않은 경우, readtable
은 지정된 행에서 변수 설명을 가져옵니다.
데이터형: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
변수 설명에 대한 XPath 표현식으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 VariableDescriptionsSelector
를 지정해야 합니다.
이 이름-값 인수를 지정하지 않으면 readtable은 변수 설명을 가져오지 않습니다.
예: "/RootNode/RowNode/@Name"
예: "//table[1]/descriptions/*"
출력 인수
확장 기능
사용법 관련 참고 및 제한 사항:
텍스트 및 스프레드시트 파일 워크플로는 스레드 기반 환경에서 지원됩니다.
버전 내역
R2013b에 개발됨압축된 파일과 아카이브된 파일에서 데이터를 테이블로 읽어올 수 있습니다.
스프레드시트에서 데이터를 가져올 때 readtable
이 MergedCellRowRule
및 MergedCellColumnRule
이름-값 인수를 사용하여 여러 행과 열을 병합한 셀을 가져오는 방법을 지정할 수 있습니다.
HTML 파일 및 Microsoft Word 파일의 가져오기 옵션을 사용자 지정하려면 각각 htmlImportOptions
및 wordDocumentImportOptions
를 사용하십시오. 파일에서 가져오기 옵션을 자동으로 감지하려면 detectImportOptions
함수를 사용하십시오.
가져오기 동작을 제어하려면 선택적 이름-값 인수를 사용하여 XML 데이터를 테이블로 읽어옵니다. 예를 들어, 특성 노드를 무시하려면 ImportAttributes
를 false
로 설정하십시오.
또한 인터넷 URL에서 지원되는 모든 파일 형식을 읽어올 수 있습니다. 프로토콜 유형 http://
또는 https://
를 포함하는 string형으로 파일 이름을 지정하십시오.
PreserveVariableNames
인수는 권장되지 않습니다. VariableNamingRule
을 대신 사용하십시오. 다음 값 중 하나를 지정하십시오.
'preserve'
는 변수 이름의 공백과 비ASCII 문자를 유지합니다. R2019b부터 테이블은 이러한 문자가 있는 변수 이름을 지원합니다.'modify'
는 공백과 비ASCII 문자가 포함된 텍스트를 유효한 MATLAB 식별자로 변환합니다.
PreserveVariableNames
에 대한 지원을 제거할 계획은 없습니다.
기본적으로 readtable
함수는 detectImportOptions
함수의 결과를 사용하여 테이블 형식 데이터를 가져옵니다. 본질적으로 이 두 함수를 호출하면 동일하게 동작합니다.
T = readtable(filename) T = readtable(filename,detectImportOptions(filename))
이 변경으로 인해 여러 동작 차이가 발생합니다.
입력값에 대한 설명 | 새 디폴트 동작 | 이전 디폴트 동작 |
---|---|---|
첫 번째 행에 출력 테이블 변수의 이름으로 할당할 텍스트가 없는 경우 |
| 데이터 값의 첫 번째 행에 있는 값을 출력 테이블 변수의 이름으로 변환합니다. |
제목 라인에 복수 행의 텍스트가 포함된 경우 |
|
|
필드가 비어 있는 경우 | 감지된 데이터형의 누락값으로 처리합니다. | 빈 문자형 벡터 또는 string형으로 처리합니다. |
값이 따옴표로 묶인 경우 | 감지된 데이터형으로 처리합니다. | 텍스트로 처리합니다. |
텍스트를 변환할 수 없는 경우 | 감지된 데이터형의 누락값으로 처리합니다. | 텍스트로 처리합니다. |
숫자형 문자 뒤에 구분 기호 없이 숫자형이 아닌 문자가 오는 경우 | 숫자형이 아닌 문자로 처리합니다. | 숫자형 문자와 숫자형이 아닌 문자를 구분 기호로 분리한 것처럼 처리합니다. |
입력 텍스트 파일에 구분 기호 개수가 다른 라인이 있는 경우 | 추가 변수를 사용하여 출력 테이블을 반환합니다. | 오류 메시지를 표시합니다. |
이전 동작을 복원하려면 Format
을 "auto"
로 설정하십시오.
T = readtable(filename,Format="auto")
문자 '0x'
가 접두사로 추가된 텍스트는 이제 16진수 데이터로 처리되고, '0b'
가 접두사로 추가된 텍스트는 2진수 데이터로 처리됩니다.
또한, readtable
은 이제 텍스트 데이터를 읽을 때 문자 집합을 자동으로 감지합니다.
Excel이 설치된 Windows 시스템에서 UseExcel
의 디폴트 설정은 false
입니다. 이전 동작을 유지하려면 UseExcel
을 true
로 설정하십시오.
T = readtable(filename,UseExcel=true)
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
웹사이트 선택
번역된 콘텐츠를 보고 지역별 이벤트와 혜택을 살펴보려면 웹사이트를 선택하십시오. 현재 계신 지역에 따라 다음 웹사이트를 권장합니다:
또한 다음 목록에서 웹사이트를 선택하실 수도 있습니다.
사이트 성능 최적화 방법
최고의 사이트 성능을 위해 중국 사이트(중국어 또는 영어)를 선택하십시오. 현재 계신 지역에서는 다른 국가의 MathWorks 사이트 방문이 최적화되지 않았습니다.
미주
- América Latina (Español)
- Canada (English)
- United States (English)
유럽
- 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)