readvars

Чтение переменных из файла

Синтаксис

[Var1,Var2,...,VarN] = readvars(filename)

[Var1,Var2,...,VarN] = readvars(filename,opts)

[Var1,Var2,...,VarN] = readvars(___,Name,Value)

Описание

[Var1,Var2,...,VarN] = readvars(filename) создает переменные путем чтения ориентированных на столбцы данных из файла. Если файл содержит N столбцы данных, затем readvars возвращает N переменные Var1,Var2,...,VarN.

readvars определяет формат файла из расширения файла:

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

пример

[Var1,Var2,...,VarN] = readvars(filename,opts) дополнительно использует настройки импорта opts.

пример

[Var1,Var2,...,VarN] = readvars(___,Name,Value) создает переменные из файла с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение". Используйте любой из входных параметров из предыдущих синтаксисов перед указанием пар "имя-значение".

Чтобы задать конкретные настройки импорта для ваших данных, можно либо использовать opts Объект или можно задать пары "имя-значение". Если вы задаете пары "имя-значение" в дополнение к opts, затем readvars поддерживает только эти пары "имя-значение":

Текстовые файлы - DateLocale, Encoding
Файлы электронной таблицы - Sheet, UseExcel

Примеры

свернуть все

Чтение переменных из текстового файла

Открыть Live Script

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

Предварительный просмотр данных в outages.csv. Файл имеет 6 переменные.

opts = detectImportOptions('outages.csv');
preview('outages.csv',opts)

ans=8×6 table
       Region           OutageTime        Loss     Customers     RestorationTime            Cause       
    _____________    ________________    ______    __________    ________________    ___________________

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

Импортируйте первые три столбца как отдельные переменные в рабочей области.

[Region,OutageTime,Loss] = readvars('outages.csv');
whos Region OutageTime Loss

  Name               Size             Bytes  Class       Attributes

  Loss            1468x1              11744  double                
  OutageTime      1468x1              23520  datetime              
  Region          1468x1             174988  cell

Чтение переменных из файла электронной таблицы

Открыть Live Script

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

Предварительный просмотр данных в patients.xls. Файл имеет 10 переменные.

opts = detectImportOptions('patients.xls');
preview('patients.xls',opts)

