readcell

파일에서 셀형 배열 만들기

페이지 내 모두 축소

구문

C = readcell(filename)

C = readcell(filename,Name,Value)

C = readcell(filename,opts)

C = readcell(filename,opts,Name,Value)

설명

C = readcell(filename)은 텍스트 파일 또는 스프레드시트 파일에서 열 방향 데이터를 읽어 들여 셀형 배열을 만듭니다.

예제

C = readcell(filename,Name,Value)는 하나 이상의 이름-값 인수를 사용하여 옵션을 지정합니다. 예를 들어, 파일의 제목 라인 개수, 예상되는 변수 또는 열 개수, 읽어 들일 데이터 범위를 지정할 수 있습니다.

예제

C = readcell(filename,opts)는 import options 객체 opts로 지정된 옵션을 사용하여 셀형 배열을 만듭니다. readcell이 파일을 해석하는 방법을 구성하려면 import options 객체를 사용합니다. 위에 열거된 두 구문에 비해, import options 객체는 파일 가져오기 구성을 더 세부적으로 제어할 수 있고 더 향상된 성능과 재사용 가능성을 제공합니다.

예제

C = readcell(filename,opts,Name,Value)는 import options 객체와 이름-값 인수를 모두 사용하여 셀형 배열을 만듭니다. import options 객체 외에 이름-값 인수까지 지정하면, readcell은 텍스트 파일에는 DateLocale 및 Encoding 이름-값 인수만 지원하고 스프레드시트 파일에는 Sheet 및 UseExcel 이름-값 인수만 지원합니다.

예제

모두 축소

텍스트 파일에서 읽기

라이브 스크립트 열기

텍스트 파일의 내용을 셀형 배열로 가져옵니다. readcell은 텍스트 파일의 각 요소를 출력 셀형 배열에 셀형으로 가져옵니다.

C = readcell("basic_cell.txt")

C=3×3 cell array
    {[                   1]}    {[    2]}    {[        3]}
    {'hello'               }    {'world'}    {[      NaN]}
    {[10-Oct-2018 10:27:56]}    {[    1]}    {[<missing>]}

스프레드시트에서 읽기

라이브 스크립트 열기

스프레드시트 파일의 테이블 형식 데이터를 셀형 배열로 가져옵니다.

C = readcell("basic_cell.xls")

C=3×3 cell array
    {[                   1]}    {[    2]}    {[        3]}
    {'hello'               }    {'world'}    {[<missing>]}
    {[10-Oct-2018 10:27:56]}    {[    1]}    {[<missing>]}

스프레드시트에서 특정 범위 읽기

라이브 스크립트 열기

지정된 시트와 범위의 데이터를 셀형 배열로 가져옵니다.

airlinesmall_subset.xlsx 스프레드시트 파일에는 1996년~2008년의 데이터가 여러 워크시트에 포함되어 있습니다. 스프레드시트 파일의 각 시트에는 해당 연도에 대한 데이터가 있습니다.

"2007" 시트의 G, H, I 열에서 10개 행의 데이터를 가져옵니다. Excel® 범위 "G2:I11"은 열 G~I와 행 2~11(제목 행 다음의 첫 10개 행)로 정의된 데이터 영역을 나타냅니다.

C = readcell("airlinesmall_subset.xlsx","Sheet","2007","Range","G2:I11")

C=10×3 cell array
    {[ 935]}    {[ 935]}    {'WN'}
    {[1041]}    {[1040]}    {'WN'}
    {[1430]}    {[1500]}    {'WN'}
    {[ 940]}    {[ 950]}    {'WN'}
    {[1515]}    {[1515]}    {'WN'}
    {[2042]}    {[2035]}    {'WN'}
    {[2116]}    {[2130]}    {'WN'}
    {[1604]}    {[1605]}    {'WN'}
    {[1258]}    {[1230]}    {'WN'}
    {[1134]}    {[1145]}    {'WN'}

텍스트 파일에 대한 가져오기 옵션을 감지하고 사용하기

라이브 스크립트 열기

import options 객체를 사용하여 텍스트 파일에서 변수의 서브셋을 가져옵니다.

detectImportOptions 함수를 사용하여 변수의 이름과 유형, 구분 기호, 공백 문자를 비롯한 텍스트 파일의 특징을 감지합니다. import options 객체 opts는 감지된 파일의 특징을 속성으로 저장합니다.

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: [1-by-29 matlab.io.VariableImportOptions] 
	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 객체를 수정하여 가져올 변수의 서브셋과 라인 끝(EOL) 문자를 지정합니다.

opts.SelectedVariableNames = ["Year","Month","DayofMonth"];
opts.LineEnding = "\n";

import options 객체와 함께 readcell을 사용하여 데이터 서브셋을 가져옵니다.

C = readcell("airlinesmall.csv",opts);

입력 인수

모두 축소

`filename` — 읽을 파일의 이름
string형 스칼라 | 문자형 벡터

읽을 파일의 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 다음 파일 형식 중 하나를 지정할 수 있습니다.

확장자가 .txt, .dat 또는 .csv인 구분된 텍스트 파일 또는 고정 너비 텍스트 파일.
- 구분된 텍스트 파일과 고정 너비 텍스트 파일의 경우 readcell은 빈 필드를 missing 값으로 변환합니다.
- 텍스트 파일의 모든 줄에는 동일한 개수의 구분 기호가 있어야 합니다.
- readcell은 파일에서 무의미한 공백을 무시합니다.
확장자가 .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx 또는 .ods인 스프레드시트 파일.
- Microsoft^® Excel^®을 실행하는 Windows^® 시스템에서 readcell은 사용자의 Excel 버전으로 인식되는 모든 Excel 스프레드시트 파일 형식을 읽습니다.
- 시스템에 Windows용 Excel이 없거나 MATLAB^® Online™을 사용하는 경우 readcell은 .xls, .xlsm, .xlsx, .xltm, .xltx 파일만 읽습니다.

