System.IOUtils.TPath.Combine
Delphi
class function Combine(const Path1, Path2: string; const ValidateParams: Boolean = True): string; overload; inline; static;
class function Combine(const Path1, Path2, Path3: string; const ValidateParams: Boolean = True): string; overload; static;
class function Combine(const Path1, Path2, Path3, Path4: string; const ValidateParams: Boolean = True): string; overload; static;
class function Combine(const Paths: array of string; const ValidateParams: Boolean = True): string; overload; static;
C++
static System::UnicodeString __fastcall Combine(const System::UnicodeString Path1, const System::UnicodeString Path2, const bool ValidateParams = true)/* overload */;
static System::UnicodeString __fastcall Combine(const System::UnicodeString Path1, const System::UnicodeString Path2, const System::UnicodeString Path3, const bool ValidateParams = true)/* overload */;
static System::UnicodeString __fastcall Combine(const System::UnicodeString Path1, const System::UnicodeString Path2, const System::UnicodeString Path3, const System::UnicodeString Path4, const bool ValidateParams = true)/* overload */;
static System::UnicodeString __fastcall Combine(const System::UnicodeString *Paths, const System::NativeInt Paths_High, const bool ValidateParams = true)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TPath |
Description
Combine deux chaînes de chemins.
Appelez Combine pour obtenir un nouveau chemin combiné à partir de deux chemins distincts. Si le deuxième chemin est un chemin absolu, Combine le renvoie directement. Sinon, Combine renvoie une concaténation du premier et deuxième chemins.
Le tableau suivant liste les paramètres attendus par cette méthode :
| Nom | Signification |
|---|---|
|
Path1 |
Le premier chemin. Path1 est utilisé comme racine pour Path2. |
|
Path2 |
Le chemin qui est concaténé avec Path1. |
Remarque: Combine déclenche une exception si les chemins donnés contiennent des caractères non valides.
Exemples
Dans les exemples ci-dessous, la fonction TPath.combine est utilisée pour combiner deux chemins. Le tableau ci-dessous indique les résultats attendus et fournit une rapide explication.
| Entrée | Sortie | Description |
|---|---|---|
TPath.combine('E:\somewhere\', 'there\file.txt')
|
'E:\somewhere\there\file.txt'
|
Il est recommandé d'utiliser cette API ainsi. Dans ce cas, la sortie est le chemin complet vers le fichier .txt. |
TPath.combine('E:\somewhere\', 'there\file.txt')
|
'E:\somewhere\there\file.txt'
|
Comme vous pouvez le voir, TPath.combine deux chemins, même lorsque le premier chemin ne se termine pas par le signe barre oblique inversée; ce qui donne le chemin complet correct vers le fichier `.txt`. |
TPath.combine('E:\somewhere', '\there\file.txt')
|
'\there\file.txt'
|
Dans cet exemple, TPath.combine ne combine pas les chemins si le deuxième chemin commence par une barre oblique inversée. En conséquence, la fonction renvoie uniquement le deuxième chemin. |
TPath.combine('E:\somewhere', 'C:\there\file.txt')
|
'C:\there\file.txt'
|
TPath.combine ne peut pas combiner deux chemins différents. Dans ce cas, il renvoie simplement le second chemin en sortie.
|
Remarque: N'oubliez pas que .\ et ..\ ne sont pas encore résolus.