which: optional find_all to find all executable

Author: scivision

+stdlib/which.m

@@ -4,11 +4,14 @@
 % That is, can return relative path if executable is in:
 % * (Windows) in cwd
 % * (all) fpath or Path contains relative paths
+%
+% find_all option finds all executables specified under PATH, instead of only the first
 
-function exe = which(filename, fpath, use_java)
+function exe = which(filename, fpath, find_all, use_java)
 arguments
   filename (1,1) string
-  fpath (1,:) string = getenv('PATH')
+  fpath (1,:) string = string.empty
+  find_all (1,1) logical = false
   use_java (1,1) logical = false
 end
 
@@ -25,18 +28,24 @@
 end
 
 % path given
+if isempty(fpath) || strlength(fpath) == 0
+  fpath = string(getenv("PATH"));
+end
 
 if isscalar(fpath)
-  % PATH could have ~/ prefixed paths in it
-  fpath = split(stdlib.expanduser(fpath), pathsep).';
+  fpath = split(fpath, pathsep);
 end
 fpath = fpath(strlength(fpath)>0);
 
-for p = fpath
+for p = fpath.'
   e = p + "/" + filename;
   if isfile(e) && stdlib.is_exe(e, use_java)
-    exe = stdlib.posix(e);
-    return
+    if find_all
+      exe(end+1) = stdlib.posix(e); %#ok<AGROW>
+    else
+      exe = stdlib.posix(e);
+      return
+    end
   end
 end
 

test/TestWhich.m

@@ -9,7 +9,7 @@
 
 function test_which_name(tc, use_java)
 
-tc.verifyEmpty(stdlib.which(tempname, getenv('PATH'), use_java))
+tc.verifyEmpty(stdlib.which(tempname, [], use_java))
 
 if ispc
   n = "pwsh.exe";
@@ -21,7 +21,7 @@ function test_which_name(tc, use_java)
 % Unix-like OS may have Matlab as alias which is not visible to
 % stdlib.which()
 % virus scanners may block stdlib.which("cmd.exe") on Windows
-tc.verifyNotEmpty(stdlib.which(n, getenv('PATH'), use_java))
+tc.verifyNotEmpty(stdlib.which(n, [], use_java))
 
 end