%DISK_FREE return free disk space for specified folder in bytes (double)
% INPUT ARGUMENTS:
% * some_path - string, existing file or folder path. Should be global.
% * disk_free('C:\temp'); % regular usage
% * disk_free('C:\temp\1.txt'); % path points to a file
% * disk_free('\\?\C:\temp'); % UNCW path
% * disk_free('\\\\C:\temp'); % UNCW path with with java-style prefix
% * disk_free('\\IMP\Ctemp'); % samba share folder
% INVALID USAGE:
% * disk_free('\\IMP'); % samba share root. Results in error.
% * disk_free('C'); % Use 'C:' instead. Results in error.
% * disk_free('disk_free') % Matlab function. Results in [0 0 0]
% % or some other result, if corresponding
% % local file was found.
% % i.e. don't use local paths!
% Would result in an error for an empty DVD-rom drive (disk not inserted).
% And similar cases.
Just a note: "\\?\C:\" is not an UNC path, but this is the prefix allows to use Windows API functions with long names (uo to about 32767). "\\Server\share\" is an UNC path and you can use it to access samba shares, but not only them.
"path" is an important Matlab function. Shadowing it by a local variable with the same name can lead to serious troubles e.g. during debugging.
Beside these small details, this function is well documented, useful and usable. I'd add the name of the author and a version date to the help section.