filename에 확장자가 포함되어 있지 않은 경우 FileType 이름-값 인수를 사용하여 파일 형식을 나타냅니다.

파일의 위치에 따라 filename은 다음 형식 중 하나가 될 수 있습니다.

위치

형식

현재 폴더 또는 MATLAB 경로의 폴더

filename에 파일의 이름을 지정합니다.

예: "myFile.txt"

폴더 안의 파일

파일이 현재 폴더나 MATLAB 경로의 폴더에 없는 경우, filename에 전체 경로 이름 또는 상대 경로 이름을 지정합니다.

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

예: "dataDir\myFile.txt"

인터넷 URL

파일이 인터넷 URL(Uniform Resource Locator)로 지정된 경우, filename은 프로토콜 유형 "http://" 또는 "https://"를 포함해야 합니다.

예: "http://hostname/path_to_file/my_data.csv"

원격 위치

파일이 원격 위치에 저장된 경우, filename은 다음 형식으로 지정된 파일의 전체 경로를 포함해야 합니다.

scheme_name://path_to_file/my_file.ext

원격 위치에 따라 scheme_name은 다음 표에 있는 값 중 하나가 될 수 있습니다.

원격 위치	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Blob Storage	`wasb`, `wasbs`
HDFS™	`hdfs`

자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

예: "s3://bucketname/path_to_file/my_file.csv"

`opts` — 파일 가져오기 옵션
`DelimitedTextImportOptions` 객체 | `FixedWidthImportOptions` 객체 | `SpreadsheetImportOptions` 객체

파일 가져오기 옵션으로, 다음 표에 있는 import options 객체 중 하나로 지정되며 detectImportOptions 함수나 연관된 가져오기 옵션 함수에 의해 생성됩니다. import options 객체에는 데이터 가져오기 과정을 구성하는 속성이 포함되어 있습니다. 다음 표에서는 데이터를 가져올 때 readcell이 적용하는 각 import options 객체의 속성을 보여줍니다.

파일 형식	Import Options 객체	적용되는 속성
구분된 텍스트 파일	`DelimitedTextImportOptions` 객체	`SelectedVariableNames` `DataLines` `Delimiter` `Whitespace` `LineEnding` `CommentStyle` `ConsecutiveDelimitersRule` `LeadingDelimitersRule` `TrailingDelimitersRule` `Encoding` `MissingRule` `EmptyLineRule` `ExtraColumnsRule`
고정 너비 텍스트 파일	`FixedWidthImportOptions` 객체	`SelectedVariableNames` `DataLines` `VariableWidths` `Whitespace` `LineEnding` `CommentStyle` `Encoding` `PartialFieldRule` `EmptyLineRule` `MissingRule` `ExtraColumnsRule`
스프레드시트 파일	`SpreadsheetImportOptions` 객체	`SelectedVariableNames` `Sheet` `DataRange` `MissingRule` `ImportErrorRule`

가져오기를 제어하는 방법에 대한 자세한 내용은 Control How MATLAB Imports Your Data 항목을 참조하십시오.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: readcell(filename,NumHeaderLines=5)는 지정된 파일의 처음 다섯 줄이 제목 라인임을 나타냅니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: readcell(filename,"NumHeaderLines",5)는 지정된 파일의 처음 다섯 줄이 제목 라인임을 나타냅니다.

텍스트 파일

모두 축소

`FileType` — 파일 형식
`"text"` | `"spreadsheet"`

파일 형식으로, "text" 또는 "spreadsheet"로 지정됩니다.

filename에 파일 확장자가 포함되어 있지 않거나 확장자가 다음 중 하나가 아닌 경우 FileType 이름-값 인수를 지정하십시오.

.txt, .dat, .csv - 구분된 텍스트 파일 또는 고정 너비 텍스트 파일
.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods - 스프레드시트 파일

예: "FileType","text"

`Delimiter` — 필드 구분 기호 문자
string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

구분된 텍스트 파일의 필드 구분 기호 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

예: "Delimiter","|"

예: "Delimiter",[";","*"]

`LeadingDelimitersRule` — 선행 구분 기호를 관리하는 방법
`"keep"` | `"ignore"` | `"error"`

구분된 텍스트 파일의 선행 구분 기호를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.

값	동작
`"keep"`	구분 기호를 유지합니다.
`"ignore"`	구분 기호를 무시합니다.
`"error"`	오류를 반환하고 가져오기 작업을 취소합니다.

`TrailingDelimitersRule` — 후행 구분 기호를 관리하는 방법
`"keep"` | `"ignore"` | `"error"`

구분된 텍스트 파일의 후행 구분 기호를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.

값	동작
`"keep"`	구분 기호를 유지합니다.
`"ignore"`	구분 기호를 무시합니다.
`"error"`	오류를 반환하고 가져오기 작업을 취소합니다.

`ConsecutiveDelimitersRule` — 연속된 구분 기호를 관리하는 절차
`"split"` | `"join"` | `"error"`

구분된 텍스트 파일의 연속된 구분 기호를 관리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.

값	동작
`"split"`	연속된 구분 기호를 여러 개의 필드로 분할합니다.
`"join"`	여러 구분 기호를 하나의 구분 기호로 결합합니다.
`"error"`	오류를 반환하고 가져오기 작업을 취소합니다.

`NumHeaderLines` — 제목 라인 수
양의 정수

파일의 제목 라인 수로, 양의 정수로 지정됩니다. 지정되지 않은 경우, readcell이 자동으로 파일에 있는 제목 라인 수를 감지합니다.

예: "NumHeaderLines",7

`TextType` — 가져오는 텍스트 데이터의 유형
`"string"` | `"char"`

