detectImportOptions

파일 내용에 따라 가져오기 옵션 생성

구문

opts = detectImportOptions(filename)

opts = detectImportOptions(filename,Name,Value)

설명

opts = detectImportOptions(filename)은 파일에서 테이블을 찾아서 그 테이블의 가져오기 옵션을 반환합니다. options 객체를 수정하고 readtable에서 이를 사용하여 MATLAB^®이 테이블 형식 데이터를 가져오는 방법을 제어할 수 있습니다. 반환되는 options의 유형은 파일 확장자에 따라 달라집니다. 예를 들어, filename이 스프레드시트 파일인 경우 함수는 SpreadsheetImportOptions 객체를 반환합니다. 그러나 이 함수는 filename이 텍스트 파일인 경우 DelimitedTextImportOptions 객체나 FixedWidthImportOptions 객체를, filename이 XML 파일인 경우 XMLImportOptions 객체를, filename이 HTML 파일인 경우 HTMLImportOptions 객체를, filename이 Microsoft^® Word 문서인 경우 WordDocumentImportOptions를 반환합니다.

예제

opts = detectImportOptions(filename,Name,Value)는 하나 이상의 Name,Value 쌍 인수로 지정된 추가 파라미터를 활용하여 파일에서 테이블을 찾습니다.

예제

모두 축소

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

라이브 스크립트 열기

스프레드시트 파일에 대한 가져오기 옵션을 감지하고, 가져올 변수를 지정한 다음 데이터를 읽어 들입니다.

파일에서 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
           VariableNamingRule: 'modify'

   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

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

라이브 스크립트 열기

가져오기 옵션을 만들고 여러 변수의 데이터형을 조정한 후 데이터를 읽어 들입니다.

텍스트 파일에서 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'
       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

변수 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

Microsoft Word 문서 파일에 대한 가져오기 옵션을 감지하고 사용하기

라이브 스크립트 열기

Microsoft Word 문서 파일에 대한 가져오기 옵션을 감지하고, 가져올 테이블을 지정한 다음 데이터를 읽어 들입니다.

파일 MaintenanceReport.docx에는 두 개의 테이블이 포함되어 있습니다. 두 번째 테이블의 마지막 행에는 테이블 변수와 일치하지 않는 병합된 열을 가진 셀이 들어 있습니다.

detectImportOptions 함수를 사용하여 가져오기 옵션을 감지합니다. TableIndex를 2로 설정하여 두 번째 테이블에서 읽어 들이도록 지정합니다.

filename = "MaintenanceReport.docx";
opts = detectImportOptions(filename,'TableIndex',2)

opts = 
  WordDocumentImportOptions with properties:

   Replacement Properties:
                MissingRule: "fill"
            ImportErrorRule: "fill"
               EmptyRowRule: "skip"
       MergedCellColumnRule: "placeleft"
          MergedCellRowRule: "placetop"
           ExtraColumnsRule: "addvars"

   Variable Import Properties: Set types by name using setvartype
              VariableNames: ["Description"    "Category"    ...    ]
              VariableTypes: ["string"    "string"    "string"    ...    ]
      SelectedVariableNames: ["Description"    "Category"    ...    ]
            VariableOptions: Show all 5 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
         VariableNamingRule: "preserve"

   Location Properties:
              TableSelector: "(//w:tbl)[2]"
                   DataRows: [2 Inf]
           VariableNamesRow: 1
           VariableUnitsRow: 0
    VariableDescriptionsRow: 0
             RowNamesColumn: 0

병합된 열이 있는 셀을 가진 행을 읽어 들이지 않고 건너뛰도록 MergedCellColumnRule 속성을 'omitrow'로 설정합니다.

opts.MergedCellColumnRule = 'omitrow';

options 객체와 함께 readtable 함수를 사용하여 Microsoft Word 문서 파일의 테이블을 읽어 들입니다.

filename = "MaintenanceReport.docx";
T = readtable(filename,opts)

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"

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

라이브 스크립트 열기

HTML 파일에 대한 가져오기 옵션을 감지하고, 가져올 테이블을 지정한 다음 데이터를 읽어 들입니다.

URL https://www.mathworks.com/help/matlab/text-files.html에서 텍스트 "readtable"을 포함하는 첫 번째 테이블의 가져오기 옵션을 감지합니다. detectImportOptions 함수를 사용하여 가져오기 옵션을 감지하고 XPath 쿼리 "//TABLE[contains(.,'readtable')]"을 사용하여 읽어 들일 테이블을 지정합니다. ReadVariableNames를 false로 설정하여 변수 이름을 읽어 들이지 않도록 지정합니다.

url = "https://www.mathworks.com/help/matlab/text-files.html";
opts = detectImportOptions(url,'TableSelector',"//TABLE[contains(.,'readtable')]",'ReadVariableNames',false)

opts = 
  HTMLImportOptions with properties:

   Replacement Properties:
                MissingRule: "fill"
            ImportErrorRule: "fill"
               EmptyRowRule: "skip"

   Variable Import Properties: Set types by name using setvartype
              VariableNames: ["Var1"    "Var2"]
              VariableTypes: ["string"    "string"]
      SelectedVariableNames: ["Var1"    "Var2"]
            VariableOptions: Show all 2 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
         VariableNamingRule: "modify"

   Location Properties:
              TableSelector: "//TABLE[contains(.,'readtable')]"
           VariableNamesRow: 0
           VariableUnitsRow: 0
    VariableDescriptionsRow: 0
             RowNamesColumn: 0

readtable 함수를 사용하여 테이블을 읽어 들입니다.

T = readtable(url,opts)

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"

가져온 텍스트 데이터의 데이터형 지정하기

라이브 스크립트 열기

가져오기 옵션을 지정하여 텍스트 데이터를 문자열 데이터형으로 가져옵니다.

파일에 대한 options 객체를 만듭니다.

opts = detectImportOptions('outages.csv');

readtable을 사용하여 가져올 변수를 지정한 다음 요약을 표시합니다. 선택한 변수의 데이터형은 char입니다.

opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts);
summary(T)

Variables:

    Region: 1468x1 cell array of character vectors

    Cause: 1468x1 cell array of character vectors

텍스트 데이터를 string 데이터형으로 가져온 다음 TextType 이름-값 쌍을 지정하여 가져오기 옵션을 만듭니다.

opts = detectImportOptions('outages.csv','TextType','string');

readtable을 사용하여 가져올 변수를 지정한 다음 요약을 표시합니다. 이제, 선택한 변수의 데이터형은 string입니다.

opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts);
summary(T)

Variables:

    Region: 1468x1 string

    Cause: 1468x1 string

사용자 지정 XML 네임스페이스 접두사 등록하기

라이브 스크립트 열기

RegisteredNamespaces 이름-값 인수를 사용하여 입력 파일의 기존 네임스페이스 URL에 사용자 지정 XML 네임스페이스 접두사를 등록합니다.

XML 파일에서 XMLImportOptions 객체를 만듭니다. Street 요소 노드의 XPath 표현식을 'VariableSelectors'의 값으로 지정하고 Street 노드에 속한 URL에 접두사 myPrefix를 등록합니다.

opts = detectImportOptions("students.xml","RegisteredNamespaces", ["myPrefix","https://www.mathworks.com"],...
    "VariableSelectors","//myPrefix:Street")

opts = 
  XMLImportOptions with properties:

   Replacement Properties:
                     MissingRule: "fill"
                 ImportErrorRule: "fill"
                RepeatedNodeRule: "addcol"

   Variable Import Properties: Set types by name using setvartype
                   VariableNames: "Street"
                   VariableTypes: "string"
           SelectedVariableNames: "Street"
                 VariableOptions: Show all 1 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
              VariableNamingRule: "preserve"

   Location Properties:
                   TableSelector: <missing>
                     RowSelector: <missing>
               VariableSelectors: "//myPrefix:Street"
           VariableUnitsSelector: <missing>
    VariableDescriptionsSelector: <missing>
                RowNamesSelector: <missing>
            RegisteredNamespaces: ["myPrefix"    "https://www.mathworks.com"]

options 객체와 함께 readtable 함수를 사용하여 선택한 변수를 가져옵니다.

T2 = readtable("students.xml",opts)

T2=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"

입력 인수

모두 축소

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

읽을 파일의 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

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

위치

형식

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

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

예: 'myFile.txt'

폴더 안의 파일

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

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

예: '\imgDir\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'

filename에 파일 확장자가 포함되는 경우 detectImportOptions는 확장자를 통해 파일 형식을 결정하게 됩니다. 파일 형식을 따로 나타내고자 하면 'FileType' 이름-값 쌍을 지정해야 합니다.

detectImportOptions 함수가 지원하는 파일 확장자에는 .txt, .dat, .csv, .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods, .xml, .docx, .html, .xhtml, .htm 등이 있습니다.

참고

파일 확장자 .xlsb와 .ods는 Windows^®용 Excel^®이 설치되어 있는 플랫폼에서만 지원됩니다.

