detectImportOptions

Создайте настройки импорта на основе содержимого файла

Синтаксис

opts = detectImportOptions(filename)

opts = detectImportOptions(filename,Name,Value)

Описание

opts = detectImportOptions(filename) определяет местоположение таблицы в файле и возвращает его настройки импорта. Можно изменить объект опций и использовать его с readtable управлять, как MATLAB^® импортирует табличные данные. Тип возвращенных опций зависит от расширения файла. Например, функция возвращает SpreadsheetImportOptions возразите если filename файл электронной таблицы. Однако функция возвращает DelimitedTextImportOptions или FixedWidthImportOptions возразите если filename текстовый файл.

пример

opts = detectImportOptions(filename,Name,Value) определяет местоположение таблицы в файле с помощью дополнительных параметров, заданных одним или несколькими Name,Value парные аргументы.

Примеры

свернуть все

Обнаружьте и используйте настройки импорта для файлов электронной таблицы

Скрипт Open Live Script

Обнаружьте настройки импорта для файла электронной таблицы, задайте переменные, чтобы импортировать, и затем считать данные.

Создайте объект настроек импорта из файла.

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

Измените объект опций задать который переменные импортировать.

opts.SelectedVariableNames = {'Systolic','Diastolic'};

Используйте 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

Обнаружьте и используйте настройки импорта для текстовых файлов

Скрипт Open Live Script

Создайте настройки импорта, адаптируйте типы данных для нескольких переменных, и затем считайте данные.

Создайте объект настроек импорта из текстового файла.

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

Исследуйте Type свойство переменных TaxiIn и TaxiOut.

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'};

Используйте 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

Обозначение типа данных для данных импортируемого текста

Скрипт Open Live Script

Импортируйте текстовые данные как тип данных String путем определения настроек импорта.

Создайте объект опций для файла.

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

Входные параметры

свернуть все

`filename` — Имя файла, чтобы читать
вектор символов | строковый скаляр

Имя файла, чтобы читать в виде вектора символов или строкового скаляра.

В зависимости от местоположения вашего файла, filename может взять одну из следующих форм.

Местоположение

Форма

Текущая папка или папка на пути MATLAB

Задайте имя файла в filename.

Пример: 'myFile.txt'

Файл в папке

Если файл не находится в текущей папке или в папке на пути MATLAB, то задайте полное имя или относительный путь в filename.

Пример: 'C:\myFolder\myFile.xlsx'

Пример: '\imgDir\myFile.txt'

Удаленное местоположение

Если файл хранится в удаленном местоположении, то filename должен содержать полный путь файла, заданного как универсальный локатор ресурса (URL) формы:

scheme_name://path_to_file/my_file.ext

На основе вашего удаленного местоположения, scheme_name может быть одно из значений в этой таблице.

Удаленное местоположение	`scheme_name`
Amazon S3™	`s3`
Устройство хранения данных Windows Azure^® Blob	`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.

Примечание

Расширения файла .xlsb и .ods только поддерживаются на платформах с Excel^® для Windows^®.

Типы данных: char | string

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'FileType','spreadsheet'

Параметры

свернуть все

`'FileType'` — Тип файла
`'spreadsheet'` | `'text'` | `'delimitedtext'` | `'fixedwidth'`

Тип файла в виде разделенной запятой пары, состоящей из 'FileType' и одно из этих значений.

Значение	Настройки импорта для файла
`'spreadsheet'`	Возвратите `SpreadsheetImportOptions` объект.
`'text'`	Возвратите `DelimitedTextImportOptions` или `FixedWidthImportOptions` объект в зависимости от размещения текстового файла.
`'delimitedtext'`	Возвратите `DelimitedTextImportOptions` объект. Используйте эту опцию для текстовых файлов, которым разделили столбцы разделители.
`'fixedwidth'`	Возвратите `FixedWidthImportOptions` объект. Используйте эту опцию для текстовых файлов, которые имеют столбцы фиксированных ширин.

Используйте 'FileType' аргумент пары "имя-значение", когда filename не включает расширение файла, или когда расширение не является одним из них:

.txt, .dat, или .csv для текстовых файлов
.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, или .ods для файлов электронной таблицы

Расширения файла .xlsb и .ods только поддерживаются на платформах с Excel для Windows.

Пример: 'FileType','text'

Типы данных: char | string

`'TextType'` — Введите для данных об импортируемом тексте
`'char'` (значение по умолчанию) | `'string'`

Введите для данных об импортируемом тексте в виде разделенной запятой пары, состоящей из 'TextType' и любой 'char' или 'string'.

'char' — Импортируйте текстовые данные в MATLAB как векторы символов.
'string' — Импортируйте текстовые данные в MATLAB как строковые массивы.

Пример: 'TextType','char'

`'DatetimeType'` — Введите для импортированных данных о дате и времени
`'datetime'` (значение по умолчанию) | `'text'` | `'exceldatenum'` Файлы электронной таблицы только

Введите для импортированных данных о дате и времени в виде разделенной запятой пары, состоящей из 'DatetimeType' и одно из этих значений: 'datetime'Текст, или 'exceldatenum'. Значение 'exceldatenum' применимо только для файлов электронной таблицы и не допустим для текстовых файлов.

Значение Введите для импортированных данных о дате и времени

Значение	Введите для импортированных данных о дате и времени
`'datetime'`	MATLAB `datetime` тип данных Для получения дополнительной информации смотрите `datetime`.
`'text'`	Если `'DatetimeType'` задан как `'text'`, затем тип для импортированных данных о дате и времени зависит от значения, заданного в `'TextType'` параметр: Если `'TextType'` установлен в `'char'`, затем функция импорта возвращает даты как массив ячеек из символьных векторов. Если `'TextType'` установлен в `'string'`, затем функция импорта возвращает даты как массив строк.
`'exceldatenum'`	Excel последовательные числа даты Последовательный номер даты является одним номером, равным номеру дней с данной ссылочной даты. Excel последовательные числа даты использует различную ссылочную дату, чем MATLAB последовательные числа даты. Для получения дополнительной информации о датах Excel смотрите `https://support.microsoft.com/en-us/kb/214330`.

