createHashMapObject: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Page creation; more to come soon™)
 
m (Some wiki formatting)
Line 36: Line 36:
];
];


private _hashMapObject = createhashMapObject _declaration; // hints "Hello!"
private _hashMapObject = createHashMapObject _declaration; // hints "Hello!"
_hashMapObject call ["Method"]; // hints "Method has been called"
_hashMapObject call ["Method"]; // hints "Method has been called"
hint str _hashMapObject; // hints "My HashMap Object"
hint str _hashMapObject; // hints "My HashMap Object"

Revision as of 17:58, 9 April 2023

Hover & click on the images for description
Only available in Development branch(es) until its release with Arma 3 patch v2.14.

Description

Description:
Create a HashMap with an Object-Oriented Programming behaviour.
Groups:
HashMap

Syntax

Syntax:
createHashMapObject details
Parameters:
details: Array of Arrays in format [name, value]. name can be anything like any other HashMap, but it must be a String for it to be used like an OOP object method (see call - Syntax 3).
Some special values, starting with #, are reserved and expect a specific value type (they are all optional):
  • "#create": Code - this is the hashmap object's constructor
  • "#clone": Code - this is code happening when cloning is done on this hashmap object
  • "#delete": Code - this is the hashmap object's destructor
  • "#str": Code - code that is used to evaluate what is displayed when - must return String
  • "#flags": Array of Strings - case-insensitive flags regarding this hashmap object
    • "noCopy": forbids copying, +_hashMapObject will throw an error
    • "sealed": prevents from adding and removing any keys - key values can still be edited
    • "unscheduled": all methods (including #clone and #create) will be executed in unscheduled environment
Return Value:
HashMap

Examples

Example 1:
private _declaration = [ ["#flags", ["sealed"]], ["#create", { hint "Hello!" }], ["#clone", { hint "We were copied!" }], ["#delete", { hint "Goodbye" }], ["#str", { "My HashMap Object" }], ["Method", { hint "Method has been called" }] ]; private _hashMapObject = createHashMapObject _declaration; // hints "Hello!" _hashMapObject call ["Method"]; // hints "Method has been called" hint str _hashMapObject; // hints "My HashMap Object" private _shallowCopy = _hashMapObject; // no hint private _deepCopy = +_hashMapObject; // hints "We were copied!" // at the end of the scope, _hashMapObject is deleted and hints "Goodbye"

Additional Information

See also:
call createHashMap

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note