데이터형: char | string

이름-값 인수

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

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

예: 'FileType','spreadsheet'

지원되는 모든 파일 형식

모두 축소

`FileType` — 파일 형식
`'spreadsheet'` | `'text'` | `'delimitedtext'` | `'fixedwidth'` | `'xml'` | `'worddocument'` | `'html'`

파일 형식으로, 'FileType'과 함께 다음 값 중 하나가 쉼표로 구분되어 지정됩니다.

값	파일에 대한 가져오기 옵션
`'spreadsheet'`	`SpreadsheetImportOptions` 객체를 반환합니다.
`'text'`	텍스트 파일의 레이아웃에 따라 `DelimitedTextImportOptions` 또는 `FixedWidthImportOptions` 객체를 반환합니다.
`'delimitedtext'`	`DelimitedTextImportOptions` 객체를 반환합니다. 이 옵션은 구분 기호를 사용해서 열이 구분되어 있는 텍스트 파일에 사용하십시오.
`'fixedwidth'`	`FixedWidthImportOptions` 객체를 반환합니다. 이 옵션은 고정 너비의 열을 가진 텍스트 파일에 사용하십시오.
`'xml'`	`XMLImportOptions` 객체를 반환합니다. 이 옵션은 XML 파일에 사용하십시오.
`'worddocument'`	`WordDocumentImportOptions` 객체를 반환합니다. 이 옵션은 Microsoft Word 문서 파일에 사용하십시오.
`'html'`	`HTMLImportOptions` 객체를 반환합니다. 이 옵션은 HTML 파일에 사용하십시오.

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

.txt, .dat, .csv - 텍스트 파일
.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods - 스프레드시트 파일
.xml - XML 파일
.docx - Microsoft Word 문서 파일
.html, .xhtml 또는 .htm - HTML 파일

파일 확장자 .xlsb와 .ods는 Windows용 Excel이 설치되어 있는 플랫폼에서만 지원됩니다.

예: 'FileType','text'

데이터형: 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 `datetime` 데이터형 자세한 내용은 `datetime`을 참조하십시오.
`'text'`	`'DatetimeType'`이 `'text'`로 지정된 경우, 가져오는 날짜/시간 데이터의 유형은 `'TextType'` 파라미터에 지정된 값에 따라 달라집니다. `'TextType'`이 `'char'`로 설정된 경우 가져오기 함수는 날짜를 문자형 벡터로 구성된 셀형 배열로 반환합니다. `'TextType'`이 `'string'`으로 설정된 경우 가져오기 함수는 날짜를 string형 배열로 반환합니다.
`'exceldatenum'`	Excel 날짜 일련 번호 값 날짜 일련 번호 값은 주어진 기준 날짜로부터의 일수로, 단일 숫자입니다. Excel 날짜 일련 번호 값은 MATLAB 날짜 일련 번호 값과는 다른 기준 날짜를 사용합니다. Excel 날짜에 대한 자세한 내용은 `https://support.microsoft.com/kb/214330`을 참조하십시오.

'datetime'

MATLAB datetime 데이터형

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

'text'

'DatetimeType'이 'text'로 지정된 경우, 가져오는 날짜/시간 데이터의 유형은 'TextType' 파라미터에 지정된 값에 따라 달라집니다.

'TextType'이 'char'로 설정된 경우 가져오기 함수는 날짜를 문자형 벡터로 구성된 셀형 배열로 반환합니다.
'TextType'이 'string'으로 설정된 경우 가져오기 함수는 날짜를 string형 배열로 반환합니다.

'exceldatenum'

Excel 날짜 일련 번호 값

날짜 일련 번호 값은 주어진 기준 날짜로부터의 일수로, 단일 숫자입니다. Excel 날짜 일련 번호 값은 MATLAB 날짜 일련 번호 값과는 다른 기준 날짜를 사용합니다. Excel 날짜에 대한 자세한 내용은 https://support.microsoft.com/kb/214330을 참조하십시오.

데이터형: char | string

`ReadVariableNames` — 첫 번째 행을 변수 이름으로 읽기
`true` | `false`

첫 번째 행을 변수 이름으로 읽을지 여부를 나타내는 표시자로, 'ReadVariableNames'와 함께 true 또는 false가 쉼표로 구분되어 지정됩니다. 지정되지 않은 경우, readtable은 자동으로 변수 이름의 존재를 감지합니다.

표시자	설명
`true`	읽을 영역의 첫 번째 행에 테이블의 변수 이름이 포함되어 있는 경우에 사용하십시오. `readtable`은 각 열별 변수를 감지된 변수 이름으로 `T`에 만듭니다.
`false`	읽을 영역의 첫 번째 행에 테이블의 데이터가 포함되어 있는 경우에 사용하십시오. `readtable`은 `'Var1',...,'VarN'` 형식으로 디폴트 변수 이름을 만듭니다. 여기에서 `N`은 변수 번호입니다.
지정되지 않음	지정되지 않으면 가져오기 함수는 자동으로 `true`나 `false`를 감지하고 그 결과에 따라 진행합니다.

데이터형: logical

`VariableNamingRule` — 변수 이름을 유지할지 지정하는 플래그
`"modify"` (디폴트 값) | `"preserve"`

변수 이름을 유지할지 지정하는 플래그로, "modify" 또는 "preserve" 중 하나로 지정됩니다.

"modify" — 유효하지 않은 변수 이름(유효 여부는 isvarname 함수의 판정에 따름)을 유효한 MATLAB 식별자로 변환합니다.
"preserve" — 공백과 비ASCII 문자가 포함된 변수 이름과 같이 MATLAB 식별자로 유효하지 않은 변수 이름을 그대로 유지합니다.

R2019b부터 변수 이름과 행 이름에 공백, 비ASCII 문자 등 모든 문자를 사용할 수 있습니다. 또한 영문자뿐만 아니라 어떤 문자로도 시작할 수 있습니다. 변수 이름과 행 이름은 유효한 MATLAB 식별자(유효 여부는 isvarname 함수의 판정에 따름)가 아니어도 됩니다. 변수 이름과 행 이름을 그대로 유지하려면 VariableNamingRule의 값을 "preserve"로 설정하십시오. VariableNamingRule의 값이 "modify"에서 "preserve"로 변경될 때 변수 이름은 새로 고쳐지지 않습니다.

데이터형: char | string

`ReadRowNames` — 첫 번째 열을 행 이름으로 읽을지 여부를 나타내는 표시자
`false` (디폴트 값) | `true`

첫 번째 열을 행 이름으로 읽을지 여부를 나타내는 표시자로, 'ReadRowNames'와 함께 false 또는 true가 쉼표로 구분되어 지정됩니다.

표시자	설명
`false`	읽을 영역의 첫 번째 열이 데이터를 포함하며 테이블의 행 이름이 아닌 경우에 사용하십시오.
`true`	읽을 영역의 첫 번째 열에 테이블의 행 이름이 포함되어 있는 경우에 사용하십시오.
지정되지 않음	지정되지 않으면 가져오기 함수는 `false`라고 간주합니다.

데이터형: logical

`MissingRule` — 누락된 데이터를 관리하는 방법
`'fill'` (디폴트 값) | `'error'` | `'omitrow'` | `'omitvar'`

누락된 데이터를 관리하는 방법으로, 다음 표에 있는 값 중 하나로 지정됩니다.

누락 규칙	동작
`'fill'`	누락된 데이터를 `FillValue` 속성의 내용으로 대체합니다. `FillValue` 속성은 가져올 변수의 `VariableImportOptions` 객체에 지정됩니다. `FillValue` 속성에 액세스하는 데 대한 자세한 내용은 `getvaropts`를 참조하십시오.
`'error'`	가져오기를 중지하고 누락된 레코드와 필드를 보여주는 오류 메시지를 표시합니다.
`'omitrow'`	누락된 데이터가 포함된 행을 생략합니다.
`'omitvar'`	누락된 데이터가 포함된 변수를 생략합니다.

예: opts.MissingRule = 'omitrow';

데이터형: char | string

`ImportErrorRule` — 가져오기 오류를 처리하는 절차
`'fill'` (디폴트 값) | `'error'` | `'omitrow'` | `'omitvar'`

가져오기 오류를 처리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.

가져오기 오류 규칙	동작
`'fill'`	오류가 발생한 데이터를 `FillValue` 속성의 내용으로 대체합니다. `FillValue` 속성은 가져올 변수의 `VariableImportOptions` 객체에 지정됩니다. `FillValue` 속성에 액세스하는 데 대한 자세한 내용은 `getvaropts`를 참조하십시오.
`'error'`	가져오기를 중지하고 오류를 일으킨 레코드와 필드를 보여주는 오류 메시지를 표시합니다.
`'omitrow'`	오류가 발생한 행을 생략합니다.
`'omitvar'`	오류가 발생한 변수를 생략합니다.

