Создайте справку для классов

Текст справки из команды doc

Когда вы используете doc команда для отображения справки по классу, MATLAB^® автоматически отображает информацию, полученную из определения класса.

Например, создайте файл определения класса с именем someClass.m с несколькими свойствами и методами, как показано.

classdef someClass
    % someClass Summary of this class goes here
    %   Detailed explanation goes here
    
    properties
        One     % First public property
        Two     % Second public property
    end
    properties (Access=private)
        Three   % Do not show this property
    end
      
    methods
        function obj = someClass
            % Summary of constructor
        end
        function myMethod(obj)
            % Summary of myMethod
            disp(obj)
        end
    end
    methods (Static)
        function myStaticMethod
            % Summary of myStaticMethod
        end
    end
    
end

Просмотрите текст справки и подробности из определения класса с помощью doc команда.

doc someClass

Пользовательский текст справки

Можно добавить информацию о классах, которые оба doc команда и help включить команду в свои отображения. The doc команда отображает текст справки в верхней части сгенерированного HTML, над информацией, полученной из определения класса. The help команда отображает текст справки в Командном окне. Для получения дополнительной информации смотрите:

Классы
Методы
Свойства
Перечисления
События

Классы

Создайте текст справки для классов, включив комментарии в линии сразу после classdef оператор в файле. Например, создайте файл с именем myClass.m, как показано.

classdef myClass
    % myClass   Summary of myClass
    % This is the first line of the description of myClass.
    % Descriptions can include multiple lines of text.
    %
    % myClass Properties:
    %    a - Description of a
    %    b - Description of b
    %
    % myClass Methods:
    %    doThis - Description of doThis
    %    doThat - Description of doThat

    properties
        a
        b
    end
    
    methods
        function obj = myClass
        end
        function doThis(obj)
        end
        function doThat(obj)
        end
    end
    
end

Списки и описания свойств и методов в исходном блоке комментариев являются необязательными. Если вы включаете строки с комментариями, содержащие имя класса и далее Properties или Methods и двоеточие (:), затем MATLAB создает гиперссылки на справку для свойств или методов.

Просмотрите текст справки для класса в Командном окне используя help команда.

help myClass

  myClass   Summary of myClass
  This is the first line of the description of myClass.
  Descriptions can include multiple lines of text.
 
  myClass Properties:
     a - Description of a
     b - Description of b

  myClass Methods:
     doThis - Description of doThis
     doThat - Description of doThat

Методы

Создайте справку для метода, вставив комментарии сразу после оператора определения функции. Для примера измените файл определения класса myClass.m для включения справки по doThis способ.

       function doThis(obj)
        % doThis  Do this thing
        %   Here is some help text for the doThis method.
        %
        %   See also DOTHAT.
        
        disp(obj)
        end

Просмотрите текст справки для метода в Командном окне с помощью help команда. Задайте и имя класса, и имя метода, разделенные точкой.

help myClass.doThis

  doThis  Do this thing
    Here is some help text for the doThis method.

    See also doThat.

Свойства

Существует два способа создать справку для свойств:

Вставьте строки с комментариями над определением свойства. Используйте этот подход для многострочного текста справки.
Добавить однострочный комментарий рядом с определением свойства.

Комментарии выше определения имеют приоритет над комментарием рядом с определением.

Для примера измените определения свойств в файле определения класса myClass.m.

    properties
        a          % First property of myClass

        % b - Second property of myClass
        % The description for b has several 
        % lines of text.
        b          % Other comment
    end

Просмотрите справку по свойствам в Командном окне используя help команда. Задайте как имя класса, так и имя свойства, разделенное точкой.

help myClass.a

 a -  First property of myClass

help myClass.b

  b - Second property of myClass
  The description for b has several 
  lines of text.

Перечисления

Как и свойства, существует два способа создать справку для перечислений:

Вставьте строки с комментариями над определением перечисления. Используйте этот подход для многострочного текста справки.
Добавить однострочный комментарий рядом с определением перечисления.

Комментарии выше определения имеют приоритет над комментарием рядом с определением.

Например, создайте класс перечисления в файле с именем myEnumeration.m.

classdef myEnumeration
    enumeration
        uno,         % First enumeration

        % DOS - Second enumeration
        % The description for DOS has several 
        % lines of text.
        dos          % A comment (not help text)
    end
end

Просмотрите справку в Командном окне используя help команда. Задайте как имя класса, так и представитель перечисления, разделенный точкой.

help myEnumeration.uno

uno -  First enumeration

help myEnumeration.dos

  dos - Second enumeration
  The description for dos has several 
  lines of text.

События

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

Вставьте строки с комментариями над определением события. Используйте этот подход для многострочного текста справки.
Добавьте однострочный комментарий рядом с определением события.

Комментарии выше определения имеют приоритет над комментарием рядом с определением.

Например, создайте класс в файле с именем hasEvents.m.

classdef hasEvents < handle
   events
       Alpha     % First event

       % Beta - Second event
       % Additional text about second event.
       Beta      % (not help text)
   end
   
   methods
       function fireEventAlpha(h)
           notify(h,'Alpha')
       end
       
       function fireEventBeta(h)
           notify(h,'Beta')
       end
   end
end

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

help hasEvents.Alpha

 Alpha -  First event

help hasEvents.Beta

  Beta - Second event
  Additional text about second event.

См. также

doc | help

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