'datetime'

MATLAB datetime тип данных

Для получения дополнительной информации смотрите datetime.

'text'

Если 'DatetimeType' задан как 'text', затем тип для импортированных данных о дате и времени зависит от значения, заданного в 'TextType' параметр:

Если 'TextType' установлен в 'char', затем функция импорта возвращает даты как массив ячеек из символьных векторов.
Если 'TextType' установлен в 'string', затем функция импорта возвращает даты как массив строк.

'exceldatenum'

Excel последовательные числа даты

Последовательный номер даты является одним номером, равным номеру дней с данной ссылочной даты. Excel последовательные числа даты использует различную ссылочную дату, чем MATLAB последовательные числа даты. Для получения дополнительной информации о датах Excel смотрите https://support.microsoft.com/en-us/kb/214330.

Типы данных: char | string

`'ExpectedNumVariables'` — Ожидаемое количество переменных
положительное целое число

Ожидаемое количество переменных в виде разделенной запятой пары, состоящей из 'ExpectedNumVariables' и положительное целое число. Если незаданный, функция импорта автоматически обнаруживает количество переменных.

Типы данных: single | double

`'Range'` — Фрагмент данных, чтобы читать
вектор символов | строковый скаляр | числовой вектор

Фрагмент данных, чтобы считать из текста или файлов электронной таблицы в виде запятой разделенную пару, состоящую из 'Range' и вектор символов, строковый скаляр или числовой вектор в одной из следующих форм.

Способы задать Range Описание