ans=8×10 table
      LastName        Gender      Age              Location               Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    ____________    __________    ___    _____________________________    ______    ______    ______    ________    _________    ________________________

    {'Smith'   }    {'Male'  }    38     {'County General Hospital'  }      71       176      true        124          93             {'Excellent'}      
    {'Johnson' }    {'Male'  }    43     {'VA Hospital'              }      69       163      false       109          77             {'Fair'     }      
    {'Williams'}    {'Female'}    38     {'St. Mary's Medical Center'}      64       131      false       125          83             {'Good'     }      
    {'Jones'   }    {'Female'}    40     {'VA Hospital'              }      67       133      false       117          75             {'Fair'     }      
    {'Brown'   }    {'Female'}    49     {'County General Hospital'  }      64       119      false       122          80             {'Good'     }      
    {'Davis'   }    {'Female'}    46     {'St. Mary's Medical Center'}      68       142      false       121          70             {'Good'     }      
    {'Miller'  }    {'Female'}    33     {'VA Hospital'              }      64       142      true        130          88             {'Good'     }      
    {'Wilson'  }    {'Male'  }    40     {'VA Hospital'              }      68       180      false       115          82             {'Good'     }

Импортируйте первые три столбца как отдельные переменные в рабочей области.

[LastName,Gender,Age] = readvars('patients.xls');
whos  LastName Gender Age

  Name            Size            Bytes  Class     Attributes

  Age           100x1               800  double              
  Gender        100x1             11412  cell                
  LastName      100x1             11616  cell

Чтение переменных из заданного листа и области значений с помощью настроек импорта

Открыть Live Script

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

Файл электронной таблицы airlinesmall_subset.xlsx содержит данные в нескольких таблицах за годы с 1996 по 2008 год. Каждый лист имеет данные за определенный год. Предварительный просмотр данных из файловой airlinesmall_subset.xlsx. The preview функция по умолчанию показывает данные из первого листа.

opts = detectImportOptions('airlinesmall_subset.xlsx');
preview('airlinesmall_subset.xlsx',opts)

ans=8×29 table
    Year    Month    DayofMonth    DayOfWeek    DepTime    CRSDepTime    ArrTime    CRSArrTime    UniqueCarrier    FlightNum     TailNum      ActualElapsedTime    CRSElapsedTime    AirTime    ArrDelay    DepDelay    Origin      Dest      Distance    TaxiIn    TaxiOut    Cancelled    CancellationCode    Diverted    CarrierDelay    WeatherDelay      SDelay      SecurityDelay    LateAircraftDelay
    ____    _____    __________    _________    _______    __________    _______    __________    _____________    _________    __________    _________________    ______________    _______    ________    ________    _______    _______    ________    ______    _______    _________    ________________    ________    ____________    ____________    __________    _____________    _________________

    1996      1          18            4         2117         2120        2305         2259          {'HP'}           415       {'N637AW'}           108                 99            85           6          -3       {'COS'}    {'PHX'}      551         5         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          12            5         1252         1245        1511         1500          {'HP'}           610       {'N905AW'}            79                 75            58          11           7       {'LAX'}    {'PHX'}      370         3         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          16            2         1441         1445        1708         1721          {'HP'}           211       {'N165AW'}            87                 96            74         -13          -4       {'RNO'}    {'PHX'}      601         4          9           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           1            1         2258         2300        2336         2335          {'HP'}          1245       {'N183AW'}            38                 35            20           1          -2       {'TUS'}    {'PHX'}      110         6         12           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           4            4         1814         1814        1901         1910          {'US'}           683       {'N963VJ'}            47                 56            34          -9           0       {'DTW'}    {'PIT'}      201         6          7           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          31            3         1822         1820        1934         1925          {'US'}           757       {'N912VJ'}            72                 65            52           9           2       {'PHL'}    {'PIT'}      267         6         14           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          18            4          729          730         841          843          {'US'}          1564       {'N941VJ'}            72                 73            58          -2          -1       {'DCA'}    {'PVD'}      357         3         11           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          26            5         1704         1705        1829         1839          {'NW'}          1538       {'N960N' }            85                 94            69         -10          -1       {'DTW'}    {'RIC'}      456         3         13           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}

Сконфигурируйте значения в opts объект для импорта 10 строки для столбцов 5 и 6 листа с именем '2007'.

opts.Sheet = '2007';
opts.SelectedVariableNames = [5 6]; 
opts.DataRange = '2:11';
[DepTime,CRSDepTime] = readvars('airlinesmall_subset.xlsx',opts);

Отобразите переменные.

[DepTime, CRSDepTime]

ans = 10×2

         711         710
         652         655
        1116        1120
         825         825
        1411        1400
        1935        1935
        2005        2005
        1525        1525
        1133        1105
         922         925

Чтение переменных из заданного листа и области значений

Открыть Live Script

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

opts = detectImportOptions('airlinesmall_subset.xlsx');
preview('airlinesmall_subset.xlsx',opts)

ans=8×29 table
    Year    Month    DayofMonth    DayOfWeek    DepTime    CRSDepTime    ArrTime    CRSArrTime    UniqueCarrier    FlightNum     TailNum      ActualElapsedTime    CRSElapsedTime    AirTime    ArrDelay    DepDelay    Origin      Dest      Distance    TaxiIn    TaxiOut    Cancelled    CancellationCode    Diverted    CarrierDelay    WeatherDelay      SDelay      SecurityDelay    LateAircraftDelay
    ____    _____    __________    _________    _______    __________    _______    __________    _____________    _________    __________    _________________    ______________    _______    ________    ________    _______    _______    ________    ______    _______    _________    ________________    ________    ____________    ____________    __________    _____________    _________________

    1996      1          18            4         2117         2120        2305         2259          {'HP'}           415       {'N637AW'}           108                 99            85           6          -3       {'COS'}    {'PHX'}      551         5         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          12            5         1252         1245        1511         1500          {'HP'}           610       {'N905AW'}            79                 75            58          11           7       {'LAX'}    {'PHX'}      370         3         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          16            2         1441         1445        1708         1721          {'HP'}           211       {'N165AW'}            87                 96            74         -13          -4       {'RNO'}    {'PHX'}      601         4          9           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           1            1         2258         2300        2336         2335          {'HP'}          1245       {'N183AW'}            38                 35            20           1          -2       {'TUS'}    {'PHX'}      110         6         12           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           4            4         1814         1814        1901         1910          {'US'}           683       {'N963VJ'}            47                 56            34          -9           0       {'DTW'}    {'PIT'}      201         6          7           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          31            3         1822         1820        1934         1925          {'US'}           757       {'N912VJ'}            72                 65            52           9           2       {'PHL'}    {'PIT'}      267         6         14           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          18            4          729          730         841          843          {'US'}          1564       {'N941VJ'}            72                 73            58          -2          -1       {'DCA'}    {'PVD'}      357         3         11           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          26            5         1704         1705        1829         1839          {'NW'}          1538       {'N960N' }            85                 94            69         -10          -1       {'DTW'}    {'RIC'}      456         3         13           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}

