Matlab >= R2020b

Author: scivision

+stdlib/Backend.m

@@ -24,17 +24,9 @@
 methods
 
 function self = Backend(functionName, backendReq)
-% arguments
-%   functionName (1,1) string = ""
-%   backendReq (1,:) string = string.empty
-% end
-if nargin < 1
-  functionName = "";
-end
-if nargin < 2
-  backendReq = string.empty;
-else
-  backendReq = string(backendReq);
+arguments
+  functionName (1,1) string = ""
+  backendReq (1,:) string = string.empty
 end
 
 if isempty(backendReq) || ~isscalar(backendReq)
@@ -54,19 +46,11 @@
 
 
 function backendAvailable = select(self, functionName, backendReq, firstOnly)
-% arguments
-%   self
-%   functionName (1,1) string
-%   backendReq (1,:) string = string.empty
-%   firstOnly (1,1) logical = false
-% end
-if nargin < 3
-  backendReq = string.empty;
-else
-  backendReq = string(backendReq);
-end
-if nargin < 4
-  firstOnly = false;
+arguments
+  self
+  functionName (1,1) string
+  backendReq (1,:) string = string.empty
+  firstOnly (1,1) logical = false
 end
 
 backendAvailable = string.empty;
@@ -151,15 +135,10 @@
 
 
 function func = getFunc(self, functionName, backendReq)
-% arguments
-%   self
-%   functionName (1,1) string
-%   backendReq (1,:) string = string.empty
-% end
-if nargin < 3
-  backendReq = string.empty;
-else
-  backendReq = string(backendReq);
+arguments
+  self
+  functionName (1,1) string
+  backendReq (1,:) string = string.empty
 end
 
 if isscalar(backendReq)

+stdlib/absolute.m

@@ -16,8 +16,9 @@
 % non-existant path is made absolute relative to pwd
 
 function c = absolute(p, base)
-if nargin < 2
-  base = pwd();
+arguments
+  p {mustBeTextScalar}
+  base {mustBeTextScalar} = pwd()
 end
 
 if stdlib.is_absolute(p)
@@ -48,5 +49,3 @@
 end
 
 end
-
-%!assert(~isempty(stdlib.absolute('')))

+stdlib/allToolboxes.m

@@ -1,5 +1,5 @@
 %% ALLTOOLBOXES tell all the Matlab toolboxes known for this Matlab release
-% requires: java, Matlab >= R2018a
+% requires: java
 
 function names = allToolboxes()
 

+stdlib/append.m

@@ -2,27 +2,21 @@
 % APPEND(S1, S2, ...) appends strings or character vectors S1, S2, ... together.
 % the output is a scalar string or character vector
 %
-% builtin append() is for Matlab >= R2019a, while this works back to R2016b.
 % strcat() has the side effect of trimming whitespace, so we prefer
 % stdlib.append() for string concatenation in case a user path has trailing whitespace.
 
-function s = append(txt, varargin)
-
-s = string(txt);
-
-if stdlib.matlabOlderThan('R2019a')
-  for i = 1:numel(varargin)
-    s = s + varargin{i};
-  end
-else
-  s = s.append(varargin{:});
+function s = append(txt, a)
+arguments
+  txt {mustBeTextScalar}
+end
+arguments (Repeating)
+  a {mustBeText}
 end
 
-if ischar(txt) && all(cellfun(@ischar, varargin))
+s = string(txt).append(a{:});
+
+if ischar(txt) && all(cellfun(@ischar, a))
   s = char(s);
 end
 
 end
-
-
-%!assert(stdlib.append('a','b'), 'ab')

+stdlib/auto_chunk_size.m

@@ -7,9 +7,9 @@
 % * dims: proposed dataset dimensions (like size())
 
 function csize = auto_chunk_size(dims)
