이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.
파일에서 테이블 만들기
은 파일에서 열 방향 데이터를 읽어 테이블을 만듭니다.T
= readtable(filename
)
readtable
은 다음과 같은 파일 확장자에서 파일 형식을 결정합니다.
.txt
, .dat
, .csv
- 기호로 구분된 텍스트 파일
.xls
, .xlsb
, .xlsm
, .xlsx
, .xltm
, .xltx
, .ods
- 스프레드시트 파일
readtable
은 파일의 각 열별로 변수를 하나씩 T
에 만들고, 그 변수 이름은 파일의 첫 번째 행에서 읽어 들입니다. 기본적으로, 생성된 변수는 전체 열이 숫자인 경우 double
형이 되고, 숫자가 아닌 요소가 열에 있는 경우 문자형 벡터로 구성된 셀형 배열이 됩니다.
는 하나 이상의 이름-값 쌍의 인수를 추가 옵션으로 지정하여 파일에서 테이블을 만듭니다. 예를 들어, T
= readtable(___,Name,Value
)readtable
이 파일의 첫 번째 행을 변수 이름으로 읽을지 또는 데이터로 읽을지 여부를 지정할 수 있습니다.
데이터에 대한 특정 가져오기 옵션을 설정하기 위해 opts
객체를 사용하거나 이름-값 쌍을 지정할 수 있습니다. opts
에 더해 이름-값 쌍을 지정하는 경우, readtable
은 다음과 같은 이름-값 쌍만 지원합니다.
텍스트 및 스프레드시트 파라미터 — ReadVariableNames
, ReadRowNames
텍스트 전용 파라미터 — DateLocale
, Encoding
스프레드시트 전용 파라미터 — Sheet
, UseExcel
파일 myCsvTable.dat
를 불러오고 텍스트 편집기에서 파일 내용을 미리 봅니다. 아래에 스크린샷이 나와 있습니다. 파일에 쉼표로 구분된 열 방향 데이터가 포함되어 있음을 알 수 있습니다.
filename = fullfile(matlabroot,'examples','matlab','myCsvTable.dat');
쉼표로 구분된 텍스트 파일에서 테이블을 생성합니다. 생성되는 테이블 T
에 파일의 각 열별로 변수가 하나씩 포함되고 readtable
은 파일의 첫 번째 라인에 있는 항목을 변수 이름으로 취급합니다.
T = readtable(filename)
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
파일 mySpaceDelimTable.txt
를 불러오고 텍스트 편집기에서 파일 내용을 미리 봅니다. 아래에 스크린샷이 나와 있습니다. 파일에 공백으로 구분된 열 방향 데이터가 포함되어 있음을 알 수 있습니다.
filename = fullfile(matlabroot,'examples','matlab','mySpaceDelimTable.txt');
변수 이름을 열 제목으로 포함하지 않은 공백으로 구분된 텍스트 파일에서 테이블을 만듭니다.
T = readtable(filename,... 'Delimiter',' ','ReadVariableNames',false)
T=3×5 table
Var1 Var2 Var3 Var4 Var5
____ ____ ____ ____ _______
'M' 45 45 'NY' 'true'
'F' 41 32 'CA' 'false'
'M' 40 34 'MA' 'false'
T
에는 디폴트 변수 이름이 포함되어 있습니다.
파일 myCsvTable.dat
를 불러오고 텍스트 편집기에서 파일 내용을 미리 봅니다. 아래에 스크린샷이 나와 있습니다. 파일에 쉼표로 구분된 열 방향 데이터가 포함되어 있음을 알 수 있습니다.
filename = fullfile(matlabroot,'examples','matlab','myCsvTable.dat');
쉼표로 구분된 텍스트 파일에서 테이블을 생성합니다. 처음 두 열을 문자형 벡터로 가져오고 세 번째 열을 uint32
로, 그 다음의 두 열을 배정밀도 부동소수점 숫자로 가져옵니다. 마지막 열의 항목은 문자형 벡터로 가져옵니다.
T = readtable(filename,'Format','%s%s%u%f%f%s')
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'
변환 지정자는 문자형 벡터로 구성된 셀형 배열의 경우 %s
이고, double
형의 경우 %f
이며, uint32
형의 경우 %u
입니다.
파일에서 독일식 날짜를 읽고 테이블에 영어권 국가의 날짜로 추가합니다.
파일 german_dates.txt
를 불러오고 텍스트 편집기에서 파일 내용을 미리 봅니다. 아래에 스크린샷이 나와 있습니다. 값의 첫 번째 열에는 독일식 날짜가 포함되어 있고 두 번째 및 세 번째 열에는 숫자형 값이 들어 있습니다.
filename = fullfile(matlabroot,'examples','matlab','german_dates.txt');
readtable
을 사용하여 샘플 파일을 읽습니다. 변환 지정자는 날짜의 경우 %D
이고 부동소수점 값의 경우 %f
입니다. FileEncoding
이름-값 쌍의 인수를 사용하여 파일 인코딩을 지정합니다. DateLocale
이름-값 쌍의 인수를 사용하여 날짜의 형식과 로케일을 지정합니다.
T = readtable(filename,'ReadVariableNames',false,... 'Format','%{dd MMMM yyyy}D %f %f',... 'FileEncoding','ISO-8859-15',... 'DateLocale','de_DE')
T=3×3 table
Var1 Var2 Var3
________________ ____ _____
01 January 2014 20.2 100.5
01 February 2014 21.6 102.7
01 March 2014 20.7 99.8
첫 번째 행에 변수 이름을 포함하고 첫 번째 열에 행 이름을 포함한 스프레드시트에서 테이블을 만듭니다.
T = readtable('patients.xls','ReadRowNames',true);
테이블에서 처음 5개 행과 처음 4개 변수를 표시합니다.
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
테이블의 DimensionNames
속성을 확인합니다.
T.Properties.DimensionNames
ans = 1x2 cell array
{'LastName'} {'Variables'}
'LastName'
은 스프레드시트의 첫 번째 행에 있는 첫 번째 열의 이름입니다.
스프레드시트 patients.xls
의 지정된 영역의 데이터를 사용하여 테이블을 만듭니다. 끝 지점 C2
와 E6
사이에 있는 5x3의 사각형 영역의 데이터를 사용합니다. 이 영역의 첫 번째 행을 변수 이름으로 사용하지 않습니다.
T = readtable('patients.xls',... 'Range','C2:E6',... 'ReadVariableNames',false)
T = 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
T
에는 디폴트 변수 이름이 포함되어 있습니다.
가져오기 옵션을 만들고 여러 변수의 데이터형을 조정한 후 데이터를 읽어 들입니다.
텍스트 파일에서 import options 객체를 만듭니다.
opts = detectImportOptions('airlinesmall.csv')
opts = DelimitedTextImportOptions with properties: Format Properties: Delimiter: {','} Whitespace: '\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' EmptyLineRule: 'skip' Encoding: 'UTF-8' 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 Location Properties: DataLines: [2 Inf] VariableNamesLine: 1 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0 To display a preview of the table, use preview
변수 TaxiIn
과 TaxiOut
의 Type
속성을 검토합니다.
getvaropts(opts,{'TaxiIn','TaxiOut'})
ans = 1x2 TextVariableImportOptions array with properties: Name Type FillValue TreatAsMissing QuoteRule Prefixes Suffixes EmptyFieldRule WhitespaceRule
변수 TaxiIn
과 TaxiOut
의 유형을 double
형으로 변경합니다.
opts = setvartype(opts,{'TaxiIn','TaxiOut'},'double');
가져와서 검토할 일부 변수를 지정합니다.
opts.SelectedVariableNames = {'TaxiIn','TaxiOut'};
options 객체와 함께 readtable
함수를 사용하여 선택한 변수를 가져옵니다. 테이블의 요약을 표시합니다.
T = readtable('airlinesmall.csv',opts);
summary(T)
Variables: TaxiIn: 123523x1 double Values: Min 0 Median 5 Max 1451 NumMissing 37383 TaxiOut: 123523x1 double Values: Min 0 Median 13 Max 755 NumMissing 37364
스프레드시트 파일에 대한 가져오기 옵션을 감지하고, 가져올 변수를 지정한 다음 데이터를 읽어 들입니다.
파일에서 import options 객체를 만듭니다.
opts = detectImportOptions('patients.xls')
opts = SpreadsheetImportOptions with properties: Sheet Properties: Sheet: '' Replacement Properties: MissingRule: 'fill' ImportErrorRule: 'fill' 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 Range Properties: DataRange: 'A2' (Start Cell) VariableNamesRange: 'A1' RowNamesRange: '' VariableUnitsRange: '' VariableDescriptionsRange: '' To display a preview of the table, use preview
options 객체를 수정하여 가져올 변수를 지정합니다.
opts.SelectedVariableNames = {'Systolic','Diastolic'};
options 객체와 함께 readtable
을 사용하여 지정된 변수를 가져옵니다.
T = readtable('patients.xls',opts);
summary(T)
Variables: Systolic: 100x1 double Values: Min 109 Median 122 Max 138 Diastolic: 100x1 double Values: Min 68 Median 81.5 Max 99
filename
— 읽을 파일의 이름읽을 파일의 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.
파일의 위치에 따라 filename
은 다음 형식 중 하나가 될 수 있습니다.
위치 | 형식 | ||||||||
---|---|---|---|---|---|---|---|---|---|
현재 폴더 또는 MATLAB® 경로의 폴더 |
예: | ||||||||
폴더 안의 파일 | 파일이 현재 폴더나 MATLAB 경로의 폴더에 없는 경우, 예: 예: | ||||||||
원격 위치 | 파일이 원격 위치에 저장된 경우,
원격 위치에 따라
자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오. 예: |
filename
에 파일 확장자가 포함되는 경우 가져오기 함수는 확장자를 통해 파일 형식을 결정하게 됩니다. 파일 형식을 따로 나타내고자 하면 'FileType'
이름-값 쌍의 인수를 지정해야 합니다.
Microsoft® Excel® 소프트웨어를 실행하는 Windows® 시스템에서 가져오기 함수는 사용자의 Excel 버전으로 인식되는 모든 Excel 스프레드시트 파일 형식을 읽습니다.
시스템에 Windows용 Excel이 없거나 MATLAB Online™을 사용 중인 경우, 가져오기 함수는 UseExcel
속성이 false
로 설정된 상태로 작동하고 .xls, .xlsx, .xlsm, .xltx, and .xltm
파일만 읽습니다.
기호로 구분된 텍스트 파일의 경우, 가져오기 함수는 파일의 빈 필드를 NaN
(숫자형 변수의 경우)이나 빈 문자형 벡터(텍스트 변수의 경우)로 변환합니다. 텍스트 파일의 모든 줄에는 동일한 개수의 구분 기호가 있어야 합니다. 가져오기 함수는 파일에서 무의미한 공백을 무시합니다.
데이터형: char
| string
opts
— 파일 가져오기 옵션SpreadsheetImportOptions
| DelimitedtextImportOptions
| FixedWidthImportOptions
파일 가져오기 옵션으로, detectImportOptions
함수에 의해 생성된 SpreadsheetImportOptions
객체, DelimitedTextImportOptions
객체 또는 FixedWidthImportOptions
객체로 지정됩니다. opts
객체에는 데이터 가져오기 과정을 제어하는 속성이 들어 있습니다. 각 객체의 속성에 대한 자세한 내용은 해당 객체 페이지를 참조하십시오.
파일 형식 | 출력값 |
---|---|
스프레드시트 파일 | SpreadsheetImportOptions 객체 |
텍스트 파일 | DelimitedTextImportOptions 객체 |
고정 너비 텍스트 파일 | FixedWidthImportOptions 객체 |
선택적으로 Name,Value
인수가 쉼표로 구분되어 지정됩니다. 여기서 Name
은 인수 이름이고 Value
는 대응값입니다. Name
은 따옴표 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN
과 같이 여러 개의 이름-값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.
'ReadVariableNames',false
는 파일의 첫 번째 행이 변수 이름에 해당하지 않음을 나타냅니다.파일을 읽을 때는 아래와 같습니다.
텍스트 파일을 읽을 때는 FileType
, ReadVariableNames
, ReadRowNames
, TreatAsEmpty
, DatetimeType
, Delimiter
, HeaderLines
, Format
, EmptyValue
, MultipleDelimsAsOne
, CollectOutput
, CommentStyle
, ExpChars
, EndOfLine
, DateLocale
, Encoding
의 파라미터 이름만 적용됩니다.
스프레드시트 파일을 읽을 때는 FileType
, ReadVariableNames
, ReadRowNames
, TreatAsEmpty
, DatetimeType
, Sheet
, Range
, UseExcel
, TextType
의 파라미터 이름만 적용됩니다.
opts
가져오기 옵션으로 텍스트 파일이나 스프레드시트 파일을 읽을 때는 ReadVariableNames
, ReadRowNames
, DateLocale
, Encoding
, Sheet
, UseExcel
의 파라미터 이름만 적용됩니다.
'FileType'
— 파일 형식'text'
| 'spreadsheet'
파일 형식으로, 'FileType'
과 함께 'text'
나 'spreadsheet'
가 쉼표로 구분되어 지정됩니다.
filename
에 파일 확장자가 포함되어 있지 않거나 확장자가 다음 중 하나가 아닌 경우 'FileType'
이름-값 쌍의 인수를 지정하십시오.
.txt
, .dat
, .csv
- 기호로 구분된 텍스트 파일
.xls
, .xlsb
, .xlsm
, .xlsx
, .xltm
, .xltx
, .ods
- 스프레드시트 파일
예: 'FileType','text'
데이터형: char
| string
'ReadVariableNames'
— 첫 번째 행을 변수 이름으로 읽기true
| false
| 1
| 0
첫 번째 행을 변수 이름으로 읽을지 여부를 나타내는 표시자로, 'ReadVariableNames'
와 함께 true
, false
, 1
, 0
중 하나가 쉼표로 구분되어 지정됩니다. 지정되지 않은 경우, readtable
은 자동으로 변수 이름의 존재를 감지합니다.
표시자 | 설명 |
---|---|
| 읽을 영역의 첫 번째 행에 테이블의 변수 이름이 포함되어 있는 경우에 사용하십시오. |
| 읽을 영역의 첫 번째 행에 테이블의 데이터가 포함되어 있는 경우에 사용하십시오. |
지정되지 않음 | 지정되지 않으면 readtable 은 자동으로 true 나 false 를 감지하고 그 결과에 따라 진행합니다. |
참고: 논리값 표시자 'ReadVariableNames'
와 'ReadRowNames'
가 모두 true
인 경우, readtable
은 읽을 영역의 첫 번째 행의 첫 번째 열에 있는 이름을 속성 T.Properties.DimensionNames
의 첫 번째 차원 이름으로 저장합니다.
opts
가져오기 옵션 이외에 ReadVariableNames
인수를 지정하면 readtable
동작이 지정 내용에 따라 변경됩니다.
ReadVariableNames
가 true
이면 import options 객체의 VariableNamesRange
속성이나 VariableNamesLine
속성을 사용하여 지정된 파일에서 변수 이름을 읽습니다.
ReadVariableNames
이 false
이면 import options 객체의 VariableNames
속성에서 변수 이름을 읽습니다.
'ReadRowNames'
— 첫 번째 열을 행 이름으로 읽을지 여부를 나타내는 표시자false
(디폴트 값) | true
| 0
| 1
첫 번째 열을 행 이름으로 읽을지 여부를 나타내는 표시자로, 'ReadRowNames'
와 함께 false
, true
, 0
, 1
중 하나가 쉼표로 구분되어 지정됩니다.
표시자 | 설명 |
---|---|
| 읽을 영역의 첫 번째 열이 데이터를 포함하며 테이블의 행 이름이 아닌 경우에 사용하십시오. |
| 읽을 영역의 첫 번째 열에 테이블의 행 이름이 포함되어 있는 경우에 사용하십시오. |
지정되지 않음 | 지정되지 않으면 readtable 은 false 를 가정합니다. |
참고: 논리값 표시자 'ReadVariableNames'
와 'ReadRowNames'
가 모두 true
인 경우, readtable
은 읽을 영역의 첫 번째 행의 첫 번째 열에 있는 이름을 속성 T.Properties.DimensionNames
의 첫 번째 차원 이름으로 저장합니다.
opts
가져오기 옵션과 함께 ReadRowNames
인수를 지정하면 readtable
동작이 지정 내용에 따라 변경됩니다.
ReadRowNames
가 true
이면 import options 객체의 RowNamesRange
속성이나 RowNameColumn
속성을 사용하여 지정된 파일에서 행 이름을 읽습니다.
ReadRowNames
가 false
이면 행 이름을 가져오지 않습니다.
'TreatAsEmpty'
— 빈 값으로 취급할 자리 표시자 텍스트빈 값으로 취급할 자리 표시자 텍스트로, 'TreatAsEmpty'
와 함께 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 또는 string형 배열이 쉼표로 구분되어 지정됩니다. 이 문자에 대응하는 테이블 요소는 NaN
으로 설정됩니다.
'TreatAsEmpty'
는 파일에서 숫자형 열에만 적용되고 readtable
은 '-99'
같은 숫자형 리터럴을 허용하지 않습니다.
예: 'TreatAsEmpty','N/A'
또는 'TreatAsEmpty',"N/A"
는 숫자형 열 내의 N/A
를 NaN
으로 설정합니다.
예: 'TreatAsEmpty',{'.','NA','N/A'}
또는 'TreatAsEmpty',[".","NA","N/A"]
는 숫자형 열 내의 .
, NA
, N/A
를 NaN
으로 설정합니다.
데이터형: char
| string
'TextType'
— 가져오는 텍스트 데이터의 유형 'char'
(디폴트 값) | 'string'
가져오는 텍스트 데이터의 유형으로, 'TextType'
과 함께 'char'
이나 'string'
이 쉼표로 구분되어 지정됩니다.
'char'
— 텍스트 데이터를 문자형 벡터로 MATLAB으로 가져옵니다.
'string'
— 텍스트 데이터를 string형 배열로 MATLAB으로 가져옵니다.
예: 'TextType','char'
'DatetimeType'
— 가져오는 날짜/시간 데이터의 유형'datetime'
(디폴트 값) | 'text'
| 'exceldatenum'
(스프레드시트 파일만 해당)가져오는 날짜/시간 데이터의 유형으로, 'DatetimeType'
과 함께 'datetime'
, 'text'
또는 'exceldatenum'
값 중 하나가 쉼표로 구분되어 지정됩니다. 값 'exceldatenum'
은 스프레드시트 파일에만 적용할 수 있고 텍스트 파일에는 유효하지 않습니다.
값 | 가져오는 날짜/시간 데이터의 유형 |
---|---|
'datetime' | MATLAB 자세한 내용은 |
'text' |
|
'exceldatenum' | Excel 날짜 일련 번호 값 날짜 일련 번호 값은 주어진 기준 날짜로부터의 일수로, 단일 숫자입니다. Excel 날짜 일련 번호 값은 MATLAB 날짜 일련 번호 값과는 다른 기준 날짜를 사용합니다. Excel 날짜에 대한 자세한 내용은 |
데이터형: char
| string
'Delimiter'
— 필드 구분 기호 문자필드 구분 기호 문자로, 'Delimiter'
와 함께 문자형 벡터, 문자형 벡터로 구성된 셀형 배열 또는 string형이 쉼표로 구분되어 지정됩니다. 쉼표 ','
또는 마침표 '.'
같은 유효한 문자를 사용하여 Delimiter
를 지정합니다.
아래 표에는 일반적으로 사용되는 필드 구분 기호 문자가 일부 나열되어 있습니다.
지정자 | 필드 구분 기호 |
---|---|
| 쉼표 |
| 공백 |
| 탭 |
| 세미콜론 |
| 세로 막대 |
지정되지 않음 | 지정되지 않으면 |
연속된 구분 기호를 단일 구분 기호로 처리하려면 Delimiter
를 문자형 벡터로 구성된 셀형 배열로 지정하십시오. 또한 MultipleDelimsAsOne
옵션도 지정해야 합니다.
예: 'Delimiter',','
또는 'Delimiter','comma'
데이터형: char
| string
| cell
'HeaderLines'
— 건너뛸 라인파일 시작 부분에서 건너뛸 라인으로, 'HeaderLines'
와 함께 양수가 쉼표로 구분되어 지정됩니다. 지정되지 않으면 readtable
이 자동으로 건너뛸 라인 수를 감지합니다.
데이터형: single
| double
'Format'
— 열 형식파일의 열 형식으로, 'Format'
과 함께 하나 이상의 변환 지정자로 구성된 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 변환 지정자는 textscan
함수가 허용하는 지정자와 동일합니다.
일부 대용량 파일의 경우 형식을 지정하면 읽어 들이는 속도를 확실하게 개선할 수 있습니다. Format
에 대한 값을 지정하지 않으면 readtable
은 숫자형이 아닌 열을 해석하는 데 %q
를 사용합니다. %q
지정자는 텍스트를 읽어 들이면서 해당하는 경우 큰따옴표("
)를 생략해 버립니다.
기본적으로, 생성된 변수는 데이터에 따라 double
형이 되거나 문자형 벡터로 구성된 셀형 배열이 됩니다. 전체 열이 숫자형인 경우 변수를 double
형으로 가져옵니다. 열에 숫자형이 아닌 요소가 있는 경우 변수를 문자형 벡터로 구성된 셀형 배열로 가져옵니다.
데이터형: char
| string
'EmptyValue'
— 빈 숫자형 필드에 대해 반환된 값NaN
(디폴트 값) | 스칼라구분된 텍스트 파일에서 빈 숫자형 필드에 대해 반환된 값으로, 'EmptyValue'
와 함께 스칼라가 쉼표로 구분되어 지정됩니다.
'MultipleDelimsAsOne'
— 여러 구분 기호 처리 방식0 (false)
(디폴트 값) | 1 (true)
여러 구분 기호 처리 방식으로, 'MultipleDelimsAsOne'
과 함께 true
또는 false
가 쉼표로 구분되어 지정됩니다. true
인 경우, 가져오기 함수는 연속된 구분 기호를 단일 구분 기호로 취급합니다. 공백으로 구분된 반복 구분 기호도 단일 구분 기호로 취급됩니다. Delimiter
옵션도 지정해야 합니다.
예: 'MultipleDelimsAsOne',1
'CollectOutput'
— 데이터를 결합할지에 대한 논리값 표시자false
(디폴트 값) | true
데이터를 결합할지에 대한 논리값 표시자로, 'CollectOutput'
과 함께 true
또는 false
가 쉼표로 구분되어 지정됩니다. true
인 경우 가져오기 함수는 동일한 MATLAB 기본 클래스의 연속된 출력 셀들을 단일 배열로 결합합니다.
'CommentStyle'
— 무시할 텍스트(주석)를 지정하는 기호무시할 텍스트를 지정하는 기호로, 'CommentStyle'
과 함께 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 또는 string형 배열이 쉼표로 구분되어 지정됩니다.
예를 들어, '%'
와 같은 문자를 지정하여 동일한 라인에서 기호 다음의 텍스트를 무시할 수 있습니다. {'/*','*/'}
와 같은 두 개의 문자형 벡터로 구성된 셀형 배열을 지정하여 이러한 시퀀스 사이의 모든 텍스트를 무시할 수 있습니다.
MATLAB은 필드 내부가 아니라 각 필드의 시작 부분에서만 주석을 확인합니다.
예: 'CommentStyle',{'/*','*/'}
데이터형: char
| string
'ExpChars'
— 지수 문자'eEdD'
(디폴트 값) | 문자형 벡터 | string형지수 문자로, 'ExpChars'
와 함께 문자형 벡터 또는 string형이 쉼표로 구분되어 지정됩니다. 디폴트 지수 문자는 e
, E
, d
, D
입니다.
데이터형: char
| string
'EndOfLine'
— 라인 끝(EOL) 문자라인 끝(EOL) 문자로, 'EndOfLine'
과 함께 문자형 벡터 또는 string형이 쉼표로 구분되어 지정됩니다. 문자형 벡터는 '\r\n'
이거나 단일 문자를 지정해야 합니다. 일반적인 라인 끝(EOL) 문자는 새 줄(Newline) 문자('\n'
) 또는 캐리지 리턴('\r'
)이 있습니다. '\r\n'
을 지정할 경우 가져오기 함수는 \r
, \n
, 이 둘의 조합(\r\n
)을 모두 라인 끝(EOL) 문자로 처리합니다.
디폴트 라인 끝(EOL) 시퀀스는 파일의 내용에 따라 \n
, \r
, \r\n
중 하나입니다.
누락된 값이 있으면서 파일의 마지막 라인 끝에 라인 끝(EOL) 시퀀스가 있는 경우 가져오기 함수는 해당 필드에 대해 빈 값을 반환합니다. 이를 통해, 출력 셀형 배열 C
의 개별 셀이 같은 크기를 유지할 수 있습니다.
예: 'EndOfLine',':'
데이터형: char
| string
'DateLocale'
— 날짜 읽기에 적용할 로케일날짜 읽기에 적용할 로케일로, 'DateLocale'
과 함께
형식의 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 여기서,xx
_YY
YY
는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다.
xx
는 언어를 지정하는 ISO 639-1 두 자리 코드(소문자)입니다.
로케일에 일반적으로 사용되는 값 목록은 datetime
함수에 대한 Locale
이름-값 쌍의 인수를 참조하십시오.
텍스트를 datetime
형 값으로 읽기 위해 %D
형식 지정자를 사용할 때, DateLocale
을 사용하여 가져오기 함수가 월과 요일 이름, 약어를 해석해야 하는 로케일을 지정하십시오.
opts
가져오기 옵션과 함께 DateLocale
인수를 지정하면, 가져오기 함수는 DateLocale
인수에 지정된 값을 사용하며 가져오기 옵션에 정의된 로케일을 무시합니다.
예: 'DateLocale','ja_JP'
'Encoding'
— 문자 인코딩 체계'UTF-8'
| 'ISO-8859-1'
| 'windows-1251'
| 'windows-1252'
| ...파일과 연결된 문자 인코딩 체계로, 'Encoding'
과 함께 'system'
또는 다음 표에 있는 표준 문자 인코딩 체계 이름이 쉼표로 구분되어 지정됩니다. 인코딩을 지정하지 않거나 인코딩을 'system'
으로 지정할 경우, readtable
함수는 시스템 디폴트 인코딩을 사용하여 파일을 읽습니다.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
opts
가져오기 옵션과 함께 Encoding
인수를 지정하면 readtable
함수는 Encoding
인수에 지정된 값을 사용하고 가져오기 옵션에 정의된 인코딩을 무시합니다.
예: 'Encoding'
, 'UTF-8'
예: 'Encoding'
, 'system'
은 시스템 디폴트 인코딩을 사용합니다.
데이터형: char
| string
'DurationType'
— duration형 데이터의 출력 데이터형'duration'
(디폴트 값) | 'text'
텍스트 파일의 duration형 데이터의 출력 데이터형으로, 'DurationType'
과 함께 'duration'
이나 'text'
가 쉼표로 구분되어 지정됩니다.
값 | 가져오는 duration형 데이터의 유형 |
---|---|
'duration' |
MATLAB 자세한 내용은 |
'text' |
|
데이터형: char
| string
'Sheet'
— 읽을 워크시트1
(디폴트 값) | 양의 정수 | 문자형 벡터 | string형읽을 워크시트로, 'Sheet'
와 함께 워크시트 인덱스를 나타내는 양수나 워크시트 이름을 포함한 문자형 벡터 또는 string형이 쉼표로 구분되어 지정됩니다. 워크시트 이름에는 콜론(:
)을 사용할 수 없습니다. 스프레트시트 파일에서 시트의 이름을 확인하려면 [status,sheets]
= xlsfinfo(filename)
을 사용하십시오. 자세한 내용은 xlsfinfo
를 참조하십시오.
opts
가져오기 옵션과 함께 Sheet
인수를 지정하면 readtable
함수는 Sheet
인수에 지정된 값을 사용하고 가져오기 옵션에 정의된 시트 이름을 무시합니다.
예: 'Sheet'
, 2
예: 'Sheet'
, 'MySheetName'
예: 'Sheet'
, "MySheetName"
데이터형: char
| string
| single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
'Range'
— 읽을 워크시트의 부분읽을 워크시트의 부분으로, 사각형 영역으로 표시되며, 'Range'
와 함께 다음 형식 중 하나의 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다.
Range 를 지정하는 방법 | 설명 |
---|---|
사각 범위 | 구문 예: |
지정되지 않거나 비어 있음 | 지정되지 않으면, 예: 참고: "사용된 범위"는 실제로 데이터가 들어 있는 스프레드시트의 사각형 부분을 말합니다. |
행 범위 | Excel 행 지정자로 시작 행과 끝 행을 지정하여 범위를 식별할 수 있습니다. 그런 다음 예: |
열 범위 | Excel 열 지정자로 시작 열과 끝 열을 지정하여 범위를 식별할 수 있습니다. 그런 다음 예: |
Excel의 명명된 범위 | Excel의 스프레드시트에서 범위를 식별하는 이름을 만들 수 있습니다. 예를 들어, 스프레드시트의 사각형 부분을 선택하고 예: |
예: 'Range'
, 'A1:F10'
예: 'Range'
, "A1:F10"
데이터형: char
| string
'UseExcel'
— Windows용 Microsoft Excel을 시작할지 지정하는 플래그true
| false
스프레드시트 데이터를 읽을 때 Windows용 Microsoft Excel을 시작할지 지정하는 플래그로, 'UseExcel'
과 함께 true
또는 false
가 쉼표로 구분되어 지정됩니다.
Windows 플랫폼에서 스프레드시트 데이터를 읽을 때 Microsoft Excel을 시작하지 않으려면 'UseExcel'
파라미터를 false
로 설정하십시오.
'UseExcel'
파라미터는 다음 값 중 하나로 설정할 수 있습니다.
true
— 파일을 읽을 때 가져오기 함수가 Microsoft Excel을 시작합니다. 이 설정은 Excel이 설치된 Windows 시스템의 디폴트 값입니다.
false
— 파일을 읽을 때 가져오기 함수가 Microsoft Excel을 시작하지 않습니다. Excel이 설치되지 않은 Windows, Mac 및 Linux®의 디폴트 값은 false
입니다. 이 모드에서 작업할 때 가져오기 함수는 파일 형식 지원과 수식이나 매크로 같은 대화형 기능 지원 면에서 다르게 동작합니다.
UseExcel |
|
|
---|---|---|
지원되는 파일 형식 |
|
|
수식이나 매크로 같은 대화형 기능 지원 | 예 | 아니요 |
XLSX 형식의 대용량 파일은 불러오는 속도가 느린 경우가 있습니다. 더 나은 가져오기 및 내보내기 성능을 위해 Microsoft는 XLSB 형식을 사용할 것을 권장합니다.
detectImportOptions
| preview
| readcell
| readmatrix
| readtimetable
| readvars
| table
| textscan
| writetable
| 가져오기 툴
A modified version of this example exists on your system. Do you want to open this version instead? (ko_KR)
아래 MATLAB 명령에 해당하는 링크를 클릭하셨습니다.
이 명령을 MATLAB 명령 창에 입력해 실행하십시오. 웹 브라우저에서는 MATLAB 명령을 지원하지 않습니다.
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: .
Select web siteYou can also select a web site from the following list:
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.