Home / Lua Scripts Libraries API Manual / dtutils.file / create_unique_filename
< chop_filetype
executable_path_widget >

# create_unique_filename

## 🔗NAME

create_unique_filename

## 🔗SYNOPSIS

create a unique filename from the supplied argument

## 🔗USAGE

    local df = require "lib/dtutils.file"
    local result = df.create_unique_filename(filepath)

filepath - string - the path and filename requested

## 🔗DESCRIPTION

create_unique_filename takes a requested filepath and checks to see if it exists. If if doesn’t then it’s returned intact. If it already exists, then a two digit increment is added to the filename and it is tested again. The increment keeps increasing until either a unique filename is found or there have been 100 attempts.

## 🔗RETURN VALUE

result - string - the incremented filename

## 🔗LIMITATIONS

create_unique_filename will only attempt 100 increments.

< chop_filetype
executable_path_widget >