textread

(Не Рекомендуемый) Считанные данные из текстового файла; запишите в несколько выходных параметров

textread не рекомендуется. Использование textscan вместо этого. Для получения дополнительной информации см. Вопросы совместимости.

Синтаксис

[Var1,Var2,...,VarN] = textread(filename,format)

[Var1,Var2,...,VarN] = textread(filename,format,N)

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

Описание

пример

[Var1,Var2,...,VarN] = textread(filename,format) считывает данные из файла filename в переменные [Var1,Var2,...,VarN] с помощью заданного формата, пока не читается целый файл. textread полезно для чтения текстовых файлов с известным форматом. textread указатели и файлы фиксированного и свободного формата.

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

пример

[Var1,Var2,...,VarN] = textread(filename,format,N) считывает данные, снова используя заданный format N \times. Если N меньше нуля, textread читает целый файл.

пример

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

Примеры

свернуть все

Считайте все поля в файле свободного формата

Скрипт Open Live Script

Первая строка выборочных данных, 'scan1.dat',

09/12/2005 {'Level1'} 12.34 45 1.23e+10 Inf NaN {'Yes'} 5.1+3i

Считайте первую строку файла как файл свободного формата с помощью % формат.

[date,level,x,y,answer] = textread('scan1.dat','%s %s %f %d %s',1)

date = 1x1 cell array
    {'09/12/2005'}

level = 1x1 cell array
    {'Level1'}

x = 12.3400

y = 45

answer = 1x1 cell array
    {'1.23e10'}

Читайте Используя литерал, чтобы проигнорировать соответствие с символами

Скрипт Open Live Script

Первая строка выборочных данных, 'scan1.dat',

09/12/2005 {'Level1'} 12.34 45 1.23e+10 Inf NaN {'Yes'} 5.1+3i

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

[date,level,x,y,answer] = textread('scan1.dat','%s Level%d %f %d %s',1)

date = 1x1 cell array
    {'09/12/2005'}

level = 1

x = 12.3400

y = 45

answer = 1x1 cell array
    {'1.23e10'}

Задайте значение, чтобы заполнить пустые ячейки

Скрипт Open Live Script

Для файлов с пустыми ячейками используйте emptyvalue параметр. Предположим файл data.csv содержит:

1,2,3,4,,6

7,8,9,,11,12

Считайте использование файла NaN, чтобы заполнить любые пустые ячейки:

data = textread('data.csv','','delimiter',',','emptyvalue',NaN)

data = 2×6

     1     2     3     4   NaN     6
     7     8     9   NaN    11    12

Считайте файл в Массив ячеек из символьных векторов

Скрипт Open Live Script

Считайте файл fft.m в массив ячеек из символьных векторов.

file = textread('badpoem.txt','%s','delimiter','\n','whitespace','')

file = 4x1 cell
    {'Oranges and lemons,'    }
    {'Pineapples and tea.'    }
    {'Orangutans and monkeys,'}
    {'Dragonflys or fleas.'   }

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

свернуть все

`filename` FileName
вектор символов | строковый скаляр

Имя файла в виде вектора символов или строкового скаляра.

`format` формат
вектор символов | строковый скаляр

Формат в виде вектора символов или строкового скаляра. Этот аргумент определяет номер и типы возвращаемых аргументов. Количество возвращаемых аргументов является количеством элементов, обозначенных содержимым formatформат поддерживает подмножество спецификаторов преобразования и соглашения языка C fscanf стандартная программа. Значения для format перечислены в таблице ниже. Пробельные символы в format проигнорированы.

