readtable

Составьте таблицу из файла

Описание

пример

T = readtable(filename) составляет таблицу путем чтения данных в столбцах из файла.

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

  • .txt, .dat, или .csv для разделенных текстовых файлов

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

  • .xml для Расширяемого языка разметки (XML) файлы

  • .docx для Microsoft® Файлы документов Word

  • .html, .xhtml, или .htm для Языка разметки гипертекста (HTML) файлы

Для текста и файлов электронной таблицы, readtable создает одну переменную в T для каждого столбца в файле и именах переменных чтений из первой строки файла. Для XML-файлов, readtable создает одну переменную в T для каждого элемента или узла атрибута, обнаруженного как табличная переменная. Имена переменных соответствуют элементу и названиям атрибута. Для файлов документов Microsoft Word, readtable, по умолчанию, импортирует данные из первой таблицы в документе и создает одну переменную в T для каждого столбца в файле и именах переменных чтений из первой строки таблицы. Для файлов HTML, readtable, по умолчанию, импортирует данные от первого <TABLE> элемент и создает одну переменную в T для каждого столбца в файле и именах переменных чтений из первой строки таблицы.

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

пример

T = readtable(filename,opts) составляет таблицу с помощью настроек импорта opts.

пример

T = readtable(___,Name,Value) составляет таблицу из файла с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение". Например, можно задать ли readtable читает первую строку файла как имена переменных или как данные.

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

  • Текст и параметры электронной таблицы — ReadVariableNames'ReadRowNames'

  • Текст только параметры — DateLocale, Encoding

  • Электронная таблица только параметры — Sheet, UseExcel

Примеры

свернуть все

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

filename = 'myCsvTable.dat';

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

T = readtable(filename)
T=5×6 table
      LastName      Gender    Age    Height    Weight    Smoker
    ____________    ______    ___    ______    ______    ______

    {'Smith'   }    {'M'}     38       71       176        1   
    {'Johnson' }    {'M'}     43       69       163        0   
    {'Williams'}    {'F'}     38       64       131        0   
    {'Jones'   }    {'F'}     40       67       133        0   
    {'Brown'   }    {'F'}     49       64       119        0   

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

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

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

T = readtable('headersAndMissing.txt')
T=5×6 table
     LastName        Gender      Age    Height    Weight    Smoker
    ___________    __________    ___    ______    ______    ______

    {'Wu'     }    {'M'     }     38      71       176        1   
    {'Johnson'}    {'M'     }     43      69       163        0   
    {'Sanchez'}    {'F'     }     38      64       131        0   
    {'Brown'  }    {'F'     }    NaN      67       133        0   
    {'Picard' }    {0x0 char}    NaN      64       119        0   

Чтобы восстановить поведение по умолчанию от предыдущих релизов, задайте 'Format','auto' аргумент пары "имя-значение". readtable читает заголовки как данные, и в результате они преобразуют все табличные переменные в текст.

T = readtable('headersAndMissing.txt','Format','auto')
T=6×6 table
     LastName        Gender         Age        Height     Weight       Smoker   
    ___________    __________    __________    _______    _______    ___________

    {'string' }    {'string'}    {'int'   }    {'int'}    {'int'}    {'boolean'}
    {'Wu'     }    {'M'     }    {'38'    }    {'71' }    {'176'}    {'1'      }
    {'Johnson'}    {'M'     }    {'43'    }    {'69' }    {'163'}    {'0'      }
    {'Sanchez'}    {'F'     }    {'38'    }    {'64' }    {'131'}    {'0'      }
    {'Brown'  }    {'F'     }    {0x0 char}    {'67' }    {'133'}    {'0'      }
    {'Picard' }    {0x0 char}    {0x0 char}    {'64' }    {'119'}    {'0'      }

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

Предварительно просмотрите файл mySpaceDelimTable.txt в текстовом редакторе. Снимок экрана показывают ниже. Заметьте, что файл содержит разграниченный пробел, данные в столбцах.

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

T = readtable('mySpaceDelimTable.txt')
T=3×5 table
    Var1     Var2    Var3     Var4       Var5   
    _____    ____    ____    ______    _________

    {'M'}     45      45     {'NY'}    {'true' }
    {'F'}     41      32     {'CA'}    {'false'}
    {'M'}     40      34     {'MA'}    {'false'}

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

filename = 'myCsvTable.dat';

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

T = readtable(filename,'Format','%s%s%u%f%f%s')
T=5×6 table
      LastName      Gender    Age    Height    Weight    Smoker
    ____________    ______    ___    ______    ______    ______

    {'Smith'   }    {'M'}     38       71       176      {'1'} 
    {'Johnson' }    {'M'}     43       69       163      {'0'} 
    {'Williams'}    {'F'}     38       64       131      {'0'} 
    {'Jones'   }    {'F'}     40       67       133      {'0'} 
    {'Brown'   }    {'F'}     49       64       119      {'0'} 

Спецификаторами преобразования является %s для массива ячеек из символьных векторов, %f для double, и %u для uint32.

Считайте немецкие даты из файла и добавьте их в таблицу как английские даты.

Предварительно просмотрите файл german_dates.txt в текстовом редакторе. Снимок экрана показывают ниже. Заметьте, что первый столбец значений содержит даты на немецком языке, и вторые и третьи столбцы являются числовыми значениями.

Считайте файл примера с помощью readtable. Спецификаторами преобразования является %D даты и %f для значений с плавающей точкой. Задайте кодирование файла с помощью FileEncoding аргумент пары "имя-значение". Задайте формат и локаль дат с помощью DateLocale аргумент пары "имя-значение".

T = readtable('german_dates.txt',...
    'Format','%{dd MMMM yyyy}D %f %f',...
    'FileEncoding','ISO-8859-15',...
    'DateLocale','de_DE')
T=3×3 table
          Var1          Var2    Var3 
    ________________    ____    _____

     01 January 2014    20.2    100.5
    01 February 2014    21.6    102.7
       01 March 2014    20.7     99.8

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

T = readtable('patients.xls','ReadRowNames',true);

Отобразите первые пять строк и сначала четыре переменные таблицы.