Способы задать `Range`	Описание
Запуск ячейки `'Cell'` или `[row col]`	Задайте стартовую ячейку для данных как вектор символов или строковый скаляр или два элемента числовой вектор. Вектор символов или строковый скаляр, содержащий букву столбца и номер строки с помощью Excel `A1` обозначение. Например, `A5` идентификатор для ячейки на пересечении столбца `A` и строка `5`. Два элемента числовой вектор из формы `[row col]` указание на стартовую строку и столбец. Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула. Пример: `'A5'` или `[5 1]`
Прямоугольная область значений `'Corner1:Corner2'` или `[r1 c1 r2 c2]`	Укажите точный диапазон, чтобы считать использование прямоугольной области значений в одной из следующих форм. `'Corner1:Corner2'` — Укажите диапазон с помощью `Corner1` и `Corner2` которые являются двумя противостоящими углами, которые задают область, чтобы читать в Excel `A1` обозначение. Например, `'C2:N15'`. `[r1 c1 r2 c2]` — Укажите диапазон с помощью четырех элементов числовой вектор, содержащий начинать-строку, начальный столбец, строку конца и столбец конца. Например, `[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]

Задайте стартовую ячейку для данных как вектор символов или строковый скаляр или два элемента числовой вектор.

Вектор символов или строковый скаляр, содержащий букву столбца и номер строки с помощью Excel A1 обозначение. Например, A5 идентификатор для ячейки на пересечении столбца A и строка 5.
Два элемента числовой вектор из формы [row col] указание на стартовую строку и столбец.

Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула.

Пример: 'A5' или [5 1]

Прямоугольная область значений

'Corner1:Corner2' или [r1 c1 r2 c2]

Укажите точный диапазон, чтобы считать использование прямоугольной области значений в одной из следующих форм.

'Corner1:Corner2' — Укажите диапазон с помощью Corner1 и Corner2 которые являются двумя противостоящими углами, которые задают область, чтобы читать в Excel A1 обозначение. Например, 'C2:N15'.
[r1 c1 r2 c2] — Укажите диапазон с помощью четырех элементов числовой вектор, содержащий начинать-строку, начальный столбец, строку конца и столбец конца. Например, [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

`'NumHeaderLines'` — Количество линий заголовка
положительное целое число

Количество линий заголовка в файле в виде разделенной запятой пары, состоящей из 'NumHeaderLines' и положительное целое число. Если незаданный, функция импорта автоматически обнаруживает количество линий заголовка в файле.

Пример: 'NumHeaderLines',7

Типы данных: single | double

`'ReadVariableNames'` — Считайте первую строку как имена переменных
`true` | `false`

Индикатор для чтения первой строки как имена переменных в виде разделенной запятой пары, состоящей из 'ReadVariableNames' и любой true или false. Если незаданный, readtable автоматически обнаруживает присутствие имен переменных.

Индикатор	Описание
`true`	Используйте, когда первая строка области, которая будет читать, будет содержать имена переменных для таблицы. `readtable` создает переменную, с обнаруженным именем переменной, для каждого столбца в `T`.
`false`	Используйте, когда первая строка области, которая будет читать, будет содержать данные в таблице. `readtable` создает имена переменных по умолчанию формы `'Var1',...,'VarN'`, где `N` количество переменных.
незаданный	Когда оставлено незаданный, функция импорта автоматически обнаруживает `true` или `false` и доходы соответственно.

Типы данных: логический

`'VariableNamingRule'` — Отметьте, чтобы сохранить имена переменных
`'modify'` (значение по умолчанию) | `'preserve'`

Отметьте, чтобы сохранить имена переменных в виде разделенной запятой пары, состоящей из VariableNamingRule и любой true, или false.

'preserve' — Сохраните имена переменных, которые не являются допустимыми идентификаторами MATLAB, такими как имена переменных, которые включают символы non-ASCII и пробелы.
'modify' — Преобразуйте недопустимые имена переменных (как определено isvarname функция) к допустимым идентификаторам MATLAB.

Начиная в R2019b, имена переменных и имена строки могут включать любые символы, включая символы non-ASCII и пробелы. Кроме того, они могут начать с любых символов, не только обозначает буквами. Переменная и имена строки не должны быть допустимыми идентификаторами MATLAB (как определено isvarname функция. Чтобы сохранить эти имена переменных и имена строки, установите значение VariableNamingRule к 'preserve'.

Типы данных: char | string

`'ReadRowNames'` — Индикатор для чтения первого столбца как имена строки
`false` (значение по умолчанию) | `true`

Индикатор для чтения первого столбца как строка называет в виде разделенной запятой пары, состоящей из 'ReadRowNames' и любой false или true.

Индикатор	Описание
`false`	Используйте, когда первый столбец области, который будет читать, будет содержать данные, а не имена строки для таблицы.
`true`	Используйте, когда первый столбец области, который будет читать, будет содержать имена строки для таблицы.
незаданный	Когда оставлено незаданный, функция импорта принимает `false`.

Типы данных: логический

`'MissingRule'` — Процедура, чтобы управлять недостающими данными
`'fill'` | `'error'` | `'omitrow'` | `'omitvar'`

Процедура, чтобы управлять недостающими данными в виде одного из значений в этой таблице.

MissingRule	Поведение
`'fill'`	Замените недостающие данные на содержимое `FillValue` свойство. `FillValue` свойство задано в `VariableImportOptions` объект переменной импортируется. Для получения дополнительной информации о доступе `к FillValue` свойство, смотрите `getvaropts`.
`'error'`	Прекратите импортировать и отобразите сообщение об ошибке, показывающее недостающую запись и поле.
`'omitrow'`	Не используйте строки, которые содержат недостающие данные.
`'omitvar'`	Не используйте переменные, которые содержат недостающие данные.

Пример: opts.MissingRule = 'omitrow';

Типы данных: char | string

`'ImportErrorRule'` — Процедура, чтобы обработать ошибки импорта
`'fill'` | `'error'` | `'omitrow'` | `'omitvar'`

Процедура, чтобы обработать ошибки импорта в виде одного из значений в этой таблице.

ImportErrorRule	Поведение
`'fill'`	Замените данные, где ошибка произошла с содержимым `FillValue` свойство. `FillValue` свойство задано в `VariableImportOptions` объект переменной импортируется. Для получения дополнительной информации о доступе `к FillValue` свойство, смотрите `getvaropts`.
`'error'`	Прекратите импортировать и отобразите сообщение об ошибке, показывающее вызывающую ошибку запись и поле.
`'omitrow'`	Не используйте строки, где ошибки происходят.
`'omitvar'`	Не используйте переменные, где ошибки происходят.

Пример: opts.ImportErrorRule = 'omitvar';

Типы данных: char | string

Параметры для файлов электронной таблицы только

свернуть все

`'Sheet'` — Покройте, чтобы читать из
`''` пустой символьный массив (значение по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

Покройте, чтобы читать из в виде пустого символьного массива, вектора символов или строкового скаляра, содержащего имя листа или положительное скалярное целое число, обозначающее индекс листа. На основе значения, заданного для Sheet свойство, функция импорта ведет себя как описано в таблице.

Спецификация	Поведение
`''` (значение по умолчанию)	Импортируйте данные от первого листа.
Имя	Импортируйте данные с соответствующего имени листа, независимо от порядка листов в файле электронной таблицы.
Целое число	Импортируйте данные от листа в положении, обозначенном целым числом, независимо от имен листа в файле электронной таблицы.

Типы данных: char | string | single | double

`'DataRange'` — Местоположение данных
вектор символов | строковый скаляр | положительное скалярное целое число | массив положительных скалярных целых чисел | массив ячеек вектора символов | массив строк

Местоположение данных, которые будут импортированы в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов, массива строк, положительного скалярного целого числа или N- 2 массив положительных скалярных целых чисел. Задайте DataRange использование одной из следующих форм.

Заданный Поведение

Заданный	Поведение
`'Cell'` или `n` Запуск ячейки или стартовой строки	Задайте стартовую ячейку для данных, с помощью Excel `A1` обозначение. Например, `A5` идентификатор для ячейки на пересечении столбца `A` и строка `5`. Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула. В качестве альтернативы задайте первую строку, содержащую данные с помощью индекса строки положительной скалярной величины. Используя заданный индекс строки, функция импорта автоматически обнаруживает степень данных путем чтения из заданной первой строки в конец данных или области значений нижнего колонтитула. Пример: `'A5'` или `5`
`'Corner1:Corner2'` Прямоугольная область значений	Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где `Corner1` и `Corner2` два противостоящих угла, которые задают область, чтобы читать. Функция импорта только считывает данные, содержавшиеся в заданной области. Любые пустые поля в заданной области импортируются как недостающие ячейки. Количество столбцов должно совпадать с номером, заданным в `NumVariables` свойство. Пример: `'A5:K50'`
`'Row1:Row2'` или `'Column1:Column2'` Область значений строки или область значений столбца	Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Используя указанный диапазон строки, функция импорта автоматически обнаруживает степень столбца путем чтения из первого непустого столбца в конец данных и создает одну переменную для каждого столбца. Пример: `'5:500'` В качестве альтернативы укажите диапазон путем идентификации начала и конечного использования столбцов буквы столбца Excel или числа. Используя указанный диапазон столбца, функция импорта автоматически обнаруживает степень строки путем чтения из первой непустой строки в конец данных или области значений нижнего колонтитула. Количество столбцов в заданной области должно совпадать с номером, заданным в `NumVariables` свойство. Пример: `'A:K'`
`[n1 n2; n3 n4;...]` Несколько областей значений строки	Укажите несколько диапазонов строки, чтобы читать с `N`- `2` массив, содержащий `N` различные области значений строки. Допустимый массив нескольких областей значений строки должен: Укажите диапазоны линии в увеличивающемся порядке, который является первым диапазоном строки, указанным в массиве, появляется в файле перед другими областями значений строки. Содержите только неперекрывающиеся области значений строки. Использование `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 два противостоящих угла, которые задают область, чтобы читать.

