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