function ExpandFileNameCase(const FileName: string; out MatchFound: TFilenameCaseMatch): string;
extern DELPHI_PACKAGE System::UnicodeString __fastcall ExpandFileNameCase(const System::UnicodeString FileName, /* out */ TFilenameCaseMatch &MatchFound)/* overload */;
Returns the full path name for a relative file name on a case-sensitive file system.
ExpandFileNameCase expands a relative file name into a fully qualified path name, then attempts to find the file or a close case-insensitive match. This is useful when converting file name data from case-insensitive conventions (on Windows) to case-sensitive conventions (on MacOS and Linux). It is also useful for validating file names entered by users unfamiliar with MacOS conventions.
FileName is the relative file name to expand.
MatchFound indicates what match, if any, was found for
The return value is the fully qualified path name generated by ExpandFileNameCase. Its relationship to
FileName depends on the value of
MatchFound, as indicated in the following table:
|mkNone||The fully qualified path name, as returned by ExpandFileName.|
|mkExactMatch||The fully qualified path name for the single case-sensitive match to |
|mkSingleMatch||(on MacOS and Linux) The fully qualified path name for the single file that matches |
|mkAmbiguous||(on MacOS and Linux) The fully qualified path name for one of the case-insensitve matches to |