가져오는 텍스트 데이터의 유형으로, 다음 값 중 하나로 지정됩니다.

"string" — 텍스트 데이터를 string형 배열로 가져옵니다.
"char" — 텍스트 데이터를 문자형 벡터로 가져옵니다.

예: "TextType","char"

`DatetimeType` — 가져오는 날짜/시간 데이터의 유형
`"datetime"` (디폴트 값) | `"text"`

가져오는 날짜/시간 데이터의 유형으로, 다음 표에 있는 값 중 하나로 지정됩니다.

값 설명

값	설명
`"datetime"`	MATLAB `datetime` 데이터형 자세한 내용은 `datetime`을 참조하십시오.
`"text"`	가져오는 날짜/시간 데이터의 유형은 `TextType` 인수에 지정된 값에 따라 달라집니다. `TextType`이 `"string"`으로 설정된 경우 `readcell`은 날짜를 string형 배열로 반환합니다. `TextType`이 `"char"`로 설정된 경우 `readcell`은 날짜를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

"datetime"

MATLAB datetime 데이터형

자세한 내용은 datetime을 참조하십시오.

"text"

가져오는 날짜/시간 데이터의 유형은 TextType 인수에 지정된 값에 따라 달라집니다.

TextType이 "string"으로 설정된 경우 readcell은 날짜를 string형 배열로 반환합니다.
TextType이 "char"로 설정된 경우 readcell은 날짜를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

`ExpectedNumVariables` — 예상되는 변수 또는 열의 개수
양의 정수

예상되는 변수 또는 열의 개수로, 양의 정수로 지정됩니다. 지정되지 않으면 readcell이 자동으로 변수 또는 열 개수를 감지합니다.

`Range` — 읽을 데이터의 부분
string형 스칼라 | 문자형 벡터 | 숫자형 벡터

텍스트 파일에서 읽을 데이터의 부분으로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 숫자형 벡터로 지정됩니다.

Range를 지정하는 방법 설명

`Range`를 지정하는 방법	설명
시작 셀 `"Cell"` 또는 `[row col]`	데이터에 대한 시작 셀을 지정합니다. Excel `A1` 표기법을 사용하여 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터를 지정합니다. 예를 들어, `A5`는 열 `A`와 행 `5`가 교차하는 지점에 있는 셀의 식별자입니다. 시작 행과 열을 나타내는 `[row col]` 형식을 갖는 요소를 2개 가진 숫자형 벡터를 지정합니다. `readcell`은 시작 셀을 사용하여 시작 셀에서 가져오기를 시작하고 마지막 빈 행이나 푸터 범위에서 가져오기를 종료하는 방식으로 데이터의 범위를 자동으로 검색합니다. 예: `"A5"` 또는 `[5 1]`
사각 범위 `"Corner1:Corner2"` 또는 `[r1 c1 r2 c2]`	다음 형식 중 하나로 사각 범위를 사용하여 읽어 들일 정확한 범위를 지정합니다. `"Corner1:Corner2"` — 읽을 범위를 정의하는 2개의 끝 지점을 사용하여 Excel `A1` 표기법으로 범위를 지정합니다. 예를 들면 `"C2:N15"`와 같습니다. `[r1 c1 r2 c2]` — 시작 행, 시작 열, 끝 행, 끝 열을 포함하는 요소를 4개 가진 숫자형 벡터를 사용하여 범위를 지정합니다. 예를 들면 `[2 3 15 13]`과 같습니다. `readcell`은 지정된 범위에 포함된 데이터만 읽습니다. `readcell`은 지정된 범위 내의 빈 필드를 빈 셀로 가져옵니다.
행 범위 또는 열 범위 `"Row1:Row2"` 또는 `"Column1:Column2"`	Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다. `readcell`은 지정된 행 범위를 사용하여 비어 있지 않은 첫 번째 열부터 데이터의 끝까지 읽어 들이는 방식으로 열의 범위를 자동으로 검색합니다. `readcell`은 파일의 각 데이터 열에 대해 하나의 셀형 배열 열을 만듭니다. 예: `"5:500"` 또는 Excel 열 문자나 열 번호를 사용하여 시작 열과 끝 열을 식별하여 범위를 지정하십시오. `readcell`은 지정된 열 범위를 사용하여 비어 있지 않은 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 행의 범위를 자동으로 검색합니다. 지정된 범위에 있는 열 개수는 `ExpectedNumVariables` 속성에 지정된 개수와 일치해야 합니다. 예: `"A:K"`
시작 행 번호 `n`	양의 스칼라 행 인덱스를 사용하여 데이터를 포함하는 첫 번째 행을 지정합니다. `readcell`은 지정된 행 인덱스를 사용하여 지정된 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 데이터의 범위를 자동으로 검색합니다. 예: `5`
Excel의 명명된 범위 `"NamedRange"`	Excel의 스프레드시트에서 범위를 식별하는 이름을 만들 수 있습니다. 예를 들어, 스프레드시트의 사각형 부분을 선택하고 이름을 `"myTable"`이라고 지정할 수 있습니다. 스프레드시트에 이렇게 명명된 범위가 있는 경우 `readcell`은 이 이름을 사용하여 범위를 읽을 수 있습니다. 예: `"Range","myTable"`
지정되지 않거나 비어 있음 `""`	지정되지 않거나 비어 있으면, `readcell`은 자동으로 "사용된 범위"를 감지합니다. 예: `"Range",""` 참고: 사용된 범위는 실제로 데이터가 들어 있는 스프레드시트의 사각형 부분을 말합니다. `readcell`은 데이터가 들어 있지 않은 모든 선행 행과 열, 후행 행과 열을 잘라내어 자동으로 "사용된 범위"를 감지합니다. 공백만 있는 텍스트는 데이터로 간주되어 "사용된 범위"에 캡처됩니다.

시작 셀

