Find free file-name

The function searches a free name in required directory.


Updated 16 Nov 2005

View License

Editor's Note: This file was a File Exchange Pick of the Week

The function finds first unused name of a file in a required directory. The final name of the file consists of a name base appended by n digits (possibly with leading zeros) expressing an order of the new file possessing the same name base. The function is good for generating names of files containing results of an alternative processing of the same data.

Forms of calls:
filename = freename(dirname,base);
% dirname = name of the directory, where to find a new name
% base = base of the new name (without extension)
filename = freename(dirname,base,n);
% n = number of figures to be appended (3 is default)
% filename = free name equals a base appended by 'n' figure characters

filename =[freename('Results','meas',2) '.txt'];
The name 'meas01.txt' will be sent to filename if there is no file
of the same base name 'meas' present in the subdirectory 'Results'.
The name 'meas04.txt' is returned provided 'meas03' exists in the
subdirectory 'Results'.
file = [freename('./', 'data') '.dat'];
returns 'data001.dat' if no file file with the base name 'data'
exists in the current directory.

Cite As

Miroslav Balda (2023). Find free file-name (, MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R14
Compatible with any release
Platform Compatibility
Windows macOS Linux
Find more on File Operations in Help Center and MATLAB Answers

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes

Improving description