Импортируйте 10 строки первых трех переменных из листа с именем '2007'.

[Year, Month, DayOfMonth] = readvars('airlinesmall_subset.xlsx','Sheet','2007','Range','A2:C11');
whos Year Month DayOfMonth

  Name             Size            Bytes  Class     Attributes

  DayOfMonth      10x1                80  double              
  Month           10x1                80  double              
  Year            10x1                80  double

disp([Year Month DayOfMonth])

        2007           1           2
        2007           1           3
        2007           1           4
        2007           1           5
        2007           1           7
        2007           1           8
        2007           1           9
        2007           1          11
        2007           1          12
        2007           1          13

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

свернуть все

`filename` - Имя файла для чтения
вектор символов | строковый скаляр

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

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

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

Форма

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

Укажите имя файла в filename.

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

Файл в папке

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

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

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

URL-адрес Интернета

Если файл задан как однородный интернет-локатор ресурсов (URL), то filename должен содержать тип протокола 'http://' или 'https://'.

Пример: 'http://hostname/path_to_file/my_data.csv'

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

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

scheme_name://path_to_file/ my_file.ext

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

Удаленное местоположение	`scheme_name`
Амазонки S3™	`s3`
Windows Azure^® Хранилище больших двоичных объектов	`wasb`, `wasbs`
HDFS™	`hdfs`

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

Пример: 's3://bucketname/path_to_file/my_file.csv'

Если filename включает расширение файла, затем функция импорта определяет формат файла из расширения. В противном случае необходимо задать 'FileType' аргументы пары "имя-значение" для указания типа файла.
В Windows^® систем с Microsoft^® Excel^® ПО, функция импорта считывает любой формат файла электронной таблицы Excel, распознанный вашей версией Excel.
Если в вашей системе нет Excel для Windows или если вы используете Online™ MATLAB, функция импорта работает с UseExcel значение свойства установлено в false, и читается только .xls, .xlsx, .xlsm, .xltx, and .xltm файлы.
Для текстовых файлов с разделителями функция импорта преобразует пустые поля в файле в NaN (для числовой переменной) или пустой символьный вектор (для текстовой переменной). Все линии в текстовом файле должны иметь одинаковое количество разделителей. Функция импорта игнорирует незначительное пустое пространство в файле.

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

