File Functions

The following file-handling functions are available in IBEBlock:

Function Description
ibec_DeleteFile Erases the file from the disk.
ibec_DirectoryExists Call ibec_DirectoryExists to determine whether the directory specified by the Name parameter exists.
ibec_SetCurrentDir
ibec_RemoveDirectory Removes a directory.
ibec_FileExists Tests if a specified file exists.
ibec_FileSize Returns the size of the specified file.
ibec_GetFiles Retrieves specified file or list of files.
ibec_LoadFromFile Loads file data into variable.
ibec_SaveToFile Saves value of variable into file.
ibec_CopyFile Copies an existing file to a new one.
ibec_MoveFile Renames an existing file or a directory (including all its children).
ibec_FileDateTime Returns the TIMESTAMP of a specified file.
ibec_SetFileDateTime
ibec_GetCurrentDir Returns the fully qualified name of the current directory.
ibec_GetRunDir Returns the path of the currently executing program (IBExpert.exe of IBEScript.exe.
ibec_ExtractFileDir Extracts the drive and directory parts from FileName.
ibec_ExtractFileName Extracts the name and extension parts of a file name.
ibec_FileAttr
ibec_SetFileAttr
ibec_RenameFile
ibec_ForceDirectories Creates all the directories along a directory path if they do not already exist.

The following functions are intended for working with files in stream mode:

Function Description
ibec_fs_CloseFile Closes the file opened with the ibec_fs_OpenFile function.
ibec_fs_Eof Closes the file opened with the ibec_fs_OpenFile function.
ibec_fs_OpenFile Opens a file for reading or writing.
ibec_fs_Position Returns the current offset into the stream for reading and writing.
ibec_fs_Readln Reads a line of text from a file.
ibec_fs_ReadString Reads count bytes from the file stream.
ibec_fs_Seek Resets the current position of the file stream.
ibec_fs_Size Returns the length, in bytes, of the file stream.
ibec_fs_SetSize
ibec_fs_Writeln
ibec_fs_WriteString Writes a srtring onto the file stream stream.
ibec_fs_ReadByte Reads one byte from the file stream and returns an unsigned integer value (0..255).
ibec_fs_WriteByte Writes one byte to the file stream as a 8-bit unsigned integer.
ibec_fs_ReadWord Reads two bytes from the file stream and returns an unsigned integer value (0..65535).
ibec_fs_WriteWord Writes two bytes to the file stream as a 16-bit unsigned integer.
ibec_fs_ReadDoubleWord Reads four bytes from the file stream and returns an unsigned integer value (0..4294967295).
ibec_fs_WriteDoubleWord Writes four bytes to the file stream as a 32-bit unsigned integer.
ibec_fs_ReadInt32 Reads four bytes from the file stream and returns a signed integer value (–2147483648..2147483647).
ibec_fs_WriteInt32 Writes four bytes to the file stream as a 32-bit signed integer.

The following functions were introduced to handle work with INI files:

Function Description
ibec_ini_Open Erases all data from the INI file in the memory.
ibec_ini_Close Frees the memory associated with the INI file object.
ibec_ini_ReadString Erases an entire section of an INI file.
ibec_ini_WriteString Saves the contents of the INI file to a variable.
ibec_ini_Clear Instantiates an INI file object.
ibec_ini_EraseSection Retrieves a string value from an INI file.
ibec_ini_UpdateFile Sets the contents of the INI file from a variable.
ibec_ini_SetStrings Flushes buffered INI file data to disk.
ibec_ini_GetStrings Writes a string value to an INI file.

Please note that all ibec_ini_xxx functions, except ibec_ini_ReadString and ibec_ini_Open, return NULL.