T(1:5,1:4)
ans=5×4 table
                  Gender      Age              Location               Height
                __________    ___    _____________________________    ______

    Smith       {'Male'  }    38     {'County General Hospital'  }      71  
    Johnson     {'Male'  }    43     {'VA Hospital'              }      69  
    Williams    {'Female'}    38     {'St. Mary's Medical Center'}      64  
    Jones       {'Female'}    40     {'VA Hospital'              }      67  
    Brown       {'Female'}    49     {'County General Hospital'  }      64  

Просмотрите DimensionNames свойство таблицы.

T.Properties.DimensionNames
ans = 1x2 cell
    {'LastName'}    {'Variables'}

'LastName' имя в первом столбце первой строки электронной таблицы.

Составьте таблицу с помощью данных из заданной области электронной таблицы patients.xls. Используйте данные из 5 3 прямоугольной области между углами C2 и E6. Не используйте первую строку этой области как имена переменных.

T = readtable('patients.xls',...
    'Range','C2:E6',...
    'ReadVariableNames',false)
T = 

    Var1               Var2                Var3
    ____    ___________________________    ____

    38      'County General Hospital'      71  
    43      'VA Hospital'                  69  
    38      'St. Mary's Medical Center'    64  
    40      'VA Hospital'                  67  
    49      'County General Hospital'      64  

T содержит имена переменных по умолчанию.

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

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

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  

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

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

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  

Можно считать табличные данные при сохранении имен переменных, которые включают любые символы, включая символы non-ASCII и пробелы. Во-первых, составьте таблицу с произвольными именами переменных и запишите таблицу в текстовый файл. Затем считайте табличные данные назад при сохранении исходных имен переменных.

Составьте таблицу, содержащую произвольные имена переменных, и запишите табличные данные в файл 'sampletable.txt'.

LastName = {'Sanchez';'Johnson';'Li';'Diaz';'Brown'};
Age = [38;43;38;40;49];
Smoker = logical([1;0;1;0;1]);
varNames = {'Last Name','Age','Smoker (1 or 0)'};
T = table(LastName,Age,Smoker,'VariableNames',varNames)
T=5×3 table
     Last Name     Age    Smoker (1 or 0)
    ___________    ___    _______________

    {'Sanchez'}    38          true      
    {'Johnson'}    43          false     
    {'Li'     }    38          true      
    {'Diaz'   }    40          false     
    {'Brown'  }    49          true      

writetable(T,'sampletable.txt')

Считайте табличные данные назад с помощью readtable. По умолчанию MATLAB® преобразует любые имена переменных, которые включают пробелы и символы non-ASCII в допустимые идентификаторы MATLAB®. Например, MATLAB® преобразует имена переменных 'Last Name' к 'LastName', и 'Smoker (1 or 0)' к 'Smoker_1or0_'. Чтобы считать табличные данные при сохранении имен переменных, установите 'VariableNamingRule' параметр к preserve.

T_preserve = readtable('sampletable.txt',"VariableNamingRule","preserve")
T_preserve=5×3 table
     Last Name     Age    Smoker (1 or 0)
    ___________    ___    _______________

    {'Sanchez'}    38            1       
    {'Johnson'}    43            0       
    {'Li'     }    38            1       
    {'Diaz'   }    40            0       
    {'Brown'  }    49            1       

Можно считать шестнадцатеричные и двоичные числа из файла и сохранить их как числовые переменные в таблице. readtable функционируйте автоматически читает шестнадцатеричные и двоичные числа, когда они включают 0x и 0b префиксы соответственно. Числовые значения хранятся с помощью целочисленных типов данных. Можно также использовать настройки импорта, чтобы считать такие числа, когда у них нет префиксов.

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

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

T = readtable('hexAndBinary.txt')
T=3×4 table
    Var1     Var2      Var3         Var4    
    _____    ____    ________    ___________

      255    255     {'C7F9'}    {'Device1'}
      256      4     {'05BF'}    {'Device2'}
    43981    129     {'F00F'}    {'Device3'}

readtable функционируйте хранит числовые значения в различных целочисленных классах (uint16 и uint8) потому что T.Var1 имеет значение, которое требует больше чем 8 битов устройства хранения данных.

class(T.Var1)
ans = 
'uint16'
class(T.Var2)
ans = 
'uint8'

Чтобы задать типы данных для хранения числовых значений, импортированных из шестнадцатеричных и двоичных чисел, используйте 'HexType' и 'BinaryType' аргументы в виде пар имя-значение. Сохраните значения как 32-битные целые числа со знаком.

T = readtable('hexAndBinary.txt','HexType','int32','BinaryType','int32');
class(T.Var1)
ans = 
'int32'
class(T.Var2)
ans = 
'int32'

Можно использовать настройки импорта, чтобы обнаружить шестнадцатеричные и двоичные числа без префиксов и задать устройство хранения данных для них. Создайте объект настроек импорта для hexAndBinary.txt.

opts = detectImportOptions('hexAndBinary.txt')
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: 'UTF-8'

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
             ExtraColumnsRule: 'addvars'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
                VariableTypes: {'auto', 'auto', 'char' ... and 1 more}
        SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
              VariableOptions: Show all 4 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [1 Inf]
            VariableNamesLine: 0
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

Чтобы указать, что третий столбец должен быть импортирован, как, шестнадцатеричные значения, несмотря на отсутствие префикса, используют setvaropts функция, чтобы изменить тип переменной для третьей переменной таблицы. Установите тип переменной на int32.

opts = setvaropts(opts,3,'NumberSystem','hex','Type','int32')
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: 'UTF-8'

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
             ExtraColumnsRule: 'addvars'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
                VariableTypes: {'auto', 'auto', 'int32' ... and 1 more}
        SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
              VariableOptions: Show all 4 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [1 Inf]
            VariableNamesLine: 0
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

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

T = readtable('hexAndBinary.txt',opts)
T=3×4 table
    Var1     Var2    Var3        Var4    
    _____    ____    _____    ___________

      255    255     51193    {'Device1'}
      256      4      1471    {'Device2'}
    43981    129     61455    {'Device3'}

Создайте опции импорта XML для XML-файла, задайте переменные, чтобы импортировать, и затем считать данные.

XML-файл students.xml имеет четыре одноуровневых узла под названием Student, который каждый содержит те же дочерние узлы и атрибуты.

type students.xml
<?xml version="1.0" encoding="utf-8"?>
<Students>
    <Student ID="S11305">
        <Name FirstName="Priya" LastName="Thompson" />
        <Age>18</Age>
        <Year>Freshman</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">591 Spring Lane</Street>
            <City>Natick</City>
            <State>MA</State>
      </Address>
      <Major>Computer Science</Major>
      <Minor>English Literature</Minor>
   </Student>
   <Student ID="S23451">
        <Name FirstName="Conor" LastName="Cole" />
        <Age>18</Age>
        <Year>Freshman</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">4641 Pearl Street</Street>
            <City>San Francisco</City>
            <State>CA</State>
        </Address>
        <Major>Microbiology</Major>
        <Minor>Public Health</Minor>
    </Student>
    <Student ID="S119323">
        <Name FirstName="Morgan" LastName="Yang" />
        <Age>21</Age>
        <Year>Senior</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">30 Highland Road</Street>
            <City>Detriot</City>
            <State>MI</State>
        </Address>
        <Major>Political Science</Major>
   </Student>
   <Student ID="S201351">
        <Name FirstName="Salim" LastName="Copeland" />
        <Age>19</Age>
        <Year>Sophomore</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street>
            <City>Fort Worth</City>
            <State>TX</State>
        </Address>
        <Major>Business</Major>
        <Minor>Japanese Language</Minor>
   </Student>
   <Student ID="S201351">
        <Name FirstName="Salim" LastName="Copeland" />
        <Age>20</Age>
        <Year>Sophomore</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street>
            <City>Fort Worth</City>
            <State>TX</State>
        </Address>
        <Major>Business</Major>
        <Minor>Japanese Language</Minor>
    </Student>
    <Student ID="54600">
        <Name FirstName="Dania" LastName="Burt" />
        <Age>22</Age>
        <Year>Senior</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">22 Angie Drive</Street>
            <City>Los Angeles</City>
            <State>CA</State>
        </Address>
        <Major>Mechanical Engineering</Major>
        <Minor>Architecture</Minor>
   </Student>
    <Student ID="453197">
        <Name FirstName="Rikki" LastName="Gunn" />
        <Age>21</Age>
        <Year>Junior</Year>
        <Address>
            <Street xmlns="https://www.mathworks.com">65 Decatur Lane</Street>
            <City>Trenton</City>
            <State>ME</State>
        </Address>
        <Major>Economics</Major>
        <Minor>Art History</Minor>
   </Student>
</Students>

Создайте XMLImportOptions объект из файла. Задайте значение VariableSelectors как //@FirstName выбрать FirstName узел элемента, чтобы импортировать как табличная переменная.

opts = xmlImportOptions("VariableSelectors","//@FirstName")
opts = 
  XMLImportOptions with properties:

   Replacement Properties:
                     MissingRule: "fill"
                 ImportErrorRule: "fill"
                RepeatedNodeRule: "addcol"

   Variable Import Properties: Set types by name using setvartype
                   VariableNames: "Var1"
                   VariableTypes: "char"
           SelectedVariableNames: "Var1"
                 VariableOptions: Show all 1 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
              VariableNamingRule: "preserve"

   Location Properties:
                   TableSelector: <missing>
                     RowSelector: <missing>
               VariableSelectors: "//@FirstName"
           VariableUnitsSelector: <missing>
    VariableDescriptionsSelector: <missing>
                RowNamesSelector: <missing>
            RegisteredNamespaces: [0x2 string]

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

T = readtable("students.xml",opts)
T=7×1 table
       Var1   
    __________

    {'Priya' }
    {'Conor' }
    {'Morgan'}
    {'Salim' }
    {'Salim' }
    {'Dania' }
    {'Rikki' }

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

Создайте XMLImportOptions объект от XML-файла. Задайте выражение XPath Street узел элемента как значение 'VariableSelectors', и укажите префиксный myPrefix к URL, принадлежащему Street узел.

opts = detectImportOptions("students.xml","RegisteredNamespaces", ["myPrefix","https://www.mathworks.com"],...
    "VariableSelectors","//myPrefix:Street")
opts = 
  XMLImportOptions with properties:

   Replacement Properties:
                     MissingRule: "fill"
                 ImportErrorRule: "fill"
                RepeatedNodeRule: "addcol"

   Variable Import Properties: Set types by name using setvartype
                   VariableNames: "Street"
                   VariableTypes: "string"
           SelectedVariableNames: "Street"
                 VariableOptions: Show all 1 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
              VariableNamingRule: "preserve"

   Location Properties:
                   TableSelector: <missing>
                     RowSelector: <missing>
               VariableSelectors: "//myPrefix:Street"
           VariableUnitsSelector: <missing>
    VariableDescriptionsSelector: <missing>
                RowNamesSelector: <missing>
            RegisteredNamespaces: ["myPrefix"    "https://www.mathworks.com"]

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

T2 = readtable("students.xml",opts)
T2=7×1 table
          Street       
    ___________________

    "591 Spring Lane"  
    "4641 Pearl Street"
    "30 Highland Road" 
    "3388 Moore Avenue"
    "3388 Moore Avenue"
    "22 Angie Drive"   
    "65 Decatur Lane"  

readtable функция, по умолчанию, читает первую таблицу из файла документа Microsoft Word. Файл MaintenanceReport.docx содержит две таблицы. Последняя строка второй таблицы содержит ячейку с объединенными столбцами, которые не совпадают с табличными переменными.

Считайте вторую таблицу путем установки TableIndex опция к 2. Чтобы пропустить строки, которые имеют ячейки с объединенными столбцами, установите MergedCellColumnRule опция к 'omitrow'.

filename = "MaintenanceReport.docx";
T = readtable(filename,'TableIndex',2,'MergedCellColumnRule','omitrow')
T=3×5 table
                                 Description                                       Category          Urgency         Resolution          Cost  
    _____________________________________________________________________    ____________________    ________    __________________    ________

    "Items are occasionally getting stuck in the scanner spools."            "Mechanical Failure"    "Medium"    "Readjust Machine"    "$45"   
    "Loud rattling and banging sounds are coming from assembler pistons."    "Mechanical Failure"    "Medium"    "Readjust Machine"    "$35"   
    "There are cuts to the power when starting the plant."                   "Electronic Failure"    "High"      "Full Replacement"    "$16200"

В качестве альтернативы можно выбрать таблицу с помощью селектора XPath использование TableSelector опция. Чтобы выбрать таблицу документа Microsoft Word, которая содержит текст "Описание", используйте селектор XPath "//w:tbl[contains(.,'Description')]".

T = readtable(filename, ...
    'TableSelector',"//w:tbl[contains(.,'Description')]", ...
    'MergedCellColumnRule','omitrow')
T=3×5 table
                                 Description                                       Category          Urgency         Resolution          Cost  
    _____________________________________________________________________    ____________________    ________    __________________    ________

    "Items are occasionally getting stuck in the scanner spools."            "Mechanical Failure"    "Medium"    "Readjust Machine"    "$45"   
    "Loud rattling and banging sounds are coming from assembler pistons."    "Mechanical Failure"    "Medium"    "Readjust Machine"    "$35"   
    "There are cuts to the power when starting the plant."                   "Electronic Failure"    "High"      "Full Replacement"    "$16200"

Считайте первую таблицу из https://www.mathworks.com/help/matlab/text-files.html URL, который содержит текст "readtable" использование селектора XPath "//TABLE[contains(.,'readtable')]". Таблица не имеет строки заголовка, таким образом, устанавливает ReadVariableNames опция к false.

url = "https://www.mathworks.com/help/matlab/text-files.html";
T = readtable(url,'TableSelector',"//TABLE[contains(.,'readtable')]", ...
    'ReadVariableNames',false)
T=4×2 table
          Var1                      Var2            
    ________________    ____________________________

    "readtable"         "Create table from file"    
    "writetable"        "Write table to file"       
    "readtimetable"     "Create timetable from file"
    "writetimetable"    "Write timetable to file"   

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

свернуть все

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

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

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

Форма

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

Задайте имя файла в 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
Amazon 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 или если вы используете MATLAB Online™, функция импорта действует с UseExcel набор свойств к false, и чтения только .xls, .xlsx, .xlsm, .xltx, and .xltm файлы.

  • Для разделенных текстовых файлов функция импорта преобразует пустые поля в файле к любому NaN (для числовой переменной) или пустой символьный вектор (для текстовой переменной). Все линии в текстовом файле должны иметь то же количество разделителей. Функция импорта игнорирует незначительный пробел в файле.

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

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

Тип файловВывод
Файлы электронной таблицыSpreadsheetImportOptions объект (только доступный для SheetDataRange , и VariableNames свойства
Текстовые файлыDelimitedTextImportOptions объект
Текстовые файлы фиксированной шириныFixedWidthImportOptions объект
XML-файлыXMLImportOptions объект
Файлы документов Microsoft WordWordDocumentImportOptions объект
Файлы HTMLHTMLImportOptions объект

Аргументы name-value

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

Пример: 'ReadVariableNames',false указывает, что первая строка файла не соответствует именам переменных.
Все поддерживаемые типы файлов

свернуть все

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

ЗначениеНастройки импорта
'spreadsheet'

SpreadsheetImportOptions

'text'

DelimitedTextImportOptions или FixedWidthImportOptions в зависимости от размещения текстового файла.

'delimitedtext'

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

'fixedwidth'

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

'xml'

XMLImportOptions, используйте эту опцию для XML-файлов.

'worddocument'

WordDocumentImportOptions, используйте эту опцию для файлов документов Microsoft Word.

'html'

HTMLImportOptions, используйте эту опцию для файлов HTML.

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

  • .txt, .dat, или .csv для текстовых файлов

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

  • .xml, для XML-файлов

  • .docx для файлов документов Microsoft Word

  • .html, .xhtml, или .htm для файлов HTML

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

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

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

Индикатор

Описание

false

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

true

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

незаданныйКогда оставлено незаданный, readtable принимает false.

Примечание: Если оба 'ReadVariableNames' и 'ReadRowNames' логическими индикаторами является true, затем readtable сохраняет имя в первом столбце первой строки области, чтобы читать как первое имя размерности в свойстве, T.Properties.DimensionNames.

Если вы задаете ReadRowNames аргумент в дополнение к opts настройки импорта, затем readtable поведение изменяется на основе спецификации:

  • Если ReadRowNames true, затем считайте имена строки из заданного файла при помощи RowNamesRange или RowNameColumn свойство объекта настроек импорта.

  • Если ReadRowNames false, затем не импортируйте имена строки.

Пример: 'ReadRowNames',true

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

'TreatAsMissing' только применяется к числовым столбцам в таблице и readtable не принимает числовые литералы, такие как '-99'.

Пример: 'TreatAsMissing','N/A' или 'TreatAsMissing',"N/A" наборы N/A в рамках числовых столбцов к NaN.

Пример: 'TreatAsMissing',{'.','NA','N/A'} или 'TreatAsMissing',[".","NA","N/A"] наборы .N/A и N/A в рамках числовых столбцов к NaN.

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

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

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

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

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

Введите для импортированных данных о дате и времени в виде разделенной запятой пары, состоящей из '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.

Пример: 'DatetimeType','datetime'

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

Отметьте, чтобы сохранить имена переменных в виде любого "modify" или "preserve".

  • "modify" — Преобразуйте недопустимые имена переменных (как определено isvarname функция) к допустимым идентификаторам MATLAB.

  • "preserve" — Сохраните имена переменных, которые не являются допустимыми идентификаторами MATLAB, такими как имена переменных, которые включают символы non-ASCII и пробелы.

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

Пример: "VariableNamingRule","preserve"

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

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

MissingRule Поведение
'fill'

Замените недостающие данные на содержимое FillValue свойство.

FillValue свойство задано в VariableImportOptions объект переменной импортируется. Для получения дополнительной информации о доступе к FillValue свойство, смотрите getvaropts.

'error'Прекратите импортировать и отобразите сообщение об ошибке, показывающее недостающую запись и поле.
'omitrow'Не используйте строки, которые содержат недостающие данные.
'omitvar'Не используйте переменные, которые содержат недостающие данные.

Пример: 'MissingRule','omitrow'

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

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

ImportErrorRule Поведение
'fill'

Замените данные, где ошибка произошла с содержимым FillValue свойство.

FillValue свойство задано в VariableImportOptions объект переменной импортируется. Для получения дополнительной информации о доступе к FillValue свойство, смотрите getvaropts.

'error'Прекратите импортировать и отобразите сообщение об ошибке, показывающее вызывающую ошибку запись и поле.
'omitrow'Не используйте строки, где ошибки происходят.
'omitvar'Не используйте переменные, где ошибки происходят.

Пример: 'ImportErrorRule','omitvar'

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

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

свернуть все

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

Индикатор

Описание

true

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

false

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

незаданный Когда оставлено незаданный, readtable автоматически обнаруживает true или false и доходы соответственно.

Примечание: Если оба 'ReadVariableNames' и 'ReadRowNames' логическими индикаторами является true, затем readtable сохраняет имя в первом столбце первой строки области, чтобы читать как первое имя размерности в свойстве, T.Properties.DimensionNames.

Если вы задаете ReadVariableNames аргумент в дополнение к opts настройки импорта, затем readtable поведение изменяется на основе спецификации:

  • Если ReadVariableNames true, затем считайте имена переменных из заданного файла при помощи VariableNamesRange или VariableNamesLine свойство объекта настроек импорта.

  • Если ReadVariableNames false, затем считайте имена переменных из VariableNames свойство объекта настроек импорта.

Пример: 'ReadVariableNames',true

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

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

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

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

свернуть все

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

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

Спецификатор

Разделитель полей

','

'comma'

Запятая

' '

'space'

Пробел

'\t'

'tab'

Вкладка

';'

'semi'

Точка с запятой

'|'

'bar'

Вертикальная панель

незаданный

Если незаданный, readtable автоматически обнаруживает разделитель.

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

Пример: 'Delimiter',',' или 'Delimiter','comma'

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

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

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

Пример: 'LeadingDelimitersRule','keep'

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

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

Пример: 'TrailingDelimitersRule','keep'

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

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

Пример: 'ConsecutiveDelimitersRule','split'

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

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

Пример: 'VariableWidths',[10,7,4,26,7]

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

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

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

Процедура, чтобы обработать пустые линии в данных в виде 'skip'чтение, или 'error'. Функция импорта интерпретирует пробел как пустой.

EmptyLineRule Поведение
'skip'Пропустите пустые линии.
'read'Импортируйте пустые линии. Функция импорта анализирует пустую линию с помощью значений, заданных в VariableWidthsVariableOptions MissingRule , и другие соответствующие свойства, такие как Whitespace.
'error'Отобразите сообщение об ошибке и прервите операцию импорта.

Пример: 'EmptyLineRule','skip'

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

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

Если VariableNamesLine задан как 0, затем не импортируйте имена переменных. В противном случае импортируйте имена переменных из заданной линии.

Пример: 'VariableNamesLine',6

Типы данных: single | double | uint8 | uint16 | uint32 | uint64

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

PartialFieldRule Поведение
'keep'

Сохраните частичные полевые данные и преобразуйте текст в соответствующий тип данных.

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

'fill'

Замените недостающие данные на содержимое FillValue свойство.

FillValue свойство задано в VariableImportOptions объект переменной импортируется. Для получения дополнительной информации о доступе к FillValue свойство, смотрите getvaropts.

'omitrow'Не используйте строки, которые содержат частичные данные.
'omitvar'Не используйте переменные, которые содержат частичные данные.
'wrap'Начните читать следующую строку символов.
'error'Отобразите сообщение об ошибке и прервите операцию импорта.

Пример: 'PartialFieldRule','keep'

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

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

Если VariableUnitsLine задан как 0, затем не импортируйте переменные модули. В противном случае импортируйте переменные модули из заданной линии.

Пример: 'VariableUnitsLine',8

Типы данных: single | double | uint8 | uint16 | uint32 | uint64

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

Если VariableDescriptionsLine задан как 0, затем не импортируйте описания переменной. В противном случае импортируйте описания переменной из заданной линии.

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

Типы данных: single | double | uint8 | uint16 | uint32 | uint64

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

ExtraColumnsRule Поведение
'addvars'

Чтобы импортировать дополнительные столбцы, создайте новые переменные. Если существует N дополнительные столбцы, затем импортируйте новые переменные как 'ExtraVar1', 'ExtraVar2',..., 'ExtraVarN'.

ПРИМЕЧАНИЕ: дополнительные столбцы импортируются как текст с данными typechar.

'ignore'Проигнорируйте дополнительные столбцы данных.
'wrap'Перенесите дополнительные столбцы данных к новым записям. Это действие не изменяет количество переменных.
'error'Отобразите сообщение об ошибке и прервите операцию импорта.

Пример: 'ExtraColumnsRule','addvars'

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

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

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

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

Формат столбца файла в виде разделенной запятой пары, состоящей из 'Format' и вектор символов или строковый скаляр, имеющий один или несколько спецификаторов преобразования или 'auto'. Спецификаторы преобразования совпадают со спецификаторами, принятыми textscan функция.

Определение формата может значительно улучшить скорость для некоторых больших файлов. Если вы не задаете значение для Formatто readtable использование %q интерпретировать нечисловые столбцы. %q спецификатор читает текст и не использует двойные кавычки (") в подходящих случаях.

  • Если вы не задаете 'Format' пара "имя-значение", затем readtable функция ведет себя, как будто вы использовали результаты detectImportOptions функция, чтобы импортировать данные. Для получения дополнительной информации о последствиях этого поведения см. Вопросы совместимости.

  • Если вы задаете 'Format','auto', затем созданными переменными является double массивы, массив ячеек из символьных векторов или datetime массивы, в зависимости от данных. Если целый столбец является числовым, переменные импортируются как double. Если какой-либо элемент в столбце не является числовым, переменные импортируются как массивы ячеек из символьных векторов, или как datetime массивы, если значения представляют даты и времена.

Пример: 'Format','auto'

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

Возвращенное значение для пустых числовых полей в разделенных текстовых файлах в виде разделенной запятой пары, состоящей из 'EmptyValue' и числовой скаляр.

Пример: 'EmptyValue',0

Несколько обработка разделителя в виде разделенной запятой пары, состоящей из 'MultipleDelimsAsOne' и любой true или false. Если true, затем функция импорта обрабатывает последовательные разделители как один разделитель. Повторные разделители, разделенные пробелом, также обработаны как один разделитель. Необходимо также задать Delimiter опция.

Пример: 'MultipleDelimsAsOne',1

Логический индикатор, определяющий конкатенацию данных в виде разделенной запятой пары, состоящей из 'CollectOutput' и любой true или false. Если true, затем функция импорта конкатенирует последовательные выходные ячейки того же основного класса MATLAB в единый массив.

Пример: 'CollectOutput',true

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

Например, задайте символ, такой как '%' проигнорировать текст после символа на той же линии. Задайте массив ячеек двух векторов символов, таких как {'/*','*/'}, проигнорировать любой текст между теми последовательностями.

MATLAB проверяет на комментарии только в начале каждого поля, не в поле.

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

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

Символы экспоненты в виде разделенной запятой пары, состоящей из 'ExpChars' и вектор символов или строка. Символами экспоненты по умолчанию является eED, и D.

Пример: 'ExpChars','eE'

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

Символы конца линии в виде разделенной запятой пары, состоящей из 'LineEnding' и вектор символов или строка. Вектором символов должен быть '\r\n' или это должно задать отдельный символ. Общие символы конца линии являются символом новой строки ('\n') или возврат каретки ('\r'). Если вы задаете '\r\n', затем функция импорта обрабатывает любой \rN, и комбинация двух (\r\n) как символы конца линии.

Последовательностью конца линии по умолчанию является \nR, или \r\n, В зависимости от содержимого вашего файла.

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

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

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

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

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

  • xx строчный ISO 639-1 двухбуквенный код, указывающий на язык.

Эта таблица приводит некоторые общие значения для локали.

Локаль ЯзыкСтрана
'de_DE'Немецкий языкГермания
'en_GB'Английский языкСоединенное Королевство
'en_US'Английский языкСоединенные Штаты
'es_ES'Испанский языкИспания
'fr_FR'Французский языкФранция
'it_IT'Итальянский языкИталия
'ja_JP'Японский языкЯпония
'ko_KR'Корейский языкКорея
'nl_NL'Нидерландский языкНидерланды
'zh_CN'Китайский язык (упрощен)Китай

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

MATLAB duration тип данных

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

'text'

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

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

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

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

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

Тип выходных данных шестнадцатеричных данных в виде разделенной запятой пары, состоящей из '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' и одно из перечисленных в таблице значений.

Входной файл представляет двоичные значения как текст, с помощью любого 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

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

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

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

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

свернуть все

Рабочий лист, чтобы читать в виде разделенной запятой пары, состоящей из 'Sheet' и положительное целое число, указывающее на индекс рабочего листа или вектор символов или строку, содержащую имя рабочего листа. Имя рабочего листа не может содержать двоеточие (:). Чтобы определить имена листов в файле электронной таблицы, используйте sheets = sheetnames(filename). Для получения дополнительной информации смотрите sheetnames.

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

Пример: 'Sheet', 2

Пример: 'Sheet', 'MySheetName'

Пример: 'Sheet', "MySheetName"

Типы данных: char | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

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

'Cell' или [row col]

Запуск ячейки

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

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

  • Два элемента числовой вектор из формы [row col] указание на стартовую строку и столбец.

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

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

'Corner1:Corner2'

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

Укажите диапазон с помощью синтаксиса 'Corner1:Corner2', где Corner1 и Corner2 два противостоящих угла, которые задают область. Например, 'D2:H4' представляет прямоугольную область 3 на 5 между этими двумя углами D2 и H4 на рабочем листе. 'Range' аргумент пары "имя-значение" не является чувствительным к регистру, и использует стиль ссылки Excel A1 (см. справку Excel).

Пример: 'Range','D2:H4'

''

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

Если незаданный, readtable автоматически обнаруживает используемую область значений.

Пример: 'Range',''

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

'Row1:Row2'

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

Можно идентифицировать область значений путем определения начала и конечного использования строк указатели строки Excel. Затем readtable автоматически обнаруживает используемую область значений столбца в обозначенных строках. Например, readtable интерпретирует спецификацию области значений '1:7' как инструкция считать все столбцы в используемой области значений в строках 1 - 7 (включительно).

Пример: 'Range','1:7'

'Column1:Column2'

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

Можно идентифицировать область значений путем определения начала и конечного использования столбцов указатели столбца Excel. Затем readtable автоматически обнаруживает используемую область значений строки в рамках обозначенных столбцов. Например, readtable интерпретирует спецификацию области значений 'A:F' как инструкция считать все строки в используемой области значений в столбцах A через F (включительно).

Пример: 'Range','A:F'

'NamedRange'

Названная область значений в Excel

В Excel можно создать имена, чтобы идентифицировать области значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее 'myTable'. Если такие именованные области значений существуют в электронной таблице, то readtable может считать ту область значений с помощью ее имени.

Пример: 'Range','myTable'

Пример: 'Range', 'A1:F10'

Пример: 'Range', "A1:F10"

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

Местоположение данных, которые будут импортированы в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов, массива строк, положительного скалярного целого числа или 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]

''

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

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

Пример: ''

Пример: 'DataRange', 'B2:H15'

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

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

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

'Cell'

Задайте стартовую ячейку для данных, с помощью Excel A1 обозначение. Например, A5 идентификатор для ячейки на пересечении столбца A и строка 5.

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

Пример: 'A5'

'Corner1:Corner2'

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

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

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

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

'Row1:Row2'

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

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

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

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

n

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

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

Пример 5

''

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

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

Пример: ''

Пример: 'RowNamesRange', 'A1:H1'

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

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

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

'Cell'

Задайте стартовую ячейку для данных, с помощью Excel A1 обозначение. Например, A5 идентификатор для ячейки на пересечении столбца A и строка 5.

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

Пример: 'A5'

'Corner1:Corner2'

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

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

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

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

'Row1:Row2'

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

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

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

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

n

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

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

Пример 5

''

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

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

Пример: ''

Пример: 'VariableNamesRange', 'A1:A15'

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

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

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

'Cell'

Задайте стартовую ячейку для данных, с помощью Excel A1 обозначение. Например, A5 идентификатор для ячейки на пересечении столбца A и строка 5.

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

Пример: 'A5'

'Corner1:Corner2'

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

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

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

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

'Row1:Row2'

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

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

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

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

n

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

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

Пример 5

''

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

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

Пример: ''

Пример: 'VariableUnitsRange', 'A1:A5'

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

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

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

'Cell'

Задайте стартовую ячейку для данных, с помощью Excel A1 обозначение. Например, A5 идентификатор для ячейки на пересечении столбца A и строка 5.

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

Пример: 'A5'

'Corner1:Corner2'

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

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

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

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

'Row1:Row2'

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

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

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

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

n

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

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

Пример 5

''

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

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

Пример: ''

Пример: 'VariableDescriptionsRange', 'B1:B15'

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

Отметьте, чтобы запустить экземпляр 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.

Пример: 'UseExcel',true

XML-файлы только

свернуть все

Суффикс атрибута в виде разделенной запятой пары, состоящей из 'AttributeSuffix' и или вектор символов или строковый скаляр. Этот аргумент задает суффикс, который функция чтения добавляет ко всем табличным переменным, которые соответствуют атрибутам во входном XML-файле. Если вы не задаете 'AttributeSuffix', затем значения по умолчанию функции чтения к добавлению суффиксного 'Attribute' ко всем именам переменных, соответствующим атрибутам во входном XML-файле.

Пример: 'AttributeSuffix','_att'

Импортируйте атрибуты в виде разделенной запятой пары, состоящей из 'ImportAttributes' и любой 1 TRUE) или 0 ложь). Если вы задаете false, затем функция чтения не импортирует атрибуты XML во входном файле как переменные в выходной таблице.

