Unit 'sysutils' Package
[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] [#rtl]

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

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.

Documentation generated on: Dec 21 2024