add stdlib.append()

More efficient and more broadly available than builtin append()

Author: scivision

+stdlib/+sys/device.m

@@ -17,7 +17,7 @@
   % Get-CimInstance works, but is 100x slower
   % c0 = 'pwsh -c "(Get-CimInstance -ClassName Win32_Volume -Filter \"DriveLetter = ''';
   % c2 = '''\").SerialNumber"';
-  % cmd = append(c0, rn, c2);
+  % cmd = stdlib.append(c0, rn, c2);
 
   cmd = sprintf('vol "%s"', rn);
 elseif ismac()

+stdlib/absolute.m

@@ -31,15 +31,15 @@
 else
   c = pwd();
   if ~stdlib.strempty(base)
-    c = append(c, '/', base);
+    c = stdlib.append(c, '/', base);
   end
 end
 
 if ~stdlib.strempty(p)
   if endsWith(c, ["/", filesep])
-    c = append(c, p);
+    c = stdlib.append(c, p);
   else
-    c = append(c, '/', p);
+    c = stdlib.append(c, '/', p);
   end
 end
 

+stdlib/append.m

@@ -0,0 +1,18 @@
+%% APPEND Concatenate strings or character arrays without removing trailing whitespace
+% 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);
+s = s.append(varargin{:});
+
+if ischar(txt) && all(cellfun(@ischar, varargin))
+  s = char(s);
+end
+
+end

+stdlib/expanduser.m

@@ -29,7 +29,7 @@
     e = string(e);
   end
 else
-  e = append(home, '/', extractAfter(file, i1));
+  e = stdlib.append(home, '/', extractAfter(file, i1));
 end
 
 end

+stdlib/filename.m

@@ -14,7 +14,7 @@
 switch backend
   case 'fileparts'
     [~, f, ext] = fileparts(p);
-    f = append(f, ext);
+    f = stdlib.append(f, ext);
 % the pattern backend is a litle slower than regexp. Commented out for < R2020b compatibility
   % case 'pattern'
   %   f = extractAfter(p, asManyOfPattern(wildcardPattern + ("/" | filesep)));

+stdlib/java_run.m

@@ -152,7 +152,7 @@
 
 line = reader.readLine();
 while ~isempty(line)
-  msg = append(msg, string(line), newline);
+  msg = stdlib.append(msg, string(line), newline);
   line = reader.readLine();
 end
 msg = strip(msg);

+stdlib/join.m

@@ -14,9 +14,9 @@
 
   if ~stdlib.strempty(rnb)
     if endsWith(rnb, ["/", filesep])
-      p = append(rnb, other);
+      p = stdlib.append(rnb, other);
     else
-      p = append(rnb, '/', other);
+      p = stdlib.append(rnb, '/', other);
     end
   else
     p = other;
@@ -26,9 +26,9 @@
 
   if ~stdlib.strempty(other)
     if endsWith(base, ["/", filesep])
-      p = append(base, other);
+      p = stdlib.append(base, other);
     else
-      p = append(base, '/', other);
+      p = stdlib.append(base, '/', other);
     end
   else
     p = base;

+stdlib/normalize.m

@@ -26,9 +26,9 @@
     if n == ""
       n = parts(i);
     elseif ismember(n, ["/", filesep])
-      n = append(n, parts(i));
+      n = stdlib.append(n, parts(i));
     else
-      n = append(n, '/', parts(i));
+      n = stdlib.append(n, '/', parts(i));
     end
   end
 end

+stdlib/parent.m

@@ -18,7 +18,7 @@
     p = string(p);
   end
 elseif ispc() && strcmp(p, stdlib.root_name(file))
-  p = append(p, '/');
+  p = stdlib.append(p, '/');
 end
 
 end

+stdlib/root.m

@@ -3,6 +3,6 @@
 
 function r = root(p)
 
-r = append(stdlib.root_name(p), stdlib.root_dir(p));
+r = stdlib.append(stdlib.root_name(p), stdlib.root_dir(p));
 
 end