stringlib::readText
Чтение текстового файла
Блокноты MuPAD® будут демонтированы в будущем релизе. Используйте live скрипты MATLAB® вместо этого.
Live скрипты MATLAB поддерживают большую часть функциональности MuPAD, хотя существуют некоторые различия. Для получения дополнительной информации смотрите, Преобразуют Notebook MuPAD в Live скрипты MATLAB.
Синтаксис
stringlib::readText(filename) stringlib::readText(filename, String, <NoNL>) stringlib::readText(filename, String, <Separator = string>) stringlib::readText(..., <Encoding = "encodingValue">)
Описание
stringlib::readText(filename) читает все строки текстового файла с именем "filename" и возвращает список строк, одной строки на строку. Разрывы строки не включены в конце каждой строки. Файл должен быть текстовым файлом, в противном случае файл не может быть считан.
stringlib::readText(filename, Encoding = "encodingValue") использует заданное кодирование, чтобы считать файл. Для поддерживаемой кодировки см. Опции. Можно использовать эту опцию с ранее заданными синтаксисами.
Примеры
Пример 1
Сначала создайте текстовый файл, который может быть считан:
fprint(Unquoted, Text, "test.txt",
"This file contains three lines.\n",
"// this line is a MuPAD comment\n",
"...............................\n"):По умолчанию, stringlib::readText возвращает список всех линий:
stringlib::readText("test.txt")
Поскольку третья линия была закончена новой строкой, файл содержит четыре линии, последняя линия пуста.
Файл может быть считан как одна строка:
stringlib::readText("test.txt", String)
Когда новые строки должны быть удалены, опция NoNL может использоваться:
stringlib::readText("test.txt", String, NoNL)
В противном случае новые строки могут быть заменены другой диафрагмой:
stringlib::readText("test.txt", String, Separator = " ;; ")
Пример 2
Чтобы задать кодирование, чтобы считать данные, используйте Encoding. Encoding опция применяется только к текстовым файлам, которые открыты с помощью имени файла и не дескриптора файла. Откройте файл и строки записи в кодировании "UTF-8":
fprint(Unquoted, Text, Encoding="UTF-8", "readtext_test",
"File to test stringlib::readText\n",
"Testing to encode characters such as abcäöü"):Задайте кодирование, чтобы считать файл:
stringlib::readText("readtext_test", Encoding="UTF-8")
Если вы не задаете кодирование, системное кодирование по умолчанию используется. Таким образом ваш выход может варьироваться от показанного затем. Символы, нераспознанные системным кодированием по умолчанию, заменяются символом замены по умолчанию для того кодирования:
stringlib::readText("readtext_test")
Параметры
|
Имя файла как строка |
|
Любая строка |
Опции
|
При использовании этой опции, | ||||||||||||||||||||||||||||||
|
С опцией | ||||||||||||||||||||||||||||||
|
Опция, заданная как Эта опция вызывает | ||||||||||||||||||||||||||||||
|
Эта опция позволяет вам задать кодировку символов, чтобы использовать. Позволенная кодировка:
Кодировка по умолчанию системно-зависима. Если вы задаете кодирование неправильно, символы могут читать неправильно. Символы, нераспознанные кодированием, заменяются символом замены по умолчанию для заданного кодирования. Кодировка, не перечисленная здесь, может быть задана, но не может привести к правильным результатам. |
Возвращаемые значения
Список строк или одной строки