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