"Cell" 또는 [row col]

데이터에 대한 시작 셀을 지정합니다.

Excel A1 표기법을 사용하여 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터를 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.
시작 행과 열을 나타내는 [row col] 형식을 갖는 요소를 2개 가진 숫자형 벡터를 지정합니다.

readcell은 시작 셀을 사용하여 시작 셀에서 가져오기를 시작하고 마지막 빈 행이나 푸터 범위에서 가져오기를 종료하는 방식으로 데이터의 범위를 자동으로 검색합니다.

예: "A5" 또는 [5 1]

사각 범위

"Corner1:Corner2" 또는 [r1 c1 r2 c2]

다음 형식 중 하나로 사각 범위를 사용하여 읽어 들일 정확한 범위를 지정합니다.

"Corner1:Corner2" — 읽을 범위를 정의하는 2개의 끝 지점을 사용하여 Excel A1 표기법으로 범위를 지정합니다. 예를 들면 "C2:N15"와 같습니다.
[r1 c1 r2 c2] — 시작 행, 시작 열, 끝 행, 끝 열을 포함하는 요소를 4개 가진 숫자형 벡터를 사용하여 범위를 지정합니다. 예를 들면 [2 3 15 13]과 같습니다.

readcell은 지정된 범위에 포함된 데이터만 읽습니다. readcell은 지정된 범위 내의 빈 필드를 빈 셀로 가져옵니다.

행 범위 또는 열 범위

"Row1:Row2" 또는 "Column1:Column2"

Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다.

readcell은 지정된 행 범위를 사용하여 비어 있지 않은 첫 번째 열부터 데이터의 끝까지 읽어 들이는 방식으로 열의 범위를 자동으로 검색합니다. readcell은 파일의 각 데이터 열에 대해 하나의 셀형 배열 열을 만듭니다.

예: "5:500"

또는 Excel 열 문자나 열 번호를 사용하여 시작 열과 끝 열을 식별하여 범위를 지정하십시오.

readcell은 지정된 열 범위를 사용하여 비어 있지 않은 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 행의 범위를 자동으로 검색합니다.

지정된 범위에 있는 열 개수는 ExpectedNumVariables 속성에 지정된 개수와 일치해야 합니다.

예: "A:K"

시작 행 번호

n

양의 스칼라 행 인덱스를 사용하여 데이터를 포함하는 첫 번째 행을 지정합니다.

readcell은 지정된 행 인덱스를 사용하여 지정된 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 데이터의 범위를 자동으로 검색합니다.

예: 5

Excel의 명명된 범위

"NamedRange"

Excel의 스프레드시트에서 범위를 식별하는 이름을 만들 수 있습니다. 예를 들어, 스프레드시트의 사각형 부분을 선택하고 이름을 "myTable"이라고 지정할 수 있습니다. 스프레드시트에 이렇게 명명된 범위가 있는 경우 readcell은 이 이름을 사용하여 범위를 읽을 수 있습니다.

예: "Range","myTable"

지정되지 않거나 비어 있음

""

지정되지 않거나 비어 있으면, readcell은 자동으로 "사용된 범위"를 감지합니다.

예: "Range",""

참고: 사용된 범위는 실제로 데이터가 들어 있는 스프레드시트의 사각형 부분을 말합니다. readcell은 데이터가 들어 있지 않은 모든 선행 행과 열, 후행 행과 열을 잘라내어 자동으로 "사용된 범위"를 감지합니다. 공백만 있는 텍스트는 데이터로 간주되어 "사용된 범위"에 캡처됩니다.

`WebOptions` — `HTTP` 또는 `HTTPS` 요청 옵션
`weboptions` 객체

HTTP 또는 HTTPS 요청 옵션으로, weboptions 객체로 지정됩니다. weboptions 객체는 지정된 filename이 프로토콜 유형 "http://" 또는 "https://"를 포함하는 인터넷 URL일 때 데이터를 어떻게 가져올지를 결정합니다.

`Whitespace` — 공백으로 처리할 문자
문자형 벡터 | string형 스칼라

공백으로 처리할 문자로, 하나 이상의 문자를 포함하는 문자형 벡터 또는 string형 스칼라로 지정됩니다.

예: 'Whitespace',' _'

예: 'Whitespace','?!.,'

`LineEnding` — 라인 끝(EOL) 문자
`["\n","\r","\r\n"]` (디폴트 값) | string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

라인 끝(EOL) 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

예: "LineEnding","\n"

예: "LineEnding","\r\n"

예: "LineEnding",["\b",":"]

`CommentStyle` — 주석 스타일
string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

주석 스타일로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 단일 라인 주석과 여러 라인 주석의 경우, 시작 식별자는 공백이 아닌 첫 번째 문자여야 합니다. 단일 라인의 주석에서는 단일 식별자를 지정하여 해당 식별자로 시작하는 라인을 주석으로 처리하십시오. 여러 라인의 주석에서는 시작(첫 번째) 식별자에서 끝(두 번째) 식별자까지의 라인이 주석으로 처리됩니다. 식별자로 구성된 2개 이하의 문자형 벡터만 지정할 수 있습니다.

예를 들어, CommentStyle을 "%"로 지정하면 공백이 아닌 첫 번째 문자로서의 퍼센트 기호 다음에 오는 라인이 무시됩니다.

예: "CommentStyle",["/*"]

예: "CommentStyle",["/*","*/"]

`Encoding` — 문자 인코딩 체계
`"system"` | `"UTF-8"` | `"ISO-8859-1"` | `"windows-1251"` | `"windows-1252"` | ...

파일과 연결된 문자 인코딩 체계로, "system" 또는 표준 문자 인코딩 체계 이름으로 지정됩니다. 인코딩을 지정하지 않은 경우 readcell은 파일을 읽을 때 문자 집합을 자동으로 감지하여 인코딩을 결정합니다.