예: opts.ImportErrorRule = 'omitvar';

데이터형: char | string

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

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

텍스트 파일과 스프레드시트 파일

모두 축소

`ExpectedNumVariables` — 예상 변수 개수
양의 정수

예상 변수 개수로, 'ExpectedNumVariables'와 함께 양의 정수가 쉼표로 구분되어 지정됩니다. 지정되지 않은 경우, 가져오기 함수가 자동으로 변수 개수를 감지합니다.

데이터형: single | double

`NumHeaderLines` — 헤더 라인 수
양의 정수

파일의 헤더 라인 수로, 'NumHeaderLines'와 함께 양의 정수가 쉼표로 구분되어 지정됩니다. 지정되지 않은 경우, 가져오기 함수가 자동으로 파일에 있는 헤더 라인 수를 감지합니다.

예: 'NumHeaderLines',7

데이터형: single | double

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

텍스트 또는 스프레드시트 파일에서 읽을 데이터의 부분으로, 'Range'와 함께 다음 형식 중 하나의 문자형 벡터, string형 스칼라 또는 숫자형 벡터가 쉼표로 구분되어 지정됩니다.

Range를 지정하는 방법 설명

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

시작 셀

'Cell' 또는 [row col]

데이터의 시작 셀을 문자형 벡터나 string형 스칼라 또는 요소를 2개 가진 숫자형 벡터로 지정합니다.

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

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

예: 'A5' 또는 [5 1]

사각 범위

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

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

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

가져오기 함수는 지정된 범위에 포함된 데이터만 읽어옵니다. 지정된 범위 내에 있는 모든 빈 필드는 누락된 셀로서 가져옵니다.

행 범위 또는 열 범위

'Row1:Row2' 또는 'Column1:Column2'

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

가져오기 함수는 지정된 행 범위를 사용하여 비어 있지 않은 첫 번째 열부터 데이터의 끝까지 읽어 들이는 방식으로 열의 범위를 자동으로 검색하고 열당 하나의 변수를 생성합니다.

예: '5:500'

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

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

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

예: 'A:K'

시작 행 번호

n

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

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

예:5

Excel의 명명된 범위

'NamedRange'

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

예: 'Range','myTable'

지정되지 않거나 비어 있음

''

지정되지 않은 경우, 가져오기 함수가 자동으로 "사용된 범위"를 감지합니다.

예: 'Range',''

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

데이터형: char | string | double

스프레드시트 파일 전용 파라미터

모두 축소

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

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

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

데이터형: char | string | single | double

`DataRange` — 데이터의 위치
문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | 양의 정수 스칼라로 구성된 배열 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

가져올 데이터의 위치로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열, string형 배열, 양의 정수 스칼라 또는 양의 정수 스칼라로 구성된 N×2 배열로 지정됩니다. 다음 형식 중 하나를 사용하여 DataRange를 지정하십시오.

지정 유형 동작

지정 유형	동작
`'Cell'` 또는 `n` 시작 셀 또는 시작 행	Excel `A1` 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, `A5`는 열 `A`와 행 `5`가 교차하는 지점에 있는 셀의 식별자입니다. 가져오기 함수는 시작 셀을 사용하여 시작 셀에서 가져오기를 시작하고 마지막 빈 행이나 푸터 범위에서 가져오기를 종료하는 방식으로 데이터의 범위를 자동으로 검색합니다. 또는 양의 스칼라 행 인덱스를 사용하여 데이터를 포함하는 첫 번째 행을 지정합니다. 가져오기 함수는 지정된 행 인덱스를 사용하여 지정된 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 데이터의 범위를 자동으로 검색합니다. 예: `'A5'` 또는 `5`
`'Corner1:Corner2'` 사각 범위	사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 `Corner1`과 `Corner2`는 읽을 범위를 정의하는 2개의 끝 지점입니다. 가져오기 함수는 지정된 범위에 포함된 데이터만 읽어옵니다. 지정된 범위 내에 있는 모든 빈 필드는 누락된 셀로서 가져옵니다. 열의 개수는 `NumVariables` 속성에 지정된 개수와 일치해야 합니다. 예: `'A5:K50'`
`'Row1:Row2'` 또는 `'Column1:Column2'` 행 범위 또는 열 범위	Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다. 가져오기 함수는 지정된 행 범위를 사용하여 비어 있지 않은 첫 번째 열부터 데이터의 끝까지 읽어 들이는 방식으로 열의 범위를 자동으로 검색하고 열당 하나의 변수를 생성합니다. 예: `'5:500'` 또는 Excel 열 문자나 열 번호를 사용하여 시작 열과 끝 열을 식별하여 범위를 지정하십시오. 가져오기 함수는 지정된 열 범위를 사용하여 비어 있지 않은 첫 번째 행부터 데이터의 끝까지 읽어 들이거나 푸터 범위를 읽어 들이는 방식으로 행의 범위를 자동으로 검색합니다. 지정된 범위에 있는 열 개수는 `NumVariables` 속성에 지정된 개수와 일치해야 합니다. 예: `'A:K'`
`[n1 n2; n3 n4;...]` 여러 개의 행 범위	`N`개의 서로 다른 행 범위를 갖는 `N`×`2` 배열을 사용하여 읽을 여러 개의 행 범위를 지정합니다. 여러 개의 행 범위로 구성된 유효한 배열은 다음을 충족해야 합니다. 라인 범위를 오름차순으로 지정해야 합니다. 즉, 배열에 지정된 첫 번째 행 범위가 다른 행 범위보다 파일에서 먼저 나타나야 합니다. 행 범위가 서로 겹치지 않아야 합니다. `Inf`는 여러 개의 행 범위를 지정하는 숫자형 배열의 마지막 범위를 나타낼 때만 사용해야 합니다. 예를 들면 `[1 3; 5 6; 8 Inf]`와 같습니다. 예: `[1 3; 5 6; 8 Inf]`
`''` 지정되지 않거나 비어 있음	데이터를 가져오지 않습니다. 예: `''`

'Cell' 또는 n

시작 셀 또는 시작 행

Excel A1 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.

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

예: 'A5' 또는 5

'Corner1:Corner2'

사각 범위

사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 Corner1과 Corner2는 읽을 범위를 정의하는 2개의 끝 지점입니다.

가져오기 함수는 지정된 범위에 포함된 데이터만 읽어옵니다. 지정된 범위 내에 있는 모든 빈 필드는 누락된 셀로서 가져옵니다.

열의 개수는 NumVariables 속성에 지정된 개수와 일치해야 합니다.

예: 'A5:K50'

'Row1:Row2' 또는 'Column1:Column2'

행 범위 또는 열 범위

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

예: '5:500'

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

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

예: 'A:K'

[n1 n2; n3 n4;...]

여러 개의 행 범위

N개의 서로 다른 행 범위를 갖는 N×2 배열을 사용하여 읽을 여러 개의 행 범위를 지정합니다.

여러 개의 행 범위로 구성된 유효한 배열은 다음을 충족해야 합니다.

라인 범위를 오름차순으로 지정해야 합니다. 즉, 배열에 지정된 첫 번째 행 범위가 다른 행 범위보다 파일에서 먼저 나타나야 합니다.
행 범위가 서로 겹치지 않아야 합니다.

Inf는 여러 개의 행 범위를 지정하는 숫자형 배열의 마지막 범위를 나타낼 때만 사용해야 합니다. 예를 들면 [1 3; 5 6; 8 Inf]와 같습니다.

예: [1 3; 5 6; 8 Inf]

''

지정되지 않거나 비어 있음

데이터를 가져오지 않습니다.

예: ''

데이터형: char | string | cell | single | double

`RowNamesRange` — 행 이름의 위치
문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | `''` 빈 문자형 배열

행 이름의 위치로, 문자형 벡터, string형 스칼라, 양의 정수 스칼라 또는 빈 문자형 배열로 지정됩니다. 다음 표에 있는 값 중 하나로 RowNamesRange를 지정합니다.

지정 유형 동작

지정 유형	동작
`'Cell'`	Excel `A1` 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, `A5`는 열 `A`와 행 `5`가 교차하는 지점에 있는 셀의 식별자입니다. 가져오기 함수가 데이터에 포함된 각 변수의 이름을 식별합니다. 예: `'A5'`
`'Corner1:Corner2'` 사각 범위	사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 `Corner1`과 `Corner2`는 읽을 범위를 정의하는 2개의 끝 지점입니다. `RowNamesRange`에 포함된 행 번호는 데이터의 행 번호와 일치해야 하고, `RowNamesRange`에 지정된 범위는 한 열로만 이루어져야 합니다. 예: `'A5:A50'`
`'Row1:Row2'` 행 범위	Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다. 행 이름은 하나의 열에 있어야 합니다. 예: `'5:50'`
`n` 숫자 인덱스	양의 스칼라 열 인덱스를 사용하여 행 이름을 포함하는 열을 지정합니다. 예: `5`
`''` 지정되지 않거나 비어 있음	행 이름이 없음을 나타냅니다. 예: `''`

