주요 콘텐츠

이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

readtable

파일에서 테이블 만들기

설명

T = readtable(filename)은 텍스트 파일, 스프레드시트(Microsoft® Excel® 포함) 파일, XML 파일, HTML 파일 또는 Microsoft Word 문서에서 열 방향 데이터를 읽어서 테이블을 만듭니다. readtable은 구분 기호, 데이터형과 같은 데이터의 요소를 감지하여 데이터를 가져올 방법을 결정합니다.

예제

T = readtable(filename,Name=Value)는 하나 이상의 이름-값 인수를 사용하여 옵션을 지정합니다. 예를 들어, ReadVariableNames 이름-값 인수를 사용하여 파일의 첫 번째 행을 변수 이름 또는 데이터로 읽어 올 수 있습니다.

예제

T = readtable(filename,opts)는 import options 객체 opts로 지정한 옵션을 사용하여 테이블을 만듭니다. readtable이 파일을 해석하는 방법을 구성하려면 import options 객체를 사용하십시오. 이름-값 인수에 비해, import options 객체는 파일 가져오기 구성을 더 세부적으로 제어할 수 있고 더 향상된 성능과 재사용 가능성을 제공합니다.

예제

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

예제

모두 축소

텍스트 파일의 내용을 테이블로 가져옵니다. 생성되는 테이블은 파일의 각 열별로 변수를 하나씩 포함하고 파일의 첫 번째 라인에 있는 항목을 변수 이름으로 사용합니다.

File contents of myCsvTable.dat

T = readtable("myCsvTable.dat")
T=5×6 table
      LastName      Gender    Age    Height    Weight    Smoker
    ____________    ______    ___    ______    ______    ______

    {'Smith'   }    {'M'}     38       71       176        1   
    {'Johnson' }    {'M'}     43       69       163        0   
    {'Williams'}    {'F'}     38       64       131        0   
    {'Jones'   }    {'F'}     40       67       133        0   
    {'Brown'   }    {'F'}     49       64       119        0   

데이터 누락이 있는 텍스트 파일에서 테이블을 만듭니다. 기본적으로 readtable은 누락된 부분을 적절한 누락값으로 채웁니다.

T = readtable("headersAndMissing.txt")
T=5×6 table
     LastName        Gender      Age    Height    Weight    Smoker
    ___________    __________    ___    ______    ______    ______

    {'Wu'     }    {'M'     }     38      71       176        1   
    {'Johnson'}    {'M'     }     43      69       163        0   
    {'Sanchez'}    {'F'     }     38      64       131        0   
    {'Brown'  }    {'F'     }    NaN      67       133        0   
    {'Picard' }    {0×0 char}    NaN      64       119        0   

데이터 누락이 있는 행을 생략하려면 MissingRule 이름-값 인수를 지정하십시오.

T = readtable("headersAndMissing.txt",MissingRule="omitrow")
T=3×6 table
     LastName      Gender    Age    Height    Weight    Smoker
    ___________    ______    ___    ______    ______    ______

    {'Wu'     }    {'M'}     38       71       176        1   
    {'Johnson'}    {'M'}     43       69       163        0   
    {'Sanchez'}    {'F'}     38       64       131        0   

import options 객체를 사용하여 readtable이 파일을 해석하는 방법을 구성합니다. 예를 들어 import options 객체를 사용하여 텍스트 파일의 일부만 읽어옵니다.

먼저, 변수 이름 및 유형, 구분자, 공백 문자를 포함한 텍스트 파일의 특징을 검출하기 위해 detectImportOptions를 사용해서 import options 객체를 만듭니다. 이 경우 detectImportOptionsDelimitedTextImportOptions 객체를 만듭니다.

opts = detectImportOptions("airlinesmall.csv")
opts = 
  DelimitedTextImportOptions with properties:

   Format Properties:
                    Delimiter: {','}
                   Whitespace: '\b\t '
                   LineEnding: {'\n'  '\r'  '\r\n'}
                 CommentStyle: {}
    ConsecutiveDelimitersRule: 'split'
        LeadingDelimitersRule: 'keep'
       TrailingDelimitersRule: 'ignore'
                EmptyLineRule: 'skip'
                     Encoding: 'ISO-8859-1'

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
             ExtraColumnsRule: 'addvars'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
                VariableTypes: {'double', 'double', 'double' ... and 26 more}
        SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
              VariableOptions: Show all 29 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [2 Inf]
            VariableNamesLine: 1
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

import options 객체를 수정하여 가져올 변수의 서브셋을 지정합니다. 그런 다음 import options 객체와 함께 readtable을 사용하여 데이터 서브셋을 가져옵니다.

opts.SelectedVariableNames = ["TaxiIn","TaxiOut"];
T = readtable("airlinesmall.csv",opts);

첫 번째 행에 변수 이름을 포함하고 첫 번째 열에 행 이름을 포함한 스프레드시트에서 테이블을 만듭니다. 테이블에서 처음 5개 행과 처음 4개 변수를 표시합니다.