import options 객체와 함께 Encoding 인수를 지정하면 readcell은 Encoding에 지정된 값을 사용하고 가져오기 옵션에 정의된 인코딩을 무시합니다.

예: "Encoding","UTF-8"은 UTF-8을 인코딩으로 사용합니다.

예: "Encoding","system"은 시스템 디폴트 인코딩을 사용합니다.

`DurationType` — 지속 시간 데이터의 출력 데이터형
`"duration"` (디폴트 값) | `"text"`

텍스트 파일의 지속 시간 데이터의 출력 데이터형으로, 다음 표에 있는 값 중 하나로 지정됩니다.

값 가져온 지속 시간 데이터의 유형

값	가져온 지속 시간 데이터의 유형
`"duration"`	MATLAB `duration` 데이터형 자세한 내용은 `duration`을 참조하십시오.
`"text"`	가져오는 지속 시간 데이터의 유형은 `TextType` 인수에 지정된 값에 따라 달라집니다. `TextType`이 `"string"`으로 설정된 경우 `readcell`은 지속 시간 데이터를 string형 배열로 반환합니다. `TextType`이 `"char"`로 설정된 경우 `readcell`은 지속 시간 데이터를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

"duration"

MATLAB duration 데이터형

자세한 내용은 duration을 참조하십시오.

"text"

가져오는 지속 시간 데이터의 유형은 TextType 인수에 지정된 값에 따라 달라집니다.

TextType이 "string"으로 설정된 경우 readcell은 지속 시간 데이터를 string형 배열로 반환합니다.
TextType이 "char"로 설정된 경우 readcell은 지속 시간 데이터를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

`DateLocale` — 날짜 읽기에 적용할 로캘
string형 스칼라 | 문자형 벡터

날짜 읽기에 적용할 로캘로, xx_YY 형식의 string형 스칼라 또는 문자형 벡터로 지정됩니다. 여기서,

xx는 언어를 지정하는 ISO 639-1 두 자리 코드(소문자)입니다.
YY는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다.

다음 표에는 로캘에 일반적으로 사용되는 일부 값이 나와 있습니다.

로캘	언어	국가
`"de_DE"`	독일어	독일
`"en_GB"`	영어	영국
`"en_US"`	영어	미국
`"es_ES"`	스페인어	스페인
`"fr_FR"`	프랑스어	프랑스
`"it_IT"`	이탈리아어	이탈리아
`"ja_JP"`	일본어	일본
`"ko_KR"`	한국어	한국
`"nl_NL"`	네덜란드어	네덜란드
`"zh_CN"`	중국어(간체)	중국

텍스트를 datetime형 값으로 읽기 위해 %D 형식 지정자를 사용할 때, DateLocale을 사용하여 readcell이 월과 요일 이름, 약어를 해석해야 하는 로캘을 지정하십시오.

import options 객체와 함께 DateLocale 인수를 지정하면 readcell은 DateLocale 인수에 지정된 값을 사용하고 가져오기 옵션에 정의된 로캘을 무시합니다.

예: "DateLocale","ja_JP"

스프레드시트 파일

모두 축소

`FileType` — 파일 형식
`"text"` | `"spreadsheet"`

파일 형식으로, "text" 또는 "spreadsheet"로 지정됩니다.

filename에 파일 확장자가 포함되어 있지 않거나 확장자가 다음과 다른 경우 FileType 이름-값 쌍의 인수를 지정하십시오.

.txt, .dat, .csv - 구분된 텍스트 파일 또는 고정 너비 텍스트 파일
.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods - 스프레드시트 파일

예: "FileType","text"

`NumHeaderLines` — 제목 라인 수
양의 정수

파일의 제목 라인 수로, 양의 정수로 지정됩니다. 지정되지 않은 경우, readcell이 자동으로 파일에 있는 제목 라인 수를 감지합니다.

예: "NumHeaderLines",7

`TextType` — 가져오는 텍스트 데이터의 유형
`"string"` | `"char"`

가져오는 텍스트 데이터의 유형으로, 다음 값 중 하나로 지정됩니다.

"string" — 텍스트 데이터를 string형 배열로 가져옵니다.
"char" — 텍스트 데이터를 문자형 벡터로 가져옵니다.

예: "TextType","char"

`DatetimeType` — 가져오는 날짜/시간 데이터의 유형
`"datetime"` (디폴트 값) | `"text"` | `"exceldatenum"`(스프레드시트 파일만 해당)

가져오는 날짜/시간 데이터의 유형으로, 다음 표에 있는 값 중 하나로 지정됩니다.

값 설명

값	설명
`"datetime"`	MATLAB `datetime` 데이터형 자세한 내용은 `datetime`을 참조하십시오.
`"text"`	가져오는 날짜/시간 데이터의 유형은 `TextType` 인수에 지정된 값에 따라 달라집니다. `TextType`이 `"string"`으로 설정된 경우 `readcell`은 날짜를 string형 배열로 반환합니다. `TextType`이 `"char"`로 설정된 경우 `readcell`은 날짜를 문자형 벡터로 구성된 셀형 배열로 반환합니다.
`"exceldatenum"`	Excel 날짜 일련 번호 값 값 `"exceldatenum"`은 스프레드시트 파일에만 적용할 수 있고 텍스트 파일에는 유효하지 않습니다. 날짜 일련 번호 값은 주어진 기준 날짜로부터의 일수로, 단일 숫자입니다. Excel 날짜 일련 번호 값은 MATLAB 날짜 일련 번호 값과는 다른 기준 날짜를 사용합니다. Excel 날짜에 대한 자세한 내용은 Differences between the 1900 and the 1904 date system in Excel을 참조하십시오.

"datetime"

MATLAB datetime 데이터형

자세한 내용은 datetime을 참조하십시오.

"text"

