os_mbx_check

#include <rtl.h>

OS_RESULT os_mbx_check (
   OS_ID mailbox );    /* The mailbox to check for free space */

The os_mbx_check function determines the number of messages that can still be added into the mailbox identified by the function argument. You can avoid blocking the current task by calling the os_mbx_check function to check for available space in the mailbox before calling the os_mbx_send function to send a message.

The os_mbx_check function is in the RL-RTX library. The prototype is defined in rtl.h.

The os_mbx_check function returns the number of message entries in the mailbox that are free.

isr_mbx_check, os_mbx_declare, os_mbx_init, os_mbx_send, os_mbx_wait

#include <rtl.h>

os_mbx_declare (mailbox1, 20);

__task void task1 (void) {
   ..
  if (os_mbx_check (&mailbox1) == 0) {
    printf("Mailbox is full.\n");
  }
   ..
}