-% arguments
-%   dims (1,:) {mustBeInteger,mustBePositive}
-% end
+arguments
+  dims (1,:) {mustBeInteger,mustBePositive}
+end
 
 CHUNK_BASE = 16000;  % Multiplier by which chunks are adjusted
 CHUNK_MIN = 8000;    % lower limit: 8 kbyte

+stdlib/canonical.m

@@ -13,8 +13,9 @@
 % * c: canonical path, if determined
 
 function c = canonical(file, strict)
-if nargin < 2
-  strict = false;
+arguments
+  file {mustBeTextScalar}
+  strict (1,1) logical = false
 end
 
 c = '';
@@ -26,20 +27,22 @@
     c = char(c);
   end
 catch e
-  switch e.identifier
-    case 'MATLAB:io:filesystem:filePermissions:CannotFindLocation'
-      if ~strict && ~stdlib.strempty(file)
-        c = stdlib.normalize(file);
-      end
-    case {'MATLAB:UndefinedFunction', 'Octave:undefined-function'}
-      [s, r] = fileAttribCompatible(file);
-      if s == 1
-        c = r.Name;
-      elseif ~strict && ~stdlib.strempty(r)
-        c = stdlib.normalize(file);
-      end
-    otherwise
-      rethrow(e)
+  if ~stdlib.strempty(file)
+    switch e.identifier
+      case 'MATLAB:io:filesystem:filePermissions:CannotFindLocation'
+        if ~strict
+          c = stdlib.normalize(file);
+        end
+      case {'MATLAB:UndefinedFunction', 'Octave:undefined-function'}
+        [s, r] = fileattrib(file);
+        if s == 1
+          c = r.Name;
+        elseif ~strict
+          c = stdlib.normalize(file);
+        end
+      otherwise
+        rethrow(e)
+    end
   end
 
   if isstring(file)
@@ -48,5 +51,3 @@
 end
 
 end
-
-%!assert (length(stdlib.canonical('.')) > 1)

+stdlib/checkRAM.m

@@ -15,6 +15,10 @@
 
 
 function [OK,newSizeBytes,freebytes] = checkRAM(newSize, myclass)
+arguments
+  newSize (1,:) {mustBePositive, mustBeInteger}
+  myclass {mustBeTextScalar}
+end
 
 % get available RAM
 freebytes = stdlib.ram_free();

+stdlib/checkout_license.m

@@ -11,9 +11,9 @@
 % be used rather than just checking if the relevant toolbox is installed.
 
 function [ok, featureName] = checkout_license(packageName)
-% arguments
-%   packageName (1,1) string
-% end
+arguments
+  packageName {mustBeTextScalar}
+end
 
 ok = false;
 featureName = string.empty;

+stdlib/cpu_load.m

@@ -10,16 +10,13 @@
 % If the system recent cpu usage is not available, the backend returns a negative or NaN value.
 
 function [i, b] = cpu_load(backend)
-if nargin < 1
-  backend = {'java', 'python', 'shell'};
-else
-  backend = cellstr(backend);
+arguments
+  backend (1,:) string = ["java", "python", "shell"]
 end
 
 i = [];
 
-for j = 1:numel(backend)
-  b = backend{j};
+for b = backend
   switch b
     case 'java'
       i = stdlib.java.cpu_load();
@@ -39,5 +36,3 @@
 end
 
 end
-
-%!assert (stdlib.cpu_load() >= 0)

+stdlib/create_symlink.m

@@ -8,16 +8,15 @@
 % * b: backend used
 
 function [i, b] = create_symlink(target, link, backend)
-if nargin < 3
-  backend = {'native', 'dotnet', 'python', 'shell'};
-else
-  backend = cellstr(backend);
+arguments
+  target {mustBeTextScalar}
+  link {mustBeTextScalar}
+  backend (1,:) string = ["native", "dotnet", "python", "shell"]
 end
 
 i = logical([]);
 
-for j = 1:numel(backend)
-  b = backend{j};
+for b = backend
   switch b
     case 'native'
       i = stdlib.native.create_symlink(target, link);