% PARAM Parameter object class constructor.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% DESCRIPTION: PARAM Parameter object class constructor.
%              Create a parameter object.
%
% SUPERCLASSES: ltpda_nuo < ltpda_obj
%
% CONSTRUCTORS:
%
%       p = param();                - creates an empty parameter
%       p = param(pl)               - creates a parameter from a
%                                     parameter list with the parameters:
%                                   - 'key' and 'val', or
%       p = param('key', val)       - creates a key/value pair
%                                     'val' can be from any type
%       p = param({key, desc}, val) - creates a key/value pair and a
%                                     description for the key
%       p = param('key', val, desc) - creates a key/value pair and a
%                                     description for the key
%
% VERSION:  $Id: param.m,v 1.72 2011/03/28 17:02:28 ingo Exp $
%
% SEE ALSO: ltpda_obj, ltpda_nuo, plist
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

classdef (Sealed = true, Hidden = true) param < ltpda_nuo
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                            Property definition                            %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  %---------- Public (read/write) Properties  ----------
  properties
  end
  
  %---------- Protected read-only Properties ----------
  properties (SetAccess = protected)
    key     = '';   % key of the key/value pair
    val     = [];   % value of the key/value pair
    desc    = '';   % description of the key/value pair
  end
  
  %---------- Protected Properties ----------
  properties (SetAccess = protected)
  end
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                          Check property setting                           %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  methods
    function set.key(obj, val)
      if ischar(val)
        obj.key = upper(val);
      else
        error('### The value for the property ''key'' must be a string\n### but it is from the class %s', class(val));
      end
    end
  end
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                                Constructor                                %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  methods
    function obj = param(varargin)
      
      switch nargin
        case 0
          %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
          %%%%%%%%%%%%%%%%%%%%%%%%%%%   no input   %%%%%%%%%%%%%%%%%%%%%%%%%%%%
          %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
          
          % Do nothing
          
        case 1
          %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
          %%%%%%%%%%%%%%%%%%%%%%%%%%%   one input   %%%%%%%%%%%%%%%%%%%%%%%%%%%
          %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
          
          if isa(varargin{1}, 'param')
            %%%%%%%%%%  obj = param(param)   %%%%%%%%%%
            obj = copy(varargin{1}, 1);
            
          elseif isa(varargin{1}, 'plist')
            %%%%%%%%%%  obj = param(plist)   %%%%%%%%%%
            
            if nparams(varargin{1}) == 0
              %%%%%%%%%%  obj = param(plist())   %%%%%%%%%%
              %%%%%%%%%%  obj = param(plist('KEY', 'a', 'VAL', 1))   %%%%%%%%%%
              %%% is the plist is empty then return an empty param object
              
            else
              pl = varargin{1};
              pl_key  = find(pl, 'key');
              pl_val  = find(pl, 'val');
              pl_desc = find(pl, 'desc');
              if isempty(pl_key)
                error('### building a parameter from a plist requires one parameter in the plist is called ''key''');
              end
              if isempty(pl_val)
                error('### building a parameter from a plist requires one parameter in the plist is called ''val''');
              end
              
              obj.key  = pl_key;
              obj.val  = pl_val;
              if ~isempty(pl_desc)
                if ~ischar(pl_desc)
                  error('### The description of a parameter must be a string but it is from the class [%s]', class(pl_desc));
                end
                obj.desc = pl_desc;
              end
            end
            
          elseif isstruct(varargin{1})
            %%%%%%%%%%  obj = param(struct)   %%%%%%%%%%
            obj = fromStruct(obj, varargin{1});
            
          else
            error('### unknown constructor type for param object.');
          end
          
        case 2
          %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
          %%%%%%%%%%%%%%%%%%%%%%%%%%%   two inputs   %%%%%%%%%%%%%%%%%%%%%%%%%%
          %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
          if iscell(varargin{1})
            %%%%%%%%%%  obj = param({'key', 'desc'}, ...)   %%%%%%%%%%
            obj.key = varargin{1}{1};
            if ischar(varargin{1}{2});
              obj.desc = varargin{1}{2};
            else
              error('### The description of a parameter must be a string but it is from the class [%s]', class(varargin{1}{2}));
            end
            
          elseif isa(varargin{1}, 'org.apache.xerces.dom.DeferredElementImpl')
            %%%%%%%%%%   obj = param(DOM node, history-objects)   %%%%%%%%%%
            obj = fromDom(obj, varargin{1}, varargin{2});
            return
            
          else
            %%%%%%%%%%  obj = param('key', ...)   %%%%%%%%%%
            obj.key = varargin{1};
          end
          
          if  iscell(varargin{2})       && ...
              numel(varargin{2}) == 3   && ...
              isnumeric(varargin{2}{1}) && ...
              iscell(varargin{2}{2}) && ...
              isnumeric(varargin{2}{3})
            %%%%%%%%%%  obj = param(..., {idx2options, {options}, selectionMode})   %%%%%%%%%%
            %%%%%%%%%%  example: param(..., {1, {1 2 3}, 0})   %%%%%%%%%%
            %%%%%%%%%%  example: param(..., {1, {'a' 'b' 'c'}, 0})   %%%%%%%%%%
            obj.val = paramValue(varargin{2}{1}, varargin{2}{2}, varargin{2}{3});
            
          else
            obj.val = varargin{2};
          end
          
        case 3
          %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
          %%%%%%%%%%%%%%%%%%%%%%%%%%   three inputs   %%%%%%%%%%%%%%%%%%%%%%%%%
          %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
          obj.key  = varargin{1};
          obj.val  = varargin{2};
          if ischar(varargin{3})
            obj.desc = varargin{3};
          else
            error('### The description of a parameter must be a string but it is from the class [%s]', class(varargin{1}{2}));
          end
          
        otherwise
          error('### Unknown number of arguments.');
      end
      
    end
  end
  
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                              Methods (public)                             %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  methods
    varargout = mux(varargin);
    varargout = string(varargin)
    
    %%% Define Abstract methods
    varargout = char(varargin)
    varargout = copy(varargin)
    varargout = display(varargin)
    
    varargout = setKey(varargin)
    varargout = setVal(varargin)
    varargout = setDesc(varargin)
    varargout = setKeyVal(varargin)
    
    varargout = getVal(varargin)
    varargout = getDefaultVal(varargin)
    varargout = getOptions(varargin)
    
    varargout = setProperty(varargin)
    varargout = getProperty(varargin)
    
    p = setDefaultOption(p, option)
    p = setDefaultIndex(p, index)
  end
  
  methods (Hidden = true)
    varargout = attachToDom(varargin)
  end
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                              Methods (protected)                          %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  methods (Access = protected)
    varargout = fromStruct(varargin)
    varargout = fromDom(varargin)
  end
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                              Methods (private)                            %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  methods (Access = private)
  end
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                          Methods (Static, Public)                         %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  methods (Static = true)
    
    function out = VEROUT()
      out = '$Id: param.m,v 1.72 2011/03/28 17:02:28 ingo Exp $';
    end
    
    function ii = getInfo(varargin)
      ii = utils.helper.generic_getInfo(varargin{:}, 'param');
    end
    
    function out = SETS()
      out = {'Default'};
    end
    
    function out = getDefaultPlist(set)
      switch lower(set)
        case 'default'
          out = plist();
        otherwise
          error('### Unknown set [%s]', set');
      end
    end
    
    function obj = initObjectWithSize(n,m)
      obj = param.newarray([n m]);
    end
    
  end
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                          Methods (Static, Private)                        %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  methods (Static = true, Access = private)
  end
  
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  %                         Methods (static, hidden)                          %
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
  methods (Static = true, Hidden = true)
    varargout = loadobj(varargin)
    varargout = update_struct(varargin)
  end
  
end