Command parameters must be simple / regular

[mslonik]

Dear Forum,

I've found that for commands (e.g. IniRead) the OutputVar parameter must be simple / regular. It means that as OutputVar I must not use object types (e.g. linear array or associative array etc.). This issue was discussed in this topic. This isn't true for functions. So I see here advantage / disadvantage if commands are compared to functions.

My suggestions to documentation:

General:
Mention about this trait when difference between functions and commands are described: here and here.

Specific:
Mention about this trait in each specific command description, in OutputVar section, e.g. in description of IniRead command.

Kind regards, mslonik

[gregster]

jftr, currently, there is a (short) mention here - re "forcing an expression":

Force an expression: An expression can be used in a parameter that does not directly support it (except OutputVar parameters) by preceding the expression with a percent sign and a space or tab. In [v1.1.21+], this prefix can be used in the InputVar parameters of all commands except the traditional IF commands (use If (expression) instead). This technique is often used to access arrays.

[gregster]

Also, the second place you suggested for an addendum already contains this information - even in a special 'note' box:

Note: Only a plain variable can be used as an OutputVar. Array elements, properties and other expressions are not supported.

[mslonik]

Yes, you're right. True, it's mentioned. Then I suggest to close this topic.

Kind regards, mslonik