Files

GISDK includes the following functions that support general DOS file management:

GISDK Function	Summary
ChooseDirectory()	Gets the path name to an existing directory/folder
ChooseFile()	Gets the name of an existing file using the Windows File Open dialog box
ChooseFileName()	Gets the name of a new file using the Windows File Open dialog box
ChooseFiles()	Gets the names of one or more existing files using the Windows File Open dialog box
ChooseFolder()	Gets the path name to an existing directory/folder
CompactPath()	Shortens a file's pathname to the listed length for purposes of display
ConcatenateFiles()	Writes a group of files one after another into a new file
CopyFile()	Copies a file
CreateDirectory()	Creates a new folder (directory) with a default security descriptor set by the system
DeleteFile()	Deletes a file
FileCheckUsage()	Checks whether files are in use by Maptitude
GetAbsolutePath()	Converts a relative pathname to an absolute pathname
GetDirectoryInfo()	Gets a listing of the contents of a directory
GetDiskSpace()	Gets the disk size and the amount of space available in bytes
GetDrives()	Returns a list of disk drives and their type
GetFileInfo()	Gets information about a file
GetLongPathName()	Returns the full, long pathname for a file
GetRandFileName()	Generates a valid and unused file name with a given specification, but does not delete such files on shutdown
GetReadOnly()	Gets the value of the Read Only checkbox in the most recent call to Choose File
GetRelativePath()	Converts an absolute pathname to a relative pathname
GetShortPathName()	Returns the short pathname for a file
GetTempFileName()	Generates a valid and unused file name with a given specification
GetTempPath()	Gets the name of the directory used by the program to store temporary files
IsPathAbsolute()	Tests to see if the pathname is an absolute pathname
PutInRecycleBin()	Puts a file or folder in the recycle bin
RemoveDirectory()	Removes a folder (directory)
RenameFile()	Copies, moves, or changes the name of a file
SearchFilePath()	Searches for the path for a filename
SetFileAttributes()	Changes the attributes of a file or a directory
SplitPath()	Splits a path and filename into its component parts

The GISDK functions shown below let you create, open, read and write to DOS text files:

GISDK Function	Summary
CloseFile()	Closes a file
FileAtEOF()	Test to see if end of file has been reached
OpenFile()	Opens a text or binary file on disk
ParseString()	Divides a string into pieces separated by the specified delimiters
ReadArray()	Reads a text file into an array of strings
ReadLine()	Reads a string of characters from a text file
ReadSizedArray()	Reads a group of strings from a text file
WriteArray()	Writes the elements of an array to a text file
WriteArraySeparated()	Writes the elements of an array to a file, separated by a delimiter
WriteLine()	Writes a string of characters to a text file

The following GISDK functions let you create, open, read and write to DOS binary files:

GISDK Function	Summary
CloseFile()	Closes a file
FileAtEOF()	Test to see if end of file has been reached
FileGetPosition()	Gets the current Read/Write position of a file
FileReadDouble()	Reads a double-precision (8-byte) floating point number from a binary file
FileReadFloat()	Reads a single-precision (4-byte) floating point number from a binary file
FileReadLongInt()	Reads a long (4-byte) integer from a binary file
FileReadShortInt()	Reads a short (2-byte) integer from a binary file
FileReadString()	Reads a character string from a binary file
FileSetPosition()	Sets the current Read/Write position of a file
FileWriteDouble()	Writes a double-precision (8-byte) floating point number to a binary file
FileWriteFloat()	Writes a single-precision (4-byte) floating point number to a binary file
FileWriteLongInt()	Writes a long (4-byte) integer to a binary file
FileWriteShortInt()	Writes a short (2-byte) integer to a binary file
FileWriteString()	Writes a character string to a binary file
OpenFile()	Opens a text or binary file on disk