`opts` - настройки импорта файлов
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`

Настройки импорта файлов, заданные как SpreadsheetImportOptions, DelimitedTextImportOptions, FixedWidthImportOptions, или XMLImportOptions объект, созданный detectImportOptions функция. The opts объект содержит свойства, которые управляют процессом импорта данных. Для получения дополнительной информации о свойствах каждого объекта см. соответствующую страницу объекта.

Тип файлов	Выход
Файлы электронной таблицы	`SpreadsheetImportOptions` объект (доступен только для `Sheet`, `DataRange`, и `VariableNames` свойства)
Текстовые файлы	`DelimitedTextImportOptions` объект
Текстовые файлы фиксированной ширины	`FixedWidthImportOptions` объект
XML- файлы	`XMLImportOptions` объект

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

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

Пример: 'NumHeaderLines',5 указывает, что первые пять линии, предшествующих табличным данным, являются линиями заголовка.

Текст и Файлы электронной таблицы

свернуть все

`'FileType'` - Тип файла
`'text'` | `'spreadsheet'`

Тип файла, заданный как разделенная разделенными запятой парами, состоящая из 'FileType' и 'text' или 'spreadsheet'.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Способы задать `Range`	Описание
Стартовая камера `'Cell'` или `[row col]`	Задайте стартовую камеру для данных в виде вектора символов или строкового скаляра или двухчислового элемента. Вектор символов или строковый скаляр, содержащий букву столбца и номер строки с помощью `A1` Excel обозначение. Для примера, `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','' Примечание: Used Range относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. Функция импорта автоматически обнаруживает используемую область значений, обрезая все начальные и конечные строки и столбцы, которые не содержат данных. Текст, который является только белым пространством, рассматривается как данные и захватывается в пределах используемой области значений.

Стартовая камера

'Cell' или [row col]

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

Вектор символов или строковый скаляр, содержащий букву столбца и номер строки с помощью A1 Excel обозначение. Для примера, 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',''

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

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

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

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

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

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

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

Тип для импортированных данных даты и времени, заданный как разделенная разделенными запятой парами, состоящая из 'DatetimeType' и одно из следующих значений: 'datetime', 'text', или '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

`'TreatAsMissing'` - Текст для интерпретации как отсутствующие данные
вектор символов | строковый скаляр | массив ячеек из векторов символов | строковые массивы

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

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

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

Текстовые файлы только

свернуть все

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

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

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

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

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

`'Whitespace'` - Символы для лечения как пустое пространство
вектор символов | строковый скаляр

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

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

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

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

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

Пример: 'LineEnding','\n'

Пример: 'LineEnding','\r\n'

Пример: 'LineEnding',{'\b',':'}

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

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

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

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

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

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

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

Схема кодирования символов, сопоставленная с файлом, задается как разделенная разделенными запятой парами, состоящая из 'Encoding' и 'system' или стандартное имя схемы кодирования символов. Когда вы не задаете никакую кодировку, readvars функция использует автоматическое обнаружение набора chararracter, чтобы определить кодировку при чтении файла.

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

Пример: 'Encoding','UTF-8' использует UTF-8 в качестве кодировки.

Пример: 'Encoding','system' использует системную кодировку по умолчанию.

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

`'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

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

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

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

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

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

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

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

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

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

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

Пример: Если пара "имя-значение" задана как 'DecimalSeparator',',', затем функция импорта импортирует текст "3,14159" как число 3.14159.

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

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

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

Пример: Если пара "имя-значение" задана как 'ThousandsSeparator',',', затем функция импорта импортирует текст "1,234,000" как 1234000.

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

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

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

Пример: Если пара "имя-значение" задана как 'TrimNonNumeric',true, затем функция импорта читает '$500/-' как 500.

Типы данных: logical

`'ConsecutiveDelimitersRule'` - Процедура обработки последовательных разделителей
`'split'` | `'join'` | `'error'`

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

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

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

`'LeadingDelimitersRule'` - Процедура управления ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

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

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

`'TrailingDelimitersRule'` - Процедура управления конечными разделителями
`'keep'` | `'ignore'` | `'error'`

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

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

Только файлы электронной таблицы

свернуть все

`'Sheet'` - Лист для чтения с
`''` пустой символьный массив (по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

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

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

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

`'UseExcel'` - флаг для запуска образца Microsoft Excel для Windows
`false` (по умолчанию) | `true`

Флаг для запуска образца Microsoft Excel для Windows при чтении данных электронных таблиц, заданный как разделенная разделенными запятой парами, состоящая из 'UseExcel' и любой из них true, или false.

Можно задать 'UseExcel' параметр к одному из следующих значений:

true - функция импорта запускает образец Microsoft Excel при чтении файла.
false - функция импорта не запускает образец Microsoft Excel при чтении файла. При работе в этом режиме функциональность импортирующей функции отличается поддержкой форматов файлов и интерактивных функций, таких как формулы и макросы.

UseExcel	`true`	`false`
Поддерживаемые форматы файлов	`.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods`	`.xls, .xlsx, .xlsm, .xltx, .xltm`
Поддержка интерактивных функций, таких как формулы и макросы	Да	Нет

При чтении из файлов электронной таблицы на платформах Windows, если необходимо запустить образец Microsoft Excel, установите 'UseExcel' параметр в true.

См. также

readcell | readmatrix | readtable | readtimetable

Введенный в R2019a

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

readvars

Синтаксис

Описание

Примеры

Чтение переменных из текстового файла

Чтение переменных из файла электронной таблицы

Чтение переменных из заданного листа и области значений с помощью настроек импорта

Чтение переменных из заданного листа и области значений

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

`filename` - Имя файла для чтения
вектор символов | строковый скаляр

`opts` - настройки импорта файлов
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`

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