'Cell'

Excel A1 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.

가져오기 함수가 데이터에 포함된 각 변수의 이름을 식별합니다.

예: 'A5'

'Corner1:Corner2'

사각 범위

사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 Corner1과 Corner2는 읽을 범위를 정의하는 2개의 끝 지점입니다.

RowNamesRange에 포함된 행 번호는 데이터의 행 번호와 일치해야 하고, RowNamesRange에 지정된 범위는 한 열로만 이루어져야 합니다.

예: 'A5:A50'

'Row1:Row2'

행 범위

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

행 이름은 하나의 열에 있어야 합니다.

예: '5:50'

n

숫자 인덱스

양의 스칼라 열 인덱스를 사용하여 행 이름을 포함하는 열을 지정합니다.

예: 5

''

지정되지 않거나 비어 있음

행 이름이 없음을 나타냅니다.

예: ''

데이터형: char | single | double

`VariableNamesRange` — 변수 이름의 위치
문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | `''` 빈 문자형 배열

변수 이름의 위치로, 문자형 벡터, string형 스칼라, 양의 정수 스칼라 또는 빈 문자형 배열로 지정됩니다. 다음 표에 있는 값 중 하나로 VariableNamesRange를 지정합니다.

지정 유형 동작

지정 유형	동작
`'Cell'`	Excel `A1` 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, `A5`는 열 `A`와 행 `5`가 교차하는 지점에 있는 셀의 식별자입니다. 가져오기 함수가 데이터에 포함된 각 변수의 이름을 읽어 들입니다. 예: `'A5'`
`'Corner1:Corner2'` 사각 범위	사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 `Corner1`과 `Corner2`는 읽을 범위를 정의하는 2개의 끝 지점입니다. `NumVariables` 속성에 지정된 번호는 열 번호와 일치해야 하고, 범위는 한 행으로만 이루어져야 합니다. 예: `'A5:K5'`
`'Row1:Row2'` 행 범위	Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다. 변수 이름은 단일 행에 있어야 합니다. 예: `'5:5'`
`n` 숫자 인덱스	양의 스칼라 행 인덱스를 사용하여 변수 이름을 포함하는 행을 지정합니다. 예: `5`
`''` 지정되지 않거나 비어 있음	변수 이름이 없음을 나타냅니다. 예: `''`

'Cell'

Excel A1 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.

가져오기 함수가 데이터에 포함된 각 변수의 이름을 읽어 들입니다.

예: 'A5'

'Corner1:Corner2'

사각 범위

사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 Corner1과 Corner2는 읽을 범위를 정의하는 2개의 끝 지점입니다.

NumVariables 속성에 지정된 번호는 열 번호와 일치해야 하고, 범위는 한 행으로만 이루어져야 합니다.

예: 'A5:K5'

'Row1:Row2'

행 범위

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

변수 이름은 단일 행에 있어야 합니다.

예: '5:5'

n

숫자 인덱스

양의 스칼라 행 인덱스를 사용하여 변수 이름을 포함하는 행을 지정합니다.

예: 5

''

지정되지 않거나 비어 있음

변수 이름이 없음을 나타냅니다.

예: ''

데이터형: char | single | double

`VariableUnitsRange` — 변수 단위의 위치
문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | `''` 빈 문자형 배열

변수 단위의 위치로, 문자형 벡터, string형 스칼라, 양의 정수 스칼라 또는 빈 문자형 배열로 지정됩니다. 다음 표에 있는 값 중 하나로 VariableUnitsRange를 지정합니다.

지정 유형 동작

지정 유형	동작
`'Cell'`	Excel `A1` 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, `A5`는 열 `A`와 행 `5`가 교차하는 지점에 있는 셀의 식별자입니다. 가져오기 함수가 데이터에 포함된 각 변수의 단위를 읽어 들입니다. 예: `'A5'`
`'Corner1:Corner2'` 사각 범위	사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 `Corner1`과 `Corner2`는 읽을 범위를 정의하는 2개의 끝 지점입니다. `NumVariables` 속성에 지정된 번호는 열 번호와 일치해야 하고, 범위는 한 행으로만 이루어져야 합니다. 예: `'A5:K5'`
`'Row1:Row2'` 행 범위	Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다. 변수 이름은 단일 행에 있어야 합니다. 예: `'5:5'`
`n` 숫자 인덱스	양의 스칼라 행 인덱스를 사용하여 데이터 단위를 포함하는 행을 지정합니다. 예: `5`
`''` 지정되지 않거나 비어 있음	변수 단위가 없음을 나타냅니다. 예: `''`

'Cell'

Excel A1 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.

가져오기 함수가 데이터에 포함된 각 변수의 단위를 읽어 들입니다.

예: 'A5'

'Corner1:Corner2'

사각 범위

사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 Corner1과 Corner2는 읽을 범위를 정의하는 2개의 끝 지점입니다.

NumVariables 속성에 지정된 번호는 열 번호와 일치해야 하고, 범위는 한 행으로만 이루어져야 합니다.

예: 'A5:K5'

'Row1:Row2'

행 범위

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

변수 이름은 단일 행에 있어야 합니다.

예: '5:5'

n

숫자 인덱스

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

예: 5

''

지정되지 않거나 비어 있음

변수 단위가 없음을 나타냅니다.

예: ''

데이터형: char | string | single | double

`VariableDescriptionsRange` — 변수 설명의 위치
문자형 벡터 | string형 스칼라 | `''` 빈 문자형 배열

변수 설명의 위치로, 문자형 벡터, string형 스칼라, 양의 정수 스칼라 또는 빈 문자형 배열로 지정됩니다. 다음 표에 있는 값 중 하나로 VariableDescriptionRange를 지정합니다.

지정 유형 동작

지정 유형	동작
`'Cell'`	Excel `A1` 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, `A5`는 열 `A`와 행 `5`가 교차하는 지점에 있는 셀의 식별자입니다. 가져오기 함수가 데이터에 포함된 각 변수의 설명을 읽어 들입니다. 예: `'A5'`
`'Corner1:Corner2'` 사각 범위	사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 `Corner1`과 `Corner2`는 읽을 범위를 정의하는 2개의 끝 지점입니다. `NumVariables` 속성에 지정된 번호는 열 번호와 일치해야 하고, 범위는 한 행으로만 이루어져야 합니다. 예: `'A5:K5'`
`'Row1:Row2'` 행 범위	Excel 행 번호를 사용하여 시작 행과 끝 행을 식별하여 범위를 지정합니다. 변수 이름은 단일 행에 있어야 합니다. 예: `'5:5'`
`n` 숫자 인덱스	양의 스칼라 행 인덱스를 사용하여 설명을 포함하는 행을 지정합니다. 예: `5`
`''` 지정되지 않거나 비어 있음	변수 설명이 없음을 나타냅니다. 예: `''`

'Cell'

Excel A1 표기법을 사용하여 데이터에 대한 시작 셀을 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.

가져오기 함수가 데이터에 포함된 각 변수의 설명을 읽어 들입니다.

예: 'A5'

'Corner1:Corner2'

사각 범위

사각 범위 형식을 사용하여 읽을 정확한 범위를 지정합니다. 여기서 Corner1과 Corner2는 읽을 범위를 정의하는 2개의 끝 지점입니다.

NumVariables 속성에 지정된 번호는 열 번호와 일치해야 하고, 범위는 한 행으로만 이루어져야 합니다.

예: 'A5:K5'

'Row1:Row2'

행 범위

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

변수 이름은 단일 행에 있어야 합니다.

예: '5:5'

n

숫자 인덱스

양의 스칼라 행 인덱스를 사용하여 설명을 포함하는 행을 지정합니다.

예: 5

''

지정되지 않거나 비어 있음

변수 설명이 없음을 나타냅니다.

예: ''

데이터형: char | string | single | double

텍스트 파일 전용 파라미터

모두 축소

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

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

예: 'Delimiter','|'

예: 'Delimiter',{';','*'}

데이터형: char | string | cell

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

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

선행 구분 기호 규칙	동작
`'keep'`	구분 기호를 유지합니다.
`'ignore'`	구분 기호를 무시합니다.
`'error'`	오류를 반환하고 가져오기 작업을 중단합니다.

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

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

선행 구분 기호 규칙	동작
`'keep'`	구분 기호를 유지합니다.
`'ignore'`	구분 기호를 무시합니다.
`'error'`	오류를 반환하고 가져오기 작업을 중단합니다.

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

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

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

데이터형: char | string

`VariableWidths` — 변수의 필드 너비
양의 정수 값으로 구성된 벡터

고정 너비 텍스트 파일의 변수 필드 너비로, 양의 정수 값으로 구성된 벡터로 지정됩니다. 벡터를 구성하는 각각의 양의 정수는 변수를 만드는 필드의 문자 수에 해당합니다. VariableWidths 속성에는 VariableNames 속성에 지정된 각 변수에 대응하는 요소가 포함되어 있습니다.

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

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

