knx/src/knx/save_restore.h

#pragma once
#include <stdint.h>

/**
 * Interface for classes that can save and restore data from a buffer. 
 */
class SaveRestore
{
  public:
    /**
     * This method is called when the object should save its state to the buffer.
     *  
     * @param buffer The buffer the object should save its state to.
     * 
     * @return The buffer plus the size of the object state. The next object will use this value as 
     * the start of its buffer.
     */
    virtual uint8_t* save(uint8_t* buffer)
    {
        return buffer;
    }
    
    /**
     * This method is called when the object should restore its state from the buffer.
     *  
     * @param buffer The buffer the object should restore its state from.
     * 
     * @return The buffer plus the size of the object state. The next object will use this value as 
     * the start of its buffer.
     */
    virtual const uint8_t* restore(const uint8_t* buffer)
    {
        return buffer;
    }
    
    /**
     * @return The maximum number of bytes the object needs to save its state. 
     */
    virtual uint16_t saveSize()
    {
        return 0;
    }
};