Messages(READ_buf,...)

Description

Read string, received from another thread.

Syntax

Messages(READ_buf, value, string[], script_name[]);

Parameters

Variable	Input

Variable	Input
`size_of_data`	Expected data length.
`data[]`	Variable where data will be stored.
`script_name[]`	Array into which sender script name will be written into.

Returns

Return value	Return explanation
SCRIPT_OPERATION_SUCCESS	Success
SCRIPT_OPERATION_FAILED	Failed
SCRIPT_PARAM_INVALID	Passed array is too small.

Function call example

Example of reading string from message

new sender_script_name[20];             // max script name length is 20 bytes
new received_str_data[50];

public callback (event)
{
    switch(event)
    {
       case Messages_received:
       {
            read_message();
       }
    }
    return 0;
}

read_message()
{
	Messages(READ_buf, sizeof(received_str_data), received_str_data, sender_script_name);
	Messages(CLEAN);
}


main()
{
	Init(RS232, 9600,  WORDLENGTH_8, STOPBITS_1, PARITY_NONE); 
	
    for(;;)
    {	
        Delay(100);
    }
}

Notes and Warnings

We recommend using function Messages(CLEAN); after message has been received and stored into buffer. In case this function was not used - user won't be able to receive new message.

Used in Examples

Messages guide