setproperty
warning
This function starts with a lowercase letter.
Description
Add a new property or change an existing property.
| Name | Description |
|---|---|
| id | The virtual machine to use, you should keep this zero. (optional=0) |
| name[] | Used in combination with value when storing integers; don't use this if you want to store a string. |
| value | The integer value to store or the property's unique ID if storing a string. Use the hash-function to calculate it from a string. (optional=cellmin) |
| string[] | The value of the property, as a string. Don't use this if you want to store an integer. |
Returns
This function does not return any specific values.
Examples
setproperty(.name = "MyInteger", .value = 42);
new value = getproperty(.name = "MyInteger");
printf("Value that was stored is: %d", value);
setproperty(0, "", 123984334, ":)");
new value[4];
getproperty(0, "", 123984334, value);
strunpack(value, value, sizeof(value)); // we need to unpack the string first
print(value);
//should print :)
setproperty(.value = 123984334, .string = ":)");
// The rest is the same as above.
Notes
tip
It is recommended to use the PVars/SVars or GVar plugin instead of these natives for being very slow.
Related Functions
- getproperty: Get the value of a property.
- deleteproperty: Delete a property.
- existproperty: Check if a property exists.