예: 'Whitespace',' _'

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

`LineEnding` — 라인 끝(EOL) 문자
`{'\n','\r','\r\n'}` (디폴트 값) | 문자형 벡터 | string형 스칼라 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

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

예: 'LineEnding','\n'

예: 'LineEnding','\r\n'

예: 'LineEnding',{'\b',':'}

데이터형: char | string | cell

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

파일과 연결된 문자 인코딩 체계로, 'Encoding'과 함께 'system' 또는 표준 문자 인코딩 체계 이름이 쉼표로 구분되어 지정됩니다.

인코딩을 지정하지 않은 경우 함수는 파일을 읽을 때 문자 집합을 자동으로 감지하여 인코딩을 결정합니다.

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

데이터형: char | string

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

주석 스타일로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

예를 들어, CommentStyle을 '%'로 지정하면 동일한 라인에 있는 퍼센트 기호 다음의 텍스트가 무시됩니다.

예: 'CommentStyle',{'/*'}

데이터형: char | string | cell

`DurationType` — duration형 데이터의 출력 데이터형
`'duration'` (디폴트 값) | `'text'`

텍스트 파일의 duration형 데이터의 출력 데이터형으로, 'DurationType'과 함께 'duration'이나 'text'가 쉼표로 구분되어 지정됩니다.

값 가져오는 duration형 데이터의 유형

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

'duration'

MATLAB duration 데이터형

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

'text'

'DurationType'이 'text'로 지정된 경우, 가져오는 duration형 데이터의 유형은 'TextType' 파라미터에 지정된 값에 따라 달라집니다.

'TextType'이 'char'로 설정된 경우 가져오기 함수는 duration형 데이터를 문자형 벡터로 구성된 셀형 배열로 반환합니다.
'TextType'이 'string'으로 설정된 경우 가져오기 함수는 duration형 데이터를 string형 배열로 반환합니다.

데이터형: char | string

`ExtraColumnsRule` — 추가 열을 처리하는 절차
`'addvars'` | `'ignore'` | `'wrap'` | `'error'`

데이터의 추가 열을 처리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.

추가 열 규칙	동작
`'addvars'`	추가 열을 가져오기 위해 새 변수를 생성합니다. `N`개의 추가 열이 있는 경우, 새 변수를 `'ExtraVar1', 'ExtraVar2',..., 'ExtraVarN'`으로 가져옵니다. 데이터의 추가 열은 `VariableTypes`가 `char`인 것으로 간주하여 가져옵니다.
`'ignore'`	데이터의 추가 열을 무시합니다.
`'wrap'`	새 레코드로 데이터의 추가 열을 줄 바꿈합니다. 이 동작을 수행해도 변수의 개수는 변경되지 않습니다.
`'error'`	오류 메시지를 표시하고 가져오기 작업을 중단합니다.

데이터형: char | string

`TreatAsMissing` — 누락된 데이터로 해석할 텍스트
문자형 벡터 | string형 스칼라 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

누락된 데이터로 해석할 텍스트로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다.

가져오기 함수가 누락된 인스턴스를 발견하면 MissingRule 속성의 조건을 사용하여 적합한 동작을 결정합니다.

예: 'TreatAsMissing',{'NA','TBD'}는 가져오기 함수에 NA 또는 TBD 인스턴스를 누락된 필드로 처리하도록 지시합니다.

데이터형: char | string | cell

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

날짜 읽기에 적용할 로캘로, 'DateLocale'과 함께 xx_YY 형식의 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 여기서,

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

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

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

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

opts 가져오기 옵션과 함께 DateLocale 인수를 지정하면, 가져오기 함수는 DateLocale 인수에 지정된 값을 사용하며 가져오기 옵션에 정의된 로캘을 무시합니다.

예: 'DateLocale','ja_JP'

`ThousandsSeparator` — 천 단위 구분을 나타내는 문자
문자형 벡터 | string형 스칼라

숫자형 변수의 천 단위 구분을 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 천 단위 구분 문자는 매 세 자리값에서 숫자를 분류하는 시각적 구분 기호로 동작합니다. 가져오기 함수는 ThousandsSeparator 속성의 문자를 사용하여 가져올 숫자를 해석합니다.

데이터형: char | string

`DecimalSeparator` — 소수점 구분 기호를 나타내는 문자
문자형 벡터 | string형 스칼라

숫자형 변수의 소수점 구분 기호를 나타내는 문자로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 가져오기 함수는 DecimalSeparator 속성을 사용하여 숫자의 정수부와 소수부를 구별합니다.

정수 데이터형으로 변환할 때는 소수부 숫자가 가장 가까운 정수로 반올림됩니다.

데이터형: char | string

`TrimNonNumeric` — 숫자형이 아닌 문자 제거
`false` (디폴트 값) | `true`

숫자형 변수에서 숫자형이 아닌 문자를 제거하며, 논리형 true 또는 false로 지정됩니다.

데이터형: logical

`HexType` — 16진수 데이터의 출력 데이터형
`'auto'` (디폴트 값) | `'text'` | `'int8'` | `'int16'` | ...

16진수 데이터의 출력 데이터형으로, 'HexType'과 함께 표에 나와 있는 값 중 하나가 쉼표로 구분되어 지정됩니다.

입력 파일은 0x 또는 0X를 접두사로 사용하고 문자 0-9, a-f, A-F를 숫자로 사용하여 16진수 값을 텍스트로 나타냅니다. (대문자와 소문자는 동일한 숫자를 나타냅니다. 예를 들어 '0xf'와 '0xF'는 모두 15를 나타냅니다.)

가져오기 함수는 16진수 값을 'HexType'의 값으로 지정된 데이터형으로 변환합니다.

`'HexType'`의 값	출력 테이블 변수의 데이터형
`'auto'`	자동으로 감지된 데이터형
`'text'`	변경되지 않은 입력 텍스트
`'int8'`	8비트 정수, 부호 있음
`'int16'`	16비트 정수, 부호 있음
`'int32'`	32비트 정수, 부호 있음
`'int64'`	64비트 정수, 부호 있음
`'uint8'`	8비트 정수, 부호 없음
`'uint16'`	16비트 정수, 부호 없음
`'uint32'`	32비트 정수, 부호 없음
`'uint64'`	64비트 정수, 부호 없음

예: 'HexType','uint16'은 16진수 값을 나타내는 텍스트(예: '0xFF')를 출력 테이블에서 부호 없는 16비트 정수(예: 255)로 변환합니다.

데이터형: char | string

`BinaryType` — 이진 데이터의 출력 데이터형
`'auto'` (디폴트 값) | `'text'` | `'int8'` | `'int16'` | ...

이진 데이터의 출력 데이터형으로, 'BinaryType'과 함께 표에 나와 있는 값 중 하나가 쉼표로 구분되어 지정됩니다.

입력 파일은 0b 또는 0B를 접두사로 사용하고 문자 0 및 1을 숫자로 사용하여 이진 값을 텍스트로 나타냅니다.

가져오기 함수는 이진 값을 'BinaryType'의 값으로 지정된 데이터형으로 변환합니다.

`'BinaryType'`의 값	출력 테이블 변수의 데이터형
`'auto'`	자동으로 감지된 데이터형
`'text'`	변경되지 않은 입력 텍스트
`'int8'`	8비트 정수, 부호 있음
`'int16'`	16비트 정수, 부호 있음
`'int32'`	32비트 정수, 부호 있음
`'int64'`	64비트 정수, 부호 있음
`'uint8'`	8비트 정수, 부호 없음
`'uint16'`	16비트 정수, 부호 없음
`'uint32'`	32비트 정수, 부호 없음
`'uint64'`	64비트 정수, 부호 없음

예: 'BinaryType','uint16'은 이진 값을 나타내는 텍스트(예: '0b11111111')를 출력 테이블에서 부호 없는 16비트 정수(예: 255)로 변환합니다.

데이터형: char | string

XML 파일에만 해당

모두 축소

`ImportAttributes` — 특성 가져오기
논리값 `1` 또는 `true` (디폴트 값) | 논리값 `0` 또는 `false`

가져오기 특성으로, 'ImportAttributes'와 함께 1(true) 또는 0(false)이 쉼표로 구분되어 지정됩니다. false를 지정하면 읽기 함수가 입력 파일의 XML 특성을 출력 테이블의 변수로 가져오지 않습니다.

예: 'ImportAttributes',false

`AttributeSuffix` — 특성 접미사
`'Attribute'` (디폴트 값) | 문자형 벡터 | string형 스칼라

특성 접미사로, 'AttributeSuffix'와 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 이 인수는 읽기 함수가 입력 XML 파일의 특성에 대응하는 모든 테이블 변수에 추가하는 접미사를 지정합니다. 'AttributeSuffix'를 지정하지 않으면 읽기 함수는 기본적으로 입력 XML 파일의 특성에 대응하는 모든 변수 이름에 접미사 'Attribute'를 추가합니다.

