Hashset Module Documentation
From Nwnx
Documentation and program are © by Ingmar Stieger (Papillon). Version 1.0 of 18.12.2003.
|
|
What does this module do?
his modules implements an advanced data structure, combining a hashmap and a set. This means you can set up associations between key - value pairs (hashmap), and also cycle through all stored data (set). You can even use this like an array, although it has much more to offer than just that. Even if it's the first release of this module, it has been in production on Avlis for quite some now and proofed to be very reliable.
Licence This module is distributed unter the terms of the GNU GENERAL PUBLIC LICENSE included in licence.txt.
Using the module
Importing the erf
- 1. Place the file "hashset_nwnx.erf" into the C:\\Neverwinternights\\NWN\\erf directory.
- 2. In the toolset, open up the module into which you wish to install the scripts.
- 3. Under the File Menu, click Import. A window will pop up.
- 4. Make sure the contents of the C:\\Neverwinternights\\NWN\\erf directory are showing in the window
- 5. Select "hashset_nwnx.erf" from the list.
The following script should now be imported: hashset_nwnx
Using the HashSet functions
The functions below are implemented. Have a look at the script modload in the module "hashset_nwnx.mod" to see how these functions are used.
int HashSetCreate(object oObject, string sHashSetName, int iSize = 500)
create a new HashSet on oObject with name sHashSetName iSize is optional
void HashSetDestroy(object oObject, string sHashSetName)
Clear and delete sHashSetName on oObject
int HashSetValid(object oObject, string sHashSetName)
return true if hashset sHashSet is valid
int HashSetKeyExists(object oObject, string sHashSetName, string sKey)
return true if hashset sHashSet contains key sKey
int HashSetSetLocalString(object oObject, string sHashSetName, string sKey, string sValue)
Set key sKey of sHashset to string sValue
string HashSetGetLocalString(object oObject, string sHashSetName, string sKey)
Retrieve string value of sKey in sHashset
int HashSetSetLocalInt(object oObject, string sHashSetName, string sKey, int iValue)
Set key sKey of sHashset to integer iValue
int HashSetGetLocalInt(object oObject, string sHashSetName, string sKey)
Retrieve integer value of sKey in sHashset
int HashSetDeleteVariable(object oObject, string sHashSetName, string sKey)
Delete sKey in sHashset
string HashSetGetNthKey(object oObject, string sHashSetName, int i)
Return the n-th key in sHashset note: this returns the KEY, not the value of the key
string HashSetGetFirstKey(object oObject, string sHashSetName)
Return the first key in sHashset note: this returns the KEY, not the value of the key;
string HashSetGetNextKey(object oObject, string sHashSetName)
Return the next key in sHashset note: this returns the KEY, not the value of the key;
string HashSetGetCurrentKey(object oObject, string sHashSetName)
Return the current key in sHashset note: this returns the KEY, not the value of the key;
int HashSetGetSize(object oObject, string sHashSetName)
Return the number of elements in sHashset
int HashSetHasNext(object oObject, string sHashSetName)
Return TRUE if the current key is not the last one, FALSE otherwise