Количество столбцов должно совпадать с номером, заданным в NumVariables свойство.

Пример: 'A5:K50'

'Row1:Row2' или 'Column1:Column2'

Область значений строки или область значений столбца

Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel.

Пример: '5:500'

Количество столбцов в заданной области должно совпадать с номером, заданным в NumVariables свойство.

Пример: 'A:K'

[n1 n2; n3 n4;...]

Несколько областей значений строки

Укажите несколько диапазонов строки, чтобы читать с N- 2 массив, содержащий N различные области значений строки.

Допустимый массив нескольких областей значений строки должен:

Укажите диапазоны линии в увеличивающемся порядке, который является первым диапазоном строки, указанным в массиве, появляется в файле перед другими областями значений строки.
Содержите только неперекрывающиеся области значений строки.

Использование Inf только поддерживается, чтобы указать на последнюю область значений в числовом массиве, указывающем несколько диапазонов строки. Например, [1 3; 5 6; 8 Inf].

Пример: [1 3; 5 6; 8 Inf]

''

Незаданный или пустой

Не выбирайте данные.

Пример: ''

Типы данных: char | string | cell | single | double

`'RowNamesRange'` — Местоположение имен строки
вектор символов | строковый скаляр | положительное скалярное целое число | `''` пустой символьный массив

Местоположение строки называет в виде вектора символов, строкового скаляра, положительного скалярного целого числа или пустого символьного массива. Задайте RowNamesRange как одно из значений в этой таблице.

Заданный Поведение

Заданный	Поведение
`'Cell'`	Задайте стартовую ячейку для данных, с помощью Excel `A1` обозначение. Например, `A5` идентификатор для ячейки на пересечении столбца `A` и строка `5`. Функция импорта идентифицирует имя для каждой переменной в данных. Пример: `'A5'`
`'Corner1:Corner2'` Прямоугольная область значений	Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где `Corner1` и `Corner2` два противостоящих угла, которые задают область, чтобы читать. Количество строк содержится в `RowNamesRange` должен совпадать с количеством строк данных и областью значений, обозначенной `RowNamesRange` должен охватить только один столбец. Пример: `'A5:A50'`
`'Row1:Row2'` Область значений строки	Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Имена строки должны быть в отдельном столбце. Пример: `'5:50'`
`n` Индекс номера	Задайте столбец, содержащий имена строки с помощью индекса столбца положительной скалярной величины. Пример 5
`''` Незаданный или пустой	Укажите, что нет никаких имен строки. Пример: `''`

'Cell'

Функция импорта идентифицирует имя для каждой переменной в данных.

Пример: 'A5'

'Corner1:Corner2'

Прямоугольная область значений

Количество строк содержится в RowNamesRange должен совпадать с количеством строк данных и областью значений, обозначенной RowNamesRange должен охватить только один столбец.

Пример: 'A5:A50'

'Row1:Row2'

Область значений строки

Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel.

Имена строки должны быть в отдельном столбце.

Пример: '5:50'

n

Индекс номера

Задайте столбец, содержащий имена строки с помощью индекса столбца положительной скалярной величины.

Пример 5

''

Незаданный или пустой

Укажите, что нет никаких имен строки.

Пример: ''

Типы данных: char | single | double

`'VariableNamesRange'` — Местоположение имен переменных
вектор символов | строковый скаляр | положительное скалярное целое число | `''` пустой символьный массив

Местоположение имен переменных в виде вектора символов, строкового скаляра, положительного скалярного целого числа или пустого символьного массива. Задайте VariableNamesRange как одно из значений в этой таблице.

Заданный Поведение

Заданный	Поведение
`'Cell'`	Задайте стартовую ячейку для данных, с помощью Excel `A1` обозначение. Например, `A5` идентификатор для ячейки на пересечении столбца `A` и строка `5`. Функция импорта читает имя для каждой переменной в данных. Пример: `'A5'`
`'Corner1:Corner2'` Прямоугольная область значений	Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где `Corner1` и `Corner2` два противостоящих угла, которые задают область, чтобы читать. Количество столбцов должно совпадать с номером, заданным в `NumVariables` свойство и область значений должны охватить только одну строку. Пример: `'A5:K5'`
`'Row1:Row2'` Область значений строки	Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Должна быть одна строка. Пример: `'5:5'`
`n` Индекс номера	Задайте строку, содержащую имена переменных с помощью индекса строки положительной скалярной величины. Пример 5
`''` Незаданный или пустой	Укажите, что нет никаких имен переменных. Пример: `''`

'Cell'

Функция импорта читает имя для каждой переменной в данных.

Пример: 'A5'

'Corner1:Corner2'

Прямоугольная область значений

Количество столбцов должно совпадать с номером, заданным в NumVariables свойство и область значений должны охватить только одну строку.

Пример: 'A5:K5'

'Row1:Row2'

