DtvLong dal_mes_inp (nam, st1, st2, st3, siz, inp)

Writes the message of a message name into the message window. The additional entries are inserted into the message at runtime (at the placeholders > %s < ). Additionally a user input is requested.

Input Parameters Significance
char *nam message name [0 = direct output]
char *st1 1. additional entry [0 = unassigned]
char *st2 2. additional entry [0 = unassigned]
char *st3 3. additional entry [0 = unassigned]
DtvLong siz maximum length of the input string

Output Parameters Significance
char *inp input string [default]

Return Code Significance
0 no error
1 message module not initialized
2 message output disabled

The message must be contained in the system entity T_MESSAGE.

If you pass a zero pointer as message name, DataView will directly output the text passed in the parameter st1.

For the parameter inp you can specify an entry as default. This input string will then be output in the message window first.

Each message occupies one row in the message window. You can output several messages in the message window below each other if you defined a multi-line message window via the dal_mes_set function.

In the calling function have to be allocated siz+1 bytes storage place