Описание

import::csv используется, чтобы считать CSV (“Запятая Разделенные Значения” или “Символьные Разделенные Значения”) файлы данных, произведенные внешними программами, как Microsoft^® Excel^®. CSV является основанным на ASCII форматом файла табличных данных, официально заданным в RFC 4180, которому разделил поля символ запятой.

import::csv(filename) считывает данные в файле filename. Данные о файле, разделенные запятой, рассматриваются как различные элементы данных. Результатом является список списков, каждого подсписка, представляющего одну строку файла.

import::csv(filename, separator) считывает данные в файле filename. Данные о файле, разделенные символьным separator, рассматриваются как различные элементы данных. Результатом является список списков, каждого подсписка, представляющего одну строку файла.

import::csv(filename, separator, NonNested) считывает данные в файле filename как одна запись данных. Данные о файле, разделенные символьным separator, рассматриваются как различные элементы данных. Результатом является невложенный список плоскости, содержащий данные всех строк файла.

В отличие от finput, данные не должны быть закончены двоеточием или точкой с запятой. Данные, разделенные separator, интерпретированы как один элементы данных. Разделитель по умолчанию является запятой.

Проигнорированы пустые строки.

Все элементы данных в файле, который не может быть преобразован в допустимые числа MuPAD^®, импортируются как строки MuPAD.

import::csv пытается преобразовать номер, содержавшийся в файле CSV к допустимому номеру MuPAD. Например: 1,234.56 или 1 234.56 преобразованы в MuPAD номер 1234.56. Много стран используют запятую, чтобы разделить неотъемлемую и дробную часть вместо точки, используемой в Англии и США. Например: 1234,56 или 1.234,56 преобразованы в 1 234,56. import::csv ожидает этот числовой формат, если опция DecimalComma будет дана.

С NonNested результатом будет список, содержащий все данные. В противном случае результатом является список списка, каждого “внутреннего” списка, представляющего строку файла CSV.

С Trim удалены начальные и конечные пробелы в строках.

Если файл задан строкой, соответствующий файл открыт и закрыт, автоматически. Если пользователь открыл текстовый файл в режиме Read и передает дескриптор файла, чтобы импортировать:: readdata, файл остается открытым и должен быть закрыт пользователем.

Файлы, сжатые с gzip или в совместимом формате, чей конец имен в “.gz”, автоматически распаковываются, будучи считанным import::csv.

import::csv(filename) ищет файл в различных директориях:

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

Обратите внимание на то, что значение “рабочей директории” зависит от операционной системы. В системах Microsoft Windows^® и в Apple Mac OS X систем, “рабочая директория” является папкой, где MuPAD установлен. В системах UNIX^® это - текущая рабочая директория, в которой был запущен MuPAD; когда запущено с меню или настольного элемента, это обычно - корневой каталог пользователя.

Разделитель пути (“/”) вставляется по мере необходимости при конкатенации данного пути и filename.

Если файл задан именем файла, нет никакой потребности открыть или закрыть файл через fopen и fclose, соответственно. Это сделано автоматически import::readdata.

Вместо имени файла также может использоваться дескриптор файла файла, открытого через fopen. Обратите внимание на то, что файл, должно быть, был открыт в режиме Read fopen. Если дескриптор файла используется, соответствующий файл не закрывается автоматически, но должен быть закрыт пользователем через fclose.