Пример: 'ImportAttributes',false

Строка таблицы имя узла XML в виде разделенной запятой пары, состоящей из 'RowNodeName' и или вектор символов или строковый скаляр. Этот аргумент задает имя узла XML, которое формирует рисунок строк выходной таблицы.

Пример: 'RowNodeName','XMLNodeName'

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

Пример: 'RowSelector','/RootNode/ChildNode'

Табличная переменная имена узла XML в виде разделенной запятой пары, состоящей из 'VariableNodeNames' и или массив ячеек из символьных векторов или массив строк. Этот аргумент задает имя узла XML, которое чтение функционирует использование, чтобы идентифицировать узлы XML, чтобы считать как переменные в выходной таблице.

Пример: 'VariableNodeNames',{'XMLNodeName1','XMLNodeName2'}

Пример: 'VariableNodeNames',"XMLNodeName"

Пример: 'VariableNodeNames',["XMLNodeName1","XMLNodeName2"]

Выражения XPath табличной переменной в виде массива ячеек из символьных векторов или массива строк, что чтение функционирует использование, чтобы выбрать табличные переменные. Необходимо задать VariableSelectors как допустимые выражения версии 1.0 XPath.

Пример: 'VariableSelectors',{'/RootNode/ChildNode'}

Пример: 'VariableSelectors',"/RootNode/ChildNode"

