callExtension: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(wip)
mNo edit summary
Line 15: Line 15:
* 201: PARAMS_ERROR_TOO_MANY_ARGS
* 201: PARAMS_ERROR_TOO_MANY_ARGS
* 301: EXECUTION_WARNING_TAKES_TOO_LONG
* 301: EXECUTION_WARNING_TAKES_TOO_LONG
Each error will have entry in .rpt file as well with more details.
Each error will have entry in .rpt file with more details.
|= Description
|= Description
____________________________________________________________________________________________
____________________________________________________________________________________________
Line 29: Line 29:


|p21= extension: [[String]] - extension name |= Parameter 1
|p21= extension: [[String]] - extension name |= Parameter 1
|p22= [command, arguments]: [[Array]]
|p22= [command, arguments]: [[Array]] - callExtension params
|p23= command: [[String]] - extension command |= Parameter 2
|p23= command: [[String]] - extension command |= Parameter 2
|p24= arguments: [[Array]] - command arguments. Could be array of anything but each element will be converted to [[String]] automatically. |= Parameter 2
|p24= arguments: [[Array]] - command arguments. Could be array of anything but each element will be converted to [[String]] automatically. |= Parameter 2

Revision as of 19:56, 25 January 2017

Hover & click on the images for description

Description

Description:
Calls custom .dll also known as Extension.

Since Arma 3 v1.67 it is possible to pass array of arguments to extension.
Possible error codes:
  • 101: SYNTAX_ERROR_WRONG_PARAMS_SIZE
  • 102: SYNTAX_ERROR_WRONG_PARAMS_TYPE
  • 201: PARAMS_ERROR_TOO_MANY_ARGS
  • 301: EXECUTION_WARNING_TAKES_TOO_LONG
Each error will have entry in .rpt file with more details.
Groups:
Uncategorised

Syntax

Syntax:
extension callExtension function
Parameters:
extension: String - extension name
function: String - data send to the extension
Return Value:
String - data sent back from extension

Alternative Syntax

Syntax:
extension callExtension [command, arguments]         (Since Arma 3 v1.67)
Parameters:
extension: String - extension name
[command, arguments]: Array - callExtension params
command: String - extension command
arguments: Array - command arguments. Could be array of anything but each element will be converted to String automatically.
Return Value:
Array - in format [result, returnCode, errorCode], where:
  • result: String - data sent back from extension. It is up to extension maker what it is.
  • returnCode: Number - integer return from extension method. It is up to extension maker to define it.
  • errorCode: Number - error code in case of command error (see description). 0 means no errors.

Examples

Example 1:
_return = "myExtension" callExtension "stringToBeParsed";

Additional Information

See also:
callcompileparseSimpleArrayExtensions

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

Notes

Bottom Section