Exponenta Banner
exponenta event banner

readlines

Считывание строк файла в виде строкового массива

свернуть все на странице

    Синтаксис

    S = readlines (имя файла)
    S = readlines (имя файла, имя, значение)

    Описание

    пример

    S = readlines(filename) создает N-by-1 строковый массив путем чтения файла N-строки.

    пример

    S = readlines(filename,Name,Value) создает строковый массив из файла с дополнительными параметрами, заданными одним или несколькими аргументами пары имя-значение. Например, 'EmptyLineRule','skip' пропускает пустые строки.

    Примеры

    свернуть все

    Открыть сценарий в реальном времени

    Создайте массив строк 4 на 1, прочитав каждую строку из текстового файла в виде отдельной строки.

    lines = readlines("badpoem.txt")
    lines = 4x1 string
    "Oranges and lemons,"
    "Pineapples and tea."
    "Orangutans and monkeys,"
    "Dragonflys or fleas."
    Открыть сценарий в реальном времени

    Просмотр содержимого файла capital_cities.txt.

    type 'capital_cities.txt'
      Boston, Massachusetts

Albany, New York

  Sacramento, California

Columbus, Ohio

  Santa Fe, New Mexico

    Создание массива строк 5 на 1 путем пропуска пустых строк при чтении capital_cities.txt. Массив по-прежнему содержит символы пробела из входных данных, но не пустые строки.

    lines = readlines("capital_cities.txt","EmptyLineRule","skip")
    lines = 5x1 string
    "  Boston, Massachusetts"
    "Albany, New York"
    "  Sacramento, California"
    "Columbus, Ohio"
    "  Santa Fe, New Mexico"
    Открыть сценарий в реальном времени

    Просмотр содержимого файла capital_cities.txt.

    type 'capital_cities.txt'
      Boston, Massachusetts

Albany, New York

  Sacramento, California

Columbus, Ohio

  Santa Fe, New Mexico

    Укажите значение 'WhitespaceRule' как 'trimleading' для удаления пробела перед каждой строкой текста. Массив больше не содержит начальных символов пробела из входных данных, но сохраняет пустые строки.

    lines = readlines("capital_cities.txt","WhitespaceRule","trimleading")
    lines = 10x1 string
    "Boston, Massachusetts"
    ""
    "Albany, New York"
    ""
    "Sacramento, California"
    ""
    "Columbus, Ohio"
    ""
    "Santa Fe, New Mexico"
    ""

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

    свернуть все

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

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

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

    Форма

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

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

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

    Файл в папке

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

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

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

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

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

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

    Удаленное расположение

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

    scheme_name://path_to_file/my_file.ext

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

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

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

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

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

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

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

    Пример: 'EmptyLineRule','skip' указывает пропускать пустые строки при импорте файла.

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

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

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

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

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

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

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

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

    Процедура обработки пробела, окружающего строку в данных, указанная как 'preserve', 'trim', 'trimleading', или 'trimtrailing'.

    Правило пробела

    Поведение

    'preserve'Сохраните ведущее и заключительное пробелы.
    'trim'Удалите начальный и конечный пробелы.
    'trimleading'Удалите только ведущее пробельное пространство.
    'trimtrailing'Удалите только заключительное пробельное пространство.

    Пример: 'WhitespaceRule','trim'

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

    Процедура обработки пустых строк в данных, указанных как 'skip', 'read', или 'error'.

    Правило пустых строк

    Поведение

    'read'

    Импортируйте пустые строки.

    'skip'

    Пропустите пустые строки.

    'error'Вывод сообщения об ошибке и прекращение операции импорта.

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

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

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

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

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

    См. также

    | | |

    Представлен в R2020b

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

    Поддержка