BIS fnc dbValueSet: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (Some wiki formatting)
 
(37 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{RV|type=function


{{Function|= Comments
|game1= tkoh
____________________________________________________________________________________________
|version1= 1.00


| tkoh |= Game name
|game2= arma3
|version2= 0.50


|1.00|= Game version
|gr1= Database
____________________________________________________________________________________________


| <pre>//
|descr= Add value to Scripted Database. If the provided path does not exist it is created, otherwise the value is overwritten. The passed array gets modified.
/*


Description:
|s1= [database, path, newvalue] call [[BIS_fnc_dbValueSet]]
Add value to Scripted Database.


Parameter(s):
|p1= database - [[Array]]: database array
_this select 0: ARRAY - Database array
_this select 1: ARRAY - Path
_this select 2: ARRAY - Value


Returns:
|p2= path - [[Array]]: path to value
BOOLEAN - True if value was added
*/


</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |DESCRIPTION=
|r1= [[Boolean]]: True if value was added
____________________________________________________________________________________________


| <!-- [] call [[BIS_fnc_dbValueSet]]; --> |SYNTAX=
|x1= <sqf>
private _db = ["#MILLER", ["&KILLS", 1000, "&RANK", "CAPTAIN"]];
[_db, ["miller","kills"],200] call BIS_fnc_dbValueSet;
_db // ["#MILLER",["&KILLS",200,"&RANK","CAPTAIN"]]
</sqf>


|p1= |= Parameter 1
|x2= <sqf>
 
private _db = ["#MILLER", ["&KILLS", 1000, "&RANK", "CAPTAIN"]];
| |RETURNVALUE=
[_db, ["miller","iq"],200] call BIS_fnc_dbValueSet;
____________________________________________________________________________________________
_db // ["#MILLER",["&KILLS",1000,"&RANK","CAPTAIN","&IQ",200]]
 
</sqf>
|x1= <code></code> |=
____________________________________________________________________________________________
 
| |SEEALSO=


|seealso= [[:Category:Function Group: Database|Database functions]] [[BIS_fnc_dbClassCheck]] [[BIS_fnc_dbClassId]] [[BIS_fnc_dbClassIndex]] [[BIS_fnc_dbClassList]] [[BIS_fnc_dbClassRemove]] [[BIS_fnc_dbClassReturn]] [[BIS_fnc_dbClassSet]] [[BIS_fnc_dbConfigPath]] [[BIS_fnc_dbImportConfig]] [[BIS_fnc_dbImportXML]] [[BIS_fnc_dbisClass]] [[BIS_fnc_dbisValue]] [[BIS_fnc_dbPrint]] [[BIS_fnc_dbSymbolClass]] [[BIS_fnc_dbSymbolValue]] [[BIS_fnc_dbValueCheck]] [[BIS_fnc_dbValueId]] [[BIS_fnc_dbValueIndex]] [[BIS_fnc_dbValueList]] [[BIS_fnc_dbValueRemove]] [[BIS_fnc_dbValueReturn]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Function Group: Database|{{uc:dbValueSet}}]]
[[Category:Functions|{{uc:dbValueSet}}]]
[[Category:{{Name|tkoh}}: Functions|{{uc:dbValueSet}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:dbValueSet}}]]

Latest revision as of 23:29, 12 July 2022

Hover & click on the images for description

Description

Description:
Add value to Scripted Database. If the provided path does not exist it is created, otherwise the value is overwritten. The passed array gets modified.
Execution:
call
Groups:
Database

Syntax

Syntax:
[database, path, newvalue] call BIS_fnc_dbValueSet
Parameters:
database - Array: database array
path - Array: path to value
Return Value:
Boolean: True if value was added

Examples

Example 1:
private _db = ["#MILLER", ["&KILLS", 1000, "&RANK", "CAPTAIN"]]; [_db, ["miller","kills"],200] call BIS_fnc_dbValueSet; _db // ["#MILLER",["&KILLS",200,"&RANK","CAPTAIN"]]
Example 2:
private _db = ["#MILLER", ["&KILLS", 1000, "&RANK", "CAPTAIN"]]; [_db, ["miller","iq"],200] call BIS_fnc_dbValueSet; _db // ["#MILLER",["&KILLS",1000,"&RANK","CAPTAIN","&IQ",200]]

Additional Information

See also:
Database functions BIS_fnc_dbClassCheck BIS_fnc_dbClassId BIS_fnc_dbClassIndex BIS_fnc_dbClassList BIS_fnc_dbClassRemove BIS_fnc_dbClassReturn BIS_fnc_dbClassSet BIS_fnc_dbConfigPath BIS_fnc_dbImportConfig BIS_fnc_dbImportXML BIS_fnc_dbisClass BIS_fnc_dbisValue BIS_fnc_dbPrint BIS_fnc_dbSymbolClass BIS_fnc_dbSymbolValue BIS_fnc_dbValueCheck BIS_fnc_dbValueId BIS_fnc_dbValueIndex BIS_fnc_dbValueList BIS_fnc_dbValueRemove BIS_fnc_dbValueReturn

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