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")

Параметры

filename

Имя файла как строка

string

Любая строка

Опции

String

При использовании этой опции stringlib::readText возвращает одну строку, которая содержит все содержимое файла чтения, включая разрывы строки как разделитель строк.

NoNL

С опцией NoNL возвращаемая строка не содержит разрывы строки между строками.

Separator

Опция, заданная как Separator = string

Эта опция заставляет stringlib::readText разделять все строки string вместо разрыва строки "\n".

Encoding

Эта опция позволяет вам задать кодировку символов, чтобы использовать. Позволенная кодировка:

"Big5"

"ISO-8859-1"

"windows-932"

"EUC-JP"

"ISO-8859-2"

"windows-936"

"GBK"

"ISO-8859-3"

"windows-949"

"KSC_5601"

"ISO-8859-4"

"windows-950"

"Macintosh"

"ISO-8859-9"

"windows-1250"

"Shift_JIS"

"ISO-8859-13"

"windows-1251"

"US-ASCII"

"ISO-8859-15"

"windows-1252"

"UTF-8"

 

"windows-1253"

  

"windows-1254"

  

"windows-1257"

Кодировка по умолчанию системно-зависима. Если вы задаете кодирование неправильно, символы могут читать неправильно. Символы, нераспознанные кодированием, заменяются символом замены по умолчанию для заданного кодирования.

Кодировка, не перечисленная здесь, может быть задана, но не может привести к правильным результатам.

Возвращаемые значения

Список строк или одной строки

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

Функции MuPAD

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