예: 'AttributeSuffix','_att'

`RowNodeName` — 테이블 행 XML 노드 이름
문자형 벡터 | string형 배열

테이블 행 XML 노드 이름으로, 'RowNodeName'과 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 이 인수는 출력 테이블의 행을 설명하는 XML 노드 이름을 지정합니다.

예: 'RowNodeName','XMLNodeName'

`RowSelector` — 테이블 행 XPath 표현식
문자형 벡터 | string형 스칼라

테이블 행 XPath 표현식으로, 읽기 함수가 출력 테이블의 개별 행을 선택하는 데 사용하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 RowSelector를 지정해야 합니다.

예: 'RowSelector','/RootNode/ChildNode'

`VariableNodeNames` — 테이블 변수 XML 노드 이름
문자형 벡터로 구성된 셀형 배열 | string형 배열

테이블 변수 XML 노드 이름으로, 'VariableNodeNames'와 함께 문자형 벡터의 셀형 배열 또는 string형 배열이 쉼표로 구분되어 지정됩니다. 이 인수는 읽기 함수가 출력 테이블에서 변수로 읽을 XML 노드를 식별하는 데 사용하는 XML 노드 이름을 지정합니다.

예: 'VariableNodeNames',{'XMLNodeName1','XMLNodeName2'}

예: 'VariableNodeNames',"XMLNodeName"

예: 'VariableNodeNames',["XMLNodeName1","XMLNodeName2"]

`VariableSelectors` — 테이블 변수 XPath 표현식
문자형 벡터로 구성된 셀형 배열 | string형 배열

테이블 변수 XPath 표현식으로, 읽기 함수가 테이블 변수를 선택하는 데 사용하는 문자형 벡터의 셀형 배열 또는 string형 배열로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 VariableSelectors를 지정해야 합니다.

예: 'VariableSelectors',{'/RootNode/ChildNode'}

예: 'VariableSelectors',"/RootNode/ChildNode"

예: 'VariableSelectors',["/RootNode/ChildNode1","/RootNode/ChildNode2"]

`TableNodeName` — 테이블 XML 노드 이름
문자형 벡터 | string형 스칼라

테이블 XML 노드 이름으로, 'TableNodeName'과 함께 문자형 벡터 또는 string형 스칼라가 쉼표로 구분되어 지정됩니다. 이 인수는 읽기 함수가 테이블로 읽어 들여야 하는 입력 구조체의 노드를 지정합니다.

예: 'TableNodeName','NodeName'

`VariableUnitsSelector` — 변수 단위 XPath 표현식
문자형 벡터 | string형 스칼라

변수 단위 XPath로, 읽기 함수가 테이블 변수 단위를 선택하는 데 사용하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 VariableUnitsSelector를 지정해야 합니다.

예: 'VariableUnitsSelector','/RootNode/ChildNode'

`VariableDescriptionsSelector` — 변수 설명 XPath 표현식
문자형 벡터 | string형 스칼라

변수 설명 XPath 표현식으로, 읽기 함수가 테이블 변수 설명을 선택하는 데 사용하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 VariableDescriptionsSelector를 지정해야 합니다.

예: 'VariableDescriptionsSelector','/RootNode/ChildNode'

`RowNamesSelector` — 테이블 행 이름 XPath 표현식
문자형 벡터 | string형 스칼라

테이블 행 이름 XPath 표현식으로, 읽기 함수가 테이블 행의 이름을 선택하는 데 사용하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 RowNamesSelector를 지정해야 합니다.

예: 'RowNamesSelector','/RootNode/ChildNode'

`RepeatedNodeRule` — 반복되는 XML 노드를 처리하는 절차
`'addcol'` (디폴트 값) | `'ignore'` | `'error'`

테이블의 주어진 행에서 반복되는 XML 노드를 처리하는 절차로, 'addcol', 'ignore' 또는 'error'로 지정됩니다.

반복 노드 규칙	동작
`'addcol'`	테이블의 변수 헤더 아래에 반복 노드에 대한 열을 추가합니다. `'RepeatedNodeRule'`의 값을 `'addcol'`로 지정하면 반복되는 노드에 대해 테이블에 별도의 변수가 생성되지 않습니다.
`'ignore'`	반복되는 노드를 가져오는 작업을 건너뜁니다.
`'error'`	오류 메시지를 표시하고 가져오기 작업을 중단합니다.

예: 'RepeatedNodeRule','ignore'

`RegisteredNamespaces` — 등록된 XML 네임스페이스 접두사 집합
string형 배열

등록된 XML 네임스페이스 접두사의 집합으로, RegisteredNamespaces 및 접두사 배열이 쉼표로 구분되어 지정됩니다. 읽기 함수는 XML 파일에서 XPath 표현식을 실행할 때 이러한 접두사를 사용합니다. 네임스페이스 접두사 및 관련 URL을 Nx2 string형 배열로 지정합니다. RegisteredNamespaces는 readstruct용 StructSelector 또는 readtable 및 readtimetable용 VariableSelectors와 같이 선택자 이름-값 인수로 지정된 XPath 표현식을 실행할 때 사용할 수 있습니다.

기본적으로, 읽기 함수는 XPath 실행에 사용하기 위해 등록할 네임스페이스 접두사를 자동으로 감지합니다. 그러나 사용자가 RegisteredNamespaces 이름-값 인수를 사용하여 새 네임스페이스 접두사를 등록할 수도 있습니다. XML 노드에 네임스페이스 URL이 있지만 XML 파일에 선언된 네임스페이스 접두사가 없는 경우 새 네임스페이스 접두사를 등록할 수 있습니다.

예를 들어, 네임스페이스 접두사가 포함되지 않은 example.xml이라는 XML 파일에서 XPath 표현식을 실행해 보겠습니다. 'RegisteredNamespaces'를 ["myprefix", "https://www.mathworks.com"]으로 지정하여 URL https://www.mathworks.com에 접두사 myprefix를 할당합니다.

T = readtable("example.xml", "VariableSelector", "/myprefix:Data",...
 "RegisteredNamespaces", ["myprefix", "https://www.mathworks.com"])

예: 'RegisteredNamespaces',["myprefix", "https://www.mathworks.com"]

Microsoft Word 문서와 HTML 파일만 해당

모두 축소

`TableIndex` — 읽어 들일 테이블의 인덱스
`1` (디폴트 값) | 양의 정수

여러 테이블을 포함하는 Microsoft Word 문서 또는 HTML 파일에서 읽어 들일 테이블의 인덱스로, 양의 정수로 지정됩니다.

TableIndex를 지정하면 TableSelector가 동일한 XPath 표현식으로 자동 설정됩니다.

`MergedCellColumnRule` — 병합된 열이 있는 셀을 처리하는 절차
`"placeleft"` (디폴트 값) | `"placeright"` | `"duplicate"` | `"omitrow"` | `"error"`

병합된 열이 있는 셀을 처리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.

가져오기 오류 규칙	동작
`"placeleft"`	가장 왼쪽 셀에 데이터를 배치하고 나머지 셀을 `FillValue` 속성의 내용으로 채웁니다. `FillValue` 속성은 가져올 변수의 `VariableImportOptions` 객체에 지정됩니다. `FillValue` 속성에 액세스하는 데 대한 자세한 내용은 `getvaropts`를 참조하십시오.
`"placeright"`	가장 오른쪽 셀에 데이터를 배치하고 나머지 셀을 `FillValue` 속성의 내용으로 채웁니다. `FillValue` 속성은 가져올 변수의 `VariableImportOptions` 객체에 지정됩니다. `FillValue` 속성에 액세스하는 데 대한 자세한 내용은 `getvaropts`를 참조하십시오.
`"duplicate"`	모든 셀의 데이터를 복제합니다.
`"omitrow"`	오류가 발생한 행을 생략합니다.
`"error"`	오류 메시지를 표시하고 가져오기 작업을 중단합니다.

`MergedCellRowRule` — 병합된 행이 있는 셀을 처리하는 절차
`"placeleft"` (디폴트 값) | `"placeright"` | `"duplicate"` | `"omitrow"` | `"error"`

병합된 행이 있는 셀을 처리하는 절차로, 다음 표에 있는 값 중 하나로 지정됩니다.

가져오기 오류 규칙	동작
`"placetop"`	맨 위쪽 셀에 데이터를 배치하고 나머지 셀을 `FillValue` 속성의 내용으로 채웁니다. `FillValue` 속성은 가져올 변수의 `VariableImportOptions` 객체에 지정됩니다. `FillValue` 속성에 액세스하는 데 대한 자세한 내용은 `getvaropts`를 참조하십시오.
`"placebottom"`	맨 아래쪽 셀에 데이터를 배치하고 나머지 셀을 `FillValue` 속성의 내용으로 채웁니다. `FillValue` 속성은 가져올 변수의 `VariableImportOptions` 객체에 지정됩니다. `FillValue` 속성에 액세스하는 데 대한 자세한 내용은 `getvaropts`를 참조하십시오.
`"duplicate"`	모든 셀의 데이터를 복제합니다.
`"omitvar"`	병합된 행이 있는 변수를 생략합니다.
`"error"`	오류 메시지를 표시하고 가져오기 작업을 중단합니다.