T = readtable("patients.xls",ReadRowNames=true);
T(1:5,1:4)
ans=5×4 table
                  Gender      Age              Location               Height
                __________    ___    _____________________________    ______

    Smith       {'Male'  }    38     {'County General Hospital'  }      71  
    Johnson     {'Male'  }    43     {'VA Hospital'              }      69  
    Williams    {'Female'}    38     {'St. Mary's Medical Center'}      64  
    Jones       {'Female'}    40     {'VA Hospital'              }      67  
    Brown       {'Female'}    49     {'County General Hospital'  }      64  

스프레드시트의 지정된 영역에 있는 데이터를 사용하여 테이블을 만듭니다. 끝 지점 C2E6 사이에 있는 5×3의 사각형 영역의 데이터를 사용합니다. 이 영역의 첫 번째 행을 변수 이름으로 사용하지 않습니다. 결과로 생성되는 테이블은 대신 디폴트 변수 이름을 사용합니다.

T = readtable("patients.xls",Range="C2:E6",ReadVariableNames=false)
T=5×3 table
    Var1                Var2                 Var3
    ____    _____________________________    ____

     38     {'County General Hospital'  }     71 
     43     {'VA Hospital'              }     69 
     38     {'St. Mary's Medical Center'}     64 
     40     {'VA Hospital'              }     67 
     49     {'County General Hospital'  }     64 

import options 객체를 사용하여 readtable이 파일을 해석하는 방법을 구성합니다. 예를 들어, import options 객체를 사용하여 스프레드시트 파일에서 지정된 변수만 읽어옵니다.

먼저, 변수 이름 및 유형을 포함한 스프레드시트 파일의 특징을 검출하기 위해 detectImportOptions를 사용해서 파일에서 import options 객체를 만듭니다. 이 경우 detectImportOptionsSpreadsheetImportOptions 객체를 만듭니다.

opts = detectImportOptions("patients.xls")
opts = 
  SpreadsheetImportOptions with properties:

   Sheet Properties:
                        Sheet: ''

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
         MergedCellColumnRule: 'placeleft'
            MergedCellRowRule: 'placetop'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
                VariableTypes: {'char', 'char', 'double' ... and 7 more}
        SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
              VariableOptions: Show all 10 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Range Properties:
                    DataRange: 'A2' (Start Cell)
           VariableNamesRange: 'A1'
                RowNamesRange: ''
           VariableUnitsRange: ''
    VariableDescriptionsRange: '' 
	To display a preview of the table, use preview

import options 객체를 수정하여 가져올 변수를 지정합니다. 그런 다음 import options 객체와 함께 readtable을 사용하여 지정된 변수를 가져옵니다. 테이블의 처음 5개 행을 표시합니다.

opts.SelectedVariableNames = ["Systolic","Diastolic"];
T = readtable("patients.xls",opts);
T(1:5,:)
ans=5×2 table
    Systolic    Diastolic
    ________    _________

      124          93    
      109          77    
      125          83    
      117          75    
      122          80    

XML 파일의 내용을 테이블로 가져옵니다.

students.xml 파일에는 Student라는 이름의 형제 노드 7개가 있으며 각 노드에는 동일한 자식 노드와 특성이 포함되어 있습니다.

type students.xml
<?xml version="1.0" encoding="utf-8"?>
<Students>
    <Student ID="S11305">
        <Name FirstName="Priya" LastName="Thompson" />
        <Age>18</Age>
        <Year>Freshman</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">591 Spring Lane</Street>
            <City>Natick</City>
            <State>MA</State>
      </Address>
      <Major>Computer Science</Major>
      <Minor>English Literature</Minor>
   </Student>
   <Student ID="S23451">
        <Name FirstName="Conor" LastName="Cole" />
        <Age>18</Age>
        <Year>Freshman</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">4641 Pearl Street</Street>
            <City>San Francisco</City>
            <State>CA</State>
        </Address>
        <Major>Microbiology</Major>
        <Minor>Public Health</Minor>
    </Student>
    <Student ID="S119323">
        <Name FirstName="Morgan" LastName="Yang" />
        <Age>21</Age>
        <Year>Senior</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">30 Highland Road</Street>
            <City>Detriot</City>
            <State>MI</State>
        </Address>
        <Major>Political Science</Major>
   </Student>
   <Student ID="S201351">
        <Name FirstName="Salim" LastName="Copeland" />
        <Age>19</Age>
        <Year>Sophomore</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street>
            <City>Fort Worth</City>
            <State>TX</State>
        </Address>
        <Major>Business</Major>
        <Minor>Japanese Language</Minor>
   </Student>
   <Student ID="S201351">
        <Name FirstName="Salim" LastName="Copeland" />
        <Age>20</Age>
        <Year>Sophomore</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street>
            <City>Fort Worth</City>
            <State>TX</State>
        </Address>
        <Major>Business</Major>
        <Minor>Japanese Language</Minor>
    </Student>
    <Student ID="54600">
        <Name FirstName="Dania" LastName="Burt" />
        <Age>22</Age>
        <Year>Senior</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">22 Angie Drive</Street>
            <City>Los Angeles</City>
            <State>CA</State>
        </Address>
        <Major>Mechanical Engineering</Major>
        <Minor>Architecture</Minor>
   </Student>
    <Student ID="453197">
        <Name FirstName="Rikki" LastName="Gunn" />
        <Age>21</Age>
        <Year>Junior</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">65 Decatur Lane</Street>
            <City>Trenton</City>
            <State>ME</State>
        </Address>
        <Major>Economics</Major>
        <Minor>Art History</Minor>
   </Student>
</Students>

먼저, XML 파일의 특징을 검출하기 위해 detectImportOptions를 사용해서 XMLImportOptions 객체를 만듭니다. VariableSelectors 이름-값 인수를 Street 요소 노드의 XPath 표현식으로 지정하여 도로 이름만 테이블로 읽어옵니다. RegisteredNamespaces 이름-값 인수를 설정하여 사용자 지정 네임스페이스 접두사를 기존 네임스페이스 URL에 등록합니다.

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

그런 다음 import options 객체와 함께 readtable을 사용하여 지정된 변수를 가져옵니다.

T = readtable("students.xml",opts)
T=7×1 table
          Street       
    ___________________

    "591 Spring Lane"  
    "4641 Pearl Street"
    "30 Highland Road" 
    "3388 Moore Avenue"
    "3388 Moore Avenue"
    "22 Angie Drive"   
    "65 Decatur Lane"  

Microsoft Word 문서의 테이블을 MATLAB의 테이블로 가져옵니다. 이 사례에서는 문서에 두 개의 테이블이 있고, 두 번째 테이블은 병합된 셀을 포함합니다. TableIndex 이름-값 인수를 설정하여 두 번째 테이블을 읽어 들입니다. MergedCellColumnRule 이름-값 인수를 설정하여, 병합된 열이 있는 셀을 갖는 행을 건너뜁니다.

filename = "MaintenanceReport.docx";
T = readtable(filename,TableIndex=2,MergedCellColumnRule="omitrow")
T=3×5 table
                                 Description                                       Category          Urgency         Resolution          Cost  
    _____________________________________________________________________    ____________________    ________    __________________    ________

    "Items are occasionally getting stuck in the scanner spools."            "Mechanical Failure"    "Medium"    "Readjust Machine"    "$45"   
    "Loud rattling and banging sounds are coming from assembler pistons."    "Mechanical Failure"    "Medium"    "Readjust Machine"    "$35"   
    "There are cuts to the power when starting the plant."                   "Electronic Failure"    "High"      "Full Replacement"    "$16200"

또는 TableSelector 이름-값 인수를 사용하여, XPath 선택자를 사용하여 테이블을 선택할 수도 있습니다. "Description" 텍스트를 포함하는 Microsoft Word 문서 테이블을 선택하려면 XPath 선택자 "//w:tbl[contains(.,'Description')]"을 사용하십시오.

T = readtable(filename, ...
    TableSelector="//w:tbl[contains(.,'Description')]", ...
    MergedCellColumnRule="omitrow")
T=3×5 table
                                 Description                                       Category          Urgency         Resolution          Cost  
    _____________________________________________________________________    ____________________    ________    __________________    ________

    "Items are occasionally getting stuck in the scanner spools."            "Mechanical Failure"    "Medium"    "Readjust Machine"    "$45"   
    "Loud rattling and banging sounds are coming from assembler pistons."    "Mechanical Failure"    "Medium"    "Readjust Machine"    "$35"   
    "There are cuts to the power when starting the plant."                   "Electronic Failure"    "High"      "Full Replacement"    "$16200"

XPath 선택자 "//TABLE[contains(.,'readtable')]"을 사용하여 URL https://www.mathworks.com/help/matlab/text-files.html에서 텍스트 "readtable"을 포함하는 첫 번째 테이블을 가져옵니다. 테이블에 제목 행이 없으므로 ReadVariableNames 이름-값 인수를 false로 설정하십시오.

url = "https://www.mathworks.com/help/matlab/text-files.html";
T = readtable(url,TableSelector="//TABLE[contains(.,'readtable')]", ...
    ReadVariableNames=false)
T=4×2 table
          Var1                      Var2            
    ________________    ____________________________

    "readtable"         "Create table from file"    
    "writetable"        "Write table to file"       
    "readtimetable"     "Create timetable from file"
    "writetimetable"    "Write timetable to file"   

입력 인수

모두 축소

읽을 파일의 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. readtable은 텍스트, 스프레드시트, XML, Microsoft Word 및 HTML 파일의 데이터 읽기를 지원합니다.

filename에 확장자가 포함되어 있지 않은 경우 FileType 이름-값 인수를 사용하여 파일 형식을 나타냅니다. 기본적으로 readtable은 입력 파일의 각 열에서 감지된 데이터 값에 적합한 데이터형의 변수를 만듭니다.

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

위치

형식

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

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 Storagewasb, wasbs
HDFS™hdfs

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

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

예: "wasbs://path_to_file/my_file.csv"

예: "hdfs:///path_to_file/my_file.csv"

텍스트 파일

  • 확장자가 .txt, .dat 또는 .csv인 파일은 구분된 텍스트 파일로 읽힙니다.

  • 기본적으로 readtable은 파일의 각 열마다 하나의 테이블 변수를 만들고 파일의 첫 번째 행에서 변수 이름을 읽어 들입니다. 빈 필드는 NaN(숫자형 변수의 경우)이나 빈 문자형 벡터(텍스트 변수의 경우)로 변환됩니다. 파일에 있는 공백은 무시됩니다.

  • 텍스트 파일의 모든 줄에는 동일한 개수의 구분 기호가 있어야 합니다.

자주 사용되는 텍스트 파일 워크플로를 보려면 텍스트 파일에서 테이블로 데이터 가져오기를 참조하십시오.

스프레드시트 파일

  • 확장자가 .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx 또는 .ods인 파일은 스프레드시트 파일로 읽힙니다.

  • 기본적으로 readtable은 파일의 각 열마다 하나의 테이블 변수를 만들고 파일의 첫 번째 행에서 변수 이름을 읽어 들입니다.

  • Microsoft Excel 소프트웨어를 실행하는 Windows® 시스템에서 readtable은 사용자의 Excel 버전으로 인식되는 모든 Excel 스프레드시트 파일 형식을 읽습니다. 시스템에 Windows용 Microsoft Excel이 없거나 MATLAB Online™을 사용 중인 경우, readtableUseExcel 속성이 false로 설정된 상태로 작동하고 확장자가 .xls, .xlsm, .xlsx, .xltm.xltx인 파일만 읽습니다.

  • XLSX 형식의 대용량 파일은 불러오는 속도가 느린 경우가 있습니다. 더 나은 가져오기 및 내보내기 성능을 위해 Microsoft는 XLSB 형식을 사용할 것을 권장합니다.

자주 사용되는 스프레드시트 파일 워크플로를 보려면 스프레드시트 데이터를 테이블로 읽어오기 항목을 참조하십시오.

XML 파일

(R2021a 이후)

  • 확장자가 .xml인 파일은 XML(Extensible Markup Language) 파일로 읽힙니다.

  • 기본적으로 readtable은 테이블 변수로 감지된 각 요소 또는 특성 노드마다 하나의 테이블 변수를 만듭니다. 변수 이름은 요소 및 특성 이름에 해당합니다.

Microsoft Word 문서

(R2021b 이후)

  • 확장자가 .docx인 파일은 Microsoft Word 파일로 읽힙니다.

  • 기본적으로 readtable은 문서의 첫 번째 테이블에서 데이터를 가져오고 파일의 각 열마다 하나의 테이블 변수를 만든 다음 테이블의 첫 번째 행에서 변수 이름을 읽어 들입니다.

HTML 파일

(R2021b 이후)

  • 확장자가 .html, .xhtml 또는 .htm인 파일은 HTML(Hypertext Markup Language) 파일로 읽힙니다.

  • 기본적으로 readtable은 첫 번째 <table> 요소에서 데이터를 가져오고 테이블의 각 열마다 하나의 테이블 변수를 만든 다음 테이블의 첫 번째 행에서 변수 이름을 읽어 들입니다.

압축되어 아카이브된 파일

(R2025a 이후)

  • 압축된 파일 형식은 파일로 읽힙니다.

  • 아카이브된 파일 형식은 폴더로 처리됩니다. 예를 들어, 함수는 mydatafiles.zip을 폴더로 해석하므로, 이 파일 내에 있는 파일을 지정해야 합니다(예: mydatafiles.zip/file1.xlsx).

  • .gz 확장자로 끝나는 파일의 경우, 함수는 .gz 앞에 있는 확장자를 사용하여 파일 형식을 확인합니다. 예를 들어, mydata.csv.gz는 CSV 파일로 읽힙니다.

파일 가져오기 옵션으로, 다음 표에 있는 import options 객체 중 하나로 지정되며 detectImportOptions 함수나 연관된 가져오기 옵션 함수에 의해 생성됩니다. import options 객체에는 데이터 가져오기 과정을 구성하는 속성이 포함되어 있습니다. readtable은 각 import options 객체의 관련 속성만 사용합니다.

파일 형식Import Options 객체
텍스트 파일DelimitedTextImportOptions 객체
고정 너비 텍스트 파일FixedWidthImportOptions 객체
스프레드시트 파일SpreadsheetImportOptions 객체
XML 파일XMLImportOptions 객체
Microsoft Word 문서WordDocumentImportOptions 객체
HTML 파일HTMLImportOptions 객체

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

이름-값 인수

모두 확장

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

예: readtable(filename,ReadVariableNames=false)는 파일의 첫 번째 행을 변수 이름 대신 데이터로 읽어 오도록 지정합니다.

데이터 및 제목 위치

모두 확장

파일의 시작 부분에서 건너뛸 제목 라인 수로, 음이 아닌 정수로 지정됩니다. 이 이름-값 인수를 지정하지 않으면 readtable은 건너뛸 라인 수를 자동으로 감지합니다.

변수 이름과 데이터는 제목이 아닌 첫 번째 라인부터 읽힙니다.

데이터형: single | double

파일에서 읽을 범위로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 숫자형 벡터로 지정됩니다.

Range를 지정하는 방법 설명

"Cell" 또는 [row col]

시작 요소

데이터의 시작 요소를 다음 값 중 하나로 지정합니다.

  • 스프레드시트 A1 표기법을 사용하여 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터를 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 요소의 식별자입니다.

  • 시작 행과 열을 나타내는 [row col] 형식을 갖는 요소를 2개 가진 숫자형 벡터를 지정합니다.

readtable은 시작 요소를 사용하여 시작 요소에서 가져오기를 시작하고 마지막 빈 행에서 가져오기를 종료하는 방식으로 데이터의 범위를 자동으로 감지합니다.

예: "A5"

예: [5 1]

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

사각 범위

데이터의 사각 범위를 다음 값 중 하나로 지정합니다.

  • "Corner1:Corner2" 형식의 string형 스칼라 또는 문자형 벡터를 지정합니다. 여기서 Corner1Corner2는 범위를 정의하는 2개의 끝 지점입니다. 예를 들어, "D2:H4"는 파일에서 2개의 끝 지점 D2H4 사이에 있는 3×5 사각 범위를 나타냅니다. 스프레드시트 A1 표기법을 사용하는 Range 이름-값 인수는 대/소문자를 구분하지 않습니다.

  • 시작 행, 시작 열, 끝 행, 끝 열을 나타내는 [r1 c1 r2 c2] 형식을 갖는 요소를 4개 가진 숫자형 벡터를 지정합니다. 예를 들어, [2 3 15 13]은 파일의 2행 3열과 15행 13열 사이에 있는 14×11 사각 범위를 나타냅니다.

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

열의 개수는 ExpectedNumVariables 이름-값 인수에 지정된 개수와 일치해야 합니다.

예: "D2:H4"

예: [2 3 15 13]

"Row1:Row2"

행 범위

"Row1:Row2" 형식의 string형 스칼라 또는 문자형 벡터에 행 번호를 사용하여 시작 행과 끝 행을 지정합니다.

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

예: "1:7"은 행 1에서 7(구간의 끝점 포함)까지의 모든 열을 읽습니다.

"Column1:Column2"

열 범위

"Column1:Column2" 형식의 string형 스칼라 또는 문자형 벡터에 A1 표기법 열 문자를 사용하여 시작 열과 끝 열을 지정합니다.

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

열의 개수는 ExpectedNumVariables 이름-값 인수에 지정된 개수와 일치해야 합니다.

예: "A:F"는 열 A에서 F(구간의 끝점 포함)까지의 모든 행을 읽습니다.

"NamedRange"

명명된 범위(스프레드시트만 해당)

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

""

지정되지 않거나 비어 있음

이 이름-값 인수를 지정하지 않으면 readtable은 사용된 범위를 자동으로 감지합니다.

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

데이터의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터, 양의 정수 또는 양의 정수로 구성된 N×2 배열로 지정됩니다.

DataRange를 지정하는 방법설명

"Cell"

시작 셀

A1 표기법을 사용하여, 데이터의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다. 예를 들어, A5는 열 A와 행 5가 교차하는 지점에 있는 셀의 식별자입니다.

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

예: "A5"

n

시작 행

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

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

예: 5

"Corner1:Corner2"

사각 범위

"Corner1:Corner2" 형식을 사용하여 범위를 지정합니다. 여기서 Corner1Corner2는 영역을 정의하는 2개의 끝 지점입니다.

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

예: "A5:K50"

"Row1:Row2"

행 범위

"Row1:Row2" 형식의 string형 스칼라 또는 문자형 벡터에 행 번호를 사용하여 시작 행과 끝 행을 지정합니다.

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

예: "5:500"

"Column1:Column2"

열 범위

"Column1:Column2" 형식의 string형 스칼라 또는 문자형 벡터에 A1 표기법 열 문자를 사용하여 시작 열과 끝 열을 지정합니다.

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

예: "A:K"

[n1 n2; n3 n4; ...]

여러 개의 행 범위

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

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

  • 라인 범위를 오름차순으로 지정해야 합니다.

  • 행 범위가 서로 겹치지 않아야 합니다.

Inf 사용은 숫자형 배열의 마지막 행 범위에만 지원됩니다.

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

""

비어 있음

데이터를 읽지 않습니다.

예: ""

읽을 워크시트로, 워크시트 인덱스를 나타내는 양의 정수나 워크시트 이름을 포함하는 string형 스칼라 또는 문자형 벡터로 지정됩니다. 기본적으로 readtable은 첫 번째 시트를 읽습니다.

string형 스칼라 또는 문자형 벡터를 지정하는 경우 워크시트 이름에는 콜론(:)을 사용할 수 없습니다. 스프레드시트 파일에서 시트의 이름을 확인하려면 sheets = sheetnames(filename)을 사용하십시오. 자세한 내용은 sheetnames를 참조하십시오.

opts와 함께 Sheet 인수를 지정하면 readtable 함수는 Sheet에 지정된 값을 사용하고 가져오기 옵션에 정의된 시트 이름을 무시합니다.

예: 2

예: "MySheetName"

여러 테이블을 포함하는 파일에서 읽어 들일 테이블의 인덱스로, 양의 정수로 지정됩니다. 기본적으로 readtable은 첫 번째 테이블을 읽습니다.

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

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

읽어 들일 테이블에 대한 XPath 표현식으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 TableSelector를 지정해야 합니다.

선택 작업구문
문서에서의 위치에 관계없이 선택하려는 노드와 이름이 일치하는 모든 노드를 선택합니다.이름 앞에 두 개의 슬래시(//)를 붙입니다.
요소 노드에 속한 특성 값을 선택합니다.특성 앞에 골뱅이 기호(@)를 붙입니다.
노드 세트에서 특정 노드를 선택합니다.대괄호([]) 안에 선택하고자 하는 노드 인덱스를 제공합니다.
연산 우선 순위를 지정합니다.먼저 평가할 표현식을 괄호로 묶습니다.

이 이름-값 인수를 지정하지 않으면 readtable은 테이블 위치를 감지합니다.

예: "//table[1]"

읽어올 테이블 데이터의 XML 노드 이름으로, string형 스칼라 또는 문자형 벡터로 지정됩니다.

열을 가로질러 병합된 셀에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

가져오기 규칙동작
"placeleft"

가장 왼쪽 셀에 데이터를 배치하고 나머지 셀을 MissingRule 값에 따라 FillValue 속성의 내용으로 채웁니다. MissingRule"fill"(디폴트 값)이면 FillValue를 사용하여 셀을 채웁니다.

가져올 변수의 VariableImportOptions 객체에 FillValue 속성을 설정할 수 있습니다. FillValue 속성을 설정하는 방법에 대한 자세한 내용은 setvaropts 항목을 참조하십시오.

"placeright"

가장 오른쪽 셀에 데이터를 배치하고 나머지 셀을 MissingRule 값에 따라 FillValue 속성의 내용으로 채웁니다. MissingRule"fill"(디폴트 값)이면 FillValue를 사용하여 셀을 채웁니다.

가져올 변수의 VariableImportOptions 객체에 FillValue 속성을 설정할 수 있습니다. FillValue 속성을 설정하는 방법에 대한 자세한 내용은 setvaropts 항목을 참조하십시오.

"duplicate"

모든 셀의 데이터를 복제합니다.

"omitrow"병합된 셀이 있는 행을 생략합니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

행을 가로질러 병합된 셀에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

가져오기 규칙동작
"placetop"

맨 위쪽 셀에 데이터를 배치하고 나머지 셀을 MissingRule 값에 따라 FillValue 속성의 내용으로 채웁니다. MissingRule"fill"(디폴트 값)이면 FillValue를 사용하여 셀을 채웁니다.

가져올 변수의 VariableImportOptions 객체에 FillValue 속성을 설정할 수 있습니다. FillValue 속성을 설정하는 방법에 대한 자세한 내용은 setvaropts 항목을 참조하십시오.

"placebottom"

맨 아래쪽 셀에 데이터를 배치하고 나머지 셀을 MissingRule 값에 따라 FillValue 속성의 내용으로 채웁니다. MissingRule"fill"(디폴트 값)이면 FillValue를 사용하여 셀을 채웁니다.

가져올 변수의 VariableImportOptions 객체에 FillValue 속성을 설정할 수 있습니다. FillValue 속성을 설정하는 방법에 대한 자세한 내용은 setvaropts 항목을 참조하십시오.

"duplicate"

모든 셀의 데이터를 복제합니다.

"omitvar"병합된 셀이 있는 변수를 생략합니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

변수

모두 확장

변수 이름을 읽을지 여부로, 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. 이 이름-값 인수를 지정하지 않으면 readtable은 제목 행 뒤에 변수 이름이 있는지 자동으로 감지합니다.

표시자

설명

true

변수 이름을 읽습니다.

import options 객체 opts를 지정한 경우 readtableoptsVariableNamesRange 또는 VariableNamesLine 속성을 사용하여 변수 이름의 위치를 식별합니다.

false

변수 이름을 읽지 않습니다. "Var1",...,"VarN" 형식으로 디폴트 변수 이름을 생성하며, 여기서 N은 변수의 개수입니다.

import options 객체 opts를 지정한 경우 readtableoptsVariableNames 속성을 사용하여 변수 이름을 만듭니다.

지정되지 않음

범위에 변수 이름이 포함되어 있는지 자동으로 감지합니다.

ReadVariableNamesReadRowNames가 모두 true인 경우, readtable은 읽을 영역의 첫 번째 행의 첫 번째 열에 있는 이름을 속성 T.Properties.DimensionNames의 첫 번째 차원 이름으로 저장합니다.

변수 이름에 대한 규칙으로, 다음 값 중 하나로 지정됩니다.

  • "modify" — 유효하지 않은 변수 이름(유효 여부는 isvarname 함수의 판정에 따름)을 유효한 MATLAB 식별자로 변환합니다. 이 값은 텍스트 파일과 스프레드시트 파일에 대한 디폴트 값입니다.

  • "preserve" — 공백과 비ASCII 문자가 포함된 변수 이름과 같이 MATLAB 식별자로 유효하지 않은 변수 이름을 그대로 유지합니다. 이 값은 XML, Microsoft Word 및 HTML 파일에 대한 디폴트 값입니다.

변수 이름과 행 이름은 유효한 MATLAB 식별자가 아니어도 됩니다. 이러한 이름에는 공백과 비ASCII 문자까지 포함하여 모든 문자를 사용할 수 있습니다. 또한 영문자뿐만 아니라 어떤 문자로도 시작할 수 있습니다.

예상 변수 개수로, 음이 아닌 정수로 지정됩니다. 이 이름-값 인수를 지정하지 않으면 readtable은 변수 개수를 자동으로 감지합니다.

변수 이름의 위치로, 음이 아닌 정수로 지정됩니다.

VariableNamesLine0이면 readtable은 변수 이름을 가져오지 않습니다. 그렇지 않은 경우, readtable은 지정된 라인에서 변수 이름을 가져옵니다.

변수 이름이 존재하고 VariableNamesLineReadVariableNames가 모두 지정되지 않은 경우, readtable은 변수 이름이 포함된 라인을 감지하여 변수 이름를 가져옵니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

변수 이름의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 양의 정수로 지정됩니다.

VariableNamesRange를 지정하는 방법설명

"Cell"

시작 셀

A1 표기법을 사용하여, 변수 이름의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다.

예: "A5"는 열 A와 행 5가 교차하는 지점에 있는 셀을 식별합니다.

"Corner1:Corner2"

사각 범위

"Corner1:Corner2" 형식을 사용하여 범위를 지정합니다. 여기서 Corner1Corner2는 변수 이름에 대한 영역을 정의하는 2개의 끝 지점입니다.

범위는 한 행으로만 이루어져야 합니다.

예: "A5:K5"

n

숫자 인덱스

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

예: 5

"Row1:Row2"

행 범위

"Row1:Row2" 형식을 사용하여 범위를 지정합니다. 여기서 Row1Row2는 동일한 행 인덱스입니다.

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

예: "5:5"

""

지정되지 않거나 비어 있음

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

예: ""

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

변수 이름의 위치로, 음이 아닌 정수로 지정됩니다.

VariableNamesRow0이면 readtable은 변수 이름을 가져오지 않습니다. 그렇지 않은 경우, readtable은 지정된 행에서 변수 이름을 가져옵니다.

VariableNamesRow를 지정하지 않은 경우 ReadVariableNamestrue(디폴트 값)이면 readtable은 변수 이름을 가져옵니다. 둘 다 지정되지 않은 경우 readtable은 행에 가져올 변수 이름이 포함되어 있는지 감지합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

테이블 변수로 읽을 XML 노드의 이름으로, string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 중첩 노드가 동일한 이름을 가지면 VariableNodeNames는 최상위 수준의 노드를 선택합니다.

예: ["XMLNodeName1","XMLNodeName2"]

읽을 변수에 대한 XPath 표현식으로, string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 VariableSelectors를 지정해야 합니다.

XPath 표현식을 사용하여 XML 입력 파일의 어느 요소를 가져올지 지정합니다. 예를 들어, 다음 구조를 갖는 XML 파일 myFile.xml을 가져오고자 한다고 가정하겠습니다.

<data>
    <table category="ones">
        <var>1</var>
        <var>2</var>
    </table>
    <table category="tens">
        <var>10</var>
        <var>20</var>
    </table>
</data>

선택 작업구문
문서에서의 위치에 관계없이 선택하려는 노드와 이름이 일치하는 모든 노드를 선택합니다.이름 앞에 두 개의 슬래시(//)를 붙입니다.

이름이 var인 모든 노드를 선택합니다.

T = readtable("myFile.xml",VariableSelectors="//var")
요소 노드에 속한 특성 값을 선택합니다.특성 앞에 골뱅이 기호(@)를 붙입니다.

table 노드의 category 특성 값을 선택합니다.

T = readtable("myFile.xml",VariableSelectors="//table/@category")
노드 세트에서 특정 노드를 선택합니다.대괄호([]) 안에 선택하고자 하는 노드 인덱스를 제공합니다.

table 노드의 첫 번째 var 노드를 선택합니다.

T = readtable("myFile.xml",VariableSelectors="//table/var[1]")
연산 우선 순위를 지정합니다.먼저 평가할 표현식을 괄호로 묶습니다.

table 노드의 첫 번째 var 노드를 선택합니다.

T = readtable("myFile.xml",VariableSelectors="//table/var[1]")

첫 번째 table 노드의 첫 번째 var 노드를 선택합니다.

T = readtable("myFile.xml",VariableSelectors="(//table/var)[1]")

이 이름-값 인수를 지정하지 않으면 readtable은 변수의 위치를 감지합니다.

데이터를 결합할지 여부로, 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. CollectOutputtrue인 경우 readtable은 동일한 MATLAB 기본 클래스의 연속된 출력 셀들을 하나의 배열로 결합합니다.

모두 확장

첫 번째 열을 행 이름으로 읽을지 여부로, 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다.

설명

true

읽을 영역의 첫 번째 열에서 행 이름을 읽어 들입니다.

import options 객체 opts를 지정한 경우 readtableoptsRowNamesColumn, RowNamesRange 또는 RowNamesSelector 속성을 사용하여 행 이름의 위치를 식별합니다.

false

영역의 첫 번째 열에서 데이터를 읽어 들이지만 행 이름을 만들지는 않습니다.

ReadVariableNamesReadRowNames가 모두 true인 경우, readtable은 읽을 영역의 첫 번째 행의 첫 번째 열에 있는 이름을 속성 T.Properties.DimensionNames의 첫 번째 차원 이름으로 저장합니다.

행 이름의 위치로, 음이 아닌 정수로 지정됩니다.

RowNamesColumn0이면 readtable은 행 이름을 가져오지 않습니다. 그렇지 않은 경우, readtable은 지정된 열에서 행 이름을 가져옵니다.

RowNamesColumn을 지정하지 않은 경우 ReadRowNamestrue이면 readtable은 첫 번째 열을 행 이름으로 가져옵니다.

행 이름의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 양의 정수로 지정됩니다.

RowNamesRange를 지정하는 방법설명

"Cell"

시작 셀

A1 표기법을 사용하여, 행 이름의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다.

readtable은 시작 셀부터 데이터에 포함된 각 행의 이름을 식별합니다.

예: "A5"는 열 A와 행 5가 교차하는 지점에 있는 셀을 식별합니다.

"Corner1:Corner2"

사각 범위

"Corner1:Corner2" 형식을 사용하여 범위를 지정합니다. 여기서 Corner1Corner2는 행 이름에 대한 영역을 정의하는 2개의 끝 지점입니다.

행 개수는 데이터의 행 개수와 일치해야 하고, 범위는 한 열로만 이루어져야 합니다.

예: "A5:A50"

"Column1:Column1"

열 범위

"Column1:Column1" 형식을 사용하여 범위를 지정합니다. 여기서 Column1Column2는 동일한 열 문자입니다.

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

예: "A:A"

n

숫자 인덱스

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

예: 5

""

지정되지 않거나 비어 있음

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

예: ""

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

행 이름에 대한 XPath 표현식으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 RowNamesSelector를 지정해야 합니다.

이 이름-값 인수를 지정하지 않으면 readtable은 행 이름을 가져오지 않습니다.

예: "/RootNode/ChildNode"

테이블에서 개별 행을 선택하기 위한 XPath 표현식으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 RowSelector를 지정해야 합니다.

이 이름-값 인수를 지정하지 않으면 readtable은 행의 위치를 감지합니다.

예: "/RootNode/ChildNode"

행을 지정하는 XML 노드로, string형 스칼라 또는 문자형 벡터로 지정됩니다.

데이터형

모두 확장

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

  • "char" — 텍스트 데이터를 문자형 벡터로 가져옵니다. 이 값은 텍스트 파일과 스프레드시트 파일에 대한 디폴트 값입니다.

  • "string" — 텍스트 데이터를 string형 배열로 가져옵니다. 이 값은 XML, Microsoft Word 및 HTML 파일에 대한 디폴트 값입니다.

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

결과 데이터형
"datetime"

MATLAB datetime 데이터형

"text"

데이터형은 TextType의 값에 따라 달라집니다.

  • TextType"char"인 경우 날짜는 문자형 벡터로 구성된 셀형 배열입니다.

  • TextType"string"인 경우 날짜는 string형 배열입니다.

"exceldatenum"

Excel 날짜 일련 번호 값

이 값은 스프레드시트 파일에만 유효합니다.

날짜 일련 번호 값은 주어진 기준 날짜로부터의 일수로, 단일 숫자입니다. Excel 날짜 일련 번호 값은 MATLAB 날짜 일련 번호 값과는 다른 기준 날짜를 사용합니다. Excel 날짜에 대한 자세한 내용은 Differences between the 1900 and the 1904 date system in Excel을 참조하십시오.

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

결과 데이터형
"duration"

MATLAB duration 데이터형

"text"

데이터형은 TextType의 값에 따라 달라집니다.

  • TextType"char"인 경우 duration형 데이터는 문자형 벡터로 구성된 셀형 배열입니다.

  • TextType"string"인 경우 duration형 데이터는 string형 배열입니다.

가져오는 16진수 데이터의 유형으로, 다음 표에 있는 값 중 하나로 지정됩니다.

결과 데이터형

"auto"

감지된 데이터형으로, readtable은 모든 변수 값을 표현할 수 있는 최소 크기의 정수형을 결정합니다.

"text"

변경되지 않은 입력 텍스트

"int8"

8비트 정수, 부호 있음

"int16"

16비트 정수, 부호 있음

"int32"

32비트 정수, 부호 있음

"int64"

64비트 정수, 부호 있음

"uint8"

8비트 정수, 부호 없음

"uint16"

16비트 정수, 부호 없음

"uint32"

32비트 정수, 부호 없음

"uint64"

64비트 정수, 부호 없음

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

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

결과 데이터형

"auto"

감지된 데이터형으로, readtable은 모든 변수 값을 표현할 수 있는 최소 크기의 정수형을 결정합니다.

"text"

변경되지 않은 입력 텍스트

"int8"

8비트 정수, 부호 있음

"int16"

16비트 정수, 부호 있음

"int32"

32비트 정수, 부호 있음

"int64"

64비트 정수, 부호 있음

"uint8"

8비트 정수, 부호 없음

"uint16"

16비트 정수, 부호 없음

"uint32"

32비트 정수, 부호 없음

"uint64"

64비트 정수, 부호 없음

입력 파일은 0b 또는 0B를 접두사로 사용하고 문자 01을 숫자로 사용하여 이진 값을 텍스트로 나타낼 수 있습니다. 예를 들어, 0b11111111은 255를 나타냅니다.

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

  • xx는 언어를 지정하는 ISO 639-1 두 자리 코드(소문자)입니다.

  • YY는 국가를 지정하는 ISO 3166-1 alpha-2 코드(대문자)입니다.

readtable이 어떤 로캘을 사용해 월 이름, 요일 이름, 약어를 해석할지 지정하려면 DateLocale을 사용하십시오.

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

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

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

숫자형 변수에서 숫자형이 아닌 문자를 제거할지 여부로, 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. 예를 들어, TrimNonNumerictrue인 경우 readtable"$500/-"500으로 읽습니다.

숫자형 변수의 소수점 구분 기호 문자로, string형 스칼라 또는 단일 문자로 구성된 문자형 벡터로 지정됩니다. 구분 기호 문자는 숫자의 정수부와 소수부를 구별합니다. 예를 들어, 구분 기호가 ","이면 readtable은 텍스트 "3,14159"를 숫자 3.14159로 가져옵니다.

정수 데이터형으로 변환할 때 readtable은 소수부 숫자를 가장 가까운 정수로 반올림합니다. DecimalSeparator는 숫자를 값으로 허용하지 않습니다.

숫자형 변수의 천 단위 구분 문자로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 이 구분 문자는 매 세 자리값에서 숫자를 분류하는 시각적 구분 기호로 동작합니다. 예를 들어, 구분 문자가 ","이면 readtable은 텍스트 "1,234,000"1234000으로 가져옵니다.

지수 문자로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 디폴트 지수 문자는 e, E, d, D입니다.

예: "eE"

데이터 정리

모두 확장

누락값으로 처리할 자리 표시자 텍스트로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. readtable은 이 자리 표시자 텍스트에 해당하는 테이블 요소를 해당 요소의 데이터형에 따른 누락값으로 가져옵니다.

예: "N/A"

예: [".","NA","N/A"]

가져오기 오류에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다. readtable이 텍스트 요소를 예상했던 데이터형으로 변환할 수 없는 경우 가져오기 오류가 발생합니다.

가져오기 오류 규칙동작
"fill"

오류가 발생한 데이터를 FillValue 속성의 내용으로 대체합니다.

가져올 변수의 VariableImportOptions 객체에 FillValue 속성을 설정할 수 있습니다. FillValue 속성을 설정하는 방법에 대한 자세한 내용은 setvaropts 항목을 참조하십시오.

"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.
"omitrow"오류가 발생한 행을 생략합니다.
"omitvar"오류가 발생한 변수를 생략합니다.

누락된 데이터에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

누락 규칙동작
"fill"

누락된 데이터를 FillValue 속성의 내용으로 대체합니다.

가져올 변수의 VariableImportOptions 객체에 FillValue 속성을 설정할 수 있습니다. FillValue 속성을 설정하는 방법에 대한 자세한 내용은 setvaropts 항목을 참조하십시오.

"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.
"omitrow"누락된 데이터가 포함된 행을 생략합니다.
"omitvar"누락된 데이터가 포함된 변수를 생략합니다.

텍스트 파일의 경우, 예상한 필드가 행에 없으면 데이터가 누락된 것입니다. 필드가 누락되면 행의 후속 요소에 의해 필드가 앞으로 밀리게 되며, 누락된 필드는 행의 끝부분에서 해석됩니다.

스프레드시트 파일의 경우, 행의 예상되는 필드에 데이터가 없고 필드 유형이 공백이거나 비어 있으면 데이터가 누락된 것입니다.

XML 파일의 경우, 예상했던 노드가 없으면 데이터가 누락된 것입니다.

Microsoft Word 파일의 경우, 예상한 필드가 행에 없으면 데이터가 누락된 것입니다.

HTML 파일의 경우, 예상한 필드가 행에 없으면 데이터가 누락된 것입니다.

데이터의 추가 열에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다. 하나의 행에 예상 개수보다 많은 열이 있는 경우 readtable은 해당 열을 추가 열로 간주합니다.

추가 열 규칙동작
"addvars"

추가 열을 가져오기 위해 새 변수를 생성합니다. N개의 추가 열이 있는 경우, 새 변수를 "ExtraVar1","ExtraVar2",...,"ExtraVarN"으로 가져옵니다.

readtable은 추가 열을 char 데이터형의 텍스트로 가져옵니다.

"ignore"데이터의 추가 열을 무시합니다.
"wrap"새 레코드로 데이터의 추가 열을 줄 바꿈합니다. 이 동작을 수행해도 변수의 개수는 변경되지 않습니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

구분된 텍스트 파일의 빈 숫자형 필드에 대해 반환된 값으로, NaN 또는 숫자형 스칼라로 지정됩니다.

예: 0

데이터의 빈 라인에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다. 라인에 공백 문자만 포함된 경우 readtable은 해당 라인이 비어 있는 것으로 간주합니다.

빈 라인 규칙동작
"skip"빈 라인을 건너뜁니다.
"read"빈 라인을 가져옵니다. readtableVariableWidths, VariableOptions, MissingRule과 기타 관련 인수(예: Whitespace)에 지정된 값을 사용하여 빈 라인을 구문 분석합니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

데이터의 빈 행에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

빈 라인 규칙동작
"skip"빈 행을 건너뜁니다.
"read"빈 행을 가져옵니다. readtableVariableWidths, VariableOptions, MissingRule과 기타 관련 인수(예: Whitespace)에 지정된 값을 사용하여 빈 행을 구문 분석합니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

데이터의 빈 열에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

빈 열 규칙동작
"skip"빈 열을 건너뜁니다.
"read"빈 열을 가져옵니다. readtableVariableWidths, VariableOptions, MissingRule과 기타 관련 인수(예: Whitespace)에 지정된 값을 사용하여 빈 열을 구문 분석합니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

데이터의 부분 필드에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다. 라인의 끝에 도달했을 때 필드가 예상된 너비보다 문자가 적은 경우 readtable은 해당 필드가 부분적으로 채워진 것으로 간주합니다. 이 이름-값 인수는 고정 너비를 갖는 필드에만 적용됩니다.

부분 필드 규칙동작
"keep"

부분 필드 데이터를 유지하고 텍스트를 적절한 데이터형으로 변환합니다.

readtable이 부분 데이터를 해석하지 못할 경우 변환 오류가 발생할 수 있습니다.

"fill"

누락된 데이터를 FillValue 속성의 내용으로 대체합니다.

가져올 변수의 VariableImportOptions 객체에 FillValue 속성을 설정할 수 있습니다. FillValue 속성을 설정하는 방법에 대한 자세한 내용은 setvaropts 항목을 참조하십시오.

"omitrow"부분 데이터가 들어 있는 행을 생략합니다.
"omitvar"부분 데이터가 들어 있는 변수를 생략합니다.
"wrap"다음 문자 라인을 읽습니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

파일 정보

모두 확장

파일 형식으로, 다음 표에 있는 값 중 하나로 지정됩니다.

파일 형식
"spreadsheet"스프레드시트 파일
"text"텍스트 파일
"delimitedtext"구분된 텍스트 파일
"fixedwidth"고정 너비 텍스트 파일
"xml"XML 파일
"worddocument"Microsoft Word 문서
"html"HTML 파일

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

  • .txt, .dat, .csv - 텍스트 파일

  • .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods - 스프레드시트 파일

  • .xml - XML 파일

  • .docx - Microsoft Word 문서

  • .html, .xhtml 또는 .htm - HTML 파일

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

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

스프레드시트 데이터를 읽을 때 Windows용 Microsoft Excel을 시작할지 여부로, 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다.

이 인수에 따라 readtable은 다양한 파일 형식과 대화형 기능(예: 수식 및 매크로)을 지원합니다.

지원

UseExceltrue인 경우

UseExcelfalse인 경우

지원되는 파일 형식

.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, .ods

.xls, .xlsm, .xlsx, .xltm, .xltx

수식이나 매크로 같은 대화형 기능 지원

아니요

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

R2022a 이후

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

텍스트 구문 분석

모두 확장

필드 구분 기호 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 쉼표 "," 또는 마침표 "." 같은 유효한 문자로 Delimiter를 지정합니다.

아래 표에는 일반적으로 사용되는 필드 구분 기호 문자가 일부 나열되어 있습니다.

지정자

필드 구분 기호

","

"comma"

쉼표

" "

"space"

공백

"\t"

"tab"

";"

"semi"

세미콜론

"|"

"bar"

세로 막대

지정되지 않음

이 이름-값 인수를 지정하지 않으면 readtable은 구분 기호를 자동으로 감지합니다.

여러 문자를 단일 구분 기호로 처리하려면 Delimiter를 string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정하십시오. 알 수 없는 개수의 연속된 구분 기호를 하나로 처리하려면 ConsecutiveDelimitersRule="join"을 지정하십시오.

Delimiter는 구분된 텍스트 파일에만 유효하며 고정 너비 텍스트 파일에는 유효하지 않습니다.

라인 끝(EOL) 문자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 일반적인 라인 끝(EOL) 문자로는 새 줄(Newline) 문자("\n")와 캐리지 리턴("\r")이 있습니다. "\r\n"을 지정할 경우 readtable은 이 둘의 조합(\r\n)을 라인 끝(EOL) 문자로 취급합니다. {"\r\n", "\r", "\n"}을 지정할 경우 \r, \n, \r\n은 모두 라인 끝(EOL) 문자로 취급됩니다.

디폴트 라인 끝(EOL) 시퀀스는 파일의 내용에 따라 \n, \r, \r\n 중 하나입니다.

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

다음 표에는 일반 텍스트를 사용하여 입력할 수 없는 특수 문자를 표현하는 방법이 나와 있습니다.

특수 문자

표현

백분율

%%

백슬래시

\\

경보

\a

백스페이스

\b

폼 피드(FF)

\f

새 줄(Newline)

\n

캐리지 리턴

\r

가로 탭

\t

세로 탭

\v

그 Unicode® 숫자형 값을 16진수 N으로 나타낼 수 있는 문자

\xN

그 Unicode 숫자형 값을 8진수 N으로 나타낼 수 있는 문자

\N

예: " _"

예: "?!.,"

무시할 텍스트에 대한 주석 표시자로, string형 배열, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

예를 들어, "%"와 같은 문자를 지정하여 동일한 라인에서 그 문자 다음의 텍스트를 무시할 수 있습니다. ["/*","*/"]와 같은 string형 배열을 지정하여 시퀀스 사이의 모든 텍스트를 무시할 수 있습니다.

readtable은 라인 내부가 아니라 각 라인의 시작 부분에서만 주석을 확인합니다.

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

구분된 텍스트 파일의 선행 구분 기호에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

규칙동작
"keep"구분 기호를 유지합니다.
"ignore"구분 기호를 무시합니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

구분된 텍스트 파일의 후행 구분 기호에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

규칙동작
"keep"구분 기호를 유지합니다.
"ignore"구분 기호를 무시합니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

구분된 텍스트 파일의 연속된 구분 기호에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

규칙동작
"split"연속된 구분 기호를 여러 개의 필드로 분할합니다.
"join"여러 구분 기호를 하나의 구분 기호로 결합합니다.
"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

여러 구분 기호를 하나로 처리할지 여부로, 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다.

고정 너비 텍스트 파일의 변수 필드 너비로, 양의 정수로 구성된 벡터로 지정됩니다. 각각의 정수는 변수를 만드는 필드의 문자 수에 해당합니다.

예: [10,7,4,26,7]

파일의 열 형식으로, 하나 이상의 변환 지정자를 포함하는 string형 스칼라나 문자형 벡터 또는 "auto"로 지정됩니다. 변환 지정자는 textscan 함수가 허용하는 지정자와 동일합니다.

일부 대용량 파일의 경우 형식을 지정하면 가져오는 속도를 확실하게 개선할 수 있습니다.

Format을 지정하지 않으면 detectImportOptions 함수의 결과를 사용하여 데이터를 가져온 것처럼 readtable이 동작합니다. 이 동작의 결과에 대한 자세한 내용은 R2020a 버전 내역 정보를 참조하십시오.

Format"auto"로 지정한 경우 생성되는 변수는 데이터에 따라 double형 배열, 문자형 벡터로 구성된 셀형 배열 또는 datetime형 배열입니다. 전체 열이 숫자형인 경우 결과 변수는 double형입니다. 열에 숫자형이 아닌 요소가 있는 경우 결과 변수는 문자형 벡터로 구성된 셀형 배열이거나 값이 날짜/시간을 나타내는 경우 datetime형 배열입니다.

XML 구문 분석

모두 확장

XML 특성을 출력 테이블의 변수로 가져올지 여부로, 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. 기본적으로 readtable은 XML 특성을 출력 테이블의 변수로 가져옵니다.

특성과 출력 테이블의 요소를 구분하는 데 사용되는 접미사로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 이 인수는 readtable이 입력 XML 파일의 특성에 대응하는 모든 테이블 변수에 추가하는 접미사를 지정합니다. AttributeSuffix를 지정하지 않으면 readtable은 입력 XML 파일의 특성에 대응하는 모든 변수 이름에 접미사 "Attribute"를 추가합니다.

예: "_att"

테이블의 주어진 행에서 반복되는 XML 노드에 대한 규칙으로, 다음 표에 있는 값 중 하나로 지정됩니다.

규칙

동작

"addcol"

변수에서 반복되는 각 노드에 대해 열을 추가하여 연관된 변수에 행렬을 만듭니다. "addcol"은 반복되는 노드에 대해 테이블에 별도의 변수를 생성하지 않습니다.

예를 들면 다음과 같습니다.

입력 데이터

    <table>
        <row>
            <Var1>1</Var1>
            <Var2>2</Var2>
            <Var3>3</Var3>
            <Var1>11</Var1>
            <Var1>111</Var1>
        </row>
        <row>
            <Var1>4</Var1>
            <Var2>5</Var2>
            <Var3>6</Var3>
        </row>
        <row>
            <Var1>7</Var1>
            <Var2>8</Var2>
            <Var3>9</Var3>
        </row>
    </table>

출력 테이블

         Var1          Var2    Var3
    _______________    ____    ____

    1     11    111     2       3  
    4    NaN    NaN     5       6  
    7    NaN    NaN     8       9  

"ignore"

반복되는 노드를 건너뜁니다.

"error"오류 메시지를 표시하고 가져오기 작업을 취소합니다.

등록된 XML 네임스페이스 접두사 집합으로, 접두사 및 관련 URL로 구성된 N×2 string형 배열로 지정됩니다. readtable은 XML 파일에서 XPath 표현식을 실행할 때 이러한 접두사를 사용합니다.

VariableSelectors와 같이 선택자 이름-값 인수로 지정된 XPath 표현식을 실행할 때 RegisteredNamespaces를 사용할 수 있습니다.

기본적으로 readtable은 XPath 실행에 사용할 네임스페이스 접두사를 자동으로 감지합니다. 선언되지 않은 네임스페이스 접두사를 갖는 XML 노드를 선택하려면 RegisteredNamespaces 이름-값 인수를 사용하여 네임스페이스 접두사에 대한 사용자 지정 네임스페이스 URL을 등록하십시오. 예를 들어, 네임스페이스 접두사가 포함되지 않은 XML 파일에서 URL https://www.mathworks.com에 접두사 myprefix를 할당해 보겠습니다.

T = readtable(filename,VariableSelectors="/myprefix:Data", ...
    RegisteredNamespaces=["myprefix","https://www.mathworks.com"])

변수 메타데이터

모두 확장

변수 단위의 위치로, 음이 아닌 정수로 지정됩니다.

VariableUnitsLine0이면 readtable은 변수 단위를 가져오지 않습니다. 그렇지 않은 경우, readtable은 지정된 라인에서 변수 단위를 가져옵니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

변수 단위의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 양의 정수로 지정됩니다.

VariableUnitsRange를 지정하는 방법설명

"Cell"

시작 셀

A1 표기법을 사용하여, 변수 단의의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다.

readtable은 시작 셀부터 데이터에 포함된 각 변수의 단위를 식별합니다.

예: "A5"는 열 A와 행 5가 교차하는 지점에 있는 셀을 식별합니다.

"Corner1:Corner2"

사각 범위

"Corner1:Corner2" 형식을 사용하여 범위를 지정합니다. 여기서 Corner1Corner2는 변수 단위에 대한 영역을 정의하는 2개의 끝 지점입니다.

범위는 한 행으로만 이루어져야 합니다.

예: "A5:K5"

n

숫자 인덱스

양의 행 인덱스를 사용하여 변수 단위를 포함하는 행을 지정합니다.

예: 5

"Row1:Row2"

행 범위

"Row1:Row2" 형식을 사용하여 범위를 지정합니다. 여기서 Row1Row2는 동일한 행 인덱스입니다.

변수 단위는 하나의 행에 있어야 합니다.

예: "5:5"

""

지정되지 않거나 비어 있음

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

예: ""

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

변수 단위의 위치로, 음이 아닌 정수로 지정됩니다.

VariableUnitsRow0이면 readtable은 변수 단위를 가져오지 않습니다. 그렇지 않은 경우, readtable은 지정된 행에서 변수 단위를 가져옵니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

이 이름-값 인수를 지정하지 않으면 readtable은 변수 단위를 가져오지 않습니다.

예: "/RootNode/ChildNode"

예: "//table[1]/units/"

변수 설명의 위치로, 음이 아닌 정수로 지정됩니다.

VariableDescriptionsLine0이면 readtable은 변수 설명을 가져오지 않습니다. 그렇지 않은 경우, readtable은 지정된 라인에서 변수 설명을 가져옵니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

변수 설명의 위치로, 다음 형식을 사용하여 string형 스칼라, 문자형 벡터 또는 양의 정수로 지정됩니다.

VariableDescriptionsRange를 지정하는 방법설명

"Cell"

시작 셀

A1 표기법을 사용하여, 변수 설명의 시작 셀을 열 문자와 행 번호를 포함하는 string형 스칼라나 문자형 벡터로 지정합니다.

readtable은 시작 셀부터 데이터에 포함된 각 변수의 설명을 식별합니다.

예: "A5"는 열 A와 행 5가 교차하는 지점에 있는 셀을 식별합니다.

"Corner1:Corner2"

사각 범위

"Corner1:Corner2" 형식을 사용하여 범위를 지정합니다. 여기서 Corner1Corner2는 변수 설명에 대한 영역을 정의하는 2개의 끝 지점입니다.

범위는 한 행으로만 이루어져야 합니다.

예: "A5:K5"

"Row1:Row2"

행 범위

"Row1:Row2" 형식을 사용하여 범위를 지정합니다. 여기서 Row1Row2는 동일한 행 인덱스입니다.

변수 설명은 하나의 행에 있어야 합니다.

예: "5:5"

n

숫자 인덱스

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

예: 5

""

지정되지 않거나 비어 있음

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

예: ""

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

변수 설명의 위치로, 음이 아닌 정수로 지정됩니다.

VariableDescriptionsRow0이면 readtable은 변수 설명을 가져오지 않습니다. 그렇지 않은 경우, readtable은 지정된 행에서 변수 설명을 가져옵니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

변수 설명에 대한 XPath 표현식으로, string형 스칼라 또는 문자형 벡터로 지정됩니다. 유효한 XPath 버전 1.0 표현식으로 VariableDescriptionsSelector를 지정해야 합니다.

이 이름-값 인수를 지정하지 않으면 readtable은 변수 설명을 가져오지 않습니다.

예: "/RootNode/RowNode/@Name"

예: "//table[1]/descriptions/*"

출력 인수

모두 축소

출력 테이블로, 테이블 형식으로 반환됩니다. 이 테이블에는 설명, 변수 단위, 변수 이름, 행 이름과 같은 메타데이터가 저장될 수 있습니다. 자세한 내용은 table의 속성 섹션을 참조하십시오.

확장 기능

모두 확장

버전 내역

R2013b에 개발됨

모두 확장