textread

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

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

Описание

пример

[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 парные аргументы, в дополнение к любому из входных параметров в предыдущих синтаксисах.

Примеры

свернуть все

Первая строка выборочных данных, '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'}

Первая строка выборочных данных, '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'}

Для файлов с пустыми ячейками используйте 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

Считайте файл 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.'   }

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

свернуть все

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

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

формат

Действие

Вывод

Литералы

(обычные символы)

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

'none'

%d

Считайте значение целого числа со знаком.

Двойной массив

%u

Считайте целочисленное значение.

Двойной массив

%f

Считайте значение с плавающей точкой.

Двойной массив

%s

Считайте пробел или разделенный от разделителя текст.

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

%q

Считайте дважды заключенный в кавычки текст, игнорируя кавычки.

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

%c

Считайте символы, включая пробел.

Массив символов

%[...]

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

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

%[^...]

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

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

%*...
вместо %

Проигнорируйте соответствующие символы, заданные *.

'none'

W...
вместо %

Считайте ширину поля, заданную w. %f формат поддерживает %w.pf, где w ширина поля и p точность.

 

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

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

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

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

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

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

Значение

Поведение

'matlab'

Игнорирует символы после %.

'shell'

Игнорирует символы после #.

'c'

Игнорирует символы между /* и */.

'c++'

Игнорирует символы после //.

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

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

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

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

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

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

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

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

Значение

Поведение

' '

Пробел

\b

Клавиша Backspace

\n

Новая строка

\r

Возврат каретки

\t

Горизонтальная табуляция

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

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

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

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

| | |

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