`VariableNamesRow` — 변수 이름을 포함하는 행
음이 아닌 정수

변수 이름을 포함하는 행으로, 음이 아닌 정수로 지정됩니다.

VariableNamesRow를 지정하지 않은 경우, ReadVariableNames 인수에 따라 변수 이름을 읽어 들입니다.
VariableNamesRow가 0이면 변수 이름을 가져오지 않습니다.
그렇지 않으면, 지정된 행에서 변수 이름을 가져옵니다.

`VariableUnitsRow` — 변수 단위를 포함하는 행
`0` (디폴트 값) | 음이 아닌 정수

변수 단위를 포함하는 행으로, 음이 아닌 정수로 지정됩니다.

VariableUnitsRow가 0이면 변수 단위를 가져오지 않습니다. 그렇지 않으면, 지정된 행에서 변수 단위를 가져옵니다.

`VariableDescriptionsRow` — 변수 설명을 포함하는 행
`0` (디폴트 값) | 음이 아닌 정수

변수 설명을 포함하는 행으로, 음이 아닌 정수로 지정됩니다.

VariableDescriptionsRow가 0이면 변수 설명을 가져오지 않습니다. 그렇지 않으면, 지정된 행에서 변수 설명을 가져옵니다.

`EmptyRowRule` — 테이블의 비어 있는 행에 적용되는 규칙
`"skip"` (디폴트 값) | `"read"` | `"error"`

테이블의 비어 있는 행에 적용되는 규칙으로, 다음 중 하나로 지정됩니다.

"skip" – 비어 있는 행을 건너뜁니다.
"read" – 비어 있는 행을 읽어 들입니다.
"error" – 테이블 감지 중에는 비어 있는 행을 무시하고 읽어 들이는 중에는 오류를 발생시킵니다.

`EmptyColumnRule` — 테이블의 비어 있는 열에 적용되는 규칙
`"skip"` (디폴트 값) | `"read"` | `"error"`

테이블의 비어 있는 열에 적용되는 규칙으로, 다음 중 하나로 지정됩니다.

"skip" – 비어 있는 열을 건너뜁니다.
"read" – 비어 있는 열을 읽어 들입니다.
"error" – 테이블 감지 중에는 비어 있는 열을 무시하고 읽어 들이는 중에는 오류를 발생시킵니다.

Microsoft Word 문서, HTML 파일, XML 파일에만 해당

모두 축소

`TableSelector` — 테이블 데이터 XPath 표현식
문자형 벡터 | string형 스칼라

테이블 데이터 XPath 표현식으로, 읽기 함수가 출력 테이블 데이터를 선택하는 데 사용하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 TableSelector를 지정해야 합니다.

예: 'TableSelector','/RootNode/ChildNode'

출력 인수

모두 축소

`opts` — 파일에 대한 가져오기 옵션
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`

지정된 파일에 대한 가져오기 옵션으로, SpreadsheetImportOptions 객체, DelimitedTextImportOptions 객체, FixedWidthImportOptions 또는 XMLImportOptions 객체로 반환됩니다. options 객체 유형은 지정된 파일 형식에 따라 달라집니다. 텍스트 파일(.txt, .dat 또는 .csv)의 경우 detectImportOptions 함수는 DelimitedTextImportOptions 객체나 FixedWidthImportOptions 객체를 반환합니다. 스프레드시트 파일(.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods)의 경우 detectImportOptions 함수는 SpreadsheetImportOptions 객체를 반환합니다. XML 파일(.xml)의 경우 detectImportOptions는 XMLImportOptions 객체를 반환합니다.

팁

import options 객체를 만든 후 속성값 업데이트하기: detectImportOptions로 만든 import options 객체의 속성을 업데이트할 때 점 표기법을 사용하는 것은 권장되지 않습니다. 점 표기법을 사용하여 속성을 설정하면 MATLAB이 파일의 import options 중 일부를 재감지하지 못할 수 있습니다. 따라서 모든 속성을 업데이트하고 재감지하려면 이름-값 인수를 사용하여 새 값을 지정해야 합니다. 예를 들어, ConsecutiveDelimitersRule 속성의 값을 업데이트하고 import options를 재감지하려면 다음과 같이 하십시오.
```
opts = detectImportOptions(__,'ConsecutiveDelimitersRule','join')
```

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>

이 테이블은 XPath 선택기 이름-값 인수(예: VariableSelectors 또는 TableSelector)에 지원되는 XPath 구문을 제공합니다.

선택 작업	구문	예	결과
문서에서의 위치에 관계없이 선택하려는 노드와 이름이 일치하는 모든 노드를 선택합니다.	이름 앞에 두 개의 슬래시(`//`)를 붙입니다.	data = readtable('myFile.xml', 'VariableSelectors', '//var')	data = 4×1 table var ___ 1 2 10 20
요소 노드에 속한 특성 값을 읽어 들입니다.	특성 앞에 골뱅이 기호(`@`)를 붙입니다.	data = readtable('myFile.xml', 'VariableSelectors', '//table/@category')	data = 2×1 table categoryAttribute _________________ "ones" "tens"
노드 세트에서 특정 노드를 선택합니다.	대괄호(`[]`) 안에 선택하고자 하는 노드 인덱스를 제공합니다.	data = readtable('myFile.xml', 'TableSelector', '//table[1]')	data = 2×1 table var ___ 1 2
연산 우선 순위를 지정합니다.	먼저 평가할 표현식을 괄호로 묶습니다.	data = readtable('myFile.xml', 'VariableSelectors', '//table/var[1]')	data = 2×1 table var ___ 1 10
연산 우선 순위를 지정합니다.	먼저 평가할 표현식을 괄호로 묶습니다.	data = readtable('myFile.xml', 'VariableSelectors', '(//table/var)[1]')	data = table var ___ 1

버전 내역

R2016b에 개발됨

참고 항목

도움말 항목

테이블에 대한 가져오기 옵션 정의하기

detectImportOptions

구문

설명

예제

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

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

Microsoft Word 문서 파일에 대한 가져오기 옵션을 감지하고 사용하기

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

가져온 텍스트 데이터의 데이터형 지정하기

사용자 지정 XML 네임스페이스 접두사 등록하기

입력 인수

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

이름-값 인수

FileType — 파일 형식 'spreadsheet' | 'text' | 'delimitedtext' | 'fixedwidth' | 'xml' | 'worddocument' | 'html'

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

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

ReadVariableNames — 첫 번째 행을 변수 이름으로 읽기 true | false

VariableNamingRule — 변수 이름을 유지할지 지정하는 플래그 "modify" (디폴트 값) | "preserve"

ReadRowNames — 첫 번째 열을 행 이름으로 읽을지 여부를 나타내는 표시자 false (디폴트 값) | true

MissingRule — 누락된 데이터를 관리하는 방법 'fill' (디폴트 값) | 'error' | 'omitrow' | 'omitvar'

ImportErrorRule — 가져오기 오류를 처리하는 절차 'fill' (디폴트 값) | 'error' | 'omitrow' | 'omitvar'

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

ExpectedNumVariables — 예상 변수 개수 양의 정수

NumHeaderLines — 헤더 라인 수 양의 정수

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

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

DataRange — 데이터의 위치 문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | 양의 정수 스칼라로 구성된 배열 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

RowNamesRange — 행 이름의 위치 문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | '' 빈 문자형 배열

VariableNamesRange — 변수 이름의 위치 문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | '' 빈 문자형 배열

VariableUnitsRange — 변수 단위의 위치 문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | '' 빈 문자형 배열

VariableDescriptionsRange — 변수 설명의 위치 문자형 벡터 | string형 스칼라 | '' 빈 문자형 배열

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

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

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

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

VariableWidths — 변수의 필드 너비 양의 정수 값으로 구성된 벡터

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

LineEnding — 라인 끝(EOL) 문자 {'\n','\r','\r\n'} (디폴트 값) | 문자형 벡터 | string형 스칼라 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

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

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

DurationType — duration형 데이터의 출력 데이터형 'duration' (디폴트 값) | 'text'

ExtraColumnsRule — 추가 열을 처리하는 절차 'addvars' | 'ignore' | 'wrap' | 'error'

TreatAsMissing — 누락된 데이터로 해석할 텍스트 문자형 벡터 | string형 스칼라 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

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

ThousandsSeparator — 천 단위 구분을 나타내는 문자 문자형 벡터 | string형 스칼라

DecimalSeparator — 소수점 구분 기호를 나타내는 문자 문자형 벡터 | string형 스칼라

