Main Content

setvartype

변수 데이터형 설정

설명

opts = setvartype(opts,type)은 지정된 유형에 따라 opts 객체에 포함된 모든 변수를 업데이트합니다. type은 유효한 데이터형 이름을 나타내는 문자형 벡터나 이러한 문자형 벡터로 구성된 셀형 배열이어야 합니다.

예제

opts = setvartype(opts,selection,type)selection 인수에 지정된 변수의 데이터형만 업데이트합니다.

예제

모두 축소

detectImportOptions를 사용하여 가져오기 옵션을 생성하고, 여러 변수 데이터형을 설정한 후 readtable을 사용하여 데이터를 읽어 들입니다.

옵션 객체를 생성합니다.

opts = detectImportOptions('patients.xls');

변수에 대한 현재(감지된) 데이터형을 검토합니다.

disp([opts.VariableNames' opts.VariableTypes'])
    {'LastName'                }    {'char'   }
    {'Gender'                  }    {'char'   }
    {'Age'                     }    {'double' }
    {'Location'                }    {'char'   }
    {'Height'                  }    {'double' }
    {'Weight'                  }    {'double' }
    {'Smoker'                  }    {'logical'}
    {'Systolic'                }    {'double' }
    {'Diastolic'               }    {'double' }
    {'SelfAssessedHealthStatus'}    {'char'   }

가져오기에 대한 요구 사항을 부여하고 여러 변수에 대한 데이터형을 변경합니다.

opts = setvartype(opts,{'LastName','Gender','Location',...
                   'Smoker','SelfAssessedHealthStatus'},'string');
opts = setvartype(opts,{'Age','Height','Weight',...
                                'Systolic','Diastolic'},'single');

변수에 대해 업데이트된 데이터형을 검토합니다.

disp([opts.VariableNames' opts.VariableTypes'])
    {'LastName'                }    {'string'}
    {'Gender'                  }    {'string'}
    {'Age'                     }    {'single'}
    {'Location'                }    {'string'}
    {'Height'                  }    {'single'}
    {'Weight'                  }    {'single'}
    {'Smoker'                  }    {'string'}
    {'Systolic'                }    {'single'}
    {'Diastolic'               }    {'single'}
    {'SelfAssessedHealthStatus'}    {'string'}

readtable을 사용하여 업데이트된 유형으로 변수를 가져옵니다.

T = readtable('patients.xls',opts);

입력 인수

모두 축소

파일 가져오기 옵션으로, detectImportOptions 함수에 의해 생성된 SpreadsheetImportOptions, DelimitedTextImportOptions 또는 FixedWidthImportOptions 객체로 지정됩니다. opts 객체는 변수 속성, 데이터 위치 속성, 대체 규칙 같은 데이터 가져오기 프로세스를 제어하는 속성을 포함합니다.

선택한 변수로, 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열, string형 배열, 숫자형 인덱스로 구성된 배열 또는 논리형 배열로 지정됩니다.

변수 이름(또는 인덱스)은 opts 객체의 VariableNames 속성에 포함된 이름의 서브셋이어야 합니다.

예: 'Height'

예: {'Height','LastName'}

예: [5 9]

데이터형: char | string | cell | uint64 | logical

변수 데이터형으로, 유효한 데이터형 이름을 포함하는 문자형 벡터, string형 스칼라, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다. type 인수는 변수를 가져올 때 사용할 데이터형을 지정합니다. 여기에 나와 있는 데이터형 중 하나를 사용하여 변수를 가져오십시오.

데이터MATLAB® 데이터형
텍스트

'char' 또는 'string'

숫자형

'single', 'double', 'int8', 'int16', 'int32', 'int64', 'uint8', 'uint16', 'uint32', 'uint64' 중 하나

정의되지 않은 부동소수점 숫자 NaN, -Inf, +Infsingle 데이터형과 double 데이터형에만 유효합니다. 따라서, 부동소수점 데이터형을 정수로 변경하면, 정의되지 않은 부동소수점 숫자는 가져오기 함수에 의해 변환됩니다. 예를 들어, 'uint8' 데이터형으로 변환하면 다음 동작이 수행됩니다.

  • NaN0으로 변환됩니다.

  • -Infintmin('int8')로 변환됩니다.

  • +Infintmax('int8')로 변환됩니다.

모든 정수 데이터형 int8, int16, int16, int32, int64, uint8, uint16, uint32, uint64에 동일한 변환 과정이 적용됩니다.

논리형

'logical'

날짜와 시간

'datetime'

duration형

'duration'

categorical형

'categorical'

예: opts = setvartype(opts,'Height','double')은 변수 Height의 데이터형을 double로 변경합니다.

예: opts = setvartype(opts,{'Weight','LastName'},{'single','string'})은 변수 Weight의 데이터형을 single형으로 변경하고 변수 LastName의 데이터형을 string형으로 변경합니다.

데이터형: char | string | cell

버전 내역

R2016b에 개발됨