Пример: 'VariableSelectors',["/RootNode/ChildNode1","/RootNode/ChildNode2"]

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

Пример: 'TableNodeName','NodeName'

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

Пример: 'VariableUnitsSelector','/RootNode/ChildNode'

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

Пример: 'VariableDescriptionsSelector','/RootNode/ChildNode'

Строка таблицы называет выражение XPath в виде вектора символов или строкового скаляра, что чтение функционирует использование, чтобы выбрать имена строк таблицы. Необходимо задать RowNamesSelector как допустимое выражение версии 1.0 XPath.

Пример: 'RowNamesSelector','/RootNode/ChildNode'

Процедура, чтобы обработать повторенные узлы XML в данной строке таблицы в виде 'addcol', 'ignore', или 'error'.

Повторное правило узла

Поведение

'addcol'

Добавьте столбцы для повторных узлов под переменным заголовком в таблице. Определение значения 'RepeatedNodeRule' как 'addcol' не создает отдельную переменную в таблице для повторного узла.

'ignore'

Пропуск, импортирующий повторные узлы.

'error'Отобразите сообщение об ошибке и прервите операцию импорта.

Пример: 'RepeatedNodeRule','ignore'

Набор зарегистрированных префиксов пространства имен XML в виде разделенной запятой пары, состоящей из RegisteredNamespaces и массив префиксов. Функция чтения использует эти префиксы при оценке выражений XPath на XML-файле. Задайте префиксы пространства имен и их связанные URL как массив строк Nx2. RegisteredNamespaces может использоваться, когда вы также оцениваете выражение XPath, заданное селекторным аргументом значения имени, таким как StructSelector для readstruct, или VariableSelectors для readtable и readtimetable.