Область значений строки

Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel.

Должна быть одна строка.

Пример: '5:5'

n

Индекс номера

Задайте строку, содержащую имена переменных с помощью индекса строки положительной скалярной величины.

Пример 5

''

Незаданный или пустой

Укажите, что нет никаких имен переменных.

Пример: ''

Типы данных: char | single | double

`'VariableUnitsRange'` — Местоположение переменных модулей
вектор символов | строковый скаляр | положительное скалярное целое число | `''` пустой символьный массив

Местоположение переменных модулей в виде вектора символов, строкового скаляра, положительного скалярного целого числа или пустого символьного массива. Задайте VariableUnitsRange как одно из значений в этой таблице.

Заданный Поведение

Заданный	Поведение
`'Cell'`	Задайте стартовую ячейку для данных, с помощью Excel `A1` обозначение. Например, `A5` идентификатор для ячейки на пересечении столбца `A` и строка `5`. Функция импорта читает модуль для каждой переменной в данных. Пример: `'A5'`
`'Corner1:Corner2'` Прямоугольная область значений	Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где `Corner1` и `Corner2` два противостоящих угла, которые задают область, чтобы читать. Количество столбцов должно совпадать с номером, заданным в `NumVariables` свойство и область значений должны охватить только одну строку. Пример: `'A5:K5'`
`'Row1:Row2'` Область значений строки	Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Должна быть одна строка. Пример: `'5:5'`
`n` Индекс номера	Задайте строку, содержащую модули данных с помощью индекса строки положительной скалярной величины. Пример 5
`''` Незаданный или пустой	Укажите, что нет никаких переменных модулей. Пример: `''`

'Cell'

Функция импорта читает модуль для каждой переменной в данных.

Пример: 'A5'

'Corner1:Corner2'

Прямоугольная область значений

Пример: 'A5:K5'

'Row1:Row2'

Область значений строки

Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel.

Должна быть одна строка.

Пример: '5:5'

n

Индекс номера

Задайте строку, содержащую модули данных с помощью индекса строки положительной скалярной величины.

Пример 5

''

Незаданный или пустой

Укажите, что нет никаких переменных модулей.

Пример: ''

Типы данных: char | string | single | double

`'VariableDescriptionsRange'` — Местоположение описаний переменной
вектор символов | строковый скаляр | `''` пустой символьный массив

Местоположение описаний переменной в виде вектора символов, строкового скаляра, положительного скалярного целого числа или пустого символьного массива. Задайте VariableDescriptionRange как одно из значений в этой таблице.

Заданный Поведение

Заданный	Поведение
`'Cell'`	Задайте стартовую ячейку для данных, с помощью Excel `A1` обозначение. Например, `A5` идентификатор для ячейки на пересечении столбца `A` и строка `5`. Функция импорта читает описание для каждой переменной в данных. Пример: `'A5'`
`'Corner1:Corner2'` Прямоугольная область значений	Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где `Corner1` и `Corner2` два противостоящих угла, которые задают область, чтобы читать. Количество столбцов должно совпадать с номером, заданным в `NumVariables` свойство и область значений должны охватить только одну строку. Пример: `'A5:K5'`
`'Row1:Row2'` Область значений строки	Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Должна быть одна строка. Пример: `'5:5'`
`n` Индекс номера	Задайте строку, содержащую описания с помощью индекса строки положительной скалярной величины. Пример 5
`''` Незаданный или пустой	Укажите, что нет никаких описаний переменной. Пример: `''`

'Cell'

Функция импорта читает описание для каждой переменной в данных.

Пример: 'A5'

'Corner1:Corner2'

Прямоугольная область значений

Пример: 'A5:K5'

'Row1:Row2'

Область значений строки

Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel.

Должна быть одна строка.

Пример: '5:5'

n

Индекс номера

Задайте строку, содержащую описания с помощью индекса строки положительной скалярной величины.

Пример 5

''

Незаданный или пустой

Укажите, что нет никаких описаний переменной.

Пример: ''

Типы данных: char | string | single | double

Параметры для текстовых файлов только

свернуть все

`'Delimiter'` — Символы разделителя полей
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

Символы разделителя полей в файле разделенного текста в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.

Пример: 'Delimiter','|'

Пример: 'Delimiter',{';','*'}

Типы данных: char | string | cell

`'LeadingDelimitersRule'` — Процедура, чтобы управлять ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

Процедура, чтобы управлять ведущими разделителями в файле разделенного текста в виде одного из значений в этой таблице.

LeadingDelimitersRule	Поведение
`'keep'`	Сохраните разделитель.
`'ignore'`	Проигнорируйте разделитель.
`'error'`	Возвратите ошибку и прервите операцию импорта.

`'TrailingDelimitersRule'` — Процедура, чтобы справиться с запаздыванием разделителей
`'keep'` | `'ignore'` | `'error'`

Процедура, чтобы справиться с запаздыванием разделителей в файле разделенного текста в виде одного из значений в этой таблице.

LeadingDelimitersRule	Поведение
`'keep'`	Сохраните разделитель.
`'ignore'`	Проигнорируйте разделитель.
`'error'`	Возвратите ошибку и прервите операцию импорта.

`'ConsecutiveDelimitersRule'` — Процедура, чтобы обработать последовательные разделители
`'split'` | `'join'` | `'error'`

Процедура, чтобы обработать последовательные разделители в файле разделенного текста в виде одного из значений в этой таблице.

ConsecutiveDelimitersRule	Поведение
`'split'`	Разделите последовательные разделители в несколько полей.
`'join'`	Соедините разделители в один разделитель.
`'error'`	Возвратите ошибку и прервите операцию импорта.

