preview

가져오기 옵션을 사용하여 파일에서 8개 행 미리보기

페이지 내 모두 축소

구문

T = preview(filename,opts)

설명

T = preview(filename,opts)는 가져오기 옵션 opts를 사용하여 filename의 처음 8개 행의 데이터를 포함하는 테이블을 반환합니다.

  • import options 객체 opts의 SelectedVariableNames 속성값이 테이블 T에 나타나는 변수를 선택합니다.

  • preview 함수는 readtable 함수가 import options 객체 opts를 사용하여 반환하는 데이터의 일부만 반환합니다.

  • 일반적으로 preview 함수의 출력값은 8개 행의 데이터를 포함합니다. 그러나 import options 객체 opts에 정의된 속성값에 따라 행 개수가 달라지는 경우가 있습니다. 자세한 내용은 팁을 참조하십시오.

예제

예제

모두 축소

라이브 스크립트 열기

먼저 import options 객체를 생성합니다. 그런 다음 가져오기 옵션을 사용하여 테이블의 처음 8개 행을 가져온 다음 원하는 변수만 보여주는 미리보기를 생성합니다.

파일의 import options 객체를 생성합니다. 

filename = 'outages.csv';
opts = detectImportOptions(filename);

테이블을 미리 봅니다.

preview(filename,opts)
ans=8×6 table
      Region            OutageTime          Loss     Customers       RestorationTime             Cause      
    ___________    ____________________    ______    __________    ____________________    _________________

    'SouthWest'    01-Feb-2002 12:18:00    458.98    1.8202e+06    07-Feb-2002 16:50:00    'winter storm'   
    'SouthEast'    23-Jan-2003 00:49:00    530.14    2.1204e+05                     NaT    'winter storm'   
    'SouthEast'    07-Feb-2003 21:15:00     289.4    1.4294e+05    17-Feb-2003 08:14:00    'winter storm'   
    'West'         06-Apr-2004 05:44:00    434.81    3.4037e+05    06-Apr-2004 06:10:00    'equipment fault'
    'MidWest'      16-Mar-2002 06:18:00    186.44    2.1275e+05    18-Mar-2002 23:23:00    'severe storm'   
    'West'         18-Jun-2003 02:49:00         0             0    18-Jun-2003 10:54:00    'attack'         
    'West'         20-Jun-2004 14:39:00    231.29           NaN    20-Jun-2004 19:16:00    'equipment fault'
    'West'         06-Jun-2002 19:28:00    311.86           NaN    07-Jun-2002 00:51:00    'equipment fault'

미리보기에 포함할 변수와 읽기 작업을 선택합니다.

opts.SelectedVariableNames = {'Region','OutageTime'};

처음 8개 행과 선택한 변수를 미리 봅니다.

preview(filename,opts)
ans=8×2 table
      Region            OutageTime     
    ___________    ____________________

    'SouthWest'    01-Feb-2002 12:18:00
    'SouthEast'    23-Jan-2003 00:49:00
    'SouthEast'    07-Feb-2003 21:15:00
    'West'         06-Apr-2004 05:44:00
    'MidWest'      16-Mar-2002 06:18:00
    'West'         18-Jun-2003 02:49:00
    'West'         20-Jun-2004 14:39:00
    'West'         06-Jun-2002 19:28:00

입력 인수

모두 축소

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

예: 'myFile.xlsx'

데이터형: char | string

파일 가져오기 옵션으로, detectImportOptions 함수에 의해 생성된 SpreadsheetImportOptions 객체, DelimitedTextImportOptions 객체 또는 FixedWidthImportOptions 객체로 지정됩니다. opts 객체에는 데이터 가져오기 과정을 제어하는 속성이 들어 있습니다. 개별 객체의 속성에 대한 자세한 내용은 해당 객체 페이지를 참조하십시오.

파일 형식출력값
스프레드시트 파일SpreadsheetImportOptions 객체
텍스트 파일DelimitedTextImportOptions 객체
고정 너비 텍스트 파일FixedWidthImportOptions 객체

알고리즘

  • preview 함수는 다음과 같은 경우 8개보다 적은 행을 반환합니다.

    • 파일에 포함된 데이터의 행 개수가 8개보다 적은 경우.

    • opts 객체의 DataLines 또는 DataRange 속성이 8개보다 적은 행을 지정하는 경우.

    • opts 객체의 속성 조합의 결과로 8개보다 적은 데이터 행이 생성되는 경우. 예를 들어, preview는 opts 객체의 EmptyLineRule, ImportErrorRule 또는 MissingRule의 값에 의해 가져오기 함수가 데이터를 생략하게 되는 경우 8개보다 적은 행을 반환합니다.

  • opts 객체의 DataLines 속성이나 DataRange 속성이 여러 개의 행 범위를 지정하고 첫 번째 행 범위가 8개보다 적은 행을 포함하면 preview는 첫 번째 행 범위의 행을 포함하여 행의 개수가 8개가 될 때까지 이어지는 행 범위의 행을 반환합니다.

버전 내역

R2018a에 개발됨

참고 항목

| | | |