Mistake on this page?
Report an issue in GitHub or email us


Mail class hierarchy

Mail works like a queue, with the added benefit of providing a memory pool for allocating messages (not only pointers).

Mail class reference

Public Member Functions
 Mail ()
bool empty () const
bool full () const
T * alloc (uint32_t millisec=0)
T * calloc (uint32_t millisec=0)
osStatus put (T *mptr)
osEvent get (uint32_t millisec=osWaitForever)
osStatus free (T *mptr)

Mail example

This code uses mail to manage measurement.

#include "mbed.h"

/* Mail */
typedef struct {
  float    voltage; /* AD result of measured voltage */
  float    current; /* AD result of measured current */
  uint32_t counter; /* A counter value               */
} mail_t;

Mail<mail_t, 16> mail_box;
Thread thread;

void send_thread (void) {
    uint32_t i = 0;
    while (true) {
        i++; // fake data update
        mail_t *mail = mail_box.alloc();
        mail->voltage = (i * 0.1) * 33; 
        mail->current = (i * 0.1) * 11;
        mail->counter = i;

int main (void) {
    while (true) {
        osEvent evt = mail_box.get();
        if (evt.status == osEventMail) {
            mail_t *mail = (mail_t*)evt.value.p;
            printf("\nVoltage: %.2f V\n\r"   , mail->voltage);
            printf("Current: %.2f A\n\r"     , mail->current);
            printf("Number of cycles: %u\n\r", mail->counter);

Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.