Reference for package '#rtl'

ExpandFileNameCase

Expand a filename entered as case insensitive to the full path as stored on the disk.

Declaration

Source position: finah.inc line 31

  function ExpandFileNameCase(const FileName: UNICODESTRING; 
                             out MatchFound: TFilenameCaseMatch)
                              : UNICODESTRING;
  function ExpandFileNameCase(const FileName: RAWBYTESTRING; 
                             out MatchFound: TFilenameCaseMatch)
                              : RAWBYTESTRING;

Description

On case insensitive platforms, ExpandFileNameCase behaves similarly to ExpandFileName except for the fact that it returns the final part of the path with the same case of letters as found on the disk (if it exists - otherwise the case equals the one provided on input). On case sensitive platforms it also checks whether one or more full paths exist on disk which would correspond to the provided input if treated case insensitively and returns the first such match found and information whether the match is unique or not.

Note that the behaviour is basically undefined if the input includes wildcards characters. Normally, wildcards in the last part of path provided on input are resolved to the first corresponding item found on the disk, but it is better not to rely on that and use other more suitable functions if working with wildcards like FindFirst /FindNext .

Errors

None.

See also

Name Description
ExpandFileName Expand a relative filename to an absolute 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.
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.