most functions require scalar, non-empty input for clarity

Author: scivision

+stdlib/+fileio/absolute_path.m

@@ -1,13 +1,13 @@
 function abspath = absolute_path(p)
 % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getAbsolutePath()
 arguments
-  p string {mustBeScalarOrEmpty}
+  p (1,1) string
 end
 
 % have to expand ~ first (like C++ filesystem::path::absolute)
 abspath = stdlib.fileio.expanduser(p);
 
-if isempty(abspath) || abspath == ""
+if abspath == ""
   return
 end
 
@@ -21,6 +21,6 @@
   abspath = stdlib.fileio.join(pwd, abspath);
 end
 
-abspath = stdlib.posix(java.io.File(abspath).getAbsolutePath());
+abspath = stdlib.fileio.posix(java.io.File(abspath).getAbsolutePath());
 
 end % function

+stdlib/+fileio/canonical.m

@@ -1,16 +1,12 @@
 function c = canonical(p)
 % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getCanonicalPath()
 arguments
-  p string {mustBeScalarOrEmpty}
+  p (1,1) string
 end
 
 % have to expand ~ first (like C++ filesystem::path::absolute)
 c = stdlib.fileio.expanduser(p);
 
-if isempty(c)
-  return
-end
-
 if ispc && startsWith(c, "\\")
   % UNC path is not canonicalized
   return

+stdlib/+fileio/expanduser.m

@@ -1,7 +1,7 @@
 function e = expanduser(p)
 
 arguments
-  p string {mustBeScalarOrEmpty}
+  p (1,1) string
 end
 
 e = p;

+stdlib/+fileio/filename.m

@@ -1,7 +1,7 @@
 function p = filename(path)
 % FILENAME filename (including suffix) without directory
 arguments
-  path string
+  path (1,1) string
 end
 
 % NOT https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#getName()

+stdlib/+fileio/is_absolute_path.m

@@ -1,12 +1,7 @@
 function isabs = is_absolute_path(apath)
 % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#isAbsolute()
 arguments
-  apath string {mustBeScalarOrEmpty}
-end
-
-if isempty(apath)
-  isabs = logical.empty();
-  return
+  apath (1,1) string
 end
 
 % expanduser() here to work like C++ filesystem::path::is_absolute()

+stdlib/+fileio/is_exe.m

@@ -3,12 +3,7 @@
 % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html#canExecute()
 
 arguments
-  file string {mustBeScalarOrEmpty}
-end
-
-if isempty(file)
-  ok = logical.empty;
-  return
+  file (1,1) string
 end
 
 ok = java.io.File(file).canExecute();

+stdlib/+fileio/is_readable.m

@@ -3,12 +3,7 @@
 % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html#isReadable(java.nio.file.Path)
 
 arguments
-  file string {mustBeScalarOrEmpty}
-end
-
-if isempty(file)
-  ok = logical.empty;
-  return
+  file (1,1) string
 end
 
 

+stdlib/+fileio/is_writable.m

@@ -3,15 +3,9 @@
 % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html#isWritable(java.nio.file.Path)
 
 arguments
-  file string {mustBeScalarOrEmpty}
+  file (1,1) string
 end
 
-if isempty(file)
-  ok = logical.empty;
-  return
-end
-
-
 ok = java.nio.file.Files.isWritable(java.io.File(stdlib.fileio.absolute_path(file)).toPath());
 
 end

+stdlib/+fileio/join.m

@@ -1,8 +1,8 @@
 function p = join(a, b)
 %% JOIN: join two paths with posix file separator
 arguments
-  a string {mustBeScalarOrEmpty}
-  b string {mustBeScalarOrEmpty}
+  a (1,1) string
+  b (1,1) string
 end
 
 p = stdlib.fileio.posix(fullfile(a, b));

+stdlib/+fileio/normalize.m

@@ -2,14 +2,9 @@
 % normalize(p) remove redundant elements of path p
 % https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Path.html#normalize()
 arguments
-  p string {mustBeScalarOrEmpty}
+  p (1,1) string
 end
 
-n = p;
-if isempty(p)
-  return
-end
-
-n = stdlib.fileio.posix(java.io.File(stdlib.fileio.expanduser(n)).toPath().normalize());
+n = stdlib.fileio.posix(java.io.File(stdlib.fileio.expanduser(p)).toPath().normalize());
 
 end