가져오는 날짜/시간 데이터의 유형은 TextType 인수에 지정된 값에 따라 달라집니다.

TextType이 "string"으로 설정된 경우 readcell은 날짜를 string형 배열로 반환합니다.
TextType이 "char"로 설정된 경우 readcell은 날짜를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

"exceldatenum"

Excel 날짜 일련 번호 값

값 "exceldatenum"은 스프레드시트 파일에만 적용할 수 있고 텍스트 파일에는 유효하지 않습니다. 날짜 일련 번호 값은 주어진 기준 날짜로부터의 일수로, 단일 숫자입니다. Excel 날짜 일련 번호 값은 MATLAB 날짜 일련 번호 값과는 다른 기준 날짜를 사용합니다. Excel 날짜에 대한 자세한 내용은 Differences between the 1900 and the 1904 date system in Excel을 참조하십시오.

`ExpectedNumVariables` — 예상되는 변수 또는 열의 개수
양의 정수

예상되는 변수 또는 열의 개수로, 양의 정수로 지정됩니다. 지정되지 않으면 readcell이 자동으로 변수 또는 열 개수를 감지합니다.

`Sheet` — 읽어 들일 시트
`''` 빈 문자형 배열 (디폴트 값) | 문자형 벡터 | string형 스칼라 | 양의 정수 스칼라

읽어 들일 시트로, 빈 문자형 배열, 시트 이름을 포함하는 문자형 벡터나 string형 스칼라, 또는 시트 인덱스를 나타내는 양의 정수 스칼라로 지정됩니다. Sheet 이름-값 인수에 지정된 값에 따라 readcell은 아래 표에 설명된 대로 동작합니다.

지정값	동작
`''`(디폴트 값)	첫 번째 시트에서 데이터를 가져옵니다.
시트 이름	스프레드시트 파일의 시트 순서와 상관없이 일치하는 시트 이름에서 데이터를 가져옵니다.
시트 인덱스	스프레드시트 파일의 시트 이름과 상관없이 인덱스로 나타내어진 위치에 있는 시트에서 데이터를 가져옵니다.

`Range` — 읽을 데이터의 부분
string형 스칼라 | 문자형 벡터 | 숫자형 벡터

스프레드시트 파일에서 읽을 데이터의 부분으로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 숫자형 벡터로 지정됩니다.

Range를 지정하는 방법 설명

`Range`를 지정하는 방법	설명
시작 셀 `"Cell"` 또는 `[row col]`	데이터에 대한 시작 셀을 다음과 같이 지정합니다. Excel `A1` 표기법을 사용하여 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터를 지정합니다. 예를 들어, `A5`는 열 `A`와 행 `5`가 교차하는 지점에 있는 셀의 식별자입니다. 시작 행과 열을 나타내는 `[row col]` 형식을 갖는 요소를 2개 가진 숫자형 벡터를 지정합니다. `readcell`은 시작 셀을 사용하여 시작 셀에서 가져오기를 시작하고 마지막 빈 행이나 푸터 범위에서 가져오기를 종료하는 방식으로 데이터의 범위를 자동으로 검색합니다. 예: `"A5"` 또는 `[5 1]`
사각 범위 `"Corner1:Corner2"` 또는 `[r1 c1 r2 c2]`	다음 형식 중 하나로 사각 범위를 사용하여 읽어 들일 정확한 범위를 지정합니다. `"Corner1:Corner2"` — 읽을 범위를 정의하는 2개의 끝 지점을 사용하여 Excel `A1` 표기법으로 범위를 지정합니다. 예를 들면 `"C2:N15"`와 같습니다. `[r1 c1 r2 c2]` — 시작 행, 시작 열, 끝 행, 끝 열을 포함하는 요소를 4개 가진 숫자형 벡터를 사용하여 범위를 지정합니다. 예를 들면 `[2 3 15 13]`과 같습니다. `readcell`은 지정된 범위에 포함된 데이터만 읽습니다. `readcell`은 지정된 범위 내에 있는 빈 필드는 누락된 셀로 가져옵니다.
행 범위 또는 열 범위 `"Row1:Row2"` 또는 `"Column1:Column2"`	Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다. `readcell`은 지정된 행 범위를 사용하여 비어 있지 않은 첫 번째 열부터 데이터의 끝까지 읽어 들이는 방식으로 열의 범위를 자동으로 검색합니다. `readcell`은 파일의 각 데이터 열에 대해 하나의 셀형 배열 열을 만듭니다. 예: `"5:500"` 또는 Excel 열 문자나 열 번호를 사용하여 시작 열과 끝 열을 식별하여 범위를 지정하십시오. `readcell`은 지정된 열 범위를 사용하여 비어 있지 않은 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 행의 범위를 자동으로 검색합니다. 지정된 범위에 있는 열 개수는 `ExpectedNumVariables` 속성에 지정된 개수와 일치해야 합니다. 예: `"A:K"`
시작 행 번호 `n`	양의 스칼라 행 인덱스를 사용하여 데이터를 포함하는 첫 번째 행을 지정합니다. `readcell`은 지정된 행 인덱스를 사용하여 지정된 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 데이터의 범위를 자동으로 검색합니다. 예: `5`
Excel의 명명된 범위 `"NamedRange"`	Excel의 스프레드시트에서 범위를 식별하는 이름을 만들 수 있습니다. 예를 들어, 스프레드시트의 사각형 부분을 선택하고 이름을 `"myTable"`이라고 지정할 수 있습니다. 스프레드시트에 이렇게 명명된 범위가 있는 경우 `readcell`은 이 이름을 사용하여 범위를 읽을 수 있습니다. 예: `"Range","myTable"`
지정되지 않거나 비어 있음 `""`	지정되지 않거나 비어 있으면, `readcell`은 자동으로 "사용된 범위"를 감지합니다. 예: `"Range",""` 참고: 사용된 범위는 실제로 데이터가 들어 있는 스프레드시트의 사각형 부분을 말합니다. `readcell`은 데이터가 들어 있지 않은 모든 선행 행과 열, 후행 행과 열을 잘라내어 자동으로 "사용된 범위"를 감지합니다. 공백만 있는 텍스트는 데이터로 간주되어 "사용된 범위"에 캡처됩니다.