TrimNonNumeric — 숫자형이 아닌 문자 제거 false (디폴트 값) | true

HexType — 16진수 데이터의 출력 데이터형 'auto' (디폴트 값) | 'text' | 'int8' | 'int16' | ...

BinaryType — 이진 데이터의 출력 데이터형 'auto' (디폴트 값) | 'text' | 'int8' | 'int16' | ...

ImportAttributes — 특성 가져오기 논리값 1 또는 true (디폴트 값) | 논리값 0 또는 false

AttributeSuffix — 특성 접미사 'Attribute' (디폴트 값) | 문자형 벡터 | string형 스칼라

RowNodeName — 테이블 행 XML 노드 이름 문자형 벡터 | string형 배열

RowSelector — 테이블 행 XPath 표현식 문자형 벡터 | string형 스칼라

VariableNodeNames — 테이블 변수 XML 노드 이름 문자형 벡터로 구성된 셀형 배열 | string형 배열

VariableSelectors — 테이블 변수 XPath 표현식 문자형 벡터로 구성된 셀형 배열 | string형 배열

TableNodeName — 테이블 XML 노드 이름 문자형 벡터 | string형 스칼라

VariableUnitsSelector — 변수 단위 XPath 표현식 문자형 벡터 | string형 스칼라

VariableDescriptionsSelector — 변수 설명 XPath 표현식 문자형 벡터 | string형 스칼라

RowNamesSelector — 테이블 행 이름 XPath 표현식 문자형 벡터 | string형 스칼라

RepeatedNodeRule — 반복되는 XML 노드를 처리하는 절차 'addcol' (디폴트 값) | 'ignore' | 'error'

RegisteredNamespaces — 등록된 XML 네임스페이스 접두사 집합 string형 배열

TableIndex — 읽어 들일 테이블의 인덱스 1 (디폴트 값) | 양의 정수

MergedCellColumnRule — 병합된 열이 있는 셀을 처리하는 절차 "placeleft" (디폴트 값) | "placeright" | "duplicate" | "omitrow" | "error"

MergedCellRowRule — 병합된 행이 있는 셀을 처리하는 절차 "placeleft" (디폴트 값) | "placeright" | "duplicate" | "omitrow" | "error"

VariableNamesRow — 변수 이름을 포함하는 행 음이 아닌 정수

VariableUnitsRow — 변수 단위를 포함하는 행 0 (디폴트 값) | 음이 아닌 정수

VariableDescriptionsRow — 변수 설명을 포함하는 행 0 (디폴트 값) | 음이 아닌 정수

EmptyRowRule — 테이블의 비어 있는 행에 적용되는 규칙 "skip" (디폴트 값) | "read" | "error"

EmptyColumnRule — 테이블의 비어 있는 열에 적용되는 규칙 "skip" (디폴트 값) | "read" | "error"

TableSelector — 테이블 데이터 XPath 표현식 문자형 벡터 | string형 스칼라

출력 인수

opts — 파일에 대한 가져오기 옵션 SpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptions | XMLImportOptions

팁

버전 내역

참고 항목

도움말 항목

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

`FileType` — 파일 형식
`'spreadsheet'` | `'text'` | `'delimitedtext'` | `'fixedwidth'` | `'xml'` | `'worddocument'` | `'html'`

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

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

`ReadVariableNames` — 첫 번째 행을 변수 이름으로 읽기
`true` | `false`

`VariableNamingRule` — 변수 이름을 유지할지 지정하는 플래그
`"modify"` (디폴트 값) | `"preserve"`

`ReadRowNames` — 첫 번째 열을 행 이름으로 읽을지 여부를 나타내는 표시자
`false` (디폴트 값) | `true`

`MissingRule` — 누락된 데이터를 관리하는 방법
`'fill'` (디폴트 값) | `'error'` | `'omitrow'` | `'omitvar'`

`ImportErrorRule` — 가져오기 오류를 처리하는 절차
`'fill'` (디폴트 값) | `'error'` | `'omitrow'` | `'omitvar'`

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

`ExpectedNumVariables` — 예상 변수 개수
양의 정수

`NumHeaderLines` — 헤더 라인 수
양의 정수

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

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

`DataRange` — 데이터의 위치
문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | 양의 정수 스칼라로 구성된 배열 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

`RowNamesRange` — 행 이름의 위치
문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | `''` 빈 문자형 배열

`VariableNamesRange` — 변수 이름의 위치
문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | `''` 빈 문자형 배열

`VariableUnitsRange` — 변수 단위의 위치
문자형 벡터 | string형 스칼라 | 양의 정수 스칼라 | `''` 빈 문자형 배열

`VariableDescriptionsRange` — 변수 설명의 위치
문자형 벡터 | string형 스칼라 | `''` 빈 문자형 배열

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

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

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

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

`VariableWidths` — 변수의 필드 너비
양의 정수 값으로 구성된 벡터

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

`LineEnding` — 라인 끝(EOL) 문자
`{'\n','\r','\r\n'}` (디폴트 값) | 문자형 벡터 | string형 스칼라 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

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

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

`DurationType` — duration형 데이터의 출력 데이터형
`'duration'` (디폴트 값) | `'text'`

`ExtraColumnsRule` — 추가 열을 처리하는 절차
`'addvars'` | `'ignore'` | `'wrap'` | `'error'`

`TreatAsMissing` — 누락된 데이터로 해석할 텍스트
문자형 벡터 | string형 스칼라 | 문자형 벡터로 구성된 셀형 배열 | string형 배열

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

`ThousandsSeparator` — 천 단위 구분을 나타내는 문자
문자형 벡터 | string형 스칼라

`DecimalSeparator` — 소수점 구분 기호를 나타내는 문자
문자형 벡터 | string형 스칼라

`TrimNonNumeric` — 숫자형이 아닌 문자 제거
`false` (디폴트 값) | `true`

`HexType` — 16진수 데이터의 출력 데이터형
`'auto'` (디폴트 값) | `'text'` | `'int8'` | `'int16'` | ...

`BinaryType` — 이진 데이터의 출력 데이터형
`'auto'` (디폴트 값) | `'text'` | `'int8'` | `'int16'` | ...

`ImportAttributes` — 특성 가져오기
논리값 `1` 또는 `true` (디폴트 값) | 논리값 `0` 또는 `false`

`AttributeSuffix` — 특성 접미사
`'Attribute'` (디폴트 값) | 문자형 벡터 | string형 스칼라

`RowNodeName` — 테이블 행 XML 노드 이름
문자형 벡터 | string형 배열

`RowSelector` — 테이블 행 XPath 표현식
문자형 벡터 | string형 스칼라

`VariableNodeNames` — 테이블 변수 XML 노드 이름
문자형 벡터로 구성된 셀형 배열 | string형 배열

`VariableSelectors` — 테이블 변수 XPath 표현식
문자형 벡터로 구성된 셀형 배열 | string형 배열

`TableNodeName` — 테이블 XML 노드 이름
문자형 벡터 | string형 스칼라

`VariableUnitsSelector` — 변수 단위 XPath 표현식
문자형 벡터 | string형 스칼라

`VariableDescriptionsSelector` — 변수 설명 XPath 표현식
문자형 벡터 | string형 스칼라

`RowNamesSelector` — 테이블 행 이름 XPath 표현식
문자형 벡터 | string형 스칼라

`RepeatedNodeRule` — 반복되는 XML 노드를 처리하는 절차
`'addcol'` (디폴트 값) | `'ignore'` | `'error'`

`RegisteredNamespaces` — 등록된 XML 네임스페이스 접두사 집합
string형 배열

`TableIndex` — 읽어 들일 테이블의 인덱스
`1` (디폴트 값) | 양의 정수

`MergedCellColumnRule` — 병합된 열이 있는 셀을 처리하는 절차
`"placeleft"` (디폴트 값) | `"placeright"` | `"duplicate"` | `"omitrow"` | `"error"`

`MergedCellRowRule` — 병합된 행이 있는 셀을 처리하는 절차
`"placeleft"` (디폴트 값) | `"placeright"` | `"duplicate"` | `"omitrow"` | `"error"`

`VariableNamesRow` — 변수 이름을 포함하는 행
음이 아닌 정수

`VariableUnitsRow` — 변수 단위를 포함하는 행
`0` (디폴트 값) | 음이 아닌 정수

`VariableDescriptionsRow` — 변수 설명을 포함하는 행
`0` (디폴트 값) | 음이 아닌 정수

`EmptyRowRule` — 테이블의 비어 있는 행에 적용되는 규칙
`"skip"` (디폴트 값) | `"read"` | `"error"`

`EmptyColumnRule` — 테이블의 비어 있는 열에 적용되는 규칙
`"skip"` (디폴트 값) | `"read"` | `"error"`

`TableSelector` — 테이블 데이터 XPath 표현식
문자형 벡터 | string형 스칼라

`opts` — 파일에 대한 가져오기 옵션
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`