protocol

Создайте протокол сеанса

Блокноты MuPAD® будут демонтированы в будущем релизе. Используйте live скрипты MATLAB® вместо этого.

Live скрипты MATLAB поддерживают большую часть функциональности MuPAD, хотя существуют некоторые различия. Для получения дополнительной информации смотрите, Преобразуют Notebook MuPAD в Live скрипты MATLAB.

Синтаксис

protocol(filename | n, <InputOnly | OutputOnly>)
protocol()

Описание

protocol(file) запускает протокол текущего терминального сеанса MuPAD®.

protocol() останавливает протокол.

protocol пишет протокол входных команд и соответствующего MuPAD выход терминального сеанса к текстовому файлу.

Когда используется от MuPAD Notebook, protocol отключен и повышает ошибку.

Файл может быть задан непосредственно его именем. Это или создает новый файл или перезаписывает существующий файл. protocol открывает и закрывает файл автоматически.

Если имя файла заканчивается в “.gz”, MuPAD запишет gzip- сжатый текстовый файл.

Если WRITEPATH не имеет значения, protocol интерпретирует имя файла как путь относительно “рабочей директории”.

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

Также абсолютные пути обрабатываются protocol.

В качестве альтернативы файл может быть задан дескриптором файла n. В этом случае файл, должно быть, был открыт через fopen(Text, filename, Write) или fopen(Text, filename, Append). Это возвращает дескриптор файла как целочисленный n. Обратите внимание на то, что fopen(filename) открывает файл в режиме только для чтения. Последующий protocol команда к этому файлу вызывает ошибку.

Файл не закрывается автоматически protocol() и должен быть закрыт последующим вызовом fclose.

Вызов protocol без аргументов отключает под управлением протокол и закрывает соответствующий файл, если он был открыт protocol. Закрытие файла протокола с fclose также отключает протокол.

Если новый протокол запускается, в то время как протокол запускается, то старый отключен, и соответствующий файл закрывается.

Взаимодействия среды

Функция чувствительна к переменной окружения WRITEPATH. Если эта переменная имеет значение, то файл протокола создается в соответствующей директории. В противном случае файл создается в “текущей рабочей директории”.

Примеры

Пример 1

Мы открываем текстовый файл test в режиме записи с fopen:

n := fopen(Text, "test", Write):

Протокол записан в этот файл:

protocol(n):
1 + 1, a/b;
solve(x^2 = 2);
protocol():
fclose(n):

Файл теперь имеет следующее содержимое:

1 + 1, a/b;

     a
  2, -
     b
solve(x^2 = 2);

         1/2           1/2
  {[x = 2   ], [x = - 2   ]}
protocol():

Пример 2

Файл протокола открыт непосредственно protocol. Только вход протоколируется:

protocol("test", InputOnly):
1 + 1, a/b;
solve(x^2 = 2);
protocol():

Файл теперь имеет следующее содержимое:

1 + 1, a/b;
solve(x^2 = 2);
protocol():

Пример 3

Файл протокола открыт непосредственно protocol. Только выход протоколируется:

protocol("test", OutputOnly):
1 + 1, a/b;
solve(x^2 = 2);
protocol():

Файл теперь имеет следующее содержимое:


     a
  2, -
     b

         1/2           1/2
  {[x = 2   ], [x = - 2   ]}

Параметры

filename

Имя файла: символьная строка

n

Дескриптор файла обеспечивается fopen: положительное целое число

Опции

InputOnly

Только вход протоколируется

Файл протокола только содержит входные линии. Весь выход не использован.

OutputOnly

Только выход протоколируется

Файл протокола только содержит выходные линии. Весь вход не использован.

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

Пустой объект типа DOM_NULL.

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

Функции MuPAD