Типы данных: char | string

`'VariableWidths'` — Ширина поля переменных
вектор из положительных целочисленных значений

Ширина поля переменных в текстовом файле фиксированной ширины в виде вектора из положительных целочисленных значений. Каждое положительное целое число в векторе соответствует количеству символов в поле, которое составляет переменную. VariableWidths свойство содержит запись, соответствующую каждой переменной, заданной в VariableNames свойство.

`'Whitespace'` — Символы, чтобы обработать как пробел
вектор символов | строковый скаляр

Символы, чтобы обработать как пробел в виде вектора символов или строкового скаляра, содержащего один или несколько символов.

Пример: 'Whitespace',' _'

Пример: 'Whitespace','?!.,'

`'LineEnding'` — Символы конца линии
`{'\n','\r','\r\n'}` (значение по умолчанию) | вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

Символы конца линии в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.

Пример: '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'` — Стиль комментариев
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

Стиль комментариев в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.

Например, чтобы проигнорировать текст после знака процента на той же линии, задайте CommentStyle как '%'.

Пример: 'CommentStyle',{'/*'}

Типы данных: char | string | cell

`'DurationType'` — Тип выходных данных данных о длительности
`'duration'` (значение по умолчанию) | `'text'`

Тип выходных данных данных о длительности из текстовых файлов в виде разделенной запятой пары, состоящей из 'DurationType' и любой 'duration' или 'text'.

Значение Введите для импортированных данных о длительности

Значение	Введите для импортированных данных о длительности
`'duration'`	MATLAB `duration` тип данных Для получения дополнительной информации смотрите `duration`.
`'text'`	Если `'DurationType'` задан как `'text'`, затем тип для импортированных данных о длительности зависит от значения, заданного в `'TextType'` параметр: Если `'TextType'` установлен в `'char'`, затем функция импорта возвращает данные о длительности как массив ячеек из символьных векторов. Если `'TextType'` установлен в `'string'`, затем функция импорта возвращает данные о длительности как массив строк.

'duration'

MATLAB duration тип данных

Для получения дополнительной информации смотрите duration.

'text'

Если 'DurationType' задан как 'text', затем тип для импортированных данных о длительности зависит от значения, заданного в 'TextType' параметр:

Если 'TextType' установлен в 'char', затем функция импорта возвращает данные о длительности как массив ячеек из символьных векторов.
Если 'TextType' установлен в 'string', затем функция импорта возвращает данные о длительности как массив строк.

Типы данных: char | string

`'ExtraColumnsRule'` — Процедура, чтобы обработать дополнительные столбцы
`'addvars'` | `'ignore'` | `'wrap'` | `'error'`

Процедура, чтобы обработать дополнительные столбцы в данных в виде одного из значений в этой таблице.

ExtraColumnsRule	Поведение
`'addvars'`	Чтобы импортировать дополнительные столбцы, создайте новые переменные. Если существует `N` дополнительные столбцы, затем импортируйте новые переменные как `'ExtraVar1', 'ExtraVar2',..., 'ExtraVarN'`. ПРИМЕЧАНИЕ: дополнительные столбцы импортируются как текст с данными type`char`.
`'ignore'`	Проигнорируйте дополнительные столбцы данных.
`'wrap'`	Перенесите дополнительные столбцы данных к новым записям. Это действие не изменяет количество переменных.
`'error'`	Отобразите сообщение об ошибке и прервите операцию импорта.

Типы данных: char | string

`'TreatAsMissing'` — Текст, чтобы интерпретировать как недостающие данные
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

Текст, чтобы интерпретировать как недостающие данные в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.

Когда функция импорта находит недостающие экземпляры, она использует спецификацию в MissingRule свойство определить соответствующие меры.

Пример: 'TreatAsMissing',{'NA','TBD'} дает функции импорта команду обрабатывать любое вхождение NA или TBD как недостающие поля.

Типы данных: char | string | cell

`'DateLocale'` — Локаль для чтения дат
вектор символов | строковый скаляр

Локаль для чтения дат в виде разделенной запятой пары, состоящей из 'DateLocale' и вектор символов или строковый скаляр формы xx_YY, где:

YY прописная альфа ISO 3166-1 2 кода, указывающие на страну.
xx строчный ISO 639-1 двухбуквенный код, указывающий на язык.

Для списка общих значений для локали смотрите Locale аргумент пары "имя-значение" для datetime функция.

При использовании %D спецификатор формата, чтобы считать текст как datetime значения, используйте DateLocale задавать локаль, в которой функция импорта должна интерпретировать имена месяца и дня недели и сокращения.

Если вы задаете DateLocale аргумент в дополнение к opts настройки импорта, затем функция импорта использует заданное значение для DateLocale аргумент, заменяя локаль задан в настройках импорта.

Пример: 'DateLocale','ja_JP'

`'ThousandsSeparator'` — Символы, которые указывают на тысячи группировки
вектор символов | строковый скаляр

Символы, которые указывают на тысячи группировки в числовых переменных в виде вектора символов или строкового скаляра. Тысячи группирующихся символов действуют как визуальные диафрагмы, группируя номер в каждых трех значениях места. Функция импорта использует символы в ThousandsSeparator свойство интерпретировать импортируемые числа.

Типы данных: char | string

`'DecimalSeparator'` — Символы, указывающие на десятичный разделитель
вектор символов | строковый скаляр

Символы, указывающие на десятичный разделитель в числовых переменных в виде вектора символов или строкового скаляра. Функция импорта использует DecimalSeparator свойство отличить целую часть номера от десятичной части.

При преобразовании в целочисленные типы данных числа с десятичной частью округлены до ближайшего целого числа.

Типы данных: char | string

`'TrimNonNumeric'` — Удалите нечисловые символы
`false` (значение по умолчанию) | `true`

Удалите нечисловые символы из числовой переменной в виде логического true или false.

Типы данных: логический

`'HexType'` — Тип выходных данных шестнадцатеричных данных
`'auto'` (значение по умолчанию) | `'text'` | `'int8'` | `'int16'` | ...

Тип выходных данных шестнадцатеричных данных в виде разделенной запятой пары, состоящей из 'HexType' и одно из перечисленных в таблице значений.

Входной файл представляет шестнадцатеричные значения как текст, с помощью любого 0x или 0X как префикс и символы 0-9AF, и AF как цифры. (Прописные и строчные буквы представляют те же цифры — например, '0xf' и '0xF' оба представляют 15.)

Функция импорта преобразует шестнадцатеричные значения в тип данных, заданный значением 'HexType'.

Значение `'HexType'`	Тип данных Выходных табличных переменных
`'auto'`	тип данных обнаруживается автоматически
`'text'`	неизменный входной текст
`'int8'`	8-битное целое число, подписанное
`'int16'`	16-битное целое число, подписанное
`'int32'`	32-битное целое число, подписанное
`'int64'`	64-битное целое число, подписанное
`'uint8'`	8-битное целое число, без знака
`'uint16'`	16-битное целое число, без знака
`'uint32'`	32-битное целое число, без знака
`'uint64'`	64-битное целое число, без знака

Пример: 'HexType','uint16' преобразует текст, представляющий шестнадцатеричные значения (такие как '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

Выходные аргументы

свернуть все

`opts` — Настройки импорта для файла
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions`

