ExpandFileName

Expand a relative filename to an absolute filename.

Declaration

Source position: finah.inc line 29

  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.
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.
ExtractFileName	Extract the filename part from a full path filename.
ExtractFilePath	Extract the path 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.