System.SysUtils.ExpandFileNameCase
Delphi
function ExpandFileNameCase(const FileName: string; out MatchFound: TFilenameCaseMatch): string;
C++
extern DELPHI_PACKAGE System::UnicodeString __fastcall ExpandFileNameCase(const System::UnicodeString FileName, /* out */ TFilenameCaseMatch &MatchFound)/* overload */;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Beschreibung
Gibt den vollständigen Pfad eines relativen Dateinamens auf einem Dateisystem mit Berücksichtigung der Groß-/Kleinschreibung zurück.
ExpandFileNameCase erweitert einen relativen Dateinamen in einen voll qualifizierten Pfadnamen und versucht dann, die Datei zu finden, wobei auch Dateien berücksichtigt werden, die sich vom angegebenen Namen nur in der Groß-/Kleinschreibung unterscheiden. Dies ist hilfreich, wenn Dateinamen aus Umgebungen, in denen die Groß-/Kleinschreibung ignoriert wird (Windows), in Dateien für Umgebungen (MacOS und Linux) umgewandelt werden, für die die genaue Schreibweise eine Rolle spielt. Mit ExpandFileNameCase können auch Dateinamen überprüft werden, die von Benutzern eingegeben wurden, die mit MacOS nicht vertraut sind.
FileName
ist der relative Dateiname, der erweitert werden soll.
MatchFound
gibt an, welche Übereinstimmung (falls überhaupt) für FileName
gefunden wurde.
Der Rückgabewert ist der voll qualifizierte von ExpandFileNameCase erzeugte Pfadname. Dessen Beziehung zu FileName
hängt von dem Wert von MatchFound
ab, wie in der folgenden Tabelle dargestellt:
MatchFound
|
Rückgabewert |
mkNone | Der voll qualifizierte Pfadname, wie von ExpandFileName zurückgegeben. |
mkExactMatch | Der voll qualifizierte Pfadname für die einzige Übereinstimmung mit FileName unter Berücksichtigung der Groß-/Kleinschreibung. Derselbe Wert wie der Rückgabewert, wenn MatchFound mkNone ist.
|
mkSingleMatch | (Unter MacOS und Linux) Der voll qualifizierte Pfadname für die einzige Übereinstimmung mit FileName ohne Berücksichtigung der Groß-/Kleinschreibung.
|
mkAmbiguous | (Unter MacOS und Linux) Der voll qualifizierte Pfadname für eine der Übereinstimmungen mit FileName ohne Berücksichtigung der Groß-/Kleinschreibung. Dieser Pfadname ist nicht identisch mit dem angegebenen Dateinamen und ist auch nicht unbedingt dessen nächste Entsprechung.
|
Hinweis: ExpandFileNameCase arbeitet viel langsamer als ExpandFileName, besonders dann, wenn der angegebene Dateiname nicht eindeutig ist oder keiner vorhandenen Datei entspricht.