Open (FB; Prefix filop)¶

FUNCTION_BLOCK Open EXTENDS CBM.ETrig

This function block opens an already existing file or creates a new one. The return value is a file handle, which can then be used as an input ”hFile” in the function blocks ”FILE.Write”, ”FILE.Read”, ”FILE.Close”. There may be restrictions concerning the specification of the directory name, e.g. only capital letters allowed, for different targets. The function ”FILE.GetProperty” shows these restrictions.

InOut:

Scope	Name	Type	Comment
Input	sFileName	CAA.FILENAME	File name, absolute or relative path specification
	eFileMode	MODE	File mode: FILE_MWRITE - write, FILE_MREAD - read, FILE_MRDWR - read & write, FILE_MAPPD - append
	xExclusive	BOOL	UNSUPPORTED PARAMETER: IS ALWAYS FALSE! Note: Because of the POSIX behaviour of the file open functions on targets, there is no way to support xExclusive=TRUE! If a file still is opened, it can be deleted or renamed at the same time! Additionally a file can be opened several times (for reading and writing).
Output	eError	ERROR	Local library error ID (0: no error; 5101: time out)
	hFile	CAA.HANDLE	File handle