`'FileType'` - Тип файла
`'text'` | `'spreadsheet'`

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

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

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

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

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

`'TreatAsMissing'` - Текст для интерпретации как отсутствующие данные
вектор символов | строковый скаляр | массив ячеек из векторов символов | строковые массивы

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

`'Whitespace'` - Символы для лечения как пустое пространство
вектор символов | строковый скаляр

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

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

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

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

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

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

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

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

`'ConsecutiveDelimitersRule'` - Процедура обработки последовательных разделителей
`'split'` | `'join'` | `'error'`

`'LeadingDelimitersRule'` - Процедура управления ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

`'TrailingDelimitersRule'` - Процедура управления конечными разделителями
`'keep'` | `'ignore'` | `'error'`

`'Sheet'` - Лист для чтения с
`''` пустой символьный массив (по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

`'UseExcel'` - флаг для запуска образца Microsoft Excel для Windows
`false` (по умолчанию) | `true`

См. также

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

Поддержка

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

readvars

Синтаксис

Описание

Примеры

Чтение переменных из текстового файла

Чтение переменных из файла электронной таблицы

Чтение переменных из заданного листа и области значений с помощью настроек импорта

Чтение переменных из заданного листа и области значений

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

filename - Имя файла для чтения вектор символов | строковый скаляр

opts - настройки импорта файлов SpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptions | XMLImportOptions

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

'FileType' - Тип файла 'text' | 'spreadsheet'

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

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

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

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

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

'TreatAsMissing' - Текст для интерпретации как отсутствующие данные вектор символов | строковый скаляр | массив ячеек из векторов символов | строковые массивы

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

'Whitespace' - Символы для лечения как пустое пространство вектор символов | строковый скаляр

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

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

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

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

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

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

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

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

'ConsecutiveDelimitersRule' - Процедура обработки последовательных разделителей 'split' | 'join' | 'error'

'LeadingDelimitersRule' - Процедура управления ведущими разделителями 'keep' | 'ignore' | 'error'

'TrailingDelimitersRule' - Процедура управления конечными разделителями 'keep' | 'ignore' | 'error'

'Sheet' - Лист для чтения с '' пустой символьный массив (по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

'UseExcel' - флаг для запуска образца Microsoft Excel для Windows false (по умолчанию) | true

См. также

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

Поддержка

`filename` - Имя файла для чтения
вектор символов | строковый скаляр

`opts` - настройки импорта файлов
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`

`'FileType'` - Тип файла
`'text'` | `'spreadsheet'`

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

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

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

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

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

`'TreatAsMissing'` - Текст для интерпретации как отсутствующие данные
вектор символов | строковый скаляр | массив ячеек из векторов символов | строковые массивы

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

`'Whitespace'` - Символы для лечения как пустое пространство
вектор символов | строковый скаляр

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

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

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

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

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

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

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

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

`'ConsecutiveDelimitersRule'` - Процедура обработки последовательных разделителей
`'split'` | `'join'` | `'error'`

`'LeadingDelimitersRule'` - Процедура управления ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

`'TrailingDelimitersRule'` - Процедура управления конечными разделителями
`'keep'` | `'ignore'` | `'error'`

`'Sheet'` - Лист для чтения с
`''` пустой символьный массив (по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

`'UseExcel'` - флаг для запуска образца Microsoft Excel для Windows
`false` (по умолчанию) | `true`