По умолчанию функция чтения автоматически обнаруживает префиксы пространства имен, чтобы указать для использования в оценке XPath, но можно также указать новые префиксы пространства имен с помощью RegisteredNamespaces аргумент значения имени. Вы можете указать новый префикс пространства имен, когда узел XML имеет пространство имен URL, но никакой заявленный префикс пространства имен в XML-файле.

Например, оцените выражение XPath на XML-файле под названием example.xml это не содержит префикс пространства имен. Задайте 'RegisteredNamespaces' как ["myprefix", "https://www.mathworks.com"] присваивать префиксный myprefix к URL https://www.mathworks.com.

T = readtable("example.xml", "VariableSelector", "/myprefix:Data",...
 "RegisteredNamespaces", ["myprefix", "https://www.mathworks.com"])

Пример: 'RegisteredNamespaces',["myprefix", "https://www.mathworks.com"]

Документ Microsoft Word и файлы HTML только

свернуть все

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

Когда вы задаете TableIndex, программное обеспечение автоматически устанавливает TableSelector к эквивалентному выражению XPath.

Пример: 'TableIndex',2

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

Когда вы задаете TableIndex, программное обеспечение автоматически устанавливает TableSelector к эквивалентному выражению XPath.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

ImportErrorRule Поведение
"placeleft"