시작 셀

"Cell" 또는 [row col]

데이터에 대한 시작 셀을 다음과 같이 지정합니다.

Excel A1 표기법을 사용하여 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터를 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.
시작 행과 열을 나타내는 [row col] 형식을 갖는 요소를 2개 가진 숫자형 벡터를 지정합니다.

예: "A5" 또는 [5 1]

사각 범위

"Corner1:Corner2" 또는 [r1 c1 r2 c2]

다음 형식 중 하나로 사각 범위를 사용하여 읽어 들일 정확한 범위를 지정합니다.

"Corner1:Corner2" — 읽을 범위를 정의하는 2개의 끝 지점을 사용하여 Excel A1 표기법으로 범위를 지정합니다. 예를 들면 "C2:N15"와 같습니다.
[r1 c1 r2 c2] — 시작 행, 시작 열, 끝 행, 끝 열을 포함하는 요소를 4개 가진 숫자형 벡터를 사용하여 범위를 지정합니다. 예를 들면 [2 3 15 13]과 같습니다.

readcell은 지정된 범위에 포함된 데이터만 읽습니다. readcell은 지정된 범위 내에 있는 빈 필드는 누락된 셀로 가져옵니다.

행 범위 또는 열 범위

"Row1:Row2" 또는 "Column1:Column2"

Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다.

예: "5:500"

또는 Excel 열 문자나 열 번호를 사용하여 시작 열과 끝 열을 식별하여 범위를 지정하십시오.

지정된 범위에 있는 열 개수는 ExpectedNumVariables 속성에 지정된 개수와 일치해야 합니다.

예: "A:K"

시작 행 번호

n

양의 스칼라 행 인덱스를 사용하여 데이터를 포함하는 첫 번째 행을 지정합니다.

예: 5

Excel의 명명된 범위

"NamedRange"

예: "Range","myTable"

지정되지 않거나 비어 있음

""

지정되지 않거나 비어 있으면, readcell은 자동으로 "사용된 범위"를 감지합니다.

예: "Range",""

`DurationType` — 지속 시간 데이터의 출력 데이터형
`"duration"` (디폴트 값) | `"text"`

스프레드시트 파일의 지속 시간 데이터의 출력 데이터형으로, 다음 표에 있는 값 중 하나로 지정됩니다.

값 가져온 지속 시간 데이터의 유형

값	가져온 지속 시간 데이터의 유형
`"duration"`	MATLAB `duration` 데이터형 자세한 내용은 `duration`을 참조하십시오.
`"text"`	가져오는 지속 시간 데이터의 유형은 `TextType` 인수에 지정된 값에 따라 달라집니다. `TextType`이 `"string"`으로 설정된 경우 `readcell`은 지속 시간 데이터를 string형 배열로 반환합니다. `TextType`이 `"char"`로 설정된 경우 `readcell`은 지속 시간 데이터를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

"duration"

MATLAB duration 데이터형

자세한 내용은 duration을 참조하십시오.

"text"

가져오는 지속 시간 데이터의 유형은 TextType 인수에 지정된 값에 따라 달라집니다.

TextType이 "string"으로 설정된 경우 readcell은 지속 시간 데이터를 string형 배열로 반환합니다.
TextType이 "char"로 설정된 경우 readcell은 지속 시간 데이터를 문자형 벡터로 구성된 셀형 배열로 반환합니다.

`WebOptions` — `HTTP` 또는 `HTTPS` 요청 옵션
`weboptions` 객체

`UseExcel` — Windows용 Microsoft Excel을 시작할지 지정하는 플래그
`false` 또는 `0` (디폴트 값) | `true` 또는 `1`

스프레드시트 데이터를 읽을 때 Windows용 Microsoft Excel을 시작할지 지정하는 플래그로, 다음 값 중 하나로 지정됩니다.

1(true) — 파일을 읽을 때 Microsoft Excel을 시작합니다.
0(false) — 파일을 읽을 때 Microsoft Excel을 시작하지 않습니다. 이 모드에서 작업할 때 readcell 기능은 파일 형식 지원과 수식이나 매크로 같은 대화형 기능 지원 면에서 다르게 동작합니다.

UseExcel	`true`	`false`
지원되는 파일 형식	`.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods`	`.xls, .xlsx, .xlsm, .xltx, .xltm`
수식이나 매크로 같은 대화형 기능 지원	예	아니요

비대화형 방식의 자동화 환경에서는 UseExcel이 지원되지 않습니다.

버전 내역

R2019a에 개발됨

참고 항목

readtable | readtimetable | readmatrix | readvars | writecell

도움말 항목

Control How MATLAB Imports Your Data

readcell

구문

설명

예제

텍스트 파일에서 읽기

스프레드시트에서 읽기

스프레드시트에서 특정 범위 읽기

텍스트 파일에 대한 가져오기 옵션을 감지하고 사용하기

입력 인수

filename — 읽을 파일의 이름 string형 스칼라 | 문자형 벡터

opts — 파일 가져오기 옵션 DelimitedTextImportOptions 객체 | FixedWidthImportOptions 객체 | SpreadsheetImportOptions 객체

이름-값 인수

FileType — 파일 형식 "text" | "spreadsheet"

Delimiter — 필드 구분 기호 문자 string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

LeadingDelimitersRule — 선행 구분 기호를 관리하는 방법 "keep" | "ignore" | "error"

