diag codePerformance: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "description.ext" to "description.ext") |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
| Line 8: | Line 8: | ||
|gr2= Performance Profiling | |gr2= Performance Profiling | ||
|descr= Attempts to run given code with given arguments given number of cycles in unscheduled environment and returns average time it took to run the code as well as actual number of executions performed. The command will return as soon as possible if the tested code is slow and the duration of the command exceeds 1 second. Engine alternative to [[BIS_fnc_codePerformance]] | |descr= Attempts to run given code with given arguments given number of cycles in unscheduled environment and returns average time it took to run the code as well as actual number of executions performed. | ||
The command will return as soon as possible if the tested code is slow and the duration of the command exceeds 1 second. | |||
Engine alternative to [[BIS_fnc_codePerformance]]. | |||
|mp= For security purposes, this command will only run for 1 cycle in multiplayer, unless in-game [[Arma 3: Debug Console|debug console]] is available via [[Description.ext|description.ext]] option or [[Eden]] attribute setting. | |||
|s1= [[diag_codePerformance]] [code, arguments, cycles] | |s1= [[diag_codePerformance]] [code, arguments, cycles] | ||
|p1= [code | |p1= code: [[Code]] - code to compare performance | ||
|p2= arguments: [[Anything]] - (Optional, default [[nil]]) arguments to pass to the code in _this variable. Default: [[nil]] | |||
| | |p3= cycles: [[Number]] - (Optional, default 100000) wanted number of cycles to run the given code. > 1000 is recommended | ||
|r1= [[Array]] format [duration, cycles], where: | |||
|r1= [[Array]] | |||
* duration: [[Number]] - average duration of 1 execution in milliseconds | * duration: [[Number]] - average duration of 1 execution in milliseconds | ||
* cycles: [[Number]] - actual number of cycles executed | * cycles: [[Number]] - actual number of cycles executed | ||
|x1= <code>_result = [[diag_codePerformance]] [{[[private]] _a = 123;}, 0, 10000];</code> | |x1= <code>[[private]] _result = [[diag_codePerformance]] [{ [[private]] _a = 123; }, 0, 10000];</code> | ||
|seealso= [[diag_log]], [[BIS_fnc_codePerformance]], [[ | |seealso= [[diag_log]], [[BIS_fnc_codePerformance]], [[Code Optimisation]] | ||
}} | }} | ||
Revision as of 18:31, 24 November 2021
Description
- Description:
- Attempts to run given code with given arguments given number of cycles in unscheduled environment and returns average time it took to run the code as well as actual number of executions performed. The command will return as soon as possible if the tested code is slow and the duration of the command exceeds 1 second. Engine alternative to BIS_fnc_codePerformance.
- Multiplayer:
- For security purposes, this command will only run for 1 cycle in multiplayer, unless in-game debug console is available via description.ext option or Eden attribute setting.
- Groups:
- DiagnosticPerformance Profiling
Syntax
- Syntax:
- diag_codePerformance [code, arguments, cycles]
- Parameters:
- code: Code - code to compare performance
- arguments: Anything - (Optional, default nil) arguments to pass to the code in _this variable. Default: nil
- cycles: Number - (Optional, default 100000) wanted number of cycles to run the given code. > 1000 is recommended
- Return Value:
- Array format [duration, cycles], where:
Examples
- Example 1:
private _result = diag_codePerformance [{ private _a = 123; }, 0, 10000];
Additional Information
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