add matlab_bin_path()

Author: scivision

+stdlib/matlab_bin_path.m

@@ -0,0 +1,18 @@
+%% MATLAB_BIN_PATH give binary paths relevant to Matlab Mex and Engine runs
+% These can be used with LIBRARY_PATH, LD_LIBRARY_PATH, PATH, etc.
+%
+% For testing, these can be used with EnvironmentVariableFixture as shown at
+% https://github.com/scivision/matlab-buildtool-mex/blob/main/engine/TestEngine.m
+
+function mpaths = matlab_bin_path()
+
+mpaths.arch = computer("arch");
+mpaths.root = matlabroot;
+
+mpaths.bin = fullfile(matlabroot, "bin");
+
+mpaths.extern_bin = fullfile(matlabroot, "extern/bin", mpaths.arch);
+
+mpaths.arch_bin = fullfile(mpaths.bin, mpaths.arch);
+
+end

+stdlib/platform_tell.m

@@ -14,6 +14,12 @@
 'hdf5', stdlib.h5get_version(), ...
 'netcdf', stdlib.nc_get_version());
 
+m = stdlib.matlab_bin_path();
+raw.matlab_extern_bin = m.extern_bin;
+raw.matlab_root = m.root;
+raw.matlab_arch_bin = m.arch_bin;
+raw.matlab_bin = m.bin;
+
 if stdlib.has_java()
   raw.java_vendor = stdlib.java_vendor();
   raw.java_version = stdlib.java_version();

Readme.md

@@ -36,12 +36,12 @@ The
 "backend" column tells which functions have selectable backend implementations.
 By default, when the "backend" is not specified to a function having selectable backend, the algorithm searches for the first available backend and uses that.
 The user can specify the backend as listed in the API for those functions by specifying say "java" etc. as available per-function.
-Normally the user will not specify the backend as we prioritize faster backends.
+Normally the user does not specify the backend as we prioritize faster backends.
 
 * [.NET](https://www.mathworks.com/help/matlab/call-net-from-matlab.html)
   * Windows: all supported Matlab releases
   * Linux / macOS: R2024b and newer
-* [Java](https://www.mathworks.com/help/matlab/using-java-libraries-in-matlab.html): all supported Matlab releases
+* [Java](./Readme_java.md): all supported Matlab releases
 * [Perl](https://www.mathworks.com/help/matlab/ref/perl.html):  all supported Matlab releases. This uses a system() call to Perl, which is bundled with Matlab on Windows and generally available on Linux and macOS
 * [Python](https://www.mathworks.com/help/matlab/call-python-libraries.html): Matlab R2022b and newer
 * System shell calls: all supported Matlab releases. As a backup when the platform doesn't have the primary (faster) methods available, the system shell can be called for some functions.

Readme_java.md

@@ -1,14 +1,16 @@
-# Matlab-Stdlib Java functions
+# Using Java in standard library for Matlab
 
-Some Matlab-Stdlib functions use the factory JRE, and have been tested with JVM versions 8 and 17 and newer.
+Java is not required for this project, but some functions are implemented with an optional Java backend.
+They are tested with and should work with Java versions 8, 11, 17, 21, and more.
 
-In general, Java's java.io.File() and java.nio.file don't work with Windows App Execution Aliases.
-However, Matlab's intrinsic file functions do work with Windows App Execution Aliases.
-
-Matlab's Java interface was
+Matlab's
+[Java language interface](https://www.mathworks.com/help/matlab/using-java-libraries-in-matlab.html)
+was
 [introduced in Matlab 6.0 R12](http://www.ece.northwestern.edu/local-apps/matlabhelp/base/relnotes/matlab/matlab124.html#20684)
 in the year 2000.
-Matlab-Stdlib uses only factory JRE classes where intrinsic Matlab code isn't easily capable of provided the needed algorithms.
+Our optional Java backend functions use only factory Java class--no third-party Java libraries are used.
+
+## Java backend diagnostic functions
 
 Tell JVM version:
 
@@ -34,7 +36,14 @@ Get the Java version:
 stdlib.java_version()
 ```
 
-Matlab factory Java version 1.8 is adequate for all Matlab-stdlib functionality.
+Tell JVM details:
+
+```matlab
+je = jenv
+
+% Tell the JAVA_HOME directory
+disp(je.Home)
+```
 
 As general information (not used by Matlab-stdlib), non-factory Java classes can be used in
 [Matlab](https://www.mathworks.com/help/matlab/matlab_external/static-path-of-java-class-path.html).
@@ -50,15 +59,6 @@ Matlab function.
 Matlab vs. Java
 [version compatibility table](https://www.mathworks.com/support/requirements/openjdk.html).
 
-Tell JVM details:
-
-```matlab
-je = jenv
-
-% Tell the JAVA_HOME directory
-disp(je.Home)
-```
-
 For example, to use the
 [JDK 17 on macOS](https://www.oracle.com/java/technologies/downloads/#jdk17-mac)
 download and extract the ARM64 Compressed Archive.