File: Datafile.em

Description: Functions to access generic data files.
Last Modified: 10/27/2007

File Constants:

CreateDataFile( filespec, flags := DF_KEYTYPE_STRING )
Parameters:
NameType
filespecString
flagsInteger
Explanation
Creates a new data file.
filespec is in normal package descriptor format. 'filename' or '::filename' will create the new data file /data/ds/filename. ':pkgname:filename' will create /data/ds/pkgname/filename.
flags specifies if the keys of the new datafile are strings OR integers.
Return values
DataFile Reference. See the DataFile object documentation.
Errors
"Error in descriptor"
"An exception occurred"
"Invalid parameter type"
Related
Datafile



ListDataFiles( )
Explanation
Returns an array of structs containing:
.pkg - name of the package the datafile belongs to
.name - name of the file
.descriptor - :pkg:name
Return values
Array of Structs
Related
Datafile



OpenDataFile( filespec )
Parameters:
NameType
filespecString
Explanation
Opens a datafile for access.
filespec is in normal package descriptor format. 'filename' or '::filename' will open the data file /data/ds/filename. ':pkgname:filename' will open /data/ds/pkgname/filename.
Return values
DataFile Reference. See the DataFile object documentation.
Errors
"Datafile does not exist"
"Error in descriptor"
"An exception occurred"
"Invalid parameter type"
Related
Datafile



UnloadDataFile( filespec )
Parameters:
NameType
filespecString
Explanation
Unloads a datafile
filespec is in normal package descriptor format. 'filename' or '::filename' will unload the data file /data/ds/filename. ':pkgname:filename' will unload /data/ds/pkgname/filename.
Return values
1 on success
Errors
"Unable to find data store file"
"Invalid parameter type"
Related
Datafile




If you know if any information is incorrect on these pages, mail your corrections to polteam@polserver.com

Copyright ©2003-2006 David Carpman and POL Development Team, all rights reserved. DO NOT REPRODUCE, MIRROR, ALTER, SPINDLE, MUTILATE, OR SIT ON.