Topic Path: Symbol Reference > Functions > GetUniqueFileName Function
GetUniqueFileName Function

Generates a unique file name with the specified path, prefix, and file extension.

function GetUniqueFileName(
    const APath: String; 
    const APrefix: String; 
    const AExt: String
): String;
Path for the generated file name.
File name prefix for the generated file name.
File extension for the generated file name. 

String - Unique file name including the path, prefix, and extension specified.

GetUniqueFileName is a String function used to generate a unique file name that incorporates the values specified in the APath, APrefix, and AExt parameters. GetUniqueFileName returns a value that includes the specified values, and the hexidecimal representation of the value from the Ticks function. For example: 




APath is an optional path to include in the unique file name. When APath contains a non-empty string value, GetUniqueFileName ensures that a trailing path delimiter exists in the APath argument. When APath contains an empty string (''), the file name will refer to a file in the current directory. 

APrefix is an optional value to be prepended to the unique file name, or an empty string ('') when no file name prefix is desired. 

AExt is an optional extension for the unique file name, or an empty string when no file name extension is desired. When AExt contains a non-empty string, GetUniqueFileName ensures that a '.' character exists in the value for AExt. 

GetUniqueFileName will execute until the return value contains a file name that does not already exist.

Copyright 1993-2006, Chad Z. Hower (aka Kudzu) and the Indy Pit Crew. All rights reserved.
Post feedback to the Indy Docs Newsgroup.