##### Synopsis

    #include <ctl_api.h>
    unsigned ctl_message_queue_receive_nb(CTL_MESSAGE_QUEUE_t *m,
                                          void **message);

##### Description

The function ctl_message_queue_receive_nb pops the oldest message in the message queue pointed at by m into the memory pointed at by message. If no messages are available the function returns zero otherwise it returns 1.

##### Portability

ctl_message_queue_receive_nb is provided in every implementation of the CrossWorks tasking library.

##### See Also

Message queues