getvaropts

获取变量导入选项

全页折叠

语法

varOpts = getvaropts(opts,selection)

说明

varOpts = getvaropts(opts,selection) 返回 selection 中指定的变量的变量导入选项。

示例

全部折叠

获取变量的导入选项

打开实时脚本

可以使用 getvaropts 函数访问控制变量导入的变量导入选项对象。

从文件创建导入选项。选项对象是各变量导入选项的集合。

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: [1-by-10 matlab.io.VariableImportOptions] 
	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

获取指定变量的变量导入选项对象。

varOpts = getvaropts(opts, 'Systolic')

varOpts = 
  NumericVariableImportOptions with properties:

   Variable Properties:
                  Name: 'Systolic'
                  Type: 'double'
             FillValue: NaN
        TreatAsMissing: {}
             QuoteRule: 'remove'
              Prefixes: {}
              Suffixes: {}
        EmptyFieldRule: 'missing'

   Numeric Options:
     ExponentCharacter: 'eEdD'
      DecimalSeparator: '.'
    ThousandsSeparator: ''
        TrimNonNumeric: 0
          NumberSystem: 'decimal'

要修改变量导入选项，请参阅 setvaropts 和 setvartype 函数参考页。

输入参数

全部折叠

`opts` — 文件导入选项
`SpreadsheetImportOptions` | `DelimitedTextImportOptions` | `FixedWidthImportOptions`

文件导入选项，指定为 detectImportOptions 函数创建的 SpreadsheetImportOptions、DelimitedTextImportOptions 或 FixedWidthImportOptions 对象。opts 对象包含控制数据导入过程的属性，例如变量属性、数据位置属性、替代规则等。