формат	Действие	Вывод
Литералы (обычные символы)	Проигнорируйте соответствующие символы. Например, в файле, который имеет `Dept` сопровождаемый номером (для номера отдела), чтобы пропустить `Dept` и только для чтения номер, используйте `'Dept'` в спецификаторе формата.	'none'
`%d`	Считайте значение целого числа со знаком.	Двойной массив
`%u`	Считайте целочисленное значение.	Двойной массив
`%f`	Считайте значение с плавающей точкой.	Двойной массив
`%s`	Считайте пробел или разделенный от разделителя текст.	Массив ячеек из символьных векторов
`%q`	Считайте дважды заключенный в кавычки текст, игнорируя кавычки.	Массив ячеек из символьных векторов
`%c`	Считайте символы, включая пробел.	Массив символов
`%[...]`	Считайте самую длинную группу символов, содержащих символы, заданные в скобках.	Массив ячеек из символьных векторов
`%[^...]`	Считайте самую длинную непустую группу символов, содержащих символы, которые не заданы в скобках.	Массив ячеек из символьных векторов
`%*... вместо %`	Проигнорируйте соответствующие символы, заданные `*`.	'none'
`W... вместо %`	Считайте ширину поля, заданную `w`. `%f` формат поддерживает `%w.pf`, где `w` ширина поля и `p` точность.

`N` — Число раз, чтобы считать данные
положительное целое число

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

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

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

Пример: 'WriteMode','append'

`bufsize` — Максимальная длина вектора символов
4 095 (значений по умолчанию) | положительное целое число

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

`commentstyle` — Проигнорируйте символы относительно связанных символов
'MATLAB' | 'окружает' | 'c' | 'C++'

Игнорирует символы относительно связанных символов в виде 'matlab', 'shell'C, или 'c++'.

Значение		Поведение
`'matlab'`		Игнорирует символы после `%`.
`'shell'`		Игнорирует символы после `#`.
`'c'`		Игнорирует символы между `/` и `/`.
`'c++'`		Игнорирует символы после `//`.

`delimiter` — Разделители между элементами
один или несколько символов

Разделители между элементами в виде одного или нескольких символов. Когда textread читает последовательную серию delimiter значения, это обрабатывает каждого как отдельный разделитель.

`emptyvalue` — Значение дано пустым ячейкам
0 (значений по умолчанию) | скаляр дважды

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

`endofline` — Символ, который обозначает конец линии
определенный из файла (значение по умолчанию) | отдельный символ | `'\r\n'`

Символ, который обозначает конец линии в виде отдельного символа или '\r\n'.

`exchars` ExponentCharacters
`'eEdD'` (значение по умолчанию) | символы экспоненты

Определяйте символы экспоненты в виде символов экспоненты.

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

Количество линий заголовка в виде положительного целого числа.

`whitespace` — Вектор из символов, которые будут обработаны как пробельный символ
`' \b\t'` (значение по умолчанию) | `' '` | `\b` | `\n` | `\r` | `\t`

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

Можно сохранить начальные и конечные пробелы в тексте, с помощью whitespace.

textread('myfile.txt','%s','whitespace','')
ans = 
    '   An  example      of preserving    spaces      '

Значение		Поведение
`' '`		Пробел
`\b`		Клавиша Backspace
`\n`		Новая строка
`\r`		Возврат каретки
`\t`		Горизонтальная табуляция

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

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

`textread` не рекомендуется

Не рекомендуемый запуск в R2012b

textread не рекомендуется. Используйте textscan вместо этого. Нет никаких планов удалить textread.

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

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

Эта таблица показывает некоторые типичные использования textread и как обновить ваш код, чтобы использовать textscan вместо этого.

Не рекомендуемый	Рекомендуемый
[date,level,x,y,answer] = textread('scan1.dat',... '%s %s %f %d %s',1)	filename = 'scan1.dat'; fileID = fopen(filename); C = textscan(fileID,'%s %s %f %d %s'); fclose(fileID); celldisp(C)
data = textread('data.csv','','delimiter',',',... 'emptyvalue',NaN)	filename = 'data.csv'; fileID = fopen(filename); C = textscan(fileID,'%f %f %f %f %u8 %f', ... 'Delimiter',',','EmptyValue',NaN); fclose(fileID); celldisp(C)

Не рекомендуемый

Рекомендуемый

[date,level,x,y,answer] = textread('scan1.dat',...
    '%s %s %f %d %s',1)

filename = 'scan1.dat';
fileID = fopen(filename);
C = textscan(fileID,'%s %s %f %d %s');
fclose(fileID);
celldisp(C)

