Составьте таблицу из файла
составляет таблицу путем чтения данных в столбцах из файла.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(___,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
— Имя файла, чтобы читатьИмя файла, чтобы читать в виде вектора символов или строкового скаляра.
В зависимости от местоположения вашего файла, filename
может взять одну из следующих форм.
Местоположение | Форма | ||||||||
---|---|---|---|---|---|---|---|---|---|
Текущая папка или папка на MATLAB® path | Задайте имя файла в Пример:
| ||||||||
Файл в папке | Если файл не находится в текущей папке или в папке на пути MATLAB, то задайте полное имя или относительный путь в Пример:
Пример:
| ||||||||
Интернет URL | Если файл задан как интернет-универсальный локатор ресурса (URL), то Пример:
| ||||||||
Удаленное местоположение | Если файл хранится в удаленном местоположении, то
На основе удаленного местоположения,
Для получения дополнительной информации смотрите работу с Удаленными данными. Пример:
|
Если filename
включает расширение файла, затем функция импорта определяет формат файла из расширения. В противном случае необходимо задать 'FileType'
аргументы пары "имя-значение", чтобы указать на тип файла.
На Windows® системы с Microsoft Excel® программное обеспечение, функция импорта читает любой формат файла электронной таблицы Excel, распознанный вашей версией Excel.
Если ваша система не имеет Excel для Windows или если вы используете MATLAB Online™, функция импорта действует с UseExcel
набор свойств к false
, и чтения только .xls, .xlsx, .xlsm, .xltx, and .xltm
файлы.
Для разделенных текстовых файлов функция импорта преобразует пустые поля в файле к любому NaN
(для числовой переменной) или пустой символьный вектор (для текстовой переменной). Все линии в текстовом файле должны иметь то же количество разделителей. Функция импорта игнорирует незначительный пробел в файле.
Типы данных: char |
string
opts
— Настройки импорта файлаSpreadsheetImportOptions
| DelimitedtextImportOptions
| FixedWidthImportOptions
| XMLImportOptions
| WordDocumentImportOptions
| HTMLDocumentImportOptions
Настройки импорта файла в виде SpreadsheetImportOptions
DelimitedTextImportOptions
FixedWidthImportOptions
, XMLImportOptions
, WordDocumentImportOptions
, или HTMLDocumentImportOptions
объект, созданный detectImportOptions
функция. opts
объект содержит свойства, которые управляют процессом импорта данных. Для получения дополнительной информации о свойствах каждого объекта смотрите соответствующую объектную страницу.
Тип файлов | Вывод |
---|---|
Файлы электронной таблицы | SpreadsheetImportOptions объект (только доступный для Sheet DataRange , и VariableNames свойства |
Текстовые файлы | DelimitedTextImportOptions объект |
Текстовые файлы фиксированной ширины | FixedWidthImportOptions объект |
XML-файлы | XMLImportOptions объект |
Файлы документов Microsoft Word | WordDocumentImportOptions объект |
Файлы HTML | HTMLImportOptions объект |
Задайте дополнительные разделенные запятой пары Name,Value
аргументы. Name
имя аргумента и Value
соответствующее значение. Name
должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN
.
'ReadVariableNames',false
указывает, что первая строка файла не соответствует именам переменных.FileType
— Тип файла'spreadsheet'
| 'text'
| 'delimitedtext'
| 'fixedwidth'
| 'xml'
| 'worddocument'
| 'html'
Тип файла в виде разделенной запятой пары, состоящей из 'FileType'
и одно из этих значений.
Значение | Настройки импорта |
---|---|
'spreadsheet' | |
'text' |
|
'delimitedtext' |
|
'fixedwidth' |
|
'xml' |
|
'worddocument' |
|
'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
— Индикатор для чтения первого столбца как имена строкиfalse
(значение по умолчанию) | true
| 0
| 1
Индикатор для чтения первого столбца как строка называет в виде разделенной запятой пары, состоящей из 'ReadRowNames'
и любой false
TRUE
, 0, или
1
.
Индикатор | Описание |
---|---|
| Используйте, когда первый столбец области, который будет читать, будет содержать данные, а не имена строки для таблицы. |
| Используйте, когда первый столбец области, который будет читать, будет содержать имена строки для таблицы. |
незаданный | Когда оставлено незаданный, readtable принимает false . |
Примечание: Если оба 'ReadVariableNames'
и 'ReadRowNames'
логическими индикаторами является true
, затем readtable
сохраняет имя в первом столбце первой строки области, чтобы читать как первое имя размерности в свойстве, T.Properties.DimensionNames
.
Если вы задаете ReadRowNames
аргумент в дополнение к opts
настройки импорта, затем readtable
поведение изменяется на основе спецификации:
Если ReadRowNames
true
, затем считайте имена строки из заданного файла при помощи RowNamesRange
или RowNameColumn
свойство объекта настроек импорта.
Если ReadRowNames
false
, затем не импортируйте имена строки.
Пример: 'ReadRowNames',true
TreatAsMissing
— Текст заполнителя, чтобы обработать как пустое значениеТекст заполнителя, чтобы обработать как пустое значение в виде разделенной запятой пары, состоящей из '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'
Введите для данных об импортируемом тексте в виде разделенной запятой пары, состоящей из 'TextType'
и любой 'char'
или 'string'
.
'char'
— Импортируйте текстовые данные в MATLAB как векторы символов.
'string'
— Импортируйте текстовые данные в MATLAB как строковые массивы.
Пример: 'TextType','char'
DatetimeType
— Введите для импортированных данных о дате и времени'datetime'
(значение по умолчанию) | 'text'
| 'exceldatenum'
Файлы электронной таблицы толькоВведите для импортированных данных о дате и времени в виде разделенной запятой пары, состоящей из 'DatetimeType'
и одно из этих значений: 'datetime'
Текст
, или 'exceldatenum'
. Значение 'exceldatenum'
применимо только для файлов электронной таблицы и не допустим для текстовых файлов.
Значение | Введите для импортированных данных о дате и времени |
---|---|
'datetime' | MATLAB Для получения дополнительной информации смотрите |
'text' | Если
|
'exceldatenum'
| Excel последовательные числа даты Последовательный номер даты является одним номером, равным номеру дней с данной ссылочной даты. Excel последовательные числа даты использует различную ссылочную дату, чем MATLAB последовательные числа даты. Для получения дополнительной информации о датах Excel смотрите |
Пример: 'DatetimeType','datetime'
Типы данных: char |
string
VariableNamingRule
— Отметьте, чтобы сохранить имена переменных"modify"
(значение по умолчанию) | "preserve"
Отметьте, чтобы сохранить имена переменных в виде любого "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'
(значение по умолчанию) | 'error'
| 'omitrow'
| 'omitvar'
Процедура, чтобы управлять недостающими данными в виде одного из значений в этой таблице.
MissingRule | Поведение |
---|---|
'fill' | Замените недостающие данные на содержимое
|
'error' | Прекратите импортировать и отобразите сообщение об ошибке, показывающее недостающую запись и поле. |
'omitrow' | Не используйте строки, которые содержат недостающие данные. |
'omitvar' | Не используйте переменные, которые содержат недостающие данные. |
Пример: 'MissingRule','omitrow'
Типы данных: char |
string
ImportErrorRule
— Процедура, чтобы обработать ошибки импорта'fill'
(значение по умолчанию) | 'error'
| 'omitrow'
| 'omitvar'
Процедура, чтобы обработать ошибки импорта в виде одного из значений в этой таблице.
ImportErrorRule | Поведение |
---|---|
'fill' | Замените данные, где ошибка произошла с содержимым
|
'error' | Прекратите импортировать и отобразите сообщение об ошибке, показывающее вызывающую ошибку запись и поле. |
'omitrow' | Не используйте строки, где ошибки происходят. |
'omitvar' | Не используйте переменные, где ошибки происходят. |
Пример: 'ImportErrorRule','omitvar'
Типы данных: char |
string
ReadVariableNames
— Считайте первую строку как имена переменныхtrue
| false
| 1
| 0
Индикатор для чтения первой строки как имена переменных в виде разделенной запятой пары, состоящей из 'ReadVariableNames'
и любой true
ложь
, 1, или
0
. Если незаданный, readtable
автоматически обнаруживает присутствие имен переменных.
Индикатор | Описание |
---|---|
| Используйте, когда первая строка области, которая будет читать, будет содержать имена переменных для таблицы. |
| Используйте, когда первая строка области, которая будет читать, будет содержать данные в таблице. |
незаданный | Когда оставлено незаданный, readtable автоматически обнаруживает true или false и доходы соответственно. |
Примечание: Если оба 'ReadVariableNames'
и 'ReadRowNames'
логическими индикаторами является true
, затем readtable
сохраняет имя в первом столбце первой строки области, чтобы читать как первое имя размерности в свойстве, T.Properties.DimensionNames
.
Если вы задаете ReadVariableNames
аргумент в дополнение к opts
настройки импорта, затем readtable
поведение изменяется на основе спецификации:
Если ReadVariableNames
true
, затем считайте имена переменных из заданного файла при помощи VariableNamesRange
или VariableNamesLine
свойство объекта настроек импорта.
Если ReadVariableNames
false
, затем считайте имена переменных из VariableNames
свойство объекта настроек импорта.
Пример: 'ReadVariableNames',true
ExpectedNumVariables
— Ожидаемое количество переменныхОжидаемое количество переменных в виде разделенной запятой пары, состоящей из 'ExpectedNumVariables'
и положительное целое число. Если незаданный, функция импорта автоматически обнаруживает количество переменных.
Пример: 'ExpectedNumVariables',5
Типы данных: single
| double
Delimiter
— Символ разделителя полейСимвол разделителя полей в виде разделенной запятой пары, состоящей из 'Delimiter'
и вектор символов, массив ячеек из символьных векторов или строка. Задайте Delimiter
использование любого допустимого символа, такого как запятая ','
или период '.'
.
Эта таблица приводит некоторые обычно используемые символы разделителя полей.
Спецификатор | Разделитель полей |
---|---|
| Запятая |
| Пробел |
| Вкладка |
| Точка с запятой |
| Вертикальная панель |
незаданный | Если незаданный, |
Чтобы обработать последовательные разделители как один разделитель, задайте Delimiter
как массив ячеек из символьных векторов. Кроме того, необходимо также задать MultipleDelimsAsOne
опция.
Пример: 'Delimiter',','
или 'Delimiter','comma'
Типы данных: char |
string
| cell
LeadingDelimitersRule
— Процедура, чтобы управлять ведущими разделителями'keep'
| 'ignore'
| 'error'
Процедура, чтобы управлять ведущими разделителями в разделенном текстовом файле в виде одного из значений в этой таблице.
LeadingDelimitersRule | Поведение |
---|---|
'keep' | Сохраните разделитель. |
'ignore' | Проигнорируйте разделитель. |
'error' | Возвратите ошибку и прервите операцию импорта. |
Пример: 'LeadingDelimitersRule','keep'
TrailingDelimitersRule
— Процедура, чтобы справиться с запаздыванием разделителей'keep'
| 'ignore'
| 'error'
Процедура, чтобы справиться с запаздыванием разделителей в разделенном текстовом файле в виде одного из значений в этой таблице.
LeadingDelimitersRule | Поведение |
---|---|
'keep' | Сохраните разделитель. |
'ignore' | Проигнорируйте разделитель. |
'error' | Возвратите ошибку и прервите операцию импорта. |
Пример: 'TrailingDelimitersRule','keep'
ConsecutiveDelimitersRule
— Процедура, чтобы обработать последовательные разделители'split'
| 'join'
| 'error'
Процедура, чтобы обработать последовательные разделители в разделенном текстовом файле в виде одного из значений в этой таблице.
ConsecutiveDelimitersRule | Поведение |
---|---|
'split' | Разделите последовательные разделители в несколько полей. |
'join' | Соедините разделители в один разделитель. |
'error' | Возвратите ошибку и прервите операцию импорта. |
Пример: 'ConsecutiveDelimitersRule','split'
Типы данных: char |
string
VariableWidths
— Ширина поля переменныхШирина поля переменных в текстовом файле фиксированной ширины в виде вектора из положительных целочисленных значений. Каждое положительное целое число в векторе соответствует количеству символов в поле, которое составляет переменную. VariableWidths
свойство содержит запись, соответствующую каждой переменной, заданной в VariableNames
свойство.
Пример: 'VariableWidths',[10,7,4,26,7]
Whitespace
— Символы, чтобы обработать как пробелСимволы, чтобы обработать как пробел в виде вектора символов или строкового скаляра, содержащего один или несколько символов.
Пример: 'Whitespace',' _'
Пример: 'Whitespace','?!.,'
EmptyLineRule
— Процедура, чтобы обработать пустые линии'skip'
| 'read'
| 'error'
Процедура, чтобы обработать пустые линии в данных в виде 'skip'
чтение
, или 'error'
. Функция импорта интерпретирует пробел как пустой.
EmptyLineRule | Поведение |
---|---|
'skip' | Пропустите пустые линии. |
'read' | Импортируйте пустые линии. Функция импорта анализирует пустую линию с помощью значений, заданных в VariableWidths VariableOptions MissingRule , и другие соответствующие свойства, такие как Whitespace . |
'error' | Отобразите сообщение об ошибке и прервите операцию импорта. |
Пример: 'EmptyLineRule','skip'
Типы данных: char |
string
VariableNamesLine
— Местоположение имен переменных
(значение по умолчанию) | положительное скалярное целое числоМестоположение имен переменных в виде положительного скалярного целого числа. VariableNamesLine
свойство задает номер строки, где имена переменных расположены.
Если VariableNamesLine
задан как 0, затем не импортируйте имена переменных. В противном случае импортируйте имена переменных из заданной линии.
Пример: 'VariableNamesLine',6
Типы данных: single
| double
| uint8
| uint16
| uint32
| uint64
PartialFieldRule
— Процедура, чтобы обработать частичные поля'keep'
| 'fill'
| 'omitrow'
| 'omitvar'
| 'wrap'
| 'error'
Процедура, чтобы обработать частичные поля в данных в виде одного из значений в этой таблице.
PartialFieldRule | Поведение |
---|---|
'keep' | Сохраните частичные полевые данные и преобразуйте текст в соответствующий тип данных. В некоторых случаях, когда функция импорта не может интерпретировать частичные данные, ошибка преобразования может произойти. |
'fill' | Замените недостающие данные на содержимое
|
'omitrow' | Не используйте строки, которые содержат частичные данные. |
'omitvar' | Не используйте переменные, которые содержат частичные данные. |
'wrap' | Начните читать следующую строку символов. |
'error' | Отобразите сообщение об ошибке и прервите операцию импорта. |
Пример: 'PartialFieldRule','keep'
Типы данных: char |
string
VariableUnitsLine
— Переменное модульное местоположение
(значение по умолчанию) | положительное скалярное целое числоПеременное модульное местоположение в виде положительного скалярного целого числа. VariableUnitsLine
свойство задает номер строки, где переменные модули расположены.
Если VariableUnitsLine
задан как 0, затем не импортируйте переменные модули. В противном случае импортируйте переменные модули из заданной линии.
Пример: 'VariableUnitsLine',8
Типы данных: single
| double
| uint8
| uint16
| uint32
| uint64
VariableDescriptionsLine
— Местоположение описания переменной
(значение по умолчанию) | положительное скалярное целое числоМестоположение описания переменной в виде положительного скалярного целого числа. VariableDescriptionsLine
свойство задает номер строки, где описания переменной расположены.
Если VariableDescriptionsLine
задан как 0, затем не импортируйте описания переменной. В противном случае импортируйте описания переменной из заданной линии.
Пример: 'VariableDescriptionsLine',7
Типы данных: single
| double
| uint8
| uint16
| uint32
| uint64
ExtraColumnsRule
— Процедура, чтобы обработать дополнительные столбцы'addvars'
| 'ignore'
| 'wrap'
| 'error'
Процедура, чтобы обработать дополнительные столбцы в данных в виде одного из значений в этой таблице.
ExtraColumnsRule | Поведение |
---|---|
'addvars' | Чтобы импортировать дополнительные столбцы, создайте новые переменные. Если существует ПРИМЕЧАНИЕ: дополнительные столбцы импортируются как текст с данными type |
'ignore' | Проигнорируйте дополнительные столбцы данных. |
'wrap' | Перенесите дополнительные столбцы данных к новым записям. Это действие не изменяет количество переменных. |
'error' | Отобразите сообщение об ошибке и прервите операцию импорта. |
Пример: 'ExtraColumnsRule','addvars'
Типы данных: char |
string
NumHeaderLines
— Количество линий заголовка
(значение по умолчанию) | положительное целое числоКоличество линий заголовка, чтобы пропустить в начале файла в виде разделенной запятой пары, состоящей из 'NumHeaderLines'
и положительное целое число. Если незаданный, readtable
автоматически обнаруживает количество линий, чтобы пропустить.
Пример: 'NumHeaderLines',2
Типы данных: single
| double
Format
ColumnFormat 'auto'
Формат столбца файла в виде разделенной запятой пары, состоящей из 'Format'
и вектор символов или строковый скаляр, имеющий один или несколько спецификаторов преобразования или 'auto'
. Спецификаторы преобразования совпадают со спецификаторами, принятыми textscan
функция.
Определение формата может значительно улучшить скорость для некоторых больших файлов. Если вы не задаете значение для Format
то readtable
использование %q
интерпретировать нечисловые столбцы. %q
спецификатор читает текст и не использует двойные кавычки ("
) в подходящих случаях.
Если вы не задаете 'Format'
пара "имя-значение", затем readtable
функция ведет себя, как будто вы использовали результаты detectImportOptions
функция, чтобы импортировать данные. Для получения дополнительной информации о последствиях этого поведения см. Вопросы совместимости.
Если вы задаете 'Format','auto'
, затем созданными переменными является double
массивы, массив ячеек из символьных векторов или datetime
массивы, в зависимости от данных. Если целый столбец является числовым, переменные импортируются как double
. Если какой-либо элемент в столбце не является числовым, переменные импортируются как массивы ячеек из символьных векторов, или как datetime
массивы, если значения представляют даты и времена.
Пример: 'Format','auto'
Типы данных: char |
string
EmptyValue
— Возвращенное значение для пустых числовых полейNaN
(значение по умолчанию) | числовой скалярВозвращенное значение для пустых числовых полей в разделенных текстовых файлах в виде разделенной запятой пары, состоящей из 'EmptyValue'
и числовой скаляр.
Пример: 'EmptyValue',0
MultipleDelimsAsOne
— Несколько обработка разделителя0 (false)
(значение по умолчанию) | 1 (true)
Несколько обработка разделителя в виде разделенной запятой пары, состоящей из 'MultipleDelimsAsOne'
и любой true
или false
. Если true
, затем функция импорта обрабатывает последовательные разделители как один разделитель. Повторные разделители, разделенные пробелом, также обработаны как один разделитель. Необходимо также задать Delimiter
опция.
Пример: 'MultipleDelimsAsOne',1
CollectOutput
— Логический индикатор, определяющий конкатенацию данныхfalse
(значение по умолчанию) | true
Логический индикатор, определяющий конкатенацию данных в виде разделенной запятой пары, состоящей из 'CollectOutput'
и любой true
или false
. Если true
, затем функция импорта конкатенирует последовательные выходные ячейки того же основного класса MATLAB в единый массив.
Пример: 'CollectOutput',true
CommentStyle
— Символы, определяющие текст проигнорироватьСимволы, определяющие текст проигнорировать в виде разделенной запятой пары, состоящей из 'CommentStyle'
и вектор символов, массив ячеек из символьных векторов, строка или массив строк.
Например, задайте символ, такой как '%'
проигнорировать текст после символа на той же линии. Задайте массив ячеек двух векторов символов, таких как {'/*','*/'}
, проигнорировать любой текст между теми последовательностями.
MATLAB проверяет на комментарии только в начале каждого поля, не в поле.
Пример: 'CommentStyle',{'/*','*/'}
Типы данных: char |
string
ExpChars
ExponentCharacters 'eEdD'
(значение по умолчанию) | вектор символов | строкаСимволы экспоненты в виде разделенной запятой пары, состоящей из 'ExpChars'
и вектор символов или строка. Символами экспоненты по умолчанию является e
E
D
, и D
.
Пример: 'ExpChars','eE'
Типы данных: char |
string
LineEnding
— Символы конца линииСимволы конца линии в виде разделенной запятой пары, состоящей из 'LineEnding'
и вектор символов или строка. Вектором символов должен быть '\r\n'
или это должно задать отдельный символ. Общие символы конца линии являются символом новой строки ('\n'
) или возврат каретки ('\r'
). Если вы задаете '\r\n'
, затем функция импорта обрабатывает любой \r
N
, и комбинация двух (\r\n
) как символы конца линии.
Последовательностью конца линии по умолчанию является \n
R
, или \r\n
, В зависимости от содержимого вашего файла.
Если существуют отсутствующие значения и последовательность конца линии в конце последней линии в файле, то функция импорта возвращает пустые значения для тех полей. Это гарантирует что отдельные ячейки в выходном массиве ячеек, C
, одного размера.
Пример: 'LineEnding',':'
Типы данных: char |
string
DateLocale
— Локаль для чтения датЛокаль для чтения дат в виде разделенной запятой пары, состоящей из '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
пара "имя-значение", чтобы отличить целую часть номера от десятичной части.
При преобразовании в целочисленные типы данных числа с десятичной частью округлены до ближайшего целого числа.
Пример: Если пара "имя-значение" задана как '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
.
Типы данных: логический
Encoding
— Схема кодировки символов'UTF-8'
| 'ISO-8859-1'
| 'windows-1251'
| 'windows-1252'
| ...Схема кодировки символов, сопоставленная с файлом в виде разделенной запятой пары, состоящей из 'Encoding'
и 'system'
или имя схемы кодирования стандартного символа. Когда вы не задаете кодирования, readtable
функционируйте использует автоматическое обнаружение набора символов, чтобы определить кодирование при чтении файла.
Если вы задаете 'Encoding'
аргумент в дополнение к настройкам импорта, затем readtable
функционируйте использует заданное значение для 'Encoding'
, переопределение кодирования задано в настройках импорта.
Пример: 'Encoding','UTF-8'
использование UTF-8 как кодирование.
Пример: 'Encoding','system'
использует кодирование системного значения по умолчанию.
Типы данных: char |
string
DurationType
— Тип выходных данных данных о длительности'duration'
(значение по умолчанию) | 'text'
Тип выходных данных данных о длительности из текстовых файлов в виде разделенной запятой пары, состоящей из 'DurationType'
и любой 'duration'
или 'text'
.
Значение | Введите для импортированных данных о длительности |
---|---|
'duration' | MATLAB Для получения дополнительной информации смотрите |
'text' | Если
|
Пример: 'DurationType','text'
Типы данных: char |
string
HexType
— Тип выходных данных шестнадцатеричных данных'auto'
(значение по умолчанию) | 'text'
| 'int8'
| 'int16'
| ...Тип выходных данных шестнадцатеричных данных в виде разделенной запятой пары, состоящей из 'HexType'
и одно из перечисленных в таблице значений.
Входной файл представляет шестнадцатеричные значения как текст, с помощью любого 0x
или 0X
как префикс и символы 0
-9A
F
, и A
F
как цифры. (Прописные и строчные буквы представляют те же цифры — например, '0xf'
и '0xF'
оба представляют 15
.)
Функция импорта преобразует шестнадцатеричные значения в тип данных, заданный значением 'HexType'
.
Значение | Тип данных Выходных табличных переменных |
---|---|
| тип данных обнаруживается автоматически |
| неизменный входной текст |
| 8-битное целое число, подписанное |
| 16-битное целое число, подписанное |
| 32-битное целое число, подписанное |
| 64-битное целое число, подписанное |
| 8-битное целое число, без знака |
| 16-битное целое число, без знака |
| 32-битное целое число, без знака |
| 64-битное целое число, без знака |
Пример: 'HexType','uint16'
преобразует текст, представляющий шестнадцатеричные значения (такие как '0xFF'
) до 16-битных целых чисел без знака (таких как 255
) в выходной таблице.
Типы данных: char |
string
BinaryType
— Тип выходных данных двоичных данных'auto'
(значение по умолчанию) | 'text'
| 'int8'
| 'int16'
| ...Тип выходных данных двоичных данных в виде разделенной запятой пары, состоящей из 'BinaryType'
и одно из перечисленных в таблице значений.
Входной файл представляет двоичные значения как текст, с помощью любого 0b
или 0B
как префикс и символы 0
и 1
как цифры.
Функция импорта преобразует двоичные значения в тип данных, заданный значением 'BinaryType'
.
Значение | Тип данных Выходных табличных переменных |
---|---|
| тип данных обнаруживается автоматически |
| неизменный входной текст |
| 8-битное целое число, подписанное |
| 16-битное целое число, подписанное |
| 32-битное целое число, подписанное |
| 64-битное целое число, подписанное |
| 8-битное целое число, без знака |
| 16-битное целое число, без знака |
| 32-битное целое число, без знака |
| 64-битное целое число, без знака |
Пример: 'BinaryType','uint16'
преобразует текст, представляющий двоичные значения (такие как '0b11111111'
) до 16-битных целых чисел без знака (таких как 255
) в выходной таблице.
Типы данных: char |
string
TrimNonNumeric
— Удалите нечисловые символыfalse
(значение по умолчанию) | true
Удалите нечисловые символы из числовой переменной в виде логического true
или false
.
Пример: Если пара "имя-значение" задана как 'TrimNonNumeric',true
, затем функция импорта читает '$500/-'
как 500
.
Типы данных: логический
Sheet
— Рабочий лист, чтобы читать
(значение по умолчанию) | положительное целое число | вектор символов | строкаРабочий лист, чтобы читать в виде разделенной запятой пары, состоящей из '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'
и вектор символов или строковый скаляр в одной из следующих форм.
Способы задать Range | Описание |
---|---|
Запуск ячейки | Задайте стартовую ячейку для данных как вектор символов или строковый скаляр или два элемента числовой вектор.
Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула. Пример:
|
Прямоугольная область значений | Укажите диапазон с помощью синтаксиса Пример:
|
Незаданный или пустой | Если незаданный, Пример: Примечание: Используемая Область значений относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. |
Область значений строки | Можно идентифицировать область значений путем определения начала и конечного использования строк указатели строки Excel. Затем Пример: |
Область значений столбца | Можно идентифицировать область значений путем определения начала и конечного использования столбцов указатели столбца Excel. Затем Пример: |
Названная область значений в Excel | В Excel можно создать имена, чтобы идентифицировать области значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее Пример: |
Пример: 'Range'
, 'A1:F10'
Пример: 'Range'
, "A1:F10"
—
Типы данных: char |
string
DataRange
— Местоположение данныхМестоположение данных, которые будут импортированы в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов, массива строк, положительного скалярного целого числа или N
- 2
массив положительных скалярных целых чисел. Задайте DataRange
использование одной из следующих форм.
Заданный | Поведение |
---|---|
Запуск ячейки или стартовой строки | Задайте стартовую ячейку для данных, с помощью Excel Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула. В качестве альтернативы задайте первую строку, содержащую данные с помощью индекса строки положительной скалярной величины. Используя заданный индекс строки, функция импорта автоматически обнаруживает степень данных путем чтения из заданной первой строки в конец данных или области значений нижнего колонтитула. Пример:
|
Прямоугольная область значений | Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где Функция импорта только считывает данные, содержавшиеся в заданной области. Любые пустые поля в заданной области импортируются как недостающие ячейки. Количество столбцов должно совпадать с номером, заданным в Пример:
|
Область значений строки или область значений столбца | Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Используя указанный диапазон строки, функция импорта автоматически обнаруживает степень столбца путем чтения из первого непустого столбца в конец данных и создает одну переменную для каждого столбца. Пример:
В качестве альтернативы укажите диапазон путем идентификации начала и конечного использования столбцов буквы столбца Excel или числа. Используя указанный диапазон столбца, функция импорта автоматически обнаруживает степень строки путем чтения из первой непустой строки в конец данных или области значений нижнего колонтитула. Количество столбцов в заданной области должно совпадать с номером, заданным в Пример:
|
Несколько областей значений строки | Укажите несколько диапазонов строки, чтобы читать с Допустимый массив нескольких областей значений строки должен:
Использование Пример:
|
Незаданный или пустой | Не выбирайте данные. Пример:
|
Пример: 'DataRange'
, 'B2:H15'
Типы данных: char |
string
| cell
| single
| double
RowNamesRange
— Местоположение имен строки''
пустой символьный массивМестоположение строки называет в виде вектора символов, строкового скаляра, положительного скалярного целого числа или пустого символьного массива. Задайте RowNamesRange
как одно из значений в этой таблице.
Заданный | Поведение |
---|---|
| Задайте стартовую ячейку для данных, с помощью Excel Функция импорта идентифицирует имя для каждой переменной в данных. Пример:
|
Прямоугольная область значений | Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где Количество строк содержится в Пример:
|
Область значений строки | Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Имена строки должны быть в отдельном столбце. Пример:
|
Индекс номера | Задайте столбец, содержащий имена строки с помощью индекса столбца положительной скалярной величины. Пример 5
|
Незаданный или пустой | Укажите, что нет никаких имен строки. Пример:
|
Пример: 'RowNamesRange'
, 'A1:H1'
Типы данных: char |
single
| double
VariableNamesRange
— Местоположение имен переменных''
пустой символьный массивМестоположение имен переменных в виде вектора символов, строкового скаляра, положительного скалярного целого числа или пустого символьного массива. Задайте VariableNamesRange
как одно из значений в этой таблице.
Заданный | Поведение |
---|---|
| Задайте стартовую ячейку для данных, с помощью Excel Функция импорта читает имя для каждой переменной в данных. Пример:
|
Прямоугольная область значений | Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где Количество столбцов должно совпадать с номером, заданным в Пример:
|
Область значений строки | Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Должна быть одна строка. Пример:
|
Индекс номера | Задайте строку, содержащую имена переменных с помощью индекса строки положительной скалярной величины. Пример 5
|
Незаданный или пустой | Укажите, что нет никаких имен переменных. Пример:
|
Пример: 'VariableNamesRange'
, 'A1:A15'
Типы данных: char |
single
| double
VariableUnitsRange
— Местоположение переменных модулей''
пустой символьный массивМестоположение переменных модулей в виде вектора символов, строкового скаляра, положительного скалярного целого числа или пустого символьного массива. Задайте VariableUnitsRange
как одно из значений в этой таблице.
Заданный | Поведение |
---|---|
| Задайте стартовую ячейку для данных, с помощью Excel Функция импорта читает модуль для каждой переменной в данных. Пример:
|
Прямоугольная область значений | Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где Количество столбцов должно совпадать с номером, заданным в Пример:
|
Область значений строки | Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Должна быть одна строка. Пример:
|
Индекс номера | Задайте строку, содержащую модули данных с помощью индекса строки положительной скалярной величины. Пример 5
|
Незаданный или пустой | Укажите, что нет никаких переменных модулей. Пример:
|
Пример: 'VariableUnitsRange'
, 'A1:A5'
Типы данных: char |
string
| single
| double
VariableDescriptionsRange
— Местоположение описаний переменной''
пустой символьный массивМестоположение описаний переменной в виде вектора символов, строкового скаляра, положительного скалярного целого числа или пустого символьного массива. Задайте VariableDescriptionRange
как одно из значений в этой таблице.
Заданный | Поведение |
---|---|
| Задайте стартовую ячейку для данных, с помощью Excel Функция импорта читает описание для каждой переменной в данных. Пример:
|
Прямоугольная область значений | Укажите точный диапазон, чтобы считать использование прямоугольной формы области значений, где Количество столбцов должно совпадать с номером, заданным в Пример:
|
Область значений строки | Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Должна быть одна строка. Пример:
|
Индекс номера | Задайте строку, содержащую описания с помощью индекса строки положительной скалярной величины. Пример 5
|
Незаданный или пустой | Укажите, что нет никаких описаний переменной. Пример:
|
Пример: 'VariableDescriptionsRange'
, 'B1:B15'
Типы данных: char |
string
| single
| double
UseExcel
— Отметьте, чтобы запустить экземпляр Microsoft Excel для Windowsfalse
(значение по умолчанию) | true
Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows при чтении данных об электронной таблице в виде разделенной запятой пары, состоящей из 'UseExcel'
и любой true
, или false
.
Можно установить 'UseExcel'
параметр к одному из этих значений:
true
— Функция импорта запускает экземпляр Microsoft Excel при чтении файла.
false
— Функция импорта не запускает экземпляр Microsoft Excel при чтении файла. При работе в этом режиме функциональность функции импорта отличается в поддержку форматов файлов и интерактивных функций, таких как формулы и макросы.
UseExcel |
|
|
---|---|---|
Поддерживаемые форматы файлов |
|
|
Поддержка интерактивных функций, таких как формулы и макросы | Да | Нет |
Когда чтение из файлов электронной таблицы на платформах Windows, если вы хотите запустить экземпляр Microsoft Excel, затем установило 'UseExcel'
параметр к true
.
Пример: 'UseExcel',true
AttributeSuffix
— Суффикс атрибута'Attribute'
(значение по умолчанию) | вектор символов | строковый скалярСуффикс атрибута в виде разделенной запятой пары, состоящей из 'AttributeSuffix'
и или вектор символов или строковый скаляр. Этот аргумент задает суффикс, который функция чтения добавляет ко всем табличным переменным, которые соответствуют атрибутам во входном XML-файле. Если вы не задаете 'AttributeSuffix'
, затем значения по умолчанию функции чтения к добавлению суффиксного 'Attribute'
ко всем именам переменных, соответствующим атрибутам во входном XML-файле.
Пример: 'AttributeSuffix','_att'
ImportAttributes
— Импортируйте атрибуты1
или true
(значение по умолчанию) | логический 0
или false
Импортируйте атрибуты в виде разделенной запятой пары, состоящей из 'ImportAttributes'
и любой 1
TRUE
) или 0
ложь
). Если вы задаете false
, затем функция чтения не импортирует атрибуты XML во входном файле как переменные в выходной таблице.
Пример: 'ImportAttributes',false
RowNodeName
— Строка таблицы имя узла XMLСтрока таблицы имя узла XML в виде разделенной запятой пары, состоящей из 'RowNodeName'
и или вектор символов или строковый скаляр. Этот аргумент задает имя узла XML, которое формирует рисунок строк выходной таблицы.
Пример: 'RowNodeName','XMLNodeName'
RowSelector
— Выражение XPath строки таблицыВыражение XPath строки таблицы в виде вектора символов или строкового скаляра, что чтение функционирует использование, чтобы выбрать отдельные строки выходной таблицы. Необходимо задать RowSelector
как допустимое выражение версии 1.0 XPath.
Пример: 'RowSelector','/RootNode/ChildNode'
VariableNodeNames
— Табличная переменная имена узла XMLТабличная переменная имена узла XML в виде разделенной запятой пары, состоящей из 'VariableNodeNames'
и или массив ячеек из символьных векторов или массив строк. Этот аргумент задает имя узла XML, которое чтение функционирует использование, чтобы идентифицировать узлы XML, чтобы считать как переменные в выходной таблице.
Пример: 'VariableNodeNames',{'XMLNodeName1','XMLNodeName2'}
Пример: 'VariableNodeNames',"XMLNodeName"
Пример: 'VariableNodeNames',["XMLNodeName1","XMLNodeName2"]
VariableSelectors
— Выражения XPath табличной переменнойВыражения XPath табличной переменной в виде массива ячеек из символьных векторов или массива строк, что чтение функционирует использование, чтобы выбрать табличные переменные. Необходимо задать VariableSelectors
как допустимые выражения версии 1.0 XPath.
Пример: 'VariableSelectors',{'/RootNode/ChildNode'}
Пример: 'VariableSelectors',"/RootNode/ChildNode"
Пример: 'VariableSelectors',["/RootNode/ChildNode1","/RootNode/ChildNode2"]
TableNodeName
— Таблица имя узла XMLТаблица имя узла XML в виде разделенной запятой пары, состоящей из 'TableNodeName'
и или вектор символов или строковый скаляр. Этот аргумент задает узел во входной структуре, которую функция чтения должна считать в таблицу.
Пример: 'TableNodeName','NodeName'
VariableUnitsSelector
— Переменное модульное выражение XPathПеременный модульный XPath в виде вектора символов или строкового скаляра, что чтение функционирует использование, чтобы выбрать модули табличной переменной. Необходимо задать VariableUnitsSelector
как допустимое выражение версии 1.0 XPath.
Пример: 'VariableUnitsSelector','/RootNode/ChildNode'
VariableDescriptionsSelector
— Выражение XPath описаний переменнойВыражение XPath описаний переменной в виде вектора символов или строкового скаляра, что чтение функционирует использование чтений, чтобы выбрать описания табличной переменной. Необходимо задать VariableDescriptionsSelector
как допустимое выражение версии 1.0 XPath.
Пример: 'VariableDescriptionsSelector','/RootNode/ChildNode'
RowNamesSelector
— Строка таблицы называет выражение XPathСтрока таблицы называет выражение XPath в виде вектора символов или строкового скаляра, что чтение функционирует использование, чтобы выбрать имена строк таблицы. Необходимо задать RowNamesSelector
как допустимое выражение версии 1.0 XPath.
Пример: 'RowNamesSelector','/RootNode/ChildNode'
RepeatedNodeRule
— Процедура, чтобы обработать повторенные узлы XML'addcol'
(значение по умолчанию) | 'ignore'
| 'error'
Процедура, чтобы обработать повторенные узлы XML в данной строке таблицы в виде 'addcol'
, 'ignore'
, или 'error'
.
Повторное правило узла | Поведение |
---|---|
'addcol' | Добавьте столбцы для повторных узлов под переменным заголовком в таблице. Определение значения |
'ignore' | Пропуск, импортирующий повторные узлы. |
'error' | Отобразите сообщение об ошибке и прервите операцию импорта. |
Пример: 'RepeatedNodeRule','ignore'
RegisteredNamespaces
— Набор зарегистрированных префиксов пространства имен XMLНабор зарегистрированных префиксов пространства имен 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"]
TableIndex
— Индекс таблицы, чтобы читать
(значение по умолчанию) | положительное целое числоИндекс таблицы, чтобы читать из документа Microsoft Word или файла HTML, содержащего несколько таблиц в виде положительного целого числа.
Когда вы задаете TableIndex
, программное обеспечение автоматически устанавливает TableSelector
к эквивалентному выражению XPath.
Пример: 'TableIndex',2
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
TableIndex
— Индекс таблицы, чтобы читать
(значение по умолчанию) | положительное целое числоИндекс таблицы, чтобы читать из документа Microsoft Word или файла HTML, содержащего несколько таблиц в виде положительного целого числа.
Когда вы задаете TableIndex
, программное обеспечение автоматически устанавливает TableSelector
к эквивалентному выражению XPath.
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
MergedCellColumnRule
— Процедура, чтобы обработать ячейки с объединенными столбцами"placeleft"
(значение по умолчанию) | "placeright"
| "duplicate"
| "omitrow"
| "error"
Процедура, чтобы обработать ячейки с объединенными столбцами в виде одного из значений в этой таблице.
ImportErrorRule | Поведение |
---|---|
"placeleft" | Поместите данные в крайнюю левую ячейку и заполните остальные ячейки содержимым
|
"placeright" | Поместите данные в самую правую ячейку и заполните остальные ячейки содержимым
|
"duplicate" | Скопируйте данные во всех ячейках. |
"omitrow" | Не используйте строки, где ошибки происходят. |
"error" | Отобразите сообщение об ошибке и прервите операцию импорта. |
Пример: 'MergedCellColumnRule',"placeright"
MergedCellRowRule
— Процедура, чтобы обработать ячейки с объединенными строками"placeleft"
(значение по умолчанию) | "placeright"
| "duplicate"
| "omitrow"
| "error"
Процедура, чтобы обработать ячейки с объединенными строками в виде одного из значений в этой таблице.
ImportErrorRule | Поведение |
---|---|
"placetop" | Поместите данные в главную ячейку и заполните остальные ячейки содержимым
|
"placebottom" | Поместите данные в нижнюю ячейку и заполните остальные ячейки содержимым
|
"duplicate" | Скопируйте данные во всех ячейках. |
"omitvar" | Не используйте переменные, где объединенные строки происходят. |
"error" | Отобразите сообщение об ошибке и прервите операцию импорта. |
Пример: 'MergedCellRowRule',"duplicate"
VariableNamesRow
— Строка, содержащая имена переменныхСтрока, содержащая имена переменных в виде неотрицательного целого числа.
Если вы не задаете VariableNamesRow
, затем программное обеспечение читает имена переменных согласно ReadVariableNames
аргумент.
Если VariableNamesRow
0
, затем программное обеспечение не импортирует имена переменных.
В противном случае программное обеспечение импортирует имена переменных из заданной строки.
Пример: 'VariableNamesRow',2
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
VariableUnitsRow
— Строка, содержащая переменные модули
(значение по умолчанию) | неотрицательное целое числоСтрока, содержащая переменные модули в виде неотрицательного целого числа.
Если VariableUnitsRow
0
, затем программное обеспечение не импортирует переменные модули. В противном случае программное обеспечение импортирует переменные модули из заданной строки.
Пример: 'VariableUnitsRow',3
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
VariableDescriptionsRow
— Строка, содержащая описания переменной
(значение по умолчанию) | неотрицательное целое числоСтрока, содержащая описания переменной в виде неотрицательного целого числа.
Если VariableDescriptionsRow
0
, затем программное обеспечение не импортирует описания переменной. В противном случае программное обеспечение импортирует описания переменной из заданной строки.
Пример: 'VariableDescriptionsRow',4
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
EmptyRowRule
— Управляйте, чтобы примениться к пустым строкам в таблице"skip"
(значение по умолчанию) | "read"
| "error"
Управляйте, чтобы примениться к пустым строкам в таблице в виде одного из следующего:
"skip"
– Пропустите пустые строки.
"read"
– Считайте пустые строки.
"error"
– Проигнорируйте пустые строки во время табличного обнаружения и ошибки при чтении.
Пример: "EmptyRowRule","read"
EmptyColumnRule
— Управляйте, чтобы примениться к пустым столбцам в таблице"skip"
(значение по умолчанию) | "read"
| "error"
Управляйте, чтобы примениться к пустым столбцам в таблице в виде одного из следующего:
"skip"
– Пропустите пустые столбцы.
"read"
– Считайте пустые столбцы.
"error"
– Проигнорируйте пустые столбцы во время табличного обнаружения и ошибки при чтении.
Пример: "EmptyColumnRule","error"
TableSelector
— Табличное выражение XPath данныхТабличное выражение XPath данных в виде вектора символов или строкового скаляра, что чтение функционирует использование, чтобы выбрать выходные табличные данные. Необходимо задать TableSelector
как допустимое выражение версии 1.0 XPath.
Пример: 'TableSelector','/RootNode/ChildNode'
T
— Таблица OutputВыведите таблицу, возвращенную как таблица. Таблица может сохранить метаданные, такие как описания, переменные модули, имена переменных и имена строки. Для получения дополнительной информации смотрите раздел 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>
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 |
detectImportOptions
функция раньше по умолчанию импортировала табличные данныеПоведение изменяется в R2020a
По умолчанию, readtable
функционируйте использует результаты detectImportOptions
функция, чтобы импортировать табличные данные. В сущности эти два вызова функции ведут себя тождественно.
T = readtable(filename) T = readtable(filename,detectImportOptions(filename))
В R2020a существует несколько различий между поведением по умолчанию readtable
и его поведение по умолчанию в предыдущих релизах.
Описание полей ввода или строк | R2020a по умолчанию | Поведение по умолчанию в предыдущих релизах |
---|---|---|
Первая строка не имеет текста, чтобы присвоить как имена выходных табличных переменных | Присваивает имена | Преобразует значения в первой строке значений данных к именам выходных табличных переменных |
Несколько строк текста как линии заголовка |
|
|
Пустые поля | Обработайте как отсутствующие значения для обнаруженного типа данных | Обработайте как пустые символьные вектора или строки |
Значения в кавычках | Обработка как обнаруженный тип данных | Обработайте как текст |
Текст, который не может быть преобразован | Обработайте как отсутствующие значения для обнаруженного типа данных | Обработайте как текст |
Нечисловой символ запаздывает цифровой символ без разделителя между ними | Обработайте символы как нечисловые | Обработайте цифровые и нечисловые символы, как будто разделитель разделил их |
Входной текстовый файл имеет линии с различным количеством разделителей | Возвращает выходную таблицу с дополнительными переменными | Сообщение об ошибке повышений |
Вызывать readtable
с поведением по умолчанию это имело до R2019b, используйте 'Format','auto'
аргумент пары "имя-значение".
T = readtable(filename,'Format','auto')
writetable
| table
| textscan
| Инструмент для импорта | detectImportOptions
| preview
| readtimetable
| readcell
| readmatrix
| readvars
| setvaropts
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.