Настройки импорта для заданного файла, возвращенного как SpreadsheetImportOptions возразите или DelimitedTextImportOptions объект. Тип объекта опций зависит от типа заданного файла. Для текстовых файлов (.txt, .dat, или .csv), detectImportOptions функция возвращает DelimitedTextImportOptions или FixedWidthImportOptions объект. Для файлов электронной таблицы (.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, или .ods), detectImportOptions функция возвращает SpreadsheetImportOptions объект.

Советы

Обновление Значений свойств После Создания Объекта Настроек импорта: Использование записи через точку, чтобы обновить свойства объекта настроек импорта, созданного detecImportOptions не рекомендуется. Установка свойств с помощью записи через точку не приводит к переобнаружению всех настроек импорта для файла. Поэтому, чтобы обновиться и повторно обнаружить все свойства, необходимо задать новые значения при помощи пар "имя-значение". Например, обновите значение для ConsecutiveDelimitersRule свойство и повторно обнаруживает настройки импорта можно следующим образом.
```
opts = detectImportOptions(__,'ConsecutiveDelimitersRule','join')
```

Документация

detectImportOptions

Синтаксис

Описание

Примеры

Обнаружьте и используйте настройки импорта для файлов электронной таблицы

Обнаружьте и используйте настройки импорта для текстовых файлов

Обозначение типа данных для данных импортируемого текста

Входные параметры

filename — Имя файла, чтобы читать вектор символов | строковый скаляр

Аргументы в виде пар имя-значение

'FileType' — Тип файла 'spreadsheet' | 'text' | 'delimitedtext' | 'fixedwidth'

'TextType' — Введите для данных об импортируемом тексте 'char' (значение по умолчанию) | 'string'

'DatetimeType' — Введите для импортированных данных о дате и времени 'datetime' (значение по умолчанию) | 'text' | 'exceldatenum' Файлы электронной таблицы только

'ExpectedNumVariables' — Ожидаемое количество переменных положительное целое число

'Range' — Фрагмент данных, чтобы читать вектор символов | строковый скаляр | числовой вектор

'NumHeaderLines' — Количество линий заголовка положительное целое число

'ReadVariableNames' — Считайте первую строку как имена переменных true | false

'VariableNamingRule' — Отметьте, чтобы сохранить имена переменных 'modify' (значение по умолчанию) | 'preserve'

'ReadRowNames' — Индикатор для чтения первого столбца как имена строки false (значение по умолчанию) | true

'MissingRule' — Процедура, чтобы управлять недостающими данными 'fill' | 'error' | 'omitrow' | 'omitvar'

'ImportErrorRule' — Процедура, чтобы обработать ошибки импорта 'fill' | 'error' | 'omitrow' | 'omitvar'

