Документация

Определения классов на пути

Чтобы вызвать метод класса, определение класса должно быть на пути MATLAB^®, как описано в следующих разделах.

Папки Class и Path

Существует два типа папок, которые могут содержать файлы определения класса.

Смотрите path функция для получения информации о пути MATLAB.

Используя папки пути

Папки, которые содержат файлы определения класса, находятся на пути MATLAB. Поэтому определения классов, помещенные в папки пути, ведут себя как любая обычная функция относительно приоритета — первое вхождение имени на пути MATLAB более приоритетно по сравнению со всеми последующими случаями того же имени.

Имя каждого файла определения класса должно совпадать с именем класса, который задан с classdef ключевое слово. Используя папку path избавляет от необходимости создавать отдельную папку класса для каждого класса. Однако целое определение класса, включая все методы, должно содержаться в одном файле.

Предположим, что у вас есть три класса, заданные в одной папке:

.../path_folder/MyClass1.m
.../path_folder/MyClass2.m
.../path_folder/MyClass3.m

Чтобы использовать эти классы, добавьте path_folder к вашему пути MATLAB:

addpath path_folder

Используя папки класса

Имя папки класса всегда начинается с @ символ, сопровождаемый именем класса для имени папки. Папка класса должна содержаться в папке path, но папка класса не находится на пути MATLAB. Поместите файл определения класса в папке класса, которая также может содержать файлы отдельного метода. Файл определения класса должен иметь то же имя как папка класса (без @ символ.

.../parent_folder/@MyClass/MyClass.m
.../parent_folder/@MyClass/myMethod1.m
.../parent_folder/@MyClass/myMethod2.m

Задайте только один класс на папку. Все файлы имеют .m или .p расширение. Для версий MATLAB R2018a и позже, автономные методы могут быть live функциями с .mlx расширение.

Используйте папку класса, когда это необходимо, чтобы использовать больше чем один файл для вашего определения класса. MATLAB обрабатывает любой файл функции в папке класса как метод класса. Файлами функции может быть код MATLAB (.m), формат файла Живого кода (.mlx), MEX-функции (зависимые расширения платформы), и Pcode-файлы (.p).

MATLAB явным образом идентифицирует любой файл в папке класса как метод того класса. Это позволяет вам использовать более модульный подход к авторским методам вашего класса.

Базовое имя каждого файла должно быть допустимым именем функции MATLAB. Допустимые имена функций начинаются с буквенного символа и могут содержать буквы, числа или символы нижнего подчеркивания. Для получения дополнительной информации см. Методы в Отдельных Файлах.

Функции в частных папках в папках класса

Частные папки содержат функции, которые сразу доступны только от функций, определяемых в папках выше private папка. Любые функции, определяемые в private папка в папке класса может только быть названа из методов класса. Функции имеют доступ к членам парламента, не занимающим официального поста класса, но не являются самостоятельно методами. Они не требуют, чтобы объект был передан как вход, и могут только быть названы с помощью функционального обозначения. Используйте функции в private папки, когда вам нужны функции помощника, которые могут быть вызваны из нескольких методов вашего класса.

Если папка класса содержит private папка, только класс, заданный в той папке, может функции доступа, заданные в private папка. Подклассы не имеют доступа к закрытым функциям суперкласса. Для получения дополнительной информации о частных папках смотрите Закрытые функции.

Если вы хотите, чтобы подкласс имел доступ к закрытым функциям суперкласса, задайте функции как защищенные методы суперкласса. Задайте методы с Access припишите набор protected.

Приоритет класса и путь MATLAB

Когда существует несколько определений классов с тем же именем, расположение файла на пути MATLAB определяет приоритет. Определение класса в папке, которая на первом месте на пути MATLAB всегда, более приоритетно по сравнению с любыми классами, которые являются позже путем, содержатся ли определения в папке класса.

Функция с тем же именем как класс в папке path более приоритетна по сравнению с классом, если функция находится в папке, которая является раньше путем. Однако класс, заданный в папке класса (-папка), более приоритетен по сравнению с функцией того же имени, даже если функция задана в папке, которая является раньше путем.

Например, рассмотрите путь со следующими папками и файлами.

MATLAB применяет эту логику, чтобы определить который версия Foo вызывать:

Класс fldr1/Foo.m более приоритетен по сравнению с классом fldr3/@Foo потому что:

Класс fldr3/@Foo более приоритетен по сравнению с функциональным fldr2/Foo.m потому что:

Функциональный fldr2/Foo.m более приоритетен по сравнению с классом fldr5/Foo.m потому что:

Класс fldr3/@Foo более приоритетен по сравнению с fldr4/@Foo потому что:

Если fldr3/@Foo/Foo.m содержит класс MATLAB, созданный перед Версией 7.6 (то есть, класс не использует classdef ключевое слово), затем fldr4/@Foo/bar.m становится методом Foo класс задан в fldr3/@Foo.

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

MATLAB может только распознать одно определение класса как текущее определение. Изменение вашего пути MATLAB может изменить файл определения для класса (см. path). Если никакие экземпляры старого определения не существуют (то есть, определение, которое является более не первым на пути), MATLAB сразу распознает новую папку текущим определением. Если, однако, у вас есть существующий экземпляр класса прежде, чем изменить путь, ли использование MATLAB, определение в новой папке зависит от того, как новый класс был задан. Если новое определение задано в папке класса, MATLAB сразу распознает новую папку текущим определением класса. Однако для классов, которые заданы в папках пути (то есть, не в классе @ папки), необходимо очистить класс, прежде чем MATLAB распознает новую папку текущим определением класса.

fldA/@Foo/Foo.m
fldB/@Foo/Foo.m

addpath fldA

a = Foo;

cd fldB

b = Foo;

fldA/Foo.m
fldB/Foo.m

addpath fldA

a = Foo;

cd fldB

clear Foo