FILE.DirCreate (FB: Prefix fildcr)

FILE.DirCreate (FB; Prefix fildcr)

This function block of the CAA_File.library creates a sub-directory in the standard directory. If the sub-directory already exists, an error message is generated. There may be restrictions concerning the specification of the directory name, for example only capital letters allowed, for different targets. The function ”FILE.GetProperty” shows these restrictions.

Input:

xExecute

BOOL

see: CAA Guidelines

sDirName

CAA.FILENAME

Directory name:

No special characters,

Separator for sub-directories “/”,

Absolute or relative path specifications

Recommendation:

No empty spaces

Use capital letters

xParents

BOOL

TRUE: - missing sub-directories will be created automatically,

FALSE: - missing sub-directories will cause an error message

Output:

xDone	BOOL	see: CAA Guidelines
xBusy	BOOL	see: CAA Guidelines
xError	BOOL	see: CAA Guidelines
eError	FILE.ERROR	Error ID 5104 - FILE.NOT_EXIST: Directory does not exist 5105 - FILE.EXIST: Directory already exists