Show: Delphi
C++
Display Preferences
System.SysUtils.ForceDirectories
From XE2 API Documentation
Delphi
function ForceDirectories(Dir: string): Boolean;
C++
extern PACKAGE bool __fastcall ForceDirectories(System::UnicodeString Dir);
Contents |
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Description
Creates a new directory, including the creation of parent directories as needed.
ForceDirectories creates a new directory as specified in Dir, which must be a fully-qualified path name. If the directories given in the path do not yet exist, ForceDirectories attempts to create them.
ForceDirectories returns True if it successfully creates all necessary directories, False if it could not create a needed directory.
Note: Do not call ForceDirectories with an empty string. Doing so causes ForceDirectories to raise an exception.
Note: The FileCtrl unit (Windows only) also contains a ForceDirectories function. However, the FileCtrl version is deprecated, and the SysUtils version preferred, even if the code does not need to be cross-platform.
See Also