Поместите данные в крайнюю левую ячейку и заполните остальные ячейки содержимым FillValue свойство.

FillValue свойство задано в VariableImportOptions объект переменной импортируется. Для получения дополнительной информации о доступе к FillValue свойство, смотрите getvaropts.

"placeright"

Поместите данные в самую правую ячейку и заполните остальные ячейки содержимым FillValue свойство.

FillValue свойство задано в VariableImportOptions объект переменной импортируется. Для получения дополнительной информации о доступе к FillValue свойство, смотрите getvaropts.

"duplicate"

Скопируйте данные во всех ячейках.

"omitrow"Не используйте строки, где ошибки происходят.
"error"Отобразите сообщение об ошибке и прервите операцию импорта.

Пример: 'MergedCellColumnRule',"placeright"

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

ImportErrorRule Поведение
"placetop"

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

FillValue свойство задано в VariableImportOptions объект переменной импортируется. Для получения дополнительной информации о доступе к FillValue свойство, смотрите getvaropts.

"placebottom"

Поместите данные в нижнюю ячейку и заполните остальные ячейки содержимым FillValue свойство.

FillValue свойство задано в VariableImportOptions объект переменной импортируется. Для получения дополнительной информации о доступе к FillValue свойство, смотрите getvaropts.

"duplicate"