'Sheet' — Покройте, чтобы читать из '' пустой символьный массив (значение по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

'RowNamesRange' — Местоположение имен строки вектор символов | строковый скаляр | положительное скалярное целое число | '' пустой символьный массив

'VariableNamesRange' — Местоположение имен переменных вектор символов | строковый скаляр | положительное скалярное целое число | '' пустой символьный массив

'VariableUnitsRange' — Местоположение переменных модулей вектор символов | строковый скаляр | положительное скалярное целое число | '' пустой символьный массив

'VariableDescriptionsRange' — Местоположение описаний переменной вектор символов | строковый скаляр | '' пустой символьный массив

'Delimiter' — Символы разделителя полей вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

'LeadingDelimitersRule' — Процедура, чтобы управлять ведущими разделителями 'keep' | 'ignore' | 'error'

'TrailingDelimitersRule' — Процедура, чтобы справиться с запаздыванием разделителей 'keep' | 'ignore' | 'error'

'ConsecutiveDelimitersRule' — Процедура, чтобы обработать последовательные разделители 'split' | 'join' | 'error'

'VariableWidths' — Ширина поля переменных вектор из положительных целочисленных значений

'Whitespace' — Символы, чтобы обработать как пробел вектор символов | строковый скаляр

'LineEnding' — Символы конца линии {'\n','\r','\r\n'} (значение по умолчанию) | вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

'Encoding' — Схема кодировки символов '' | 'UTF-8' | 'system' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

'CommentStyle' — Стиль комментариев вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

'DurationType' — Тип выходных данных данных о длительности 'duration' (значение по умолчанию) | 'text'

'ExtraColumnsRule' — Процедура, чтобы обработать дополнительные столбцы 'addvars' | 'ignore' | 'wrap' | 'error'

'TreatAsMissing' — Текст, чтобы интерпретировать как недостающие данные вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

'DateLocale' — Локаль для чтения дат вектор символов | строковый скаляр

'ThousandsSeparator' — Символы, которые указывают на тысячи группировки вектор символов | строковый скаляр

'DecimalSeparator' — Символы, указывающие на десятичный разделитель вектор символов | строковый скаляр

'TrimNonNumeric' — Удалите нечисловые символы false (значение по умолчанию) | true

'HexType' — Тип выходных данных шестнадцатеричных данных 'auto' (значение по умолчанию) | 'text' | 'int8' | 'int16' | ...

'BinaryType' — Тип выходных данных двоичных данных 'auto' (значение по умолчанию) | 'text' | 'int8' | 'int16' | ...

Выходные аргументы

opts — Настройки импорта для файла SpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptions

Советы

Смотрите также

Темы

Документация MATLAB

Поддержка

`filename` — Имя файла, чтобы читать
вектор символов | строковый скаляр

`'FileType'` — Тип файла
`'spreadsheet'` | `'text'` | `'delimitedtext'` | `'fixedwidth'`

`'TextType'` — Введите для данных об импортируемом тексте
`'char'` (значение по умолчанию) | `'string'`

`'DatetimeType'` — Введите для импортированных данных о дате и времени
`'datetime'` (значение по умолчанию) | `'text'` | `'exceldatenum'` Файлы электронной таблицы только

`'ExpectedNumVariables'` — Ожидаемое количество переменных
положительное целое число

`'Range'` — Фрагмент данных, чтобы читать
вектор символов | строковый скаляр | числовой вектор

`'NumHeaderLines'` — Количество линий заголовка
положительное целое число

`'ReadVariableNames'` — Считайте первую строку как имена переменных
`true` | `false`

`'VariableNamingRule'` — Отметьте, чтобы сохранить имена переменных
`'modify'` (значение по умолчанию) | `'preserve'`

`'ReadRowNames'` — Индикатор для чтения первого столбца как имена строки
`false` (значение по умолчанию) | `true`

`'MissingRule'` — Процедура, чтобы управлять недостающими данными
`'fill'` | `'error'` | `'omitrow'` | `'omitvar'`

`'ImportErrorRule'` — Процедура, чтобы обработать ошибки импорта
`'fill'` | `'error'` | `'omitrow'` | `'omitvar'`

`'Sheet'` — Покройте, чтобы читать из
`''` пустой символьный массив (значение по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

`'RowNamesRange'` — Местоположение имен строки
вектор символов | строковый скаляр | положительное скалярное целое число | `''` пустой символьный массив

`'VariableNamesRange'` — Местоположение имен переменных
вектор символов | строковый скаляр | положительное скалярное целое число | `''` пустой символьный массив

`'VariableUnitsRange'` — Местоположение переменных модулей
вектор символов | строковый скаляр | положительное скалярное целое число | `''` пустой символьный массив

`'VariableDescriptionsRange'` — Местоположение описаний переменной
вектор символов | строковый скаляр | `''` пустой символьный массив

`'Delimiter'` — Символы разделителя полей
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

`'LeadingDelimitersRule'` — Процедура, чтобы управлять ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

`'TrailingDelimitersRule'` — Процедура, чтобы справиться с запаздыванием разделителей
`'keep'` | `'ignore'` | `'error'`

`'ConsecutiveDelimitersRule'` — Процедура, чтобы обработать последовательные разделители
`'split'` | `'join'` | `'error'`

`'VariableWidths'` — Ширина поля переменных
вектор из положительных целочисленных значений

`'Whitespace'` — Символы, чтобы обработать как пробел
вектор символов | строковый скаляр

`'LineEnding'` — Символы конца линии
`{'\n','\r','\r\n'}` (значение по умолчанию) | вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

`'Encoding'` — Схема кодировки символов
`''` | `'UTF-8'` | `'system'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

`'CommentStyle'` — Стиль комментариев
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

`'DurationType'` — Тип выходных данных данных о длительности
`'duration'` (значение по умолчанию) | `'text'`

`'ExtraColumnsRule'` — Процедура, чтобы обработать дополнительные столбцы
`'addvars'` | `'ignore'` | `'wrap'` | `'error'`

`'TreatAsMissing'` — Текст, чтобы интерпретировать как недостающие данные
вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

`'DateLocale'` — Локаль для чтения дат
вектор символов | строковый скаляр

`'ThousandsSeparator'` — Символы, которые указывают на тысячи группировки
вектор символов | строковый скаляр

`'DecimalSeparator'` — Символы, указывающие на десятичный разделитель
вектор символов | строковый скаляр

`'TrimNonNumeric'` — Удалите нечисловые символы
`false` (значение по умолчанию) | `true`

`'HexType'` — Тип выходных данных шестнадцатеричных данных
`'auto'` (значение по умолчанию) | `'text'` | `'int8'` | `'int16'` | ...

`'BinaryType'` — Тип выходных данных двоичных данных
`'auto'` (значение по умолчанию) | `'text'` | `'int8'` | `'int16'` | ...

`opts` — Настройки импорта для файла
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions`