* * HELP & MANUAL PREMIUM PACK 4 DEMO VERSION * *
This documentation was styled with a demo skin from the Premium Pack 4 add-on for Help & Manual. The contents of the skin are encrypted and not configurable. You can only publish HM projects with this skin. You cannot edit it or change it.
This version is copyright and may only be used for local testing purposes. It may not be distributed.
Please purchase the full version of the Premium Pack to get the configurable skins and remove this notice. The package will also include the Toolbox configuration utility for Premium Pack skins.
Description
Add or change a key/data pair into a dictionary.
Syntax
pData = Dictionary_Add(pDictionary, KeyName, DataToStore)
Returns
Number: pointer to the first byte of the data stored into the dictionary.
Parameters
Name |
Type |
Optional |
Meaning |
pDictionary |
Numeric |
No |
Pointer to a dictionary. |
KeyName |
String |
No |
Name of the key |
DataToStore |
String |
No |
Data to store |
Remarks
If KeyName does not exists into dictionary a new element will be created and its data stored.
If KeyName already exists into dictionary current data will be replaced with the new one.
Restrictions
See also
This functionality has been made obsolete by newer, better optimized hash table available directly in core instead.
Examples
Dim pData As DWord At Dictionary_Exists(pDictionary, KeyName)
If GetAt(pData) <> 0 Then
SizeOfData = StrPtrLen(pData)
End If
