Classdef: Difference between revisions

256 bytes added ,  22 April 2019
no edit summary
(removed fixed bug reports: #45351 (function handles),)
No edit summary
Line 1: Line 1:
This page is a stub. We should begin documenting what classdef is implemented and what is not.
=== Features that are not implemented ===


=== Not Supported ===
* '''enumeration'''


* '''enumeration'''
Octave should be able to parse the enumeration section of a classdef definition but nothing is done with it.  Progress on this feature is tracked in bug report {{bug|44582}}.
 
* '''events and listeners'''


See {{bug|44582}} and help implementing it.
Octave should be able to parse the events section of a classdef definition but nothing is done with it.  Progress on this feature is tracked in bug report {{bug|56194}}.


* '''built-in class as superclass'''


* '''build-in class as superclass'''
Octave does not allow subclassing built-in classes.  In Matlab, classdef objects may subclass built-in integer, floating point, and logical types.  For example,
<source lang="octave">
<source lang="octave">
classdef nonsense < uint32
classdef nonsense < uint32
 
  ...
end
end
</source>
</source>


See {{bug|44035}}
does not work.
 
Progress on this feature is tracked in bug report {{bug|44035}}.
 
* '''concatenation of classdef objects'''


* '''[http://www.mathworks.com/help/matlab/matlab_oop/redefining-concatenation-for-your-class.html concatenating objects] into [http://www.mathworks.com/help/matlab/matlab_oop/initialize-object-arrays.html array of objects].'''
Octave does not support concatenation of classdef objects to create classdef array objects.


Example:
Example:
<source lang="octave">
<source lang="octave">
classdef MyClass < handle
classdef MyClass < handle
Line 33: Line 42:
</source>
</source>


Also see {{bug|44665}}
Progress on this feature is tracked in bug report {{bug|44665}}.


* '''[http://www.mathworks.com/help/matlab/matlab_oop/mutable-and-immutable-properties.html Immutable property] set access.'''
* '''Saving and loading classdef objects'''
Example:
<source lang="octave">
classdef MyClass < handle
    properties (SetAccess = immutable)
        x
    end
    methods
        function obj = MyClass()
            x = rand();
        end
    end
end
</source>


Use "private" properties as workaround.
Saving and loading classdef objects is not supported.


Progress on this feature is tracked in bug report {{bug|45833}}


* '''Defining [http://www.mathworks.com/help/matlab/matlab_oop/specifying-methods-and-functions.html#br2la89 local functions] in the same classdef-file is not working.'''
=== Supported ===
For example, the following code gives a syntax/parse error:
<source lang="octave">
classdef MyClass
    methods
        function obj = MyClass()
            myfunc()
        end
    end
end


function myfunc()
* Methods
    disp('myfunc')
end
</source>


See {{bug|41723}}.
Classdef methods are supported but not all attributes are fully implemented.


* '''debugging in classdef methods (and +package directory functions)'''
{| class="wikitable"
|-
! style="text-align:left;"| Attribute
! Support
! Notes
|-
|Abstract
|Partial
|See bug report {{bug|51377}}
|-
|Access
|Yes
|
|-
|Hidden
|Yes
|
|-
|Sealed
|Yes
|
|-
|Static
|Yes
|
|}


Breakpoints cannot currently be set in classdef methods from the gui, but only from the command line:
* Properties
<source lang="octave">
dbstop @aclass\amethod
</source>
 
See {{bug|45404}}
 
* '''Saving/reading classdef objects to/from (.mat) file'''
 
=== Supported ===


* methods
Classdef properties are supported but not all attributes are implemented.
** static
** private


* properties
{| class="wikitable"
** SetAccess (public/private/protected)
|-
! style="text-align:left;"| Attribute
! Support
! Notes
|-
|AbortSet
|No
|Property does not exist.
|-
|Abstract
|Yes
|
|-
|Access
|Partial
|
|-
|Constant
|Yes
|
|-
|Dependent
|Partial
|
|-
|GetAccess
|Partial
|
|-
|GetObservable
|No
|Property exists but is not used.
|-
|Hidden
|Yes
|
|-
|NonCopyable
|No
|Property does not exist.
|-
|SetAccess
|Partial
|
|-
|SetObservable
|No
|Property exists but is not used.
|-
|Transient
|No
|Property exists but is not used.
|}


=== Open Bug Reports ===
=== Open Bug Reports ===