ExpandFileName¶

Expand a relative filename to an absolute filename.

Declaration¶

Source position: finah.inc line 31

function ExpandFileName(const FileName: UnicodeString) : UnicodeString;

function ExpandFileName(const FileName: UnicodeString; 
                       const BasePath: UnicodeString) : UnicodeString;

function ExpandFileName(const FileName: RawByteString) : RawByteString;

function ExpandFileName(const FileName: RawByteString; 
                       const BasePath: RawByteString) : RawByteString;

Description¶

ExpandFileName expands the filename to an absolute filename. It changes all directory separator characters to the one appropriate for the system first.

If an empty filename is passed, it is expanded to the current directory.

If BasePath is not passed, the current directory is used as base path.

Errors¶

None.

See also¶

Name	Description
ExpandFileNameCase	Expand a filename entered as case insensitive to the full path as stored on the disk.
ExtractFileName	Extract the filename part from a full path filename.
ExtractFilePath	Extract the path from a filename.
ExtractFileDir	Extract the drive and directory part of a filename.
ExtractFileDrive	Extract the drive part from a filename.
ExtractFileExt	Return the extension from a filename.
ExtractRelativePath	Extract a relative path from a filename, given a base directory.

Example¶

Program Example33;

{ This program demonstrates the ExpandFileName function }

Uses sysutils;

Procedure Testit (F : String);

begin
  Writeln (F,' expands to : ',ExpandFileName(F));
end;

Begin
  Testit('ex33.pp');
  Testit(ParamStr(0));
  Testit('/pp/bin/win32/ppc386');
  Testit('\pp\bin\win32\ppc386');
  Testit('.');
End.