4.4. Creating and Opening Files

The library provides functions to create, open, and close files. Each function uses or fills in a variable of type xid which identifies the file to the API.

The "xid" type is the same type as HDF5’s hid_t. Variables of type xid are used to access all files, groups, and arrays stored in XMDF files.

C/C++

int xfCreateFile(const char *Name, xid *FileId, xbool Overwrite);
int xfOpenFile(const char *Name, xid *FileId, xbool Readonly);
int xfCloseFile(xid FileId);

FORTRAN

SUBROUTINE XF_CREATE_FILE(Name, Overwrite, FileId, Error)
CHARACTER(LEN=*), INTENT(IN):: Name
LOGICAL, INTENT(IN)       ::   Overwrite
INTEGER(XID), INTENT(OUT) ::   FileId
INTEGER, INTENT(OUT)      ::   Error
 
SUBROUTINE XF_OPEN_FILE(Name, FileId, Error)
CHARACTER(LEN=*), INTENT(IN) ::  Name
LOGICAL, INTENT(IN)          ::  ReadOnly
INTEGER(XID), INTENT(OUT)    ::  FileId
INTEGER, INTENT(OUT)         ::  Error
 
SUBROUTINE XF_CLOSE_FILE(FileId, Error)
INTEGER(XID), INTENT(IN) ::     FileId
INTEGER, INTENT(OUT) ::         Error