TrailingDelimitersRule — 후행 구분 기호를 관리하는 방법 "keep" | "ignore" | "error"

ConsecutiveDelimitersRule — 연속된 구분 기호를 관리하는 절차 "split" | "join" | "error"

NumHeaderLines — 제목 라인 수 양의 정수

TextType — 가져오는 텍스트 데이터의 유형 "string" | "char"

DatetimeType — 가져오는 날짜/시간 데이터의 유형 "datetime" (디폴트 값) | "text"

ExpectedNumVariables — 예상되는 변수 또는 열의 개수 양의 정수

Range — 읽을 데이터의 부분 string형 스칼라 | 문자형 벡터 | 숫자형 벡터

WebOptions — HTTP 또는 HTTPS 요청 옵션 weboptions 객체

Whitespace — 공백으로 처리할 문자 문자형 벡터 | string형 스칼라

LineEnding — 라인 끝(EOL) 문자 ["\n","\r","\r\n"] (디폴트 값) | string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

CommentStyle — 주석 스타일 string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

Encoding — 문자 인코딩 체계 "system" | "UTF-8" | "ISO-8859-1" | "windows-1251" | "windows-1252" | ...

DurationType — 지속 시간 데이터의 출력 데이터형 "duration" (디폴트 값) | "text"

DateLocale — 날짜 읽기에 적용할 로캘 string형 스칼라 | 문자형 벡터

FileType — 파일 형식 "text" | "spreadsheet"

NumHeaderLines — 제목 라인 수 양의 정수

TextType — 가져오는 텍스트 데이터의 유형 "string" | "char"

DatetimeType — 가져오는 날짜/시간 데이터의 유형 "datetime" (디폴트 값) | "text" | "exceldatenum"(스프레드시트 파일만 해당)

ExpectedNumVariables — 예상되는 변수 또는 열의 개수 양의 정수

Sheet — 읽어 들일 시트 '' 빈 문자형 배열 (디폴트 값) | 문자형 벡터 | string형 스칼라 | 양의 정수 스칼라

Range — 읽을 데이터의 부분 string형 스칼라 | 문자형 벡터 | 숫자형 벡터

DurationType — 지속 시간 데이터의 출력 데이터형 "duration" (디폴트 값) | "text"

WebOptions — HTTP 또는 HTTPS 요청 옵션 weboptions 객체

UseExcel — Windows용 Microsoft Excel을 시작할지 지정하는 플래그 false 또는 0 (디폴트 값) | true 또는 1

버전 내역

참고 항목

도움말 항목

`filename` — 읽을 파일의 이름
string형 스칼라 | 문자형 벡터

`opts` — 파일 가져오기 옵션
`DelimitedTextImportOptions` 객체 | `FixedWidthImportOptions` 객체 | `SpreadsheetImportOptions` 객체

`FileType` — 파일 형식
`"text"` | `"spreadsheet"`

`Delimiter` — 필드 구분 기호 문자
string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

`LeadingDelimitersRule` — 선행 구분 기호를 관리하는 방법
`"keep"` | `"ignore"` | `"error"`

`TrailingDelimitersRule` — 후행 구분 기호를 관리하는 방법
`"keep"` | `"ignore"` | `"error"`

`ConsecutiveDelimitersRule` — 연속된 구분 기호를 관리하는 절차
`"split"` | `"join"` | `"error"`

`NumHeaderLines` — 제목 라인 수
양의 정수

`TextType` — 가져오는 텍스트 데이터의 유형
`"string"` | `"char"`

`DatetimeType` — 가져오는 날짜/시간 데이터의 유형
`"datetime"` (디폴트 값) | `"text"`

`ExpectedNumVariables` — 예상되는 변수 또는 열의 개수
양의 정수

`Range` — 읽을 데이터의 부분
string형 스칼라 | 문자형 벡터 | 숫자형 벡터

`WebOptions` — `HTTP` 또는 `HTTPS` 요청 옵션
`weboptions` 객체

`Whitespace` — 공백으로 처리할 문자
문자형 벡터 | string형 스칼라

`LineEnding` — 라인 끝(EOL) 문자
`["\n","\r","\r\n"]` (디폴트 값) | string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

`CommentStyle` — 주석 스타일
string형 배열 | 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열

`Encoding` — 문자 인코딩 체계
`"system"` | `"UTF-8"` | `"ISO-8859-1"` | `"windows-1251"` | `"windows-1252"` | ...

`DurationType` — 지속 시간 데이터의 출력 데이터형
`"duration"` (디폴트 값) | `"text"`

`DateLocale` — 날짜 읽기에 적용할 로캘
string형 스칼라 | 문자형 벡터

`FileType` — 파일 형식
`"text"` | `"spreadsheet"`

`NumHeaderLines` — 제목 라인 수
양의 정수

`TextType` — 가져오는 텍스트 데이터의 유형
`"string"` | `"char"`

`DatetimeType` — 가져오는 날짜/시간 데이터의 유형
`"datetime"` (디폴트 값) | `"text"` | `"exceldatenum"`(스프레드시트 파일만 해당)

`ExpectedNumVariables` — 예상되는 변수 또는 열의 개수
양의 정수

`Sheet` — 읽어 들일 시트
`''` 빈 문자형 배열 (디폴트 값) | 문자형 벡터 | string형 스칼라 | 양의 정수 스칼라

`Range` — 읽을 데이터의 부분
string형 스칼라 | 문자형 벡터 | 숫자형 벡터

`DurationType` — 지속 시간 데이터의 출력 데이터형
`"duration"` (디폴트 값) | `"text"`

`WebOptions` — `HTTP` 또는 `HTTPS` 요청 옵션
`weboptions` 객체

`UseExcel` — Windows용 Microsoft Excel을 시작할지 지정하는 플래그
`false` 또는 `0` (디폴트 값) | `true` 또는 `1`