data = textread('data.csv','','delimiter',',',...
    'emptyvalue',NaN)

filename = 'data.csv';
fileID = fopen(filename);
C = textscan(fileID,'%f %f %f %f %u8 %f', ...
    'Delimiter',',','EmptyValue',NaN);
fclose(fileID);
celldisp(C)

Представлено до R2006a

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

textread

Синтаксис

Описание

Примеры

Считайте все поля в файле свободного формата

Читайте Используя литерал, чтобы проигнорировать соответствие с символами

Задайте значение, чтобы заполнить пустые ячейки

Считайте файл в Массив ячеек из символьных векторов

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

`filename` FileName
вектор символов | строковый скаляр

`format` формат
вектор символов | строковый скаляр

`N` — Число раз, чтобы считать данные
положительное целое число

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

`bufsize` — Максимальная длина вектора символов
4 095 (значений по умолчанию) | положительное целое число

`commentstyle` — Проигнорируйте символы относительно связанных символов
'MATLAB' | 'окружает' | 'c' | 'C++'

`delimiter` — Разделители между элементами
один или несколько символов

`emptyvalue` — Значение дано пустым ячейкам
0 (значений по умолчанию) | скаляр дважды

`endofline` — Символ, который обозначает конец линии
определенный из файла (значение по умолчанию) | отдельный символ | `'\r\n'`

`exchars` ExponentCharacters
`'eEdD'` (значение по умолчанию) | символы экспоненты

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

`whitespace` — Вектор из символов, которые будут обработаны как пробельный символ
`' \b\t'` (значение по умолчанию) | `' '` | `\b` | `\n` | `\r` | `\t`

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

`textread` не рекомендуется

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

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

Поддержка

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

textread

Синтаксис

Описание

Примеры

Считайте все поля в файле свободного формата

Читайте Используя литерал, чтобы проигнорировать соответствие с символами

Задайте значение, чтобы заполнить пустые ячейки

Считайте файл в Массив ячеек из символьных векторов

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

filename FileName вектор символов | строковый скаляр

format формат вектор символов | строковый скаляр

N — Число раз, чтобы считать данные положительное целое число

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

bufsize — Максимальная длина вектора символов 4 095 (значений по умолчанию) | положительное целое число

commentstyle — Проигнорируйте символы относительно связанных символов 'MATLAB' | 'окружает' | 'c' | 'C++'

delimiter — Разделители между элементами один или несколько символов

emptyvalue — Значение дано пустым ячейкам 0 (значений по умолчанию) | скаляр дважды

endofline — Символ, который обозначает конец линии определенный из файла (значение по умолчанию) | отдельный символ | '\r\n'

exchars ExponentCharacters 'eEdD' (значение по умолчанию) | символы экспоненты

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

whitespace — Вектор из символов, которые будут обработаны как пробельный символ ' \b\t' (значение по умолчанию) | ' ' | \b | \n | \r | \t

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

textread не рекомендуется

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

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

Поддержка

`filename` FileName
вектор символов | строковый скаляр

`format` формат
вектор символов | строковый скаляр

`N` — Число раз, чтобы считать данные
положительное целое число

`bufsize` — Максимальная длина вектора символов
4 095 (значений по умолчанию) | положительное целое число

`commentstyle` — Проигнорируйте символы относительно связанных символов
'MATLAB' | 'окружает' | 'c' | 'C++'

`delimiter` — Разделители между элементами
один или несколько символов

`emptyvalue` — Значение дано пустым ячейкам
0 (значений по умолчанию) | скаляр дважды

`endofline` — Символ, который обозначает конец линии
определенный из файла (значение по умолчанию) | отдельный символ | `'\r\n'`

`exchars` ExponentCharacters
`'eEdD'` (значение по умолчанию) | символы экспоненты

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

`whitespace` — Вектор из символов, которые будут обработаны как пробельный символ
`' \b\t'` (значение по умолчанию) | `' '` | `\b` | `\n` | `\r` | `\t`

`textread` не рекомендуется