Alarm.cpp

Go to the documentation of this file.

 
 // Inclusione <automatica> dell'header che si sta implementando
#include "Alarm.h"
 
// Implementazione del metodo 'Init' della categoria 'Init'
bool Alarm::Init()
{
    // Se esiste, dealloco istanza corrente per 'm_Alarm'
    if (m_Alarm)
    {
        // Deallocazione
        delete m_Alarm;
 
        // Sanificazione manuale
        m_Alarm = nullptr;
    }
 
    // Costruzione dell'oggetto di classe "AlarmData" attraverso il corrispettivo costruttore di default
    // Allocazione dinamica [heap]
    m_Alarm = new AlarmData();
 
    // Dopo l'allocazione, controllo che effettivamente � andata a buon fine. Un puntatore nullo (i.e. 'nullptr') sarebbe indice di errori durante l'allocazione.
    if (m_Alarm)
        return true;
 
    return false;
}
 
// Implementazione del metodo 'set_Time' della categoria 'Value Setters'
// set_Time (1)
bool Alarm::set_Time(const unsigned int& t_Hour, const unsigned int& t_Minute)
{
    // Imposto i valori degli attributi della classe "AlarmData" con i parametri 't_Hour', 't_Minute'.
    // Richiamo il metodo 'set_Time' della classe "AlarmData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_Alarm' sia stato effettivamente allocato
    if (m_Alarm)
        return m_Alarm->set_Time(t_Hour, t_Minute);
    else
        return false;
}
 
// Implementazione del metodo 'set_Time' della categoria 'Value Setters'
// set_Time (2)
bool Alarm::set_Time(const unsigned int& t_Hour, const unsigned int& t_Minute, const Clock::TimePeriod& t_Period)
{
    // Imposto i valori degli attributi della classe "AlarmData" con i parametri 't_Hour', 't_Minute', 't_Period'
    // Richiamo il metodo 'set_Time' della classe "AlarmData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_Alarm' sia stato effettivamente allocato
    if (m_Alarm)
        return m_Alarm->set_Time(t_Hour, t_Minute, t_Period);
    else
        return false;
}
 
// Implementazione del metodo 'set_Time' della categoria 'Value Setters'
// set_Time (3)
bool Alarm::set_Time(const String& t_Value)
{
    // Imposto i valori degli attributi della classe "AlarmData" con i parametri 't_Hour', 't_Minute', 't_Period'
    // Richiamo il metodo 'set_Time' della classe "AlarmData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_Alarm' sia stato effettivamente allocato
    if (m_Alarm)
        return m_Alarm->set_Time(t_Value);
    else
        return false;
}
 
// Implementazione del metodo 'set_Time' della categoria 'Value Setters'
// set_Time (4)
bool Alarm::set_Time(const String& t_Value, const Clock::TimePeriod& t_Period)
{
    // Imposto i valori degli attributi della classe "AlarmData" con i parametri 't_Hour', 't_Minute', 't_Period'
    // Richiamo il metodo 'set_Time' della classe "AlarmData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_Alarm' sia stato effettivamente allocato
    if (m_Alarm)
        return m_Alarm->set_Time(t_Value, t_Period);
    else
        return false;
}
 
// Implementazione del metodo 'set_State' della categoria 'Value Setters'
bool Alarm::set_State(const AlarmData::AlarmState& t_State)
{
    // Imposto il valore dell'attributo della classe "AlarmData" con il parametro 't_State'.
    // Richiamo il metodo 'set_State' della classe "AlarmData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_Alarm' sia stato effettivamente allocato
    if (m_Alarm)
        return m_Alarm->set_State(t_State);
    else
        return false;
}
 
// Implementazione del metodo 'get_Alarm' della categoria 'LowLevel getters'
AlarmData* const Alarm::get_Alarm()
{
    // Ritorno l'attributo 'm_Alarm' perch� rappresenta gi� un puntatore
    return m_Alarm;
}
 
// Implementazione del metodo 'get_SetTime' della categoria 'Metodi'
String Alarm::get_SetTime()
{
    // Richiamo il metodo 'get_SetTime' della classe "AlarmData"
    // Ritorno il valore che ritorna il metodo della classe "AlarmData" nel caso l'operazione di dereferenziamento dell'oggetto si conclude con successo.
    // In caso contrario, ritorno il valore dell'invalidatore 'm_Invalidator'
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_Alarm' sia stato effettivamente allocato
    if (m_Alarm)
    {
        if (m_Alarm->get_SetTime() == String(AlarmData::get_CoreInvalidator()))
            return String(m_Invalidator);
        else
            return m_Alarm->get_SetTime();
    }
    else
        return String(m_Invalidator);
}
 
// Implementazione del metodo 'Check' della categoria 'Metodi'
bool Alarm::Check()
{
    // Controllo se la sveglia, nel momento della chiamata di questo stesso medesimo metodo, � in trigger oppure no
    // Richiamo il metodo 'Check' della classe "AlarmData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_Alarm' sia stato effettivamente allocato
    if (m_Alarm)
        return m_Alarm->Check();
    else
        return false;
}
 
// Implementazione del metodo 'UpdateFormat' della categoria 'Metodi'
bool Alarm::UpdateFormat()
{
    // Effettua l'aggiornamento del formato dell'ora dal punto di vista di AlarmData per sincronizzarlo con quello di Clock
    // Richiamo il metodo 'UpdateFormat' della classe "AlarmData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_Alarm' sia stato effettivamente allocato
    if (m_Alarm)
        return m_Alarm->UpdateFormat();
    else
        return false;
}