Skip to content

ChangeFileExt

Change the extension of a filename.

Declaration

Source position: finah.inc line 23

function ChangeFileExt(const FileName: UnicodeString; 
                      const Extension: UnicodeString) : UnicodeString;
function ChangeFileExt(const FileName: RawByteString; 
                      const Extension: RawByteString) : RawByteString;

Description

ChangeFileExt changes the file extension in FileName to Extension. The extension Extension includes the starting . (dot). The previous extension of FileName are all characters after the last ., the . character included.

If FileName doesn't have an extension, Extension is just appended.

If Extension is empty, the effect of this function is to remove any existing extension.

Errors

None.

See also

Name Description
ExtractFileExt Return the extension from a filename.
ExtractFileName Extract the filename part from a full path filename.
ExtractFilePath Extract the path from a filename.
ExpandFileName Expand a relative filename to an absolute filename.