Скопируйте данные во всех ячейках.

"omitvar"Не используйте переменные, где объединенные строки происходят.
"error"Отобразите сообщение об ошибке и прервите операцию импорта.

Пример: 'MergedCellRowRule',"duplicate"

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

  • Если вы не задаете VariableNamesRow, затем программное обеспечение читает имена переменных согласно ReadVariableNames аргумент.

  • Если VariableNamesRow 0, затем программное обеспечение не импортирует имена переменных.

  • В противном случае программное обеспечение импортирует имена переменных из заданной строки.

Пример: 'VariableNamesRow',2

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

Если VariableUnitsRow 0, затем программное обеспечение не импортирует переменные модули. В противном случае программное обеспечение импортирует переменные модули из заданной строки.

Пример: 'VariableUnitsRow',3

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

Если VariableDescriptionsRow 0, затем программное обеспечение не импортирует описания переменной. В противном случае программное обеспечение импортирует описания переменной из заданной строки.

Пример: 'VariableDescriptionsRow',4

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

  • "skip" – Пропустите пустые строки.

  • "read" – Считайте пустые строки.

  • "error" – Проигнорируйте пустые строки во время табличного обнаружения и ошибки при чтении.

Пример: "EmptyRowRule","read"

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

  • "skip" – Пропустите пустые столбцы.

  • "read" – Считайте пустые столбцы.

  • "error" – Проигнорируйте пустые столбцы во время табличного обнаружения и ошибки при чтении.

Пример: "EmptyColumnRule","error"

Документ Microsoft Word, HTML и XML-файлы только

свернуть все

Табличное выражение XPath данных в виде вектора символов или строкового скаляра, что чтение функционирует использование, чтобы выбрать выходные табличные данные. Необходимо задать TableSelector как допустимое выражение версии 1.0 XPath.

Пример: 'TableSelector','/RootNode/ChildNode'

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

свернуть все

Выведите таблицу, возвращенную как таблица. Таблица может сохранить метаданные, такие как описания, переменные модули, имена переменных и имена строки. Для получения дополнительной информации смотрите раздел Properties table.

Советы

  • Большие файлы в формате XLSX иногда медленно загружают. Для лучшей эффективности импорта и экспорта Microsoft рекомендует, чтобы вы использовали формат XLSB.

  • Используйте селекторы XPath, чтобы задать который элементы документа входа XML импорту. Например, предположите, что вы хотите импортировать XML-файл myFile.xml, который имеет следующую структуру:

    <data>
        <table category="ones">
            <var>1</var>
            <var>2</var>
        </table>
        <table category="tens">
            <var>10</var>
            <var>20</var>
        </table>
    </data>
    
    Эта таблица обеспечивает синтаксисы XPath, которые поддерживаются для аргументов name-value селектора XPath, таких как VariableSelectors или TableSelector.

    Операция выбораСинтаксисПримерРезультат
    Выберите каждый узел, имя которого совпадает с узлом, который вы хотите выбрать, независимо от его местоположения в документе.Снабдите префиксом имя две наклонных черты вправо (//).
    data = readtable('myFile.xml', 'VariableSelectors', '//var')
    data =
    
      4×1 table
    
        var
        ___
    
         1 
         2 
        10 
        20 
    Считайте значение атрибута, принадлежащего узлу элемента.Снабдите префиксом атрибут знак at sign (@).
    data = readtable('myFile.xml', 'VariableSelectors', '//table/@category')
    data =
    
      2×1 table
    
        categoryAttribute
        _________________
    
             "ones"      
             "tens"   
    Выберите определенный узел в наборе узлов.Обеспечьте индекс узла, который вы хотите выбрать в квадратных скобках ([]).
    data = readtable('myFile.xml', 'TableSelector', '//table[1]')
    data =
    
      2×1 table
    
        var
        ___
    
         1 
         2 
    
    Задайте приоритет операций.Добавьте круглые скобки вокруг выражения, которое вы хотите выполнить сначала.
    data = readtable('myFile.xml', 'VariableSelectors', '//table/var[1]')
    data =
    
      2×1 table
    
        var
        ___
    
         1 
        10 
    data = readtable('myFile.xml', 'VariableSelectors', '(//table/var)[1]')
    data =
    
      table
    
        var
        ___
    
         1 

Вопросы совместимости

развернуть все

Поведение изменяется в R2020a

Введенный в R2013